SAI Analytics - Entrada de dados externos por API

INTRODUÇÃO

As entradas de dados para a plataforma SAI Analytics podem ser realizadas através da chamada de uma URL com as informações que se deseja registrar.

A análise dos dados são realizadas pela plataforma e disponibilizadas para a consulta do cliente acessando sua conta de acesso.

Os dados podem ser transmitidos por diversos dispositivos autónomos ou informações de operadores para a alimentação de dados da unidade para análise.

ATIVIDADES

Registra informações relativas à atividade do equipamento na plataforma do SAI Analytics, é necessário o cadastro da unidade na plataforma para obtenção da [key] para a entrada dos dados.

URL (exemplo) https://sai.cybercontrol.com.br/api/logs/novo_log?idunidade=9C6144E1&status=1&data=2020-11-28%2000:00:00&ciclos=0&msg_sys=TESTE%20DE%20TRANSMISS%C3%83O Parâmetros

[key] - Número serial do equipamento registrado na plataforma.
[&data] -Data e hora da atividade (yyyy-mm-dd hh:mm:ss) 
[&horimetro] - Horimetro acumulado do equipamento.
[&ciclos] - Número de ciclos acumulados do equipamento.
[&ciclos_manual] - Número de ciclos realizados em modo manual.
[&versao] - Versão do sistema de automação do equipamento.
[&ipnumber] - Número do IP do equipamento na rede (internet).
[&status] - Código do status da atividade (Consulte tabela de status).
[&msg_sys] - Mensagem da atividade.
[&tempo] - Tempo de atividade do sistema em segundos.
[&temp_proc] - Temperatura no equipamento em graus Celsius.
[&acproducao] - Valor acumulado de produção do equipamento.
[&tmciclo] - Tempo de produção do ciclos em segundos. 

Status (Status Atividade)

Códigos de Status de atividades disponíveis para o registro das transmissões do equipamento.

Código Título Descrição 0 Off Line O equipamento foi desconectado normalmente pelo SAI. 1 On Line Equipamento conectado normalmente pelo SAI. 2 Emergência Utilizado procedimento de parada de emergência no equipamento. 11 Produção Equipamento em produção. 12 Licença Validação de Licença do SAI 13 Ação Painel Chave painel automático. 14 Qualidade Controle de qualidade de produção. 21 Interrupção Interrupção de processos de produção. 51 Erro Sistema Erros gerados internamente no sistema. 52 Operador Processo de produção interrompido. 53 Ação Painel Acionamento manual do painel de controle do equipamento. 54 Operador Registro de produção em modo manual. 55 Auto Off Inatividade de transmissões por mais de uma hora. 56 Operador Alerta sonoro na unidade (sirene). 57 Configuração Ajustes de configuração do equipamento ou sistema. 58 Rede Problemas de rede ou conexão com PLC. 59 Suporte Revalidação de licenças de operação

Atenção, registros enviados com o valor de ciclos igual a zero são automaticamente excluídos pelo banco de dados após algum tempo.

Campos obrigatório

Para melhor análise de dados das atividades na unidade e equipamentos os campos abaixo devem ser informados no momento da transmissão

Ponto Entrada

Status Código Descrição da atividade Start point 1 Atividades de início de operações ou transmissões periódicas de monitoramento Process point 1...(consultar tabelas de códigos) Atividades normais no processo de produção. Set point 17 Atividade de término de operações para a coleta de dados. Emergency 2 Atividade de acionamento de emergências. Alert Point 5…(consultar tabelas de códigos) Atividades de alerta de processos. End point 0 Logout / off

PRODUÇÃO

SAI está preparado para o envio de registros de produções da unidade para a plataforma SAI Analytics de forma manual pelo operador, onde as mesmas serão disponibilizadas para a consulta.

No caso de software de terceiros ou outros dispositivos de controle, os dados podem ser enviados através da API seguindo as orientações para o reconhecimento pela plataforma.

URL (exemplo) https://sai.cybercontrol.com.br/api/logs/novo_log_producao?idunidade=123456&data_reg=2021-12-09 08:05:20&quant_prod=8

Parâmetros [idunidade] número de identificação da unidade na plataforma. [chave] chave de acesso, exemplo de formação da chave (ID[idunidade]+OP[ordem_prod]+DD[dia]+MM[mês]+AAAA[ano]+HH[hora]+MM[minuto]+SS[segundo]). [data_reg] data e hora do envio da informação. [data_prod] data e hora da produção. [ordem_prod] número da ordem de produção.S [quant_prod] Quantidade de produção solicitada do traço. [nomeproduto] Nome do traço ou estrutura em produção. [tempo_prod] Total do tempo de produção em segundos. [tipo_prod] Código do tipo de produção conforme a tabela:

Código Descrição 1 Completado com sucesso por automação 2 Interrompido (Emergência) 3 Abortado pelo usuário 4 Abortado pelo sistema (Peso máximo excedido) 5 Interrompido (Falha de comunicação) 6 Abortado pelo Sistema (Alocação de material) 7 Interferência do operador na dosagem 8 Registrado manualmente no sistema. 9 Produção cancelada

[nome_material] Nome do material. [umidade] Teor de umidade do material. [tolerancia] Valor de tolerância na dosagem do material. [solicitado] Quantidade solicitada na dosagem do material. [dosado] Quantidade efetivamente dosado do material. [desvio] Quantidade de desvio na dosagem. [ponto_carga] Ponto de carga do traço ou estrutura. [ciclos] Número do ciclo dosado. [nro_local] Código do número de local do material. [tipo_local] Código do tipo de local do material.

Observações Em caso de envio dos dados pela API não será necessário o envio manual das informações pelo SAI, pois poderá causar o registro em duplicidade das informações.