Trabalhos/Ordens de Produção
Seu guia para a integração V5!
A integração de trabalhos/ordens de produção entre o V5 Traceability e o sistema ERP de um cliente permite que ordens de serviço para fórmulas de lotes e produtos sejam agendadas dentro do V5 Traceability. Esses detalhes permitirão que esses trabalhos sejam processados pelo Terminal V5.
Conteúdo
1. Layout do Centro de Controle
Em termos de como podemos relacionar os detalhes do trabalho com o que vemos no Control Center, usaremos a API V5 principalmente para preencher o painel superior 'Job' para importar e exportar esses detalhes, com informações no painel inferior 'Job Line' sendo preenchido automaticamente com base na configuração de fórmula/receita.
Usando o Gateway V5, podemos preencher facilmente os dados aqui usando o ‘Job’ ponto final. No entanto, pode ser adoptada uma abordagem mais avançada que faça uso do ‘PreBatch’ ponto final. Veremos como usar ambos a seguir.
2. Links API
3. Modelo de Integração
O modelo de integração para trabalhos/ordens de produção pode ser baixado aqui.
4. Guia de campo da ordem de trabalho/produção
4.1. Chaves primárias
Chaves primárias são o identificador exclusivo para cada tabela na API V5. Para Job, estes são:
jobNumber - O código de identificação exclusivo do trabalho.
formula.commodity.code – O código de identificação exclusivo da fórmula a ser agendada.
Para a PreBatch, as chaves primárias são:
jobLine.job.jobNumber - Como acima, o código de identificação exclusivo do trabalho.
BatchSeq – A sequência de produção do lote para essa linha de trabalho específica.
4.2. Os campos obrigatórios
Outros campos são exigidos pelo SG para preencher uma linha de trabalho válida no Control Center. Para Job, isso é:
products - O número de produtos necessários (relacionado à UM base da fórmula) por lote pela linha superior (trabalho) deste trabalho.
Para a PreBatch, isso é:
products - O número de produtos que o lote individual deve produzir.
4.3. Campos preferidos
Os campos preferenciais servem para adicionar mais informações sobre o trabalho em questão e, embora não sejam obrigatórios, são úteis quando se trata de funcionalidade adicional na Rastreabilidade V5. Para Job, estes podem incluir:
batchesRequired - O número de lotes necessários para o trabalho. Se não estiver presente, o sistema utilizará a quantidade de produtos (descrita acima) e o tamanho base + produtos mínimo/máximo para calcular o número de lotes a serem produzidos.
status - O status com o qual o trabalho será importado (0 = Pendente, 1 = Agendado, 2 = Em andamento, 3 = Concluído, 4 = Em teste, 5 = Em espera), os trabalhos normalmente seriam importados com o status '1', a menos que devam ser agendados manualmente em uma data posterior e, portanto, possam ser importados com o status '0'.
Esses campos também poderiam ser aplicados a PreBatch depois de passarmos para o objeto de trabalho na API.
4.4. Campos Adicionais
Campos adicionais também podem ser incluídos para o Job ponto final, como:
productionDate - A data em que o trabalho será produzido. Será importado em branco caso não esteja presente, permitindo que os trabalhos sejam visualizados pelos Terminais a qualquer momento.
Para a PreBatch, podemos atravessar para este mesmo campo sob jobLine.job.productionDate. No entanto, também podemos usar o jobLine.productionDate campo para afetar a data de produção da linha de trabalho individual, em vez de todo o trabalho em si, permitindo-nos um controle mais rígido sobre nosso processo de produção.
5. Metodologia
Dependendo do método utilizado para nossa integração, podemos usar os seguintes endpoints para facilitar as importações. Isso pode ser:
- ‘Job’ or ‘Prebatch’ endpoints para integração JSON.
- ‘Job’ endpoint para integração de compartilhamento de arquivos CSV.
As exportações podem ser tratadas de várias maneiras, todas as quais veremos a seguir.
5.1. JSON – Importar
Job:
Podemos fazer uso do ‘Job’ endpoint para criar novos trabalhos para produção na rastreabilidade V5.
‘Job’ importar Endpoint/URI –
http://host:port/V5-API/api/integrate/import/job
Para esta importação de amostra usando o ‘Job’ endpoint, podemos estruturar um arquivo de importação básico para um único trabalho conforme abaixo:
Este arquivo JSON de amostra pode ser baixado aqui.
Usando o manual da API, podemos ver aqui que estamos usando vários pontos de dados dentro do ‘Job’ class para estruturar este arquivo. No entanto, para recuperar corretamente o código da fórmula que queremos produzir, precisamos primeiro passar para o ‘Formula’ classe e, em seguida, use o ‘Commodity’ classe para definir o ‘Code’ ponto de dados que podemos usar e, em seguida, aninhe-o no arquivo JSON apropriadamente, como podemos ver acima.
Podemos ver um resumo desse processo de fluxo de dados abaixo:
Se executarmos o arquivo JSON acima, veremos que nosso trabalho agora está visível na aba ‘Produção’ do Control Center.
Você notará que isso criou automaticamente as linhas de trabalho no painel inferior. O ‘Job’ endpoint fará isso automaticamente com base no estrutura da fórmula.
Pré-lote:
Podemos ver acima que podemos usar o ‘Job’ endpoint para inserir tarefas simples no plano de produção na Rastreabilidade V5. No entanto, se quisermos um controle mais preciso sobre a configuração do nosso trabalho, podemos fazer uso do ‘PreBatch’ URI em vez disso. Isso nos permite especificar detalhes como tamanho individual do lote/contagem de produtos e local de produção.
‘PreBatch’ importar Endpoint/URI –
http://host:port/V5-API/api/integrate/import/pre_batch
Para esta importação de amostra usando o ‘PreBatch’ endpoint, podemos estruturar um arquivo de importação básico para um único trabalho com vários lotes conforme abaixo
Este arquivo JSON de amostra pode ser baixado aqui.
Portanto, podemos ver, examinando este arquivo, que estamos criando um novo trabalho (Job-111) com 2 lotes de uma fórmula de 'Massa de Pão Básica', um para 30 libras, a ser feito na fabricação 1, e outro para 50 libras, a ser feito. feito na fabricação 2. Se olharmos o manual da API para o ‘PreBatch’ classe, então podemos ver um método de deslocamento semelhante em ação aqui para construir nosso arquivo.
Se executarmos o arquivo JSON acima, veremos esse novo trabalho criado e, se dermos uma olhada na visualização em lote dele, veremos as diferenças nos tamanhos dos lotes/locais de produção, bem como nosso personalizado predefinido números de lote. O sequenciamento em lote também pode ser incluído aqui, se desejado.
5.2. JSON – Exportar
Em termos de recebimento de arquivos relacionados a trabalhos da API V5, existem algumas opções diferentes das classes IntegrationExport e ExportTransaction que podemos usar, que veremos aqui.
Job:
Endpoint/URI de exportação de trabalho individual –
http://host:port/V5-API/api/integrate/export/job/{jobNumber}
Este endpoint exportará um arquivo JSON com todas as informações relacionadas ao trabalho especificado. Se executarmos esta solicitação usando o número do trabalho que acabamos de importar, obteremos um arquivo parecido com este:
Um exemplo de arquivo JSON deste tipo pode ser baixado aqui.
Todos os trabalhos:
Endpoint/URI de exportação de todos os trabalhos
http://host:port/V5-API/api/integrate/export/jobs
Este endpoint exportará um arquivo JSON que inclui uma lista de todos ativo trabalhos no sistema, definidos como trabalhos que possuem um status diferente de 'concluído' ou que foram excluídos do Control Center.
Se executarmos esta solicitação, receberemos um arquivo JSON de retorno estruturado da mesma forma que a exportação acima para um trabalho único, mas como mencionado, incluirá todos os trabalhos ativos.
Um exemplo de arquivo JSON deste tipo pode ser baixado aqui.
Também podemos utilizar endpoints transacionais e de log para recuperar informações mais relevantes sobre trabalhos e ordens de produção.
Para a Registro do sistema pontos finais, estes são:
5.3. CSV - Importar
Nome do arquivo de definição de cabeçalho/coluna: “job.csvh”
Os arquivos de cabeçalho completos devem ser colocados em: “<installdir>\SG Control Center\gateway\import\column_defs”
Nome do arquivo CSV de importação: “job-datetime.csv”
Os CSVs para importação devem ser colocados em: “<installdir>\SG Control Center\gateway\import”
Arquivo de cabeçalho:
Os arquivos de cabeçalho geralmente serão compilados pela SG Systems antes das integrações CSV ocorrerem, mas podemos ver um exemplo básico de um que podemos usar para trabalhos, usando o definido anteriormente definições de classe, abaixo:
Para mais informações sobre como estruturamos esses arquivos, consulte o página principal de integração. Este arquivo de cabeçalho de amostra pode ser baixado aqui.
Arquivo de importação CSV:
Podemos então usar a ordem definida de pontos de dados no cabeçalho para estruturar nosso arquivo de importação. A SG Systems pode fornecer um arquivo de modelo para isso, listando o ponto de dados para cada coluna para tornar as coisas mais claras ao preencher a lista. Observe que esta primeira linha pode ser ignorada pelo Centro de Controle e, portanto, pode ser mantida no arquivo ao enviar para importação.
Um exemplo de arquivo de importação CSV para trabalhos poderia ser mais ou menos assim:
Este arquivo de importação de amostra pode ser baixado aqui.
Com a importação concluída, podemos ver que esses trabalhos adicionais foram adicionados ao Control Center juntamente com o trabalho que criamos usando a importação JSON acima.
5.4. CSV - Exportar
Tal como acontece com as exportações JSON, temos algumas opções diferentes aqui. Podemos começar simplesmente exportando uma lista de trabalhos dentro do sistema:
Trabalhos/Cronograma:
Exportar nome do arquivo CSV: “job.csvh”
Os arquivos de cabeçalho completos devem ser colocados em: “<installdir>\SG Control Center\gateway\export/order”
Exportar nome do arquivo CSV: “job-datetime.csv”
Os CSVs para exportações serão gerados em: “<installdir>\SG Control Center\gateway\export”
Podemos usar as definições de classe definidas anteriormente para estruturar um arquivo de cabeçalho para definir quais dados receberemos de volta.
Esta exportação precisaria ser habilitada na seção Gateway do Control Center. Podemos escolher aqui exportar 'Agenda'.
Arquivo de cabeçalho:
Neste caso vamos usar apenas o mesmo arquivo de cabeçalho que usamos acima para a importação:
Arquivo de exportação CSV:
Obteríamos um arquivo CSV de retorno parecido com este:
Um exemplo deste tipo de arquivo pode ser baixado aqui. Observe que se um arquivo de cabeçalho não estiver presente na pasta indicada, será exportado um CSV que apresenta todos os pontos de dados no ‘Job’ classe.
Embora este endpoint exporte apenas uma lista de trabalhos, podemos usar alguns endpoints diferentes para recuperar informações mais detalhadas relacionadas ao consumo e à produção.
Registros de lote:
Exportar nome do arquivo CSV: “BatchLog-datetime.csv”
Os CSVs para exportações serão gerados em: “<installdir>\SG Control Center\gateway\export”
A maneira mais simples de recuperar dados de produção de trabalho do V5 Traceability na forma de um CSV é simplesmente usar e processar 'logs em lote'.
Novamente, esta exportação também precisaria ser habilitada na seção Gateway do Control Center. Podemos escolher aqui exportar 'Logs em lote'.
Arquivo de exportação CSV:
Não precisaríamos construir um arquivo de cabeçalho aqui, pois o Gateway V5 preencherá uma lista definida de pontos de dados por padrão. Com esta exportação habilitada, o sistema exportará um ‘BatchLog’ arquivo cada vez que um lote dentro de uma tarefa é concluído pelo sistema. Um exemplo básico disso é mostrado abaixo:
Um exemplo deste tipo de arquivo pode ser baixado aqui.
Registro do sistema:
Se quisermos receber dados de produção de trabalho mais personalizados ou detalhados (‘CONSUMED’/’PRODUCE’) voltando da Rastreabilidade V5, podemos fazer uso do ‘SystemLog’ ponto final para fazer isso.
Nome do arquivo de definição de cabeçalho/coluna: “SystemLog.csvh”
Os arquivos de cabeçalho completos devem ser colocados em: “<installdir>\SG Control Center\gateway\export\order”
Exportar nome do arquivo CSV: “SystemLog-datetime.csv”
Os CSVs para exportações serão gerados em: “<installdir>\SG Control Center\gateway\export”
Para este tipo de exportação usando este endpoint, estruturaríamos nosso cabeçalho usando o ‘SystemLog’ definições de classe de banco de dados.
Tal como acontece com os outros exemplos acima, esta exportação precisaria ser habilitada na seção Gateway do Control Center:
Arquivo de cabeçalho:
A partir daqui podemos estruturar nosso cabeçalho dependendo de quais dados transacionais relacionados aos trabalhos que queremos receber de volta ao ERP. Para nossos propósitos aqui, isso poderia ser assim:
Este arquivo de cabeçalho de amostra pode ser baixado aqui.
Arquivo de exportação CSV:
Se executarmos um lote simples, a exportação do log do sistema será semelhante a esta:
Este exemplo de exportação pode ser baixado aqui.
