Anveo EDI Connect / Config / Mappings / Ler e Escrever Dados da Tabela
Esta é uma tradução automática. O post original está disponível em Inglês .

Ler e Escrever Dados da Tabela

É importante notar que você só pode acessar as colunas daquela instância da tabela a partir das linhas mapping que são crianças da instância da tabela. O recuo das linhas da tabela deve, portanto, ser feito de tal forma que todas as linhas que queiram acessar os dados sejam filhos da tabela. Para este fim, várias tabelas são frequentemente aninhadas umas debaixo das outras para obter acesso a todos os campos.

Para ler ou escrever em tabelas dentro do Microsoft Dynamics 365 Business Central você tem que declarar primeiro uma instância dessa tabela no mapping. Escolha o valor Loop na linha mapping Type propriedade. Isto irá alterar as propriedades disponíveis e adicionar uma nova propriedade chamada Loop Type. Selecione a Table valores como o Loop Type.

Em seguida, você pode configurar as outras propriedades. As seguintes propriedades estão disponíveis:

Loop Type

O tipo do laço. Selecione o valor Table para acessar os dados da tabela.

Mode

Se ler dados de uma tabela, escrever dados em uma tabela (criar um novo registro) ou atualizar dados existentes.

Read

Leia os dados existentes. Os dados podem ser filtrados. É possível aplicar filtros, para que não seja encontrado nenhum registo.

Write

Criar um novo registo na tabela. Dependendo do tipo de formato, um ou mais registros podem ser criados.

Update

Atualizar um registro existente ou, opcionalmente, criar um novo, se ele não existir. O módulo só pode actualizar um registo de cada vez, por isso assegure-se de aplicar filtros para que no máximo um registo seja encontrado. Para atualizar vários registros, você tem que criar um loop de tabela lendo os dados e uma segunda instância dessa tabela no modo de atualização filtrada para a chave primária do registro lido atualmente.

Table

Selecciona a tabela fonte/alvo a partir do Microsoft Dynamics 365 Business Central. Você pode digitar o nome da tabela ou a sua identificação.

Name

O nome desta instância da tabela no mapping. O nome é usado para diferenciar entre diferentes instâncias de uma mesma tabela. Pense nisso, como um nome de variável.

Data View

Esta propriedade é nova na versão 4.00 do módulo.

All Records

Não aplique nenhum filtro especial. Você ainda pode filtrar os dados com as propriedades abaixo.

Post Process Record

Apenas utilizável, se este mapping funcionar como um pós-processamento. Filtrar a instância da tabela para o registro em que o pós-processamento foi definido.

Business Transaction Data

Apenas utilizável, se este mapping for executado dentro de uma transacção comercial. Filtra os dados para os dados da transação comercial (por exemplo os dados do trabalho).

Named Table View

Filtra os dados por uma vista de tabela nomeada. Este pode ser um dos nomes de vista de tabela embutida ou qualquer vista de tabela que é definida pela programação. Uma nova propriedade ficará disponível para seleccionar o nome.

Table View Name

Esta propriedade só está disponível, se Data View estiver definida como Named Table View. Você pode usar qualquer visão de tabela definida por código, ou uma das seguintes opções especiais:

TRANSMISSION

Se houver uma transmissão de entrada, você pode acessá-la com esta visão de tabela.

PROCESSINGQUEUE

Se o mapping estiver sendo executado como um manipulador de erros, você pode usar este filtro para acessar a entrada da fila de processamento com falha.

POST_PROCESS_REC
DEFAULT

Estes nomes de filtros são normalmente utilizados pelo módulo para armazenar informações sobre o registro pós-processo. Em vez disso, deve-se definir o valor da Data View para Post Process Record. Mas se você atualizar mapeamentos de versões antigas do módulo, você ainda poderá encontrar esses valores, que ainda funcionarão.

Os nomes também podem ser definidos a partir de código personalizado e conter qualquer filtro. Nós não recomendamos mais o uso desses nomes. Por favor, use um nome de filtro falante ou CUSTOM em seu lugar.

Limit Count

Esta propriedade é nova no Anveo EDI Connect 4.00.

Apenas disponível em modo de leitura. Especifica se você quer limitar a contagem dos registros que podem ser encontrados. Pode ser usado para seleccionar apenas o primeiro ou último registo em combinação com a propriedade de ordenação.

True

Limite os registos à contagem especificada.

False

Não limite os registos devolvidos.

Select Top

Apenas disponível se a Limit Count estiver definida para True. O número máximo de registros a serem utilizados.

Table View

Só de leitura. Agrupa outras propriedades. O nome Table View é usado na programação do Microsoft Dynamics 365 Business Central para descrever a combinação da ordenação e dos filtros constantes em uma tabela. Usamos este nome para facilitar aos programadores C/AL a utilização do módulo, pensem nele como filtros constantes e valor inicial.

Key

A chave que deve ser usada para a ordenação. Pode estar vazio.

Order

A ordem em que a chave é aplicada. O padrão é Ascending.

Filter

Filtros que são constantes ou, em outras palavras, não dependem de dados de outra tabela. Você pode filtrar todas as colunas da tabela.

Se o Mode da tabela for Write, os filtros são aplicados como valores iniciais à tabela. Assim, você também pode usar o filtro para especificar alguns dos valores das colunas para novos registros.

Data Item Link

Esta propriedade é usada para definir a relação com outra tabela. Esta é uma lista de valores. Selecionar primeiro a coluna da instância da tabela atual e depois outra tabela e campos. Esta propriedade é usada para definir a relação chave-estrangeira.

Vamos assumir que você tem uma instância da tabela EDI Document no mapping e, como criança, uma instância da tabela EDI Document Line. Para especificar que a linha pertence ao documento de cabeçalho, o usuário define a Data Item Link como:

"Document Type"="EDI Document"."Document Type", "Document No."="EDI Document"."No.", "Document Version No."="EDI Document"."Version No."

Isto irá filtrar as colunas especificadas para o valor do documento de cabeçalho. No modo de leitura, você só receberá as linhas pertencentes ao documento. No modo de escrita, as colunas serão preenchidas com os dados do documento, de modo que a linha pertença ao cabeçalho.

Se o Mode da tabela for Write o Data Item Link é aplicado como valores iniciais às colunas da tabela. Assim, você também pode usar o Data Item Link para especificar alguns dos valores da coluna para novos registros.

Temporary

Esta é uma propriedade avançada e normalmente escondida.

Especifica que você quer usar uma tabela temporária. Uma tabela temporária é mais recente, escrita na base de dados.

Init Function

Esta propriedade é nova no Anveo EDI Connect 4.00.

A propriedade função init só está disponível, se a propriedade Temporary estiver definida como True. Esta função é utilizada para preencher a tabela temporária, quando esta é inicializada.

Object

O nome do objeto no qual a função está definida.

Property/Function

O nome da função. A função deve retornar um objeto do tipo Codeunit ANVEDI Variant apontando para um RecordRef que contém os dados iniciais.

Company

Esta é uma propriedade avançada e normalmente escondida.

A empresa de onde o registo é lido / escrito. Isto pode ser usado para acessar dados de uma empresa diferente.

Não altere as instâncias da empresa na mesa em modo de escrita, exceto que você sabe o que está fazendo. Todos os acionadores são executados de acordo com os dados da empresa atual, de modo que nunca se deve escrever diretamente em nenhuma tabela padrão em uma empresa diferente.

TotalFields

Você pode especificar colunas, para as quais o módulo calculará automaticamente uma soma. Você pode ler os valores somados da tabela acessando as colunas após o loop da tabela e não como uma linha filha do loop da tabela.

Register Errors On Instance

Esta propriedade é nova no Anveo EDI Connect 4.00.

Esta é uma propriedade avançada e normalmente escondida. Se você deseja registrar automaticamente erros após esta linha para esta instância de tabela.

True

Registre erros nesta instância da tabela. Isto faz sentido para as tabelas de reserva.

False

Não registar erros nesta instância da tabela. Isto faz sentido se o acesso, por exemplo, a informações de tabela secundária.

Linked Documents

Esta é uma propriedade apenas de leitura para agrupar as propriedades das crianças.

Create Linked Documents

Se o usuário deseja criar entradas na tabela de documentos ligados para esta instância de tabela. Ajustar isto para True lhe permitirá navegar da EDI Processing Queue, da EDI Transmission (se presente) e da EDI Business Transaction (se presente) para esta tabela.

Linked Tables

Esta propriedade só está disponível, se Create Linked Documents estiver definido como True. É possível especificar outras instâncias de tabela deste mapping que devem ser ligadas à instância de tabela atual. Isso permite, por exemplo, no EDI Document, navegar para outros documentos ligados, como um cabeçalho de vendas criado.

Internal No. Display Field

É possível selecionar a coluna que deve ser usada para o número interno, sempre que uma entrada de documento ligada for criada para esta instância de tabela.

External No. Display Field

É possível selecionar a coluna que deve ser usada para o número externo, sempre que uma entrada de documento ligada for criada para esta instância de tabela.

Post-Processing

Permite especificar uma ou mais ações que devem ser executadas em cada registro desta instância da tabela, após o mapping ter sido concluído com sucesso. Os pós-processamentos não são executados, se houver algum erro. Você pode aprender mais na seção de pós-processamento.

Min. Repeat

Se você digitar um número, o mapping irá lançar um erro, se a repetição mínima especificada não for atingida.

Min. Repeat Error Message

A mensagem de erro que deve ser levantada se a contagem mínima de registros não for encontrada.

Max. Repeat

Se você digitar um número, o mapping irá lançar um erro, se a repetição máxima especificada não for alcançada.

Max. Repeat Error Message

A mensagem de erro que deve ser levantada se a contagem máxima de registros for excedida.