Ler e escrever dados de tabela
É importante notar que só é possível aceder às colunas dessa instância de tabela a partir de linhas mapping que sejam filhas da instância de tabela. A indentação das linhas da tabela deve, por conseguinte, ser efectuada de forma a que todas as linhas que pretendam aceder aos dados sejam filhas da tabela. Para este efeito, é frequente colocarem-se várias tabelas umas sob as outras para se ter acesso a todos os campos.
Para ler ou escrever em tabelas dentro do Microsoft Dynamics 365 Business Central, é necessário declarar primeiro uma instância dessa tabela no mapping. Selecionar o valor Loop na propriedade Type de linha mapping. Esta ação altera as propriedades disponíveis e adiciona uma nova propriedade denominada ” Loop Type. Seleccione o valor Table como o Loop Type.
Em seguida, pode configurar as outras propriedades. Estão disponíveis as seguintes propriedades:
O tipo de laço. Seleccione o valor Table para aceder aos dados da tabela.
Se pretende ler dados de uma tabela, escrever dados numa tabela (criar um novo registo) ou atualizar dados existentes.
Ler dados existentes. Os dados podem ser filtrados. É possível aplicar filtros, para que não seja encontrado nenhum registo.
Criar um novo registo na tabela. Dependendo do tipo de formato, podem ser criados um ou mais registos.
Atualizar um registo existente ou, opcionalmente, criar um novo registo, se este não existir. O módulo só pode atualizar um registo de cada vez, por isso certifique-se de que aplica filtros para que seja encontrado, no máximo, um registo. Para atualizar vários registos, é necessário criar um ciclo de tabela que leia os dados e uma segunda instância dessa tabela em modo de atualização filtrada para a chave primária do registo atualmente lido.
Selecciona a tabela de origem/destino do Microsoft Dynamics 365 Business Central. Pode introduzir o nome da tabela ou o seu ID.
O nome desta instância de tabela no mapping. O nome é utilizado para distinguir entre diferentes instâncias da mesma tabela. Pense nisso como um nome de variável.
Esta propriedade é nova na versão 4.00 do módulo.
Não aplicar nenhum filtro especial. Pode ainda filtrar os dados com as propriedades abaixo.
Só pode ser utilizado se este mapping for executado como um pós-processamento. Filtra a instância da tabela para o registo em que o pós-processamento foi definido.
Só pode ser utilizado se este mapping for executado no âmbito de uma transação comercial. Filtra os dados para os dados da transação comercial (por exemplo os dados do trabalho).
Filtra os dados por uma vista de tabela nomeada. Pode ser um dos nomes das vistas de tabela incorporadas ou qualquer vista de tabela definida pela programação. Será disponibilizada uma nova propriedade para selecionar o nome.
Esta propriedade só está disponível se Data View estiver definida como Named Table View. Pode utilizar qualquer vista de tabela definida por código ou uma das seguintes vistas especiais:
Se houver uma transmissão recebida, pode aceder-lhe com esta vista de tabela.
Se o mapping estiver a ser executado como um manipulador de erros, é possível utilizar este filtro para aceder à entrada da fila de processamento falhada.
DEFAULT
Estes nomes de filtros são normalmente utilizados pelo módulo para armazenar informações sobre o registo pós-processo. Em vez disso, o valor da Data View deve ser definido como Post Process Record-processo. Mas se atualizar os mapeamentos de versões mais antigas do módulo, poderá ainda encontrar estes valores, que continuarão a funcionar.
Os nomes também podem ser definidos a partir de código personalizado e conter qualquer filtro. Já não recomendamos a utilização destes nomes. Em vez disso, utilize um nome de filtro de voz ou CUSTOM.
Esta propriedade é nova no Anveo EDI Connect 4.00.
Apenas disponível no modo de leitura. Especifica se pretende limitar a contagem de registos que podem ser encontrados. Pode ser utilizado para selecionar apenas o primeiro ou o último registo em combinação com a propriedade de ordenação.
Limita os registos à contagem especificada.
Não limitar os registos devolvidos.
Apenas disponível se Limit Count estiver definida como True. O número máximo de registos a utilizar.
Só de leitura. Agrupa outras propriedades. O nome Table View é utilizado na programação Microsoft Dynamics 365 Business Central para descrever a combinação da ordenação e dos filtros constantes de uma tabela. Utilizámos este nome para facilitar a utilização do módulo pelos programadores C/AL. Pense nele como filtros constantes e valor inicial.
A chave que deve ser utilizada para a ordenação. Pode estar vazio.
A ordem pela qual a chave é aplicada. A predefinição é Ascending.
Filtros que são constantes ou, por outras palavras, não dependem de dados de outra tabela. Pode filtrar todas as colunas da tabela.
Se o Mode da tabela for Write, os filtros são aplicados como valores iniciais à tabela. Assim, também pode utilizar o filtro para especificar alguns dos valores das colunas para novos registos.
Esta propriedade é utilizada para definir a relação com outra tabela. Trata-se de uma lista de valores. Primeiro, selecciona a coluna da instância da tabela atual e, depois, outra tabela e campos. Esta propriedade é utilizada para definir a relação de chave estrangeira.
Vamos supor que tem uma instância de tabela da tabela EDI Document no mapping e como um filho uma instância da tabela EDI Document Line. Para especificar que a linha pertence ao documento de cabeçalho, definir a Data Item Link como:
"Document Type"="EDI Document"."Document Type", "Document No."="EDI Document"."No.", "Document Version No."="EDI Document"."Version No."Isto filtrará as colunas especificadas para o valor do documento de cabeçalho. No modo de leitura, só obterá as linhas pertencentes ao documento. No modo de escrita, as colunas serão preenchidas com os dados do documento, de modo a que a linha pertença ao cabeçalho.
Se o Mode da tabela for Write, a Data Item Link é aplicada como valores iniciais às colunas da tabela. Assim, também pode utilizar a Data Item Link para especificar alguns dos valores de coluna para novos registos.
Esta é uma propriedade avançada e normalmente está oculta.
Especifica que se pretende utilizar uma tabela temporária. Uma tabela temporária é escrita mais recentemente na base de dados.
Esta é uma propriedade avançada e normalmente está oculta.
A empresa a partir da qual o registo é lido ou escrito. Isto pode ser utilizado para aceder a dados de uma empresa diferente.
Não altere a empresa em instâncias de tabela no modo de escrita, exceto se souber o que está a fazer. Todos os accionadores são executados de acordo com os dados da sociedade atual, pelo que nunca se deve escrever diretamente em qualquer tabela standard de uma sociedade diferente.
Esta propriedade só está disponível para tabelas em modo de leitura. Pode especificar colunas para as quais o módulo calculará automaticamente um agregado, como uma soma. É possível ler o valor agregado da tabela acedendo à coluna após a linha da tabela, mas não como uma linha filha do ciclo da tabela.
Estão disponíveis as seguintes funções agregadas:
Apenas para campos numéricos. O resultado é a soma dos valores individuais. Pode ser utilizado para calcular o montante do documento com base no montante da linha, etc.
Apenas para campos numéricos. O número mais pequeno.
Apenas para campos numéricos. O maior número.
O valor do primeiro registo encontrado.
O valor do último registo que foi lido.
Sugestão: Pode utilizar esta funcionalidade para tabelas de configuração. Coloque-os na parte superior do mapping e defina os agregados “Primeiro” para os campos que pretende utilizar no mapping. Agora, pode aceder às propriedades em qualquer lugar abaixo desta linha no mapping sem ter de recuar tudo.
Esta é uma propriedade só de leitura para agrupar as propriedades secundárias.
Se se pretende criar entradas na tabela de documentos ligados para esta instância de tabela. Definir esta opção como True ) permite-lhe navegar da EDI Processing Queue, da EDI Transmission (se presente) e da EDI Business Transaction (se presente) para esta tabela.
Esta propriedade só está disponível se a opção Create Linked Documents estiver definida 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.
É possível selecionar a coluna que deve ser utilizada para o número interno, sempre que for criada uma entrada de documento ligado para esta instância de tabela.
É possível selecionar a coluna que deve ser utilizada para o número externo, sempre que for criada uma entrada de documento ligado para esta instância de tabela.
Permite-lhe especificar uma ou mais acções que devem ser executadas em cada registo desta instância de tabela, depois de o mapping ter terminado com êxito. Os pós-processamentos não são executados, se houver algum erro. Pode obter mais informações na secção de pós-processamento.
Se introduzir um número, o mapping emite um erro se a repetição mínima especificada não for atingida.
A mensagem de erro que deve ser emitida se o número mínimo de registos não for encontrado.
Se introduzir um número, o mapping emitirá um erro se a repetição máxima especificada não for atingida.
A mensagem de erro que deve ser apresentada se o número máximo de registos for ultrapassado.