Manual X-Bridge

X-Bridge®
Concentração de dados e gestão de comunicações
Índice
Introdução ................................................................................................................ 2
Como utilizar o X-Bridge® ......................................................................................... 4
Palavra-chave para funções de acesso restrito .......................................................... 7
Definições de Configuração ....................................................................................... 8
Configuração do X-FileServer .................................................................................. 23
Servidor de FTP....................................................................................................... 25
Update .................................................................................................................... 26
Pág. 1
9 Introdução
O X-Bridge® é uma aplicação que tem como finalidade a recepção e transmissão de dados de
e para os terminais portáteis, integrando estes dados com quaisquer aplicações de Gestão da
Empresa;
- Gestão de comunicações de uma rede de terminais portáteis;
- Gestão da diversidade de ambientes operativos dos terminais;
- Possibilidade de instalação em qualquer PC da Empresa;
- Definições de operação e comunicação configuráveis;
- Capacidade de integração com qualquer tipo de Aplicações de Gestão;
- Os terminais portáteis podem receber no início do Ciclo Operacional todos os dados
necessários para a execução das operações diárias e, no fim do Ciclo, descarregar a
informação de todas as operações realizadas, ficando estas disponíveis para integração;
- Apesar de pressupor a intervenção do operador, é possível configurar a automatização
do X-Bridge®:
+ Definição de horas de início/fim de comunicação;
+ Controlo das comunicações e histórico do resultado das ligações;
+ Alertas de possíveis erros de transmissão;
+ Verificação das comunicações e certificação do bom funcionamento das
aplicações móveis, tornando possível a sua reactivação em caso de falha;
+ Detecção do tipo de ligação disponível para o terminal – cabo, Bluetooth®,
WLAN, etc;
+ Execução de Cópias de Segurança automáticas de todos os ficheiros de
entrada e saída.
Pág. 2
Pág. 3
9 Como utilizar o X-Bridge®
A partir do ecrã principal do X-Bridge®, o operador tem uma visão privilegiada do estado das
comunicações de e para os terminais móveis, assim como da integração com as Aplicações de
Gestão.
A disposição dos elementos no ecrã é intuitiva para facilitar a visualização.
O X-Bridge® está continuamente a monitorizar a presença de terminais ligados através do
Microsoft® ActiveSync™, procedendo imediatamente à sincronização da informação. Esta
sincronização funciona nos dois sentidos:
- Obtém dados disponibilizados pelas Aplicações de Gestão e necessários às operações de
mobilidade e envia-os para o terminal;
- Recebe os dados das operações de mobilidade presentes no terminal e disponibiliza-as às
Aplicações de Gestão.
O X-Bridge® permite também que a recepção e transmissão de dados se faça sem ligação
física de equipamentos, através da Internet, processo este controlado pelo módulo de Servidor
de Ficheiros (X-FileServer), como descrito posteriormente.
Pág. 4
Legenda:
1. Botão Password - Permite ter acesso à password de administração; esta password é
necessária para ter acesso a algumas funcionalidades do X-Mobile®
2. Botão Opções – Permite visualizar e/ou alterar as opções da aplicação
3. Botão File Server – Permite ter acesso ao módulo X-FileServer para gestão de
comunicações remotas
4. Botão Update - Verifica se existem updates da aplicação
5. Botão Sair - Sai da aplicação
6. Indica se existe algum dispositivo móvel ligado à aplicação
7. Lista dos ficheiros recebidos do dispositivo móvel
8. Botão para integrar todas as comunicações e disponibilizar os dados à aplicação de
Back-office
9. Lista dos ficheiros integrados
Pág. 5
10. Lista dos ficheiros a receber do dispositivo ou dos ficheiros enviados para o dispositivo
11. Botão enviar ficheiros para PDA
12. Lista dos ficheiros a enviar para o dispositivo
13. Botão para obter dados do SQL (este botão estará visível apenas se a opção “Integrar
com SQL” estiver activada)
Pág. 6
9 Palavra-chave para funções de acesso restrito
Devido às restrições impostas a certas funções do X-Mobile® para prevenção contra a
inconsistência dos dados e violação de regras de negócio, O X-Bridge® fornece ao operador
uma palavra-chave diária que pode ser transmitida ao utilizador do terminal para acesso a
estas funções.
Legenda:
1. Calendário onde selecciona o dia, mês e ano
2. Palavra-chave do dia
3. Botão Sair - Fecha o ecrã da palavra-chave e retorna ao ecrã inicial
4. Botão Ok - Confirma a palavra-chave
Pág. 7
9 Definições de Configuração
As possibilidades de configuração avançada das definições de configuração do X-Bridge® são
uma mais-valia ao conferir uma grande versatilidade. Definindo as opções correctas, é possível
fazer uma gestão eficaz e versátil de um grande número de terminais móveis, mesmo
considerando
a
diversidade
de
ambientes
operativos
que
podem
existir.
Entre estas definições, podemos destacar os modos de comunicação, parâmetros e ficheiros de
Importação e Exportação e o registo de Utilizadores autorizados.
Se, ao arrancar a aplicação, não for encontrado o ficheiro de configuração (X-Bridge.ini), é
mostrado o ecrã de opções para a criação de um novo ficheiro.
As opções de configuração estão acessíveis através do botão “Opções” no ecrã principal do XBridge®.
Pág. 8
Legenda:
1. Opção Comunicação - Selecciona se pretende efectuar a comunicação de forma manual
ou automática entre o X-Bridge® e os dispositivos
2. Opção Tempo - Define o tempo de espera (segundos) entre cada comunicação
3. Opção Integração - Selecciona se pretende efectuar a comunicação de forma manual ou
automática entre o X-Bridge® e o ERP
4. Opção Tempo - Define o tempo de espera (segundos) entre cada integração
5. Opção Integrar com SQL - Indica se a integração com a aplicação de back-office se faz
através de tabelas de integração numa base de dados SQL Server. A activação desta
opção permite ter acesso ao botão “Integ. SQL” para a configuração desta integração
6. Opção Idioma - Selecciona, de entre as escolhas possíveis, o idioma de funcionamento
do X-Bridge®. Algumas das escolhas possíveis podem não ser suportadas de raiz.
7. Opção Iniciar com o file server - Indica se o X-Bridge® activa o módulo X-FileServer ao
iniciar
8. Opção Sep. de campo - Define o caracter que deve ser interpretado como separador de
campos nos ficheiros de dados
9. Directório X-Mobile(PDA) - Directório do PDA onde, em princípio, estarão os ficheiros da
aplicação X-Mobile®
10. Directório Predefinido (Importação)- Directório local onde devem ser colocados, por
defeito, os ficheiros recebidos dos dispositivos
11. Botão Procurar - Abre uma janela para procurar a pasta onde se encontram os ficheiros
de importação
12. Lista do(s) ficheiro(s) de importação e a sua descrição
13. Botão Novo - Acrescenta novo(s) ficheiro(s) (a)
14. Botão Detalhes - Edita os dados do ficheiro
15. Botão Eliminar - Elimina o(s) ficheiro(s) da lista
Pág. 9
16. Directório Predefinido (Exportação) - Directório local onde devem ser colocados, por
defeito, os ficheiros a serem enviados para os dispositivos
17. Botão Procurar - Abre uma janela para procurar a pasta onde se encontram os ficheiros
de exportação
18. Lista do(s) ficheiro(s) de exportação e a sua descrição
19. Botão Novo - Acrescenta novo(s) ficheiro(s) (b)
20. Botão Detalhes - Edita os dados do ficheiro
21. Botão Eliminar - Elimina o(s) ficheiro(s) da lista
22. Botão Comentários - Podem ser criados/editados comentários a incluir no ficheiro de
configuração (c)
23. Botão Utilizadores - Devem ser registados todos os utilizadores com licença válida para
o X-Mobile®
24. Para aceder à lista de utilizadores registados, premir “Utilizadores…” (d)
25. Botão Integ. SQL - Serve para configuração da integração com o SQL (e)
26. Botão Gravar - Grava as definições de configuração, premir o botão “Gravar”. Se já
existir um ficheiro de configuração actualmente, será proposta a criação de uma cópia
de segurança da configuração actual por questões de segurança. Se a resposta for
afirmativa, será criado o ficheiro “X-Bridge.ini.bak” que pode ser reposto em caso de
necessidade
27. Botão Fechar - Sai do menu opções
Pág. 10
(a)
Devem ser registados os ficheiros a transferir dos PDA’s para o X-Bridge®. Podem ser
acrescentados novos ficheiros, editados os existentes, ou eliminados da lista.
Legenda:
1. Opção Ficheiro PDA - Insere/apresenta o nome do ficheiro do PDA
2. Opção Ficheiro Local - insere/altera o nome local do ficheiro depois de transferido
3. Opção Descrição - Insere/altera a descrição do ficheiro
4. Opção Tipo de Dados - Selecciona o tipo de dados (dados, impressão, mensagem)
5. Opção Periodicidade Com. - Indica a periodicidade da comunicação (fim de dia, sempre)
6. Opção Apagar Ficheiro – indica se o ficheiro é eliminado do PDA depois da transferência
7. Local onde se insere os números dos utilizadores aos quais se aplica este ficheiro (para
inserir utilizadores contíguos, introduzir os extremos separados por “-“, p. ex., 01-03
adiciona os utilizadores 01, 02 e 03)
8. Opção Adicionar - Adiciona o(s) utilizador(es) acima introduzido(s) à lista
9. Opção Elimina - Elimina o utilizador seleccionado da lista
10. Lista dos utilizadores aos quais se aplica o ficheiro
Pág. 11
11. Botão Ok - Confirma as alterações efectuadas
12. Botão Cancelar - Cancela as alterações efectuadas
(b)
Devem ser registados os ficheiros a transferir do X-Bridge® para os PDA’s. Podem ser
acrescentados novos ficheiros, editados os existentes, ou eliminados da lista.
Legenda:
1. Opção Ficheiro Local - Insere/apresenta o nome local do ficheiro antes da transferência
(deve ser colocado “|” antes da extensão do ficheiro, p. ex., “ARTIGOS|.DAT”)
2. Opção Ficheiro PDA – Insere/altera o nome que o ficheiro tomará ao ser transferido
para o PDA
3. Opção Âmbito - Selecciona se pretende que o âmbito do ficheiro seja individual ou
geral; se o âmbito for individual, será acrescentado o utilizador ao nome do ficheiro
4. Local onde se insere os números dos utilizadores aos quais se aplica este ficheiro (para
inserir utilizadores contíguos, introduzir os extremos separados por “-“, p. ex., 01-03
adiciona os utilizadores 01, 02 e 03)
Pág. 12
5. Botão Adicionar - Adiciona o(s) utilizador(es) acima introduzido(s) à lista
6. Botão Eliminar - Elimina o utilizador seleccionado da lista
7. Lista dos utilizadores aos quais se aplica o ficheiro
8. Botão Ok - Confirma as alterações
9. Botão Cancelar - Cancela as alterações efectuadas
(c)
Podem ser criados/editados comentários a incluir no ficheiro de configuração. Estes
comentários são inseridos no início do ficheiro, antes das restantes definições.
Legenda:
1. Insere e visualiza os comentários inseridos no ficheiro de configuração
2. Botão Ok - Confirma as alterações efectuadas
3. Botão Cancelar - Cancela as alterações efectuadas
Pág. 13
(d)
Devem
ser
registados
todos
os
utilizadores
com
licença
válida
para
o
X-Mobile®.
Para aceder à lista de utilizadores registados, premir “Utilizadores…”
Legenda:
1. Lista dos utilizadores existentes, forma de comunicação, directório X-Mobile PDA,
directório importação e directório exportação
2. Botão Adicionar – Permite adicionar novo utilizador
3. Botão Detalhes - Visualiza/altera os dados do utilizador seleccionado
4. Botão Eliminar - Elimina utilizador
5. Botão Ok - Confirma as alterações
6. Botão Cancelar - Cancela as alterações
Pág. 14
Legenda:
1. Opção ID Utilizador - Insere/altera o número de identificação do utilizador
2. Opção até - Para inserção de múltiplos utilizadores com características semelhantes
(indicar o último utilizador a acrescentar)
3. Opção Forma de Comunicação - Selecciona a forma de comunicação pretendida
4. Opção ID PDA - Insere/altera o número de identificação do PDA
5. Opção Dir. X-Mobile PDA - Insere/altera o directório do ficheiro no PDA
6. Opção Dir. Importação - Insere/altera o directório dos ficheiros de importação
7. Opção Dir. Exportação - Insere/altera o directório dos ficheiros de exportação
Pág. 15
(e)
A integração entre o X-Mobile® e as aplicações de Back-office pode fazer-se através de
ficheiros ou, como alternativa, obtendo e inserindo dados em tabelas de integração num base
de dados SQL Server.
Para
que
esta
integração
se
realize,
a
respectiva
opção
deve
estar
activada.
Este tipo de integração funciona através de tabelas de integração numa base de dados SQL
Server. Os dados recebidos dos PDA’s são inseridos em tabelas de recepção de dados (prefixo
“XMI_”). Os dados a enviar para os PDA’s são obtidos das tabelas de envio (prefixo “XMO_”) ,
previamente preenchidas pelo Back-office com os dados a enviar a cada utilizador.
A configuração desta integração é feita em ficheiros de texto.
Legenda:
1. Opção Ligação ao SQL – Define as opções de ligação à base de dados SQL Server (1)
2. Opção Dados PDA -> SQL (XMI) - Os dados recebidos dos PDA’s destinados ao Backoffice são colocados nas tabelas de integração (“XMI_”) (2)
3. Opção Dados SQL -> (XMO) - A informação da base de dados SQL a ser enviada para
os PDA’s (3)
4. Opção Fechar - Sai do ecrã e volta ao anterior
(1)
Pág. 16
Para efectuar a ligação à base de dados SQL. O X-Bridge® precisa de saber os dados de
acesso. Entre eles está o nome do servidor SQL e a base de dados onde estão as tabelas de
integração.
Esta informação deve ser introduzida seleccionando a opção “Ligação SQL”.
Legenda:
1. Opção Servidor SQL - Insere/altera o nome do servidor SQL e da base de dados
2. Opção Utilizar Segurança Integrada do Windows - Pode estar activada ou desactivada.
Se activada, o início de sessão no servidor SQL é feito com as credenciais do Windows.
Se desactivada, é necessário fornecer o login e password registado no SQL Server e o
início de sessão é feito usando estas credenciais do SQL
3. Opção Utilizador SQL - Insere o nome do utilizador da base de dados SQL
4. Opção Password SQL - Insere a palavra-chave de acesso à base de dados SQL
5. Opção Base de dados SQL - Nome da base de dados
6. Opção Testar Ligação - Verifica a ligação à base de dados
7. Botão Gravar - Guarda as alterações efectuadas
8. Botão Fechar - Sai do ecrã e retorna ao anterior
Pág. 17
(2)
Os dados recebidos dos PDA’s destinados ao Back-office são colocados nas tabelas de
integração (“XMI_”). Estas tabelas têm a mesma estrutura e ordem de campos dos ficheiros
recebidos dos PDA’s. Além disso, há uma outra coluna chave com um identificador de linha
(“RowID”).
A estrutura destas tabelas só deve ser alterada se houverem alterações na estrutura dos
ficheiros dos PDA’s.
Para que o X-Bridge® possa inserir os dados na base de dados SQL, tem que existir um
ficheiro de configuração na pasta da aplicação (ConfigIN.DAT) que define a estrutura de cada
ficheiro e a forma como os seus dados são inseridos na base de dados. Cada ficheiro de dados
tem que ter uma série de entradas neste ficheiro de configuração, com a estrutura que se
descreve de seguida.
Legenda:
1. Opção Ficheiros - Nome do ficheiro de dados a inserir na base de dados
2. Opção Ficheiros - Tabela onde serão inseridos os dados do ficheiro
Pág. 18
3. Opção Ficheiros – Delimitador – Separador dos campos do ficheiro de dados
4. Botão Adicionar - Adiciona um ficheiro novo à lista de acordo com os dados introduzidos
5. Botão Eliminar - Elimina um ficheiro da lista
6. Lista dos ficheiros de dados
7. Opção Campos do ficheiro - Nome do ficheiro de dados seleccionado na lista acima
8. Opção Campos do ficheiro - Descrição do campo
9. Opção Campos do ficheiro - Comprimento do campo
10. Opção Campos do ficheiro - Tipo de ficheiro (A – Alfanumérico; N – Numérico; D –
Data; L – Lógico)
11. Opção Campos do ficheiro - Campo Tab. (nome do campo na tabela onde será inserido
o valor correspondente do ficheiro de dados)
12. Opção Campos do ficheiro - Formato do campo
13. Opção Campos do ficheiro - Observações
14. Opção Campos do ficheiro - Multip. - define um valor pelo qual vai ser multiplicado o
valor do campo do ficheiro para ser escrito na base de dados. Isto aplica-se, p. ex., em
campos de preço para eliminar as casas decimais. Para dividir, utilizar a dízima
correspondente.
15. Botão Adicionar - Adiciona um novo campo à lista de acordo com os dados introduzidos
acima
16. Botão Eliminar - Elimina um campo da lista
17. Lista dos campos do ficheiro de dados
18. Botão Gravar - Guarda as alterações efectuadas
19. Botão Fechar - Sai do ecrã e retorna ao anterior
Pág. 19
(3)
A obtenção da informação da base de dados SQL para ser enviada para os PDA’s é feita a
pedido do utilizador premindo “Obter Dados SQL” ou de forma automática mediante a
periodicidade da integração.
A tabelas “XMO_” têm uma coluna “X_UserID” que deve ser preenchida com o utilizador do XMobile® a quem se destina a informação. No caso dos ficheiros de âmbito individual (Ver
instruções para as opções, secção Exportação, Ficheiros) esta coluna é imprescindível, uma
vez que a informação a colocar nos ficheiros a enviar para os PDA’s será filtrada por esta
coluna.
Sempre que houver a necessidade de acrescentar colunas em qualquer uma das tabelas, estas
devem ser inseridas tendo em conta que os campos do ficheiro terão a mesma ordem que as
colunas da tabela.
Para que o X-Bridge® possa obter os dados da base de dados SQL, tem que existir um ficheiro
de configuração na pasta da aplicação (ConfigOUT.DAT) que define a estrutura de cada ficheiro
e a forma como os seus dados são obtidos da base de dados. Cada ficheiro de dados tem que
ter uma série de entradas neste ficheiro de configuração, com a estrutura que se descreve de
seguida.
Pág. 20
Legenda:
1. Opção Ficheiros - Nome do ficheiro de dados a ser gerado
2. Opção Ficheiros - Tabela onde serão obtidos os dados a escrever no ficheiro
3. Opção Ficheiros – Delimitador – Separador dos campos do ficheiro de dados
4. Botão Adicionar - Adiciona um ficheiro novo à lista de acordo com os dados introduzidos
5. Botão Eliminar - Elimina um ficheiro da lista
6. Lista dos ficheiros de dados
7. Opção Campos do ficheiro - do ficheiro de dados seleccionado na lista acima
8. Opção Campos do ficheiro - Descrição do campo
9. Opção Campos do ficheiro - Comprimento do campo
10. Opção Campos do ficheiro - Tipo de ficheiro (A – Alfanumérico; N – Numérico; D –
Data; L – Lógico)
11. Opção Campos do ficheiro - Campo Tab. (nome do campo na tabela onde será obtido o
valor a escrever no ficheiro)
12. Opção Campos do ficheiro - Formato do campo, apenas é considerado para campos de
data e deverá ser definida como “yyyyMMdd”, que é o formato esperado pelo PDA (p.
ex., 20070131)
13. Opção Campos do ficheiro - Observações
14. Opção Campos do ficheiro - Multip. - define um valor pelo qual vai ser multiplicado o
valor do campo da base de dados para ser escrito no ficheiro. Isto aplica-se, p. ex., em
campos de preço em que o valor deve ser multiplicado por 100 para eliminar as casas
decimais. Para dividir, utilizar a dízima correspondente.
15. Botão Adicionar - Adiciona um novo campo à lista de acordo com os dados introduzidos
acima
Pág. 21
16. Botão Eliminar - Elimina um campo da lista
17. Lista dos campos do ficheiro de dados
18. Botão Gravar - Guarda as alterações efectuadas
19. Botão Fechar - Sai do ecrã e retorna ao anterior
Esta configuração predefinida pode ser alterada para permitir a obtenção de informação a
partir de outras tabelas que não as “XMO_”.
Em alternativa, esta configuração pode ser efectuada directamente no ficheiro de configuração
da integração (ConfigOUT.DAT).
Pág. 22
9 Configuração do X-FileServer
O X-FileServer é um Add-on ao X-Bridge® que gere a transferência de ficheiros de e para
locais de FTP (File Transfer Protocol). O X-FileServer deve ser utilizado em cenários onde a
comunicação entre X-Mobile® (PDA’s) e o X-Bridge® se faz remotamente (por exemplo,
GPRS). Neste cenário os PDA’s recolhem e depositam informação de e para um site FTP criado
para
o
efeito.
A pasta de chegada de informação do PDA é monitorizada ciclicamente, sendo que, quando o
X-FileServer detecta informação depositada por um PDA, transfere-a para a pasta de chegada
do X-Bridge®, podendo, a partir daí, ser integrada.
Por outro lado, o X-FileServer coloca numa pasta FTP, a horas programadas, informação a ser
enviada para o PDA.
O X-FileServer só pode desempenhar a sua função se a opção “Arrancar com o File Server”, na
configuração do X-Bridge®, estiver activada.
Legenda:
1. Botão Minimizar - Minimiza o ecrã do X-FileServer
2. Botão Sincronizar - Sincroniza o X-Mobile® (PDA’s) e o X-Bridge®
3. Botão Opções - Visualiza as opções do X-FileServer
Pág. 23
Legenda:
1. Opção Dir. Local IN - Pasta onde são colocados os ficheiros recebidos do PDA
2. Botão Procura - Procura qual a pasta onde pretende colocar os ficheiros de download
3. Lista dos horários de UPLOAD
4. Botão Inserir - Insere um novo horário de UPLOAD na lista
5. Botão Eliminar - Elimina um horário de UPLOAD da lista
Pág. 24
6. Opção Dir.Orig. - pasta de onde o X-FileServer vai obter a informação a enviar ao PDA
7. Botão Procura - Procura qual o directório de origem
8. Opção Dir. Local Dest. - pasta onde o X-FileServer vai colocar a informação a enviar
para o PDA
9. Botão Procura - Procura qual o directório de destino
10. Opção URL - Insere/altera o endereço IP do servidor FTP
11. Opção User - Insere/altera o nome do utilizador
12. Opção Password - Insere/altera a palavra-chave do utilizador
13. Opção Dir. - Subdirectório FTP base onde será colocada ou obtida a informação
14. Opção Timer - Periodicidade (em minutos) da verificação de existência de ficheiros
(para download).
15. Opção Tipo - Tipo de ligação ao FTP (AFTP – Activo; FTP – Passivo)
16. Botão Salvar - Guarda as alterações efectuadas
Servidor de FTP
O funcionamento do X-FileServer depende da existência de um local de FTP operacional. Este
local de FTP deve possuir uma estrutura de directórios específica. Deverá existir um directório
a partir do qual é criada esta estrutura (tipicamente será o nome ou abreviatura da empresa)
e que deve incluir alguns subdirectórios obrigatórios.
•
Servidor FTP
o
Infos (directório base)
ƒ
LOGS (directório de registos)
ƒ
in (directório de recepção de dados dos PDA)
•
ƒ
temp (directório para a recepção temporária de ficheiros dos PDA)
out (directório de envio de dados para os PDA)
Pág. 25
9 Update
Esta opção procura por novas actualizações do X-Bridge® e/ou do X-Mobile®.
Pág. 26