Anvaigo EDI Connect / Config / Business Transactions / EDI Business Transaction Type
Esta é uma tradução automática. O post original está disponível em Inglês .

EDI Business Transaction Type

O tipo de transação comercial define um possível caso comercial geral. Pode tratar-se, por exemplo, de uma fatura emitida ou de uma encomenda recebida.

Essa estrutura de dados também é usada para definir a coleta automática de dados, por exemplo, para encontrar todas as novas faturas no sistema e acionar ações EDI. O tipo de transação comercial também define a forma como o parceiro EDI é determinado a partir dos dados comerciais.

Cada fluxo de transação é composto por um ou mais tipos de transação comercial, utilizando diferentes pontos de entrada do processo, que determinam a forma como os dados são tratados em cada fase. A compreensão destes diferentes tipos de estrutura do EDI Business Transaction Type é essencial para a criação de processos EDI eficientes e fiáveis.

Process Entry Point

Incoming Transmission

Este tipo é utilizado para receber e importar dados de sistemas externos para o Dynamics 365 Business Central. É normalmente a primeira etapa de uma transação e é responsável pela análise do ficheiro de entrada (por exemplo, EDIFACT, XML, CSV) e pela importação dos dados para uma estrutura de buffer interna.

  • Exemplo de caso de utilização: Receber ordens de compra ou facturas de parceiros comerciais.

Data Collection

Este tipo é utilizado para extrair dados do Dynamics 365 Business Central. Recolhe os registos necessários de tabelas como ordens de venda, facturas ou expedições, preparando-os para exportação.

  • Exemplo de caso de utilização: Reunir ordens de venda em aberto para serem exportadas como respostas ou confirmações de ordens.

Sub-Process

O tipo Subprocesso é usado principalmente para trabalhar com estruturas de buffer, como o Documento EDI ou tabelas de buffer relacionadas. Ao contrário dos outros tipos que operam diretamente em um único file (Dados de entrada) ou em um registro de origem na Central de negócios (Coleta de dados), as atividades de Subprocessos geralmente operam nos dados intermediários do buffer.

Este tipo é essencial para estruturar e controlar o fluxo da lógica de processamento em cenários de importação e exportação.

Principais casos de utilização

  • Transformação de buffer: Nos cenários de importação, um ficheiro de entrada é primeiro mapeado para uma estrutura de buffer. Em seguida, um subprocesso assume o controlo para continuar a processar essa memória intermédia. Pode tratar-se de um processamento 1:1 da memória intermédia ou de um cenário 1:n em que um registo de entrada gera várias entradas na memória intermédia.
  • Tratamento de lotes com tolerância a falhas: Quando um único ficheiro contém vários documentos comerciais (por exemplo, várias encomendas), cada registo de buffer pode ser processado no seu próprio sub-processo. Isto garante que uma falha num documento não bloqueia o processamento dos outros.
  • Preparação Mapping de exportação: Nos fluxos de exportação, o tipo de Recolha de dados reúne registos como facturas de vendas ou expedições e prepara-os em estruturas de buffer. Um sub-processo é então utilizado para processar esta memória intermédia, transformando ou mapping os dados, antes da sua saída em XML, EDIFACT ou outro formato necessário.

A partir do mapping, o registo associado à transação comercial (por exemplo, um documento EDI) está sempre acessível, pelo que, sempre que quisermos alterar o registo principal para processamento posterior, podemos utilizar um subprocesso para o efeito.

Convenções de nomenclatura

Embora seja livre de utilizar qualquer código, recomendamos que utilize convenções de nomenclatura consistentes. Seguem-se as nossas convenções, que ajudam a identificar imediatamente o objetivo da transação e o seu papel na cadeia de processamento.

O nome de cada tipo de transação comercial segue normalmente este formato:

[DOCUMENT_TYPE]_[ROLE]

Onde:

  • [DOCUMENT_TYPE] descreve o documento comercial que está a ser processado (por exemplo, ORDERS, INVOIC, DESADV).
  • [ROLE] indica a função do subtipo na transação.

Sufixos de função recomendados

SufixoSubtipoDescrição
_INCOMINGIncoming TransmissionTrata os ficheiros de entrada (por exemplo, XML, EDIFACT) para importação.
_COLLECTData CollectionRecolhe dados do Business Central (por exemplo, facturas).
_PROCESSINGSub-ProcessProcessa dados de buffer (por exemplo, transformação de importação).
_OUTGOINGSub-ProcessTransformação final da memória intermédia e mapping antes da exportação.

Exemplos de padrões de nomes:

  • ORDERS_INCOMING
    Utilizado para importar ficheiros de entrada de ordens de compra para as tabelas intermédias.
  • ORDERS_PROCESSING
    Preparar os dados e criar ordens de venda a partir do registo buffer criado pela ORDERS_INCOMING.
  • INVOIC_COLLECT
    Recolhe as facturas de vendas lançadas e os registos tampão criados.
  • INVOIC_OUTGOING
    Mapeia e transforma o buffer de facturas recolhidas num formato EDI de saída.

Campos

Code

Este campo faz parte da chave primária. Pode utilizar qualquer código que deseje. Recomendamos um código descritivo, como INVOICE_OUT, ORDERS_IN, etc.

Transaction Data Table

Dependendo do Process Entry Point, este campo define a tabela que é utilizada para os registos das transacções comerciais.

Transaction Data Table ID

Este campo armazena o ID da Transaction Data Table.

Reference No. Field

Este campo define o campo que é utilizado como número de referência na tabela de transacções comerciais. Este campo não influencia qualquer lógica de processamento, mas é o principal campo de pesquisa para encontrar o documento na perspetiva do utilizador final.

Reference No. Field No.

Este é o número do domínio técnico para o campo N Reference No. Field.

Find Communication Partner by

A possibilidade de utilizar este campo depende do Process Entry Point.

Field

Define que o parceiro de comunicação para este EDI Business Transaction Type depende de um valor da Transaction Data Table.

Constant

O parceiro de comunicação é um único para este EDI Business Transaction Type.

Relation Field Name

Define o campo que é utilizado para encontrar o parceiro de comunicação.

Relation Field No.

Domínio técnico n.º. para o campo Relation Field Name.

Process Entry Point

Este campo define o ponto de entrada do processo. O ponto de entrada do processo determina muitas das outras opções que estão disponíveis.

Data Collection

O processo tem como ponto de entrada os dados existentes no Microsoft Dynamics 365 Business Central. Esta opção permite-lhe definir tarefas de recolha automática.
(O valor inteiro desta opção na base de dados é 0)

Incoming Transmission

O processo começa com uma transmissão a partir de um canal de comunicação.
(O valor inteiro desta opção na base de dados é 1)

Sub-Process

O processo é uma subparte de outro processo. A Transaction Data Table não tem de ser a mesma. Esta opção define que este tipo de transação comercial só pode ser chamado como um sub-processo de outro.
(O valor inteiro desta opção na base de dados é 2)

Automatic Data Collection

Define se pretende ativar a recolha automática de dados. Tenha em atenção que também terá de definir uma tarefa que inicie a recolha automática. Com esta opção pode definir que tipo de campo é utilizado para detetar novos registos.

None

Não pretende ativar a recolha automática de dados.
(O valor inteiro desta opção na base de dados é 0)

SQL Timestamp

Acompanha as alterações com base no carimbo de data/hora SQL. Isso só é possível com o Microsoft Dynamics 2013R2 e mais recente. Em BC 17, foi introduzido um novo campo de sistema que contém a data/hora da última modificação. Recomendamos vivamente a sua utilização com a opção Date Field.
(O valor inteiro desta opção na base de dados é 1)

Date Field

Pretende utilizar um campo de data.
(O valor inteiro desta opção na base de dados é 2)

Code Field

Pretende utilizar um campo de código.
(O valor inteiro desta opção na base de dados é 3)

Boolean Flag

Pretende-se utilizar um sinalizador booleano, falso significa que os dados ainda não foram exportados. O campo é alterado automaticamente. Esta opção não funciona em tabelas de sistema protegidas, como cabeçalhos de facturas.
(O valor inteiro desta opção na base de dados é 4)

All records

Exportar sempre todos os registos. Isto pode ser útil para exportar, por exemplo, todas as ordens em aberto. Os filtros do DataView continuam a ser aplicados, o que lhe dá a possibilidade de utilizar campos ou critérios personalizados.

(O valor inteiro desta opção na base de dados é 5)

Timespan (Past)

Esta opção permite-lhe exportar todas as entradas que são mais recentes do que o período de tempo determinado no passado. Por exemplo, se especificar “30 dias” e utilizar a “Data de lançamento”, o módulo exportará todos os registos lançados há mais de 30 dias. Se ignorar os duplicados, pode verificar todo um período de tempo para novos documentos e exportar apenas os que ainda não foram exportados.

(O valor inteiro desta opção na base de dados é 6)

Debug Options

Especifica como tratar as entradas em que o parceiro de comunicação não pode ser encontrado.

Create Ignore Entries

Criar entradas e marcá-las.
(O valor inteiro desta opção na base de dados é 0)

None

Não criar entradas na tabela de transacções comerciais.
(O valor inteiro desta opção na base de dados é 1)

Change Detection Field Name

Define o campo, que é utilizado para encontrar novas entradas.

Change Detection Field No.

O número do campo técnico para o campo Change Detection Field Name.

Data Table View

Define uma visão de tabela que é aplicada adicionalmente aos critérios para a recolha automática de dados.

Last Timestamp

Armazena o último carimbo de data/hora. Se Automatic Data Collection estiver definida para
SQL Timestamp, é aplicado um filtro na tabela de dados, procurando apenas entradas com um valor superior a este. Após a execução da tarefa, o último valor é armazenado neste campo.

Last Code Value

Armazena o último carimbo de data/hora. Se Automatic Data Collection estiver definida para Code Field, é aplicado um filtro na tabela de dados, procurando apenas entradas com um valor superior a este. Após a execução da tarefa, o último valor é armazenado neste campo.

Last Date/Time Value

Armazena o último carimbo de data/hora. Se Automatic Data Collection estiver definida para Date Field, é aplicado um filtro na tabela de dados, procurando apenas entradas com um valor superior a este. Após a execução da tarefa, o último valor é armazenado neste campo.

Created Date/Time

Armazena a data/hora de criação desta tabela.

Modified Date/Time

Armazena a data/hora de modificação deste registo.