Link de perigo
Seu guia para a integração V5!
O endpoint de importação 'HazardLink' pode ser usado para atribuir rapidamente mercadorias a grupos de perigo no V5 Traceability.
Este guia se concentrará em como usar esse endpoint, tanto por meio da importação de CSV quanto usando JSON por meio da API V5.
Conteúdo
1. Grupos de risco padrão
O banco de dados V5 padrão apresenta vários dos grupos de risco mais comuns, mas este endpoint pode ser usado para criar grupos adicionais, se necessário. Os grupos de risco padrão que estão incluídos podem ser vistos na captura de tela abaixo:
Este endpoint não se destina à criação de commodities; isso deve sempre ser feito através do endpoint ' Commodity '.
2. Links API
Para saber mais sobre as definições deste 'HazardLink' e classes de banco de dados relacionadas, consulte o seguinte link:
3. Guia de campo HazardLink
3.1. Chaves primárias
Para ambas as metodologias de importação, as chaves primárias são:
Perigo_Perigo – o nome do Grupo de Perigo (ex: Óculos de Segurança, Protetores Auriculares, etc.).
Código_da_mercadoria – O código único da mercadoria a ser atribuído ao Grupo de Perigo.
3.2. Campos Adicionais
Outras opções aqui que podemos adicionar da classe de banco de dados 'Hazard' são:
Hazard_WarningText – O texto a ser exibido para um operador de terminal ou WMS quando a mercadoria associada a um risco for manuseada. Necessário apenas ao criar novos grupos de risco.
Hazard_TextColor – Permite a entrada de um número RGB para atribuir uma cor ao Grupo de Perigo. Observe que essa cor deve ser a mesma para todas as mercadorias dentro do mesmo Grupo de Perigo. Observe também que, ao importar cores usando este método, os números RGB não precisam ser separados por vírgulas (por exemplo, 219 125 33 em vez de 219, 125, 33).
Observe que essa opção não está disponível para a metodologia JSON, a menos que seja criado um novo grupo de risco por meio deste ponto de extremidade. Se for necessária a modificação das cores do grupo existente, é recomendável usar o ponto de extremidade CSV.
4. Conjunto de dados de exemplo
Neste artigo, veremos um conjunto de dados de exemplo simples com 2 ingredientes que podem ser usados durante a produção:
- Álcool benzílico – Máscara de segurança (laranja) e luvas de segurança (vermelhas)
- Propilenoglicol – Óculos de segurança (Azul) e Luvas de segurança (Vermelho)
5. Metodologia
5.1. JSON – Importar
Importação de ponto final/URI de 'HazardLink' –
http://host:port/V5-API/api/integrate/import/hazard_link
amostras:
Usando o endpoint 'HazardLink', podemos estruturar um arquivo de importação para as adições acima assim:
Este arquivo JSON de exemplo pode ser baixado aqui.
E depois de publicarmos isso no sistema, podemos ver que todos os nossos produtos foram atribuídos ao grupo de risco correto. Nesse caso, podemos ver ambos os produtos adicionados ao grupo de risco "Luvas de segurança".
5.2. CSV - Importar
Para importações de CSV, primeiro precisamos construir um arquivo de cabeçalho para nossas importações.
Nome do arquivo de definição de cabeçalho/coluna: “hazardLink.csvh”
Os arquivos de cabeçalho completos devem ser colocados em: “<diretório de instalação>\SG Control Center\gateway\import\column_defs”
Nome do arquivo CSV para importação: “hazardLink-datetime.csv”
Os arquivos CSV para importação devem ser colocados em: “<diretório de instalação>\SG Control Center\gateway\import”
amostras:
Arquivo de cabeçalho:
Um exemplo de arquivo de cabeçalho pode ser visto abaixo. Aqui atribuiremos nossas commodities aos grupos de risco definidos e também adicionaremos uma cor aos grupos:
Para obter mais informações sobre como estruturamos esses arquivos, consulte a página principal de integração . Este arquivo de cabeçalho de exemplo 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. Observe que essa primeira linha pode ser ignorada pelo Control Center e, portanto, pode ser mantida no arquivo ao enviar para importação. Um exemplo de importação com base em nossos requisitos acima ficaria assim:
Observe novamente que não precisamos das vírgulas que normalmente separam os valores RGB. Este arquivo de importação de exemplo pode ser baixado aqui.
Podemos então soltar esse arquivo em nossa pasta de importação, conforme definido acima, e quando a importação estiver concluída, poderemos ver que as cores do texto do grupo de risco foram atualizadas e, como acima, os 2 ingredientes agora foram adicionados ao grupo "Luvas de segurança":
