TEDControl
Em 2014 a Senior criou a integração com os fornecedores parceiros de coletores de dados através de web services, desde então, o TEDControl não é mais comercializado, sendo substituído pelos softwares de comunicação de parceiros.
Por isso, as informações existentes nessa documentação é exclusiva para clientes que ainda usam este utilitário para integração de coletores/terminais e necessitam fazer a sua reinstalação. Caso precise de algum componente, entre em contato com o seu canal de Suporte.
Utilitário que possibilita a integração de coletores/terminais com a base de dados do sistema Gestão Empresarial | ERP, por meio de ações do Senior SID, e a construção de scripts para controlar e interagir (de forma on-line) com os equipamentos homologados.
As ações do Senior SID chamadas são características da área de manufatura do Gestão Empresarial | ERP. Entretanto, é possível efetuar esta chamada de outros módulos, sendo de responsabilidade do profissional contratado pelo ciente, o desenvolvimento da integração e validação da possibilidade de integração dos coletores nos demais módulos do sistema que disponibilizam ações do Senior SID.
Requisitos de infraestrutura
- Hardware: CPU 2.0GHz, 1GB RAM
- Sistemas operacionais homologados: Windows Server 2008, Windows Vista, Windows 7 e Windows 8
- Senior Gestão Empresarial | ERP: 5.7.3 ou superior. Homologação feita apenas até a 5.8.6
- Proprietárias: IOCT - Integrações - Integrações Complementadores - Integrador de coletores TEDControl e IPSI - Integrações - Integrações Proprietárias - Integração proprietária com SapiensSID
Compatibilidade
Marca/Representante | Tipo | Modelo/Família | Interface | Observação |
---|---|---|---|---|
Colleter | Fixo | TED 1000 / TED 2000 |
|
|
TED 1100 |
|
Em equipamentos que exigem Tibbo (desatualizado), a comunicação deve ser UDP e não TCP. | ||
TED 3000 (via RF) | RS-232 | |||
Móvel | PAT 1000 (via Wi-Fi) | TCP/IP | Não possui todas as funcionalidades implementadas. | |
ChiperLab | Móvel | 8071 (via Wi-Fi) | TCP/IP (Telnet) | |
Comm5 | Fixo | TF-1000 | TCP/IP (Telnet) | Homologado também com leitor de códigos de barras genérico: COM1, Porta 4001. |
Wilbor Tech | Fixo | Wilbor Term 16 | LPT1 | Modelo desatualizado. Mantido somente para compatibilidade. |
Genérico (Windows Mobile 6) | Fixo/Móvel | TCP (Telnet) | Requisito: um cliente Telnet instalado no Windows Mobile |
Nota
A homologação consiste numa série de testes de integração com os dispositivos eletrônicos (coletor/terminal) de forma individual e sem acessórios adicionais (leitor de código de barras, balança, impressora, entre outros). O uso destes acessórios em conjunto com o coletor/terminal precisa ser avaliado para cada situação.
Instalação
Faça a extração do conteúdo do arquivo TEDControl.zip para um diretório de sua preferência. Por exemplo, C:\senior\sapiens\tedcontrol.
Configuração
No sistema, acesse Cadastros > Identificadores e Parâmetros > Parâmetros Globais e no parâmetro TedCtrDir informe um caminho de rede (padrão UNC) acessível, e com permissão para gravar, por todas as instâncias do TEDControl distribuídas pelo ambiente. Para fins de simulação (sem integração com o ERP), esta configuração não é necessária.
Após a configuração e antes de iniciar a programação, avalie as particularidades existentes para alguns modelos de coletores/terminais:
Colleter
- Coletores que utilizam interface RS-232 devem ser conectados na COM1 da máquina. Para outras portas, é necessário entrar em contato com o suporte do fabricante para mais esclarecimentos;
- Coletores que exigem o driver Tibbo (para mapear portas virtuais) devem ser configurados para operar em modo UDP e não TCP. Os modelos mais recentes não exigem mais Tibbo;
- Os nativos (sem Tibbo) exigem uma configuração adicional. Nesta configuração, deve-se relacionar os IPs dos coletores disponíveis (separados um por linha);
- Para o caso de leitura de dados de balança, o TEDControl precisa estar gravado com firmware atualizado para a versão Horlle. Para configurar esta versão é necessário:
- Ligar o TED com a tecla 1 apertada
- Digitar o IP e a máscara. Por exemplo, 192.168.000.052 e 255.255.255.000
- Digitar a porta (00008) e pressionar Enter
Caso haja algum erro durante a digitação, basta desligar e ligar novamente o TEDControl com a tecla 1 apertada.
Comm5/TF1000
No coletor deve-se configurar (via interface web) o terminal como cliente e apontar a máquina que hospeda o TEDControl como servidor (porta 23) com as caixas de seleção echo ativada e a Mostrar mensagem de queda de conexão desativada. Para utilização de leitor de código de barras, é necessário conectá-lo na porta COM1 do coletor e associá-la a porta TCP 4001. Diferente dos demais equipamentos, a leitura do código de barras deve ser acionada pelo comando var.
Programação dos coletores/terminais
O TEDControl disponibiliza um conjunto de instruções que podem ser utilizadas para exibir e capturar dados dos coletores/terminais, ou seja, programar um coletor. Esta programação é mantida dentro do arquivo tedcontrol.ini que pode ser acessado dentro do próprio TEDControl, ao marcar a caixa de seleção Modo avançado (senha ted123). Este arquivo deve estar localizado na mesma pasta do arquivo TEDControle.exe, utilizado para comunicação com o sistema.
Estrutura
O arquivo é estruturado da seguinte maneira:
Seção de configuração (nome fixo [CONFIG]):
[CONFIG]
Parâmetro=valor
...
Sessão de configuração na regra do TedControl indicando parâmetros de comunicação com o Senior SID:
[CONFIG]
urlcon=http://servidor:9090/sapiensweb/conector
nomusu=senior
senusu=senior
tmpoci=10
Nota
Utilize a URL completa para acesso ao Servidor do Middleware.
Configuração incorreta:
[CONFIG]
urlcon=http://servidor:8585/sapiensweb/conector?SIS=CO&LOGIN=SID&ACAO=EXESENHA&NOMUSU=senior&SENUSU=senior
Parâmetro | Descrição | Complemento | Mandatório | Exemplo |
---|---|---|---|---|
urlcon | URL de conexão com o Senior SID | Informar endereço do aplicativo "conector" que um componentes do Senior SID. Se não for informado nesta chave, o TEDControl iniciará em modo simulado. | Sim para integração com ERP e Não quando for apenas simulação. | urlcon=http://servidor/sapiensweb/conector |
nomusu | Usuário da conexão SID | Credencial utilizada para validação inicial da integração com SID e para as ações subsequentes. No entanto, é possível alterar as credenciais nas demais ações, informando novo NomUsu e SenUsu nos parâmetros da ação. | Não, exceto se informar urlcon) | nomusu=coletor |
senusu | Senha da conexão SID | Verificar parâmetro NomUsu | senusu=coletor | |
urlbas | Nome da base | Identificador de base do servidor ERP (aplicável somente NAS versões inferiores a 5.7.1). | Não | urlbas=HOMOLOGACAO |
prxsrv | Nome/IP do servidor Proxy | Parâmetro necessário em ambientes que exigem autenticação Proxy. | prxsrv=webserver | |
prxprt | Porta do servidor Proxy | prxprt=8080 | ||
prxusu | Usuário do servidor Proxy | prxusu=coletor | ||
prxsen | Senha do servidor Proxy | prxsen=coletor | ||
constr | Parâmetros de conexão nativa à base de dados | Utilizar o botão Definir conexão com banco de dados, na tela de programação. para auxiliar em sua configuração. | ||
tedimp | Redirecionador de impressões | Redireciona a impressão de todos coletores para um coletor específico. Disponível apenas para coletores Colleter TED com suporte a impressora serial. | tedimp=2 | |
tmpoci | Tempo (ms) máximo de ociosidade | Configura o tempo máximo de ociosidade de um coletor. Ao expirar o tempo, o coletor é automaticamente desconectado. Este recurso deve ser utilizado em coletores TCP, UDP e Telnet, pois há momentos que o sistema operacional não notifica o TEDControl quando ocorre queda na conexão. | Sim para coletores que se comunicam via TCP, UDP ou Telnet. | tmpoci=60000 |
tmpaux | Tempo (ms) máximo de espera para leitura da porta serial auxiliar (por exemplo: leitor de código de barras) | Exclusiva para coletores Comm5 com entrada serial auxiliar. Não pode ser maior do que o tmpoci. Valor padrão = 15000. | Não | tmpoci=30000 |
telcls | Indicativo se deve limpar a tela antes de imprimir no display | Para utilizar o recurso informar valor = 1 | telcls=1 | |
telpor | Porta do serviço de Telnet | Porta padrão do Telnet = 23 | telpor=23456 | |
numcol | Quantidade de caracteres por linha para exibição no coletor | O parâmetro deve ser definido no padrão NUMCOL=XXX, em que XXX é a quantidade de caracteres por linha | Não | NUMCOL=80 |
Seção adicional, apenas para coletores Colleter TCP/IP nativo (nome fixo [TEDTCPIP]):
[TEDTCPIP]
IP_coletor_1
...
Seção para ponto de partida da programação (nome fixo [INICIO]):
[INICIO]
Instrução=valor
...
Demais seções de programação que permitem definir os passos de interação do coletor com o operador. Os nomes das seções podem ser criados livremente, desde que não utilizem caracteres especiais ou espaços.
[NOME]
Instrução=valor
...
Instruções
Cada instrução somente pode ser usada uma vez por seção. Ao não usar uma, ela será executada incorretamente. Por exemplo: [SECAO1] zer=VC_OPCAO zer=VC_SENHA.
Script de programação:
; TEDCONTROL.INI – Script exemplo
;--------------------------------------------
; OBS: Todo roteiro de programação deve possuir uma seção denominada "INICIO" (que é o ponto inicial de execução). Utilize “;” para comentários.
[INICIO] msg=Menu (1=Validar 2=Executar):
var=VC_OPCAO bip=1 prx=1=VALIDAR,2=EXECUTAR
[VALIDAR] msg=Digite senha:
var=VC_SENHA* bip=1 prx=VALIDARSENHA
[VALIDARSENHA] msg=Validando senha...
sid=ACAO=SID.SRV.REGRA,NUMREG=1
; Neste exemplo, a ação SID fará a validação da senha ; e determinará o nome da próxima seção a ser executada
[SENHACORRETA] msg=Senha OK tmp=1 prx=EXECUTAR
[SENHAINCORRETA] msg=Senha incorreta!
tmp=2 bip=4 prx=INICIO
[EXECUTAR] msg=Digite valor:
var=VC_VALOR bip=1 prx=ENVIARDADOS
[ENVIARDADOS] msg=Enviando dados ao Sapiens... sid=ACAO=SID.SRV.REGRA,NUMREG=2 prx=FIM [FIM] msg=Procedimento OK!
tmp=1 bip=2 prx=INICIO
Parâmetros da linha de comando do aplicativo
Parâmetro | Coletor alvo | Descrição |
---|---|---|
-log | Todos | Gera um arquivo (tedcontrol.log) contendo o histórico das instruções executadas e seus tempos. |
-auto | Ativa o início imediato dos coletores. | |
-hub8 | Colleter TED (Hub8) | Pré-seleciona o coletor. |
-hub16 | Colleter TED (Hub16) | |
-tibbo | Colleter TED (TCP/UDP com Tibbo) | |
-tcpip | Colleter TED (TCP nativo) | |
-rf | Collerter TED (RF) | |
-pat | Colleted PAT (Wi-Fi) | |
-wilbor | Wilbor Term 16 | |
-telnet | Telnet | |
-wilbor_endporta <n> | Wilbor Term 16 | Endereço da porta paralela na qual o coletor está ligado – Valor padrão = $0378. |
-wilbor_timeout <n> | Informações de acordo com fabricante: a comutadora tem um processador interno que é mais lento que o processador do computador que a controla, por isso é necessário informar um valor de timeout para que o computador espere um tempo entre o envio de dois comandos. Quanto mais rápido o computador, maior deve ser esse valor. Se for especificado um valor muito baixo, pode haver perda de comandos enviados. Entretanto, se for especificado um valor muito alto, a performance do sistema pode ficar comprometida. Portanto para cada computador deve ser especificado um valor adequado para o timeout. Valor padrão = 100. |