Gerenciar workflows no Jitterbit EDI
Introdução
Um workflow define quais documentos são trocados com um parceiro, em qual direção viajam e como o conteúdo dos documentos é mapeado de um formato para outro.
Nota
Para todos os projetos e workflows novos, EDIXml é o formato de intercâmbio recomendado. Ele suporta todas as versões de documentos X12 e EDIFACT. XCBL é um formato legado mantido para workflows existentes.
Você pode adicionar quantos workflows precisar, dependendo do seu relacionamento com os parceiros. Os workflows são definidos na aba Manage Workflows. Eles são adicionados por um destes métodos, dependendo do seu acesso:
Depois de adicionado, você pode editar algumas partes do workflow.
Adicionar um workflow com seleção de processamento de mapa
Nota
O acesso a este recurso está disponível mediante solicitação. Para obter acesso a este recurso, entre em contato com seu Gerente de Sucesso do Cliente (CSM).
Para adicionar um workflow, siga estas etapas:
-
Selecione EDI > Trading Partners e depois selecione um parceiro.
-
Na aba Manage workflows, clique em New > Workflow. Uma nova linha é adicionada:
-
A configuração padrão do menu Map Processing é EDIXml. A outra seleção, XCBL, é um formato legado mantido para workflows existentes. Ele usa mapas predefinidos e mapeamento XCBL. Defina os campos restantes:
-
Direction: Selecione a direção, uma de Inbound (para Harmony) ou Outbound (para o parceiro comercial).
-
EDI Standard: Selecione o padrão EDI que seus documentos devem usar, um de EDIFACT, Tradacoms ou X12.
-
Document Type: Selecione um tipo de documento. O conteúdo do menu depende da configuração de EDI Standard.
-
Version: Selecione uma versão de documento. O conteúdo do menu depende da configuração de Document Type.
-
-
Defina os seguintes toggles:
-
Active: Ative para tornar o workflow ativo. Desative se o documento EDI não for mais necessário.
-
Ack: Se uma transação não exigir uma confirmação, use este toggle para desativar a confirmação de recebimento para este workflow. A configuração padrão é ativada.
-
Debug: Ative para registrar mensagens.
-
Validation: (Aparece quando Map Processing é EDIXml e Direction é Outbound.) Ative para verificar se as transações de saída são documentos EDI válidos.
-
-
Clique em Save. O workflow aparece como uma nova linha.
Adicionar um workflow
Para adicionar um workflow, siga estas etapas:
-
Clique em New > Workflow. Uma nova linha é adicionada.
-
Defina valores para os seguintes campos:
-
Direction: Selecione a direção, uma de Inbound (para Harmony) ou Outbound (para o parceiro comercial).
-
Document Type: Selecione um tipo de documento.
-
Map: Um mapa padrão é selecionado automaticamente com base nas configurações de Direction e Document Type. Não altere o mapa selecionado a menos que instruído para fazê-lo.
-
Active: Ative para tornar o workflow ativo. Desative se o documento EDI não for mais necessário.
-
Ack: Se uma transação não exigir uma confirmação, use este toggle para desativar a confirmação de recebimento para este workflow. A configuração padrão é ativada.
-
Debug: Ative para registrar mensagens.
-
-
Clique em Save. O workflow aparece como uma nova linha.
Adicionar um workflow com o Assistente de IA EDI
Para criar um workflow usando prompts em linguagem natural, clique em New > Build with AI na aba Manage workflows. Isto abre o Assistente de IA EDI.
Nota
A opção Build with AI é visível para todos os usuários. Se sua licença do Harmony não incluir a opção Assistente de IA EDI, selecionar Build with AI abre um diálogo onde você pode enviar um formulário de contato para solicitar que seja adicionado à sua licença.
Editar um fluxo de trabalho
Para editar um fluxo de trabalho, siga estas etapas:
-
Clique no botão Editar do fluxo de trabalho.
-
Altere qualquer uma das seguintes configurações:
- Tipo de documento
- Versão
- Ativo
- Ack
- Debug
-
Clique em Salvar ou Cancelar.
Excluir um fluxo de trabalho
Para excluir um fluxo de trabalho, siga estas etapas:
-
Clique no botão Excluir do fluxo de trabalho.
-
Para confirmar a ação, digite a palavra DELETE no campo de texto da caixa de diálogo Excluir fluxo de trabalho e clique no botão Excluir.
Se outro usuário excluir um fluxo de trabalho enquanto você tiver a guia Gerenciar fluxos de trabalho aberta para o mesmo parceiro, a lista de fluxos de trabalho será atualizada e uma notificação informará O fluxo de trabalho não está mais disponível. Se você tivesse alterações não salvas na guia, isso também informará que elas não foram salvas.
Baixar arquivo de mapeamento
Nota
Esta seção se aplica apenas a fluxos de trabalho XCBL legados.
Para baixar um arquivo de mapeamento XPath XCBL para um mapa de fluxo de trabalho existente, clique no botão Baixar XPATH.
Para baixar um arquivo de qualquer mapa sem salvar um fluxo de trabalho, adicione um fluxo de trabalho, selecione um mapa, clique em Baixar XPATH e então clique em Cancelar.
Validação
Para cada fluxo de trabalho, é possível ativar a validação nas transações de saída. A validação reduz o número de ciclos de teste necessários verificando que todos os segmentos obrigatórios estão presentes nas transações de saída antes de serem transmitidos.
Embora o Jitterbit EDI permita gerar transações de saída sem validação ativada, as transações podem não conter todas as informações necessárias para passar corretamente nos testes com seu parceiro comercial. (O Jitterbit EDI ainda pode processar e enviar transações para o tipo de conexão designado, mesmo com validação desativada. Isso é útil para testar a produção de transações em fluxos de trabalho do Studio.)
A menos que você tenha uma compreensão completa da transação EDI e do parceiro comercial com o qual está trabalhando, sempre ative a validação.
Dica
Para garantir que seu parceiro comercial não receba transações durante seus testes internos, defina conexões como inativas.
Exemplos
Quando a validação está ativada, os registros de mensagem fornecem detalhes sobre elementos ausentes em uma transação EDI. (A transação não é processada através de um método de comunicação porque não está em conformidade com o padrão relevante.)
Exemplo de transação processada por um fluxo de trabalho sem validação:

Exemplo de transação processada por um fluxo de trabalho com validação:

