Manual X-IntegConfig

X-IntegConfig
Configuração da integração do X-Mobile®
Versão 1.0.7
Índice
-
Introdução ............................................................................................................ 2
-
Como usar o X-IntegConfig®................................................................................... 3
-
-
Detalhes do ficheiro de importação .................................................................. 5
(a)
Edição de Instrução SQL ................................................................................ 8
(b)
Configuração do Campo ................................................................................. 9
Ecrã Abrir Base de Dados ............................................................................... 13
(a) Explorar base de dados.................................................................................... 14
Pág. 1
¾ Introdução
Na perspectiva das aplicações móveis a comunicação de dados entre os dispositivos móveis e
os sistemas centrais faz-se através de ficheiros, pelo que se torna necessário integrar e
transformar estes dados de e para ficheiros.
Esta ferramenta facilitará a definição das transformações a efectuar mapeando os dados em
ficheiros para o local correspondente na base de dados e vice-versa.
Pág. 2
¾ Como usar o X-IntegConfig®
A interface da aplicação
Ao iniciar, o programa de configuração apresenta o seguinte aspecto:
Legenda:
1. Botão nova configuração – Insere um novo ficheiro de configuração
2. Botão Abrir configuração – Abre um ficheiro de configuração existente
3. Botão Guardar configuração – Guarda as alterações do ficheiro de configuração
4. Botão Abrir base de dados SQL CE – Abre uma base dados do SQL Server CE
5. Botão Explorar base de dados SQL CE – Explora a estrutura da base de dados SQL
Server CE aberta
6. Botão Sair da aplicação – Sai da aplicação
Pág. 3
7. Nome da Configuração – Define o nome da configuração
8. Descrição – Permite introduzir uma descrição da configuração
9. Mostra lista de ficheiros de importação
10. Mostra lista de ficheiros de exportação
11. Directório IN no FTP
12. Directório OUT no FTP
13. Localização no dispositivo – Insere a localização do ficheiro de configuração no
dispositivo móvel
14. Botão Adicionar – Insere um novo ficheiro de importação
15. Botão Detalhes – Permite visualizar e/ou alterar os detalhes do ficheiro de exportação
16. Botão Eliminar – Elimina o ficheiro de exportação seleccionado da lista
Nota:
O ficheiro de configuração é guardado no disco com a extensão “.xcfg” e deve ter o mesmo
nome da base de dados da licença do X-Mobile® com o qual vai ser usado. Este ficheiro terá
de ser colocado na pasta do X-Mobile® do dispositivo.
Pág. 4
™
Detalhes do ficheiro de importação
Legenda:
1. Codificação – Tabela de caracteres usada na codificação do ficheiro. Embora
normalmente não seja imperativo definir a codificação, poderão haver situações em que
esta definição seja necessária
2. Acção prévia (apenas importação) – Indica qual a acção a efectuar previamente à
importação dos dados do ficheiro. "Nenhuma": não efectua qualquer acção; "Apagar
todos os registos": elimina todos os registos da tabela antes de iniciar a importação;
"Apagar registos únicos": elimina cada registo presente no ficheiro de dados caso este
exista na tabela, permitindo a sua actualização
3. Separador de campos – Indica o caracter usado para separar os campos do ficheiro de
dados. Se este caracter pode ser omitido com campos de comprimento fixo, ele é
obrigatório quando os campos são de comprimento variável
4. Botão Guardar – Guarda as alterações efectuadas
Pág. 5
5. Botão “Ajuda” (?) – Abre uma página de ajuda
6. Botão Fechar – Sai do ecrã de detalhes do ficheiro de importação
7. Descrição – Breve descrição do ficheiro
8. Opção Incluir – Quando desactivado, permite suspender a importação/exportação do
ficheiro
9. Ficheiro - Permite indicar o ficheiro de dados de importação/exportação. Se o âmbito do
ficheiro for individual (por utilizador) deve incluir-se "[#USR]" na posição onde deve ser
interpretado ou colocado o número do utilizador. Por exemplo, ao exportar o ficheiro
"DV[#USR].DAT" no dispositivo do utilizador 01, será criado o ficheiro "DV01.DAT". Da
mesma forma, ao importar o ficheiro "CLIENTES[#USR].DAT" no mesmo dispositivo, o
motor irá procurar o ficheiro "CLIENTES01.DAT"
10. Opção Campos de comprimento fixo – Indica se os campos do ficheiro terão
comprimento
fixo.
Neste
caso
é
importante definir o tamanho e opções de
preenchimento na configuração do campo
11. Directório – Indica o subdirectório do dispositivo onde o motor de integração deverá
procurar o ficheiro de dados de importação ou colocar o ficheiro de dados de exportação
12. Opção Acrescentar ao ficheiro existente – Quando activado, significa que os dados
exportados serão acrescentados ao ficheiro eventualmente existente. A desactivação
implica a sobreposição dos dados existentes se o ficheiro não tiver sido ainda
transferido
13. Tabela/Instrução SQL – Tratando-se de importação, deve ser indicada a tabela onde
serão inseridos os registos do ficheiro de dados. Na exportação deve ser construída
uma instrução de selecção SQL (SELECT) que contemple os dados a escrever no
ficheiro. A instrução SQL pode conter, além dos campos propriamente ditos, quaisquer
expressões permitidas pelo SQL CE e, se necessário, incluir várias vezes o mesmo
campo, desde que se defina um nome alternativo, ou "alias" (AS NomeAlternativo). O
botão "..." permite ter acesso a um editor simples de SQL que permite (se houver uma
base de dados aberta) ter acesso a uma lista de tabelas e campos disponíveis e
executar a instrução para efeitos de teste, detectando eventuais erros numa fase inicial
14. Botão de edição de instrução SQL (a)
15. Opção Eliminar Ficheiro – Quando activo permite eliminar a linha do ficheiro
seleccionada
Pág. 6
16. Lista de campos – Apresenta uma lista de configurações de campo já definidas. Um
duplo clique numa das linhas permite ver e/ou alterar a configuração do campo
correspondente
17. Botão
Adicionar
–
Permite
adicionar
uma
nova
configuração
de
campo
(ver
e/ou
os
detalhes
Configuração de Campo) (b)
18. Botão
Configuração
de
Campos
–
Permite
ver
alterar
da
configuração/linha seleccionada
19. Botão Configuração de Campos – Permite criar um novo campo a partir do campo
seleccionado
20. Botão Eliminar – Elimina um campo da configuração do ficheiro
21. Botão Subir – Permite alterar a ordem dos campos. A ordem dos campos nesta
configuração tem que corresponder à ordem dos campos do ficheiro de dados, sob pena
da ocorrência de discrepâncias ou erros na integração
22. Botão Descer – Permite alterar a ordem dos campos. A ordem dos campos nesta
configuração tem que corresponder à ordem dos campos do ficheiro de dados, sob pena
da ocorrência de discrepâncias ou erros na integração
23. Ficheiro no FPT – Nome do ficheiro no FTP
24. Ficheiro no PDA – Nome do ficheiro no PDA
25. Ficheiro Obrigatório – Quando seleccionado obriga a sua existência no FTP
26. Extensão no FPT – Extensão do ficheiro no FTP
27. Extensão do PDA – Extensão do ficheiro no PDA
28. Ficheiro de Com. Urgente – Ficheiros enviados no menu de comunicação urgente do XMobile
29. Utilizadores – Define os números de utilizadores disponíveis para o ficheiro
30. Descrição no PDA – Breve descrição do ficheiro
31. Ficheiro Individual – Quando seleccionado indica que concatenado ao nome tem que
existir o número do vendedor (por exemplo: artigos01)
Pág. 7
(a) Edição de Instrução SQL
Legenda:
1. Botão Executar SQL – Executa a instrução SQL
2. Botão Explorar Base de Dados – Mostra as tabelas da base de dados e os seus campos
3. Botão Guardar – Guarda as alterações efectuadas
4. Botões Cortar, Copiar, Colar
5. Botão Cancelar – Cancela as alterações efectuadas
6. Instrução SQL
7. Lista das tabelas da base de dados
8. Lista das colunas da tabela seleccionada
9. Mostra o resultado da última instrução SQL executada
Pág. 8
(b) Configuração do Campo
Legenda:
1. Botão Ok – Confirma as alterações
2. Botão Fechar – Retorna ao ecrã inicial
3. Botão “Ajuda” (?) – Abre uma página de ajuda
4. Ficheiro – Indica o ficheiro de dados de importação/exportação a que respeita este
campo
5. Ordem – Indica a posição do campo do ficheiro ao qual respeita este campo
Pág. 9
6. Id. do campo – Identificador único do campo. Tipicamente será o nome do campo na
tabela/instrução SQL, a não ser que o mesmo campo seja utilizado mais do que uma
vez
7. Chave Primária – Permite definir se o campo em causa faz parte da chave-primária da
tabela. Esta definição é importante quando a opção "Acção prévia" da configuração do
ficheiro (ver Configuração de Ficheiro) estiver definida como "Apagar registos únicos"
8. Descrição – Breve descrição do campo
9. Tipo de dados – Indica de que tipo é o campo (numérico, alfanumérico, data, lógico). O
tipo de dados deve ser definido de acordo com as características dos dados dos
ficheiros
sendo
que,
quando
mal
definido,
pode
dar
origem
a
erros
na
importação/exportação por incompatibilidade dos tipos de dados. Por exemplo, se num
ficheiro de importação um campo for definido como numérico e no ficheiro de dados
estiver presente um valor "A", será gerado um erro de conversão de tipo de dados e o
registo não será escrito
10. Tamanho – Número máximo de caracteres a considerar na leitura/escrita do ficheiro de
dados. Este valor só é aplicável quando o tipo de dados é Alfanumérico ou quando a
opção "Campos de comprimento fixo" na configuração do ficheiro estiver activada.
11. Multiplicador – Constante pela qual o valor original é multiplicado ao ler/escrever do/no
ficheiro. Esta constante é útil nos casos em que os valores decimais são guardados sob
a forma de números inteiros com um factor multiplicativo
Nota: Para efectuar uma divisão, deverá ser indicada a dízima correspondente (ex. para
dividir por 100, deve ser indicado o multiplicador 0,01)
12. Campo da tabela – Indique qual o campo da tabela/instrução SQL a que respeita este
campo. Na importação indica o campo da tabela onde o valor presente no ficheiro de
dados será inserido. Na exportação indica o campo da instrução SQL cujo valor vai ser
escrito no ficheiro de dados. Se estiver disponível uma base de dados, será possível
seleccionar o campo a partir da lista, sendo que, tratando-se de um campo de um
ficheiro de exportação, será necessário executar a instrução SQL para obter esta lista
13. Actualiza lista de campos (se houver uma base de dados aberta)
14. Casa decimais – Indica o número de casas decimais com que o valor numérico deve ser
escrito (exportação)
Pág. 10
15. Formato de saída – Tratando-se de um ficheiro de exportação, permite especificar o
formato com o qual o valor será escrito no ficheiro e aplica-se apenas a datas e valores
numéricos. Por exemplo, um valor poderá ser escrito de formas diferentes mediante o
formato definido (valor 1000, 0.00 - 1000,00; #,##0.00 - 1.000,00; 0 – 1000, data
13-12-2007, dd-MM-yyyy - 13-12-2007; yyyy-MM-dd - 2007-12-13; yyyyMMdd 20071213)
16. Sep. Decimal – Indica o separador decimal a considerar. No caso da importação, ajuda
a interpretar os valores numéricos independentemente das definições regionais. Se,
num ficheiro de importação, os valores numéricos estiverem com o separador decimal
".", este deve ser o indicado. Na exportação, os valores decimais são escritos com o
separador decimal indicado
Nota: Se não for indicado o separador decimal a integração fica dependente das
definições regionais (por exemplo, com "Português" será considerado o separador ","),
o que poderá levar a uma interpretação errada dos valores numéricos
17. Formato
de
entrada
–
Permite
especificar
a
extensão
do
ficheiro
que
será
posteriormente recebido pela aplicação
18. Limpar Espaços – Limpa espaços em branco entre os parâmetros
19. Valor fixo – Valor fixo a considerar ao ler/escrever do/no ficheiro. Se indicado, será
sempre considerado em detrimento do valor presente no campo. Terá utilidade nos
casos em que é necessário inserir um valor fixo na tabela quando esse campo não é
contemplado no ficheiro. Os campos com valores fixo devem, sempre que possível,
surgir depois dos campos do ficheiro
20. Texto vazio - Se o valor fixo e/ou valor por defeito for um texto vazio (cadeia de
comprimento zero), estas opções deverão ser activadas, caso contrário, o motor de
integração considerará que os valores não estão definidos
21. Valor por defeito – Valor que é considerado quando o campo do ficheiro está previsto
mas não possui qualquer valor
22. Texto vazio - Se o valor fixo e/ou valor por defeito for um texto vazio (cadeia de
comprimento zero), estas opções deverão ser activadas, caso contrário, o motor de
integração considerará que os valores não estão definidos
Pág. 11
23. Caracter (Preenchimento) – Quando o ficheiro é de exportação e a opção "Campos de
comprimento fixo" na configuração do ficheiro está activada, indica o carácter a usar
para preencher o valor do campo até ao tamanho definido (ver tamanho do campo)
24. Direcção (Preenchimento) – Indica se o carácter de preenchimento é colocado à
esquerda ou à direita do valor
25. Delimitador do Valor (Preenchimento) – Indicar o carácter a usar para delimitar o valor
do campo. Por exemplo, os valores alfanuméricos podem ser, se necessário,
delimitados por " (aspas)
26. Fórmula – Na importação, permite efectuar operações sobre os campos. A fórmula pode
consistir em operações matemáticas básicas ou em concatenações de texto. As
operações matemáticas devem ser sinalizadas pela expressão "#EVAL", colocando entre
parêntesis os argumentos e as operações. As concatenações de texto devem ser
sinalizadas pela expressão "#EVALSTR", colocando entre parêntesis os argumentos
27. Exemplos:
- Adicionar os valores do campo 1, do campo 5 e da constante 10: #EVAL([#1] + [#5]
+ 10);
- Multiplicar o valor do campo 2 por 5 e somar-lhe 10: #EVAL([#2] * 5 + 10);
- Concatenar os valores do campo 1 e do campo 2, colocando "|" entre os dois:
#EVALSTR([#1] & "|" & [#2]) ).
28. Condição – Indica qual o filtro a efectuar
29. Valor – Valor consoante a condição seleccionada
Pág. 12
™
Ecrã Abrir Base de Dados
Legenda:
1. Base de dados – Indica o caminho da base de dados
2. Botão para localizar ficheiro de base de dados
3. Password – Inserir password para ter acesso à base de dados
4. Base de dados actual – Indica qual a base de dados aberta
5. Botão explorar – Explora a estrutura da base de dados (a)
6. Botão Abrir – Abre a base de dados
7. Botão Sair – Sai do ecrã e retorna ao inicial
Pág. 13
(a) Explorar base de dados
Legenda:
1. Mostra tabelas e campos da base de dados
2. Botão Fechar – Sai do ecrã e retorna ao ecrã inicial
Pág. 14