Exibir código-fonte para 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.