Link de campo personalizado

O ponto de extremidade de importação 'CustomFieldLink' pode ser usado para atribuir rapidamente mensagens de rótulo personalizadas a commodities (geralmente fórmulas de produtos acabados) que podem ser impressas em rótulos de produtos por produto.

Mais informações sobre como isso funciona e diferentes exemplos de uso de campos personalizados podem ser encontrados aqui..

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.

1. Layout do centro de controle
2. Links da API
3. Guia de campo CustomFieldLink
   1. Chaves Primárias
   2. Os campos obrigatórios
4. Conjunto de dados de exemplo
5. Metodologia
   1. 1. JSON – Importar
      2. CSV - Importar

Em termos de como podemos relacionar detalhes de campos personalizados com o que vemos no Centro de Controle, usaremos a API V5 e o Gateway para preencher o painel superior 'CustomField' para nomear nossos campos personalizados e inserir detalhes de parâmetros de rótulo, bem como o painel inferior 'CustomFieldLink' para atribuir commodities ao campo personalizado e inserir informações específicas da fórmula que podem ser recuperadas para o conjunto de parâmetros de rótulo no painel superior.

Para saber mais sobre as definições desta classe 'CustomFieldLink', consulte o seguinte link:

Link de campo personalizado 

Para importar via endpoint 'CustomFieldLink', as chaves primárias são:

Nome_do_campo – O nome exclusivo para o campo personalizado que estamos adicionando ou atribuindo nossa fórmula. Podemos ver isso acima como 'Distributed By'.

Código_da_mercadoria – O código exclusivo da fórmula da mercadoria/produto a ser atribuído ao Grupo de Campos Personalizados.

Podemos adicionar outros dados necessários para dar corpo à importação de ambos os 'Campo customizado'E'Link de campo personalizado' classes de banco de dados. Estas são:

De CustomField:

Parâmetro_de_rótulo_de_campo - Necessário ao criar um novo grupo de Campos Personalizados, este é o parâmetro que será usado em rótulos para recuperar dados personalizados deste grupo. No exemplo do Control Center acima, podemos ver que este é 'DIST'.

Valor_padrão_de_campo - O valor padrão que será recuperado quando o parâmetro label for usado, desde que não haja um valor específico de commodity/fórmula para substituir isso no painel inferior, 'CustomFieldLink'. No exemplo do Control Center acima, podemos ver que isso é 'SG Systems LLC'.

De CustomFieldLink:

Dados – As informações a serem lembradas no rótulo para aquela mercadoria/fórmula específica quando o parâmetro de rótulo do grupo de campos personalizados é usado em um rótulo.

Para esta peça, veremos um conjunto de dados de exemplo simples com 3 fórmulas de produtos diferentes que podemos atribuir ao já criado 'Distributed By', dando a cada um deles uma mensagem de distribuição exclusiva. Também adicionaremos um novo grupo Custom Field chamado 'Preparation Instructions', com o parâmetro de rótulo 'PREP'.

Então adicionaremos os seguintes dados ao sistema:

• P006:
  • Distribuído por: Distribuição ABC.
  • Instruções de preparação: Lave antes de usar.
• P007:
  • Distribuído por: Distribuidores Dave
  • Instruções de preparação: Lave antes de usar.
• P008:
  • Distribuído por: Distribuição SGS.
  • Instruções de preparação: Lave antes de usar.

Importação de Endpoint/URI de 'CustomFieldLink' –

http://host:port/V5-API/api/integrate/import/custom_field_link

Descrição do terminal

amostras:

Usando o endpoint 'CustomFieldLink', podemos estruturar um arquivo de importação para as adições acima assim:

Então, note aqui que, como estávamos criando o grupo 'Instruções de Preparação', precisávamos incluir o parâmetro label nessa importação. Para o grupo 'Distribuído por', não precisamos disso e podemos apenas referenciar o nome do grupo em nossa importação.

Este arquivo JSON de amostra pode ser baixado aqui..

E depois de publicarmos isso no sistema, podemos ver que nossas fórmulas de exemplo foram adicionadas ao grupo "Distribuído por", com sua mensagem exclusiva na coluna "Dados" do painel inferior:

E também podemos ver que nosso novo grupo foi criado para ter as mesmas 'Instruções de Preparação' para todos os 3:

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: “link de campo personalizado.csvh”

Os arquivos de cabeçalho completos devem ser colocados em: “ \SG Control Center\gateway\import\column_defs”

Nome do arquivo CSV de importação: “customFieldLink-datahora.csv”

Os CSVs para importação devem ser colocados em: “ \SG Control Center\gateway\importar”

amostras:

Arquivo de cabeçalho:

Um arquivo de cabeçalho de exemplo pode ser visto abaixo. Aqui atribuiremos nossas commodities aos grupos de campos personalizados definidos e também adicionaremos um novo grupo conforme definido acima:

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. 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:

Este arquivo de importação de amostra pode ser baixado aqui..

Diferentemente da nossa importação JSON, devido ao mecanismo de importação CSV, precisaríamos incluir o parâmetro de rótulo 'DIST' para o grupo 'Distribuído por' neste caso.

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 os grupos de campos personalizados foram atualizados/adicionados adequadamente:

E: