Anveo EDI Connect / Config / Mappings / O conversor TEXT
Esta é uma tradução automática. O post original está disponível em Inglês .

O conversor TEXT

O conversor de texto pode ser usado para importar e exportar arquivos de texto. O conversor suporta arquivos de comprimento fixo, bem como arquivos variáveis (csv). Também é possível converter formatos de dados baseados em registros, como VDA, que possuem um tipo de registro de campo no início de cada registro.

Assumimos que você sabe como trabalhar com linhas de mapeamento e como acessar as propriedades EDI.

Utilização do Assistente

Porque os ficheiros de texto podem ter qualquer estrutura, não podemos detectar o formato de um ficheiro de exemplo. O conversor de texto tem um suporte limitado para gerar o mapeamento a partir de um arquivo de descrição. Para utilizar o assistente, comece por criar um mapeamento e configurar as propriedades do cabeçalho. Em seguida, você pode iniciar o assistente e usar um arquivo CSV, da seguinte estrutura:

Arquivo de estrutura de exemplo para criação de mapeamento de texto

A primeira coluna Name é obrigatória, assim como a linha de cabeçalho. As colunas Length e Type são opcionais. Espera-se que o arquivo esteja no locale atual do Windows e não no Unicode codificado.

Comandos específicos do conversor

Este conversor não suporta comandos.

Importação / Exportação

Vamos discutir as propriedades e características das importações e exportações separadamente.

Importação de dados de texto

Depois de criar o mapeamento, a primeira coisa que você deve fazer é verificar se as propriedades do cabeçalho estão definidas corretamente. Em seguida, você pode começar a criar linhas de mapeamento, usando o assistente, como descrito acima, ou adicionando-as manualmente.

Você pode usar filtros dentro dos loops da tabela de gravação, para criar apenas um registro, se os dados esperados forem fornecidos. Você pode configurar se mais de um filtro for verificado nas propriedades do cabeçalho. Geralmente, isso é usado, por exemplo, para diferenciar entre estruturas diferentes com base em um tipo de registro.

Se você precisar gravar dados em uma tabela, mas não quiser criar mais de um registro, você pode usar a Max. Repeat propriedade do loop. No conversor de texto, definir esta propriedade limitará a contagem de registos que serão escritos. O conversor de texto não irá lançar um erro, se a contagem máxima de repetição for atingida.

Se você precisa criar um registro e não tem um campo correspondente no arquivo, você pode usar um truque: Adicione um campo de comprimento fixo do comprimento 0 como filho da linha da tabela de gravação, para criar um registro, sem depender dos dados reais do arquivo. Por favor, certifique-se de definir o valor da propriedade Max. Repeat para um neste caso, caso contrário o módulo tentará criar um número infinito de registros.

Propriedades do cabeçalho de importação

Direction

Se o usuário deseja importar ou exportar dados. Para importar um ficheiro de texto para o Microsoft Dynamics 365 Business Central, configure-o para Import.

Encoding

A codificação que deve ser usada. Por favor, note que a codificação é limitada

Default

A codificação interna utilizada pelo Microsoft Dynamics 365 Business Central.

Windows-1252

Use a codificação do Windows. Dependendo da instalação Microsoft Dynamics 365 Business Central, pode ser uma página de código diferente da do Windows-1252. Sempre que possível, utilizamos a codificação interna do Microsoft Dynamics 365 Business Central com o nome “Windows”.

MS Dos

Use uma página de código do DOS.

IBM-500

Não suportado em versões mais recentes do Microsoft Dynamics 365 Business Central utilizando o ServiceTier. Uma antiga codificação do mainframe. Não uses mais.

Default Field Type

É possível combinar campos de comprimento fixo e campos separados por um ou mais caracteres de controle no mesmo mapeamento. Esta propriedade especifica o tipo padrão, para que você não tenha que escolhê-la em cada linha de mapeamento.

Fixed Length

O comprimento do campo deve ser especificado e é uma contagem fixa de caracteres.

Variable

O campo é encerrado por um ou mais caracteres de controle.

Default Limiter

Você pode utilizar esta propriedade para especificar valores padrão globais para todo o mapeamento. Você pode substituir essa propriedade em cada linha de mapeamento EDI. Especifica os caracteres de controle que terminam um campo de comprimento variável. Você pode usar todos os caracteres especiais.

Default Length

Você pode utilizar esta propriedade para especificar um comprimento padrão para campos de comprimento fixo. Você pode substituir este valor para cada campo individual.

Alternative Delimiter

É possível especificar um delimitador alternativo para campos de comprimento variável. Cada um dos campos no mapeamento aceitará o delimitador alternativo, bem como o normal. Destina-se principalmente a ser utilizado com formatos, onde o último campo de um ficheiro não tem os caracteres de controlo ou para formatos, onde uma quebra de linha pode ser utilizada em vez dos caracteres de controlo no final de um campo.

Você pode usar todos os caracteres especiais.

Table Check All Children

Este imóvel é novo no Anveo EDI Connect 4.00.
Nas versões anteriores à versão 4.00, esta propriedade só estava disponível internamente e nem sempre correctamente definida.

Você pode definir se o módulo irá aceitar um loop, quando o primeiro filtro foi verificado com sucesso ou se deve verificar se há outros filtros também. Como o conversor de texto não executa a estrutura completa da linha de mapeamento de filhos, a verificação de mais de um filtro deve ser usada com cuidado.

Propriedades da linha de importação

Após criar uma linha de mapeamento EDI, você pode configurar as propriedades. Mostraremos apenas as propriedades das linhas de mapeamento EDI com a propriedade Type definida como Data como as outras propriedades se comportam como em qualquer outro mapeamento.

Field Name

O nome é mostrado na Linha de Mapeamento EDI como a primeira coluna. De um ponto de vista técnico, isso não tem efeito sobre o mapeamento, mas recomendamos que você o defina para o nome do campo de acordo com qualquer documentação que possa estar disponível, ou use um nome significativo para o campo de alguma outra forma.

Field Type

É possível especificar se o campo tem um comprimento fixo ou se está separado por um caractere de controle.

Variable

O campo é encerrado por um ou mais caracteres de controle.

Fixed Length

O campo tem um comprimento fixo.

Delimiter

Este campo só está disponível se a característica Field Type estiver definida como Variable. Especifica os caracteres de controle que terminam um campo de comprimento variável. Você pode usar todos os caracteres especiais.

Alternative Delimiter

Este campo só está disponível se a característica Field Type estiver definida como Variable. Especifica um caractere de controle alternativo que encerra um campo de comprimento variável. Você pode usar todos os caracteres especiais.

Start Escape

Este campo só está disponível se a característica Field Type estiver definida como Variable. Especifica um caractere de escape inicial. Os caracteres de controle que normalmente terminariam o campo de comprimento variável são permitidos entre os caracteres Start Escape e End Escape.

End Escape

Este campo só está disponível se a característica Field Type estiver definida como Variable. Especifica um caractere de escape final. Os caracteres de controle que normalmente terminariam o campo de comprimento variável são permitidos entre os caracteres Start Escape e End Escape.

Length

Este campo só está disponível se a característica Field Type estiver definida como Fixed Length. Especifica a contagem de caracteres que devem ser lidos.

DestExpr

É possível especificar onde o valor do campo deve ser gravado. Pode encontrar mais informações na secção que utiliza a expressão de destino. Discutimos o significado dos filtros nas importações de texto no início da seção de importação neste capítulo.

Not Empty

Se o campo é aceito, se não tiver valor. Você pode usar isso em combinação ou como uma alternativa a um filtro para importar apenas os dados, se um valor estiver presente.

Format Type

É possível selecionar a categoria de dados dos dados a serem importados.

Os seguintes valores estão disponíveis:

Auto

O campo é interpretado automaticamente, com base no tipo de dados de destino.

Date

Os dados são interpretados como uma data. Você pode especificar o formato com a característica Format String

Time

Os dados são interpretados como informações de tempo. Você pode especificar o formato com a característica Format String

Date/Time

Os dados são interpretados como informações de data/hora. Você pode especificar o formato com a característica Format String

Value Translation

Suportado pelo Anveo EDI Connect 4.01 (Adicionado em 4.00.12, mas requer uma reinstalação das opções do módulo)

É altamente recomendável armazenar o valor original sem convertê-lo em uma tabela de buffer.

Às vezes você quer traduzir diretamente um valor importado para outro. Usando esse tipo de formato, os dados são interpretados através de uma conversão de valores. É possível especificar qual conversão deve ser usada usando a propriedade Value Translation.

Format String

Apenas disponível, se a propriedade Format Type estiver definida. Especifica a cadeia de formato de data/hora, como descrito no trabalho com cadeias de formato de data/hora.

Value Translation

Apenas disponível, se a propriedade Format Type estiver definida para o valor Value Translation. Especifica a conversão de valor que deve ser usada para interpretar os dados recebidos. A verificação do comprimento é feita antes, assim você pode truncar o valor antes de traduzi-lo.

Use com cuidado. É recomendável armazenar o valor original em uma tabela de buffer, sempre que possível, e traduzi-lo usando um pós-processamento.

Exportação de dados de texto

Para exportar dados, certifique-se de que a propriedade de cabeçalho de mapeamento Direction esteja definida como Export e configurar as propriedades de cabeçalho primeiro. Em seguida, você pode criar as linhas usando o assistente, como descrito acima, ou adicionar cada linha manualmente.

Propriedades do cabeçalho de exportação

Direction

Se o usuário deseja importar ou exportar dados. Para exportar dados do Microsoft Dynamics 365 Business Central para um ficheiro de texto, defina-o como Export.

Encoding

A codificação que deve ser usada. Por favor, note que a codificação é limitada

Default

A codificação interna utilizada pelo Microsoft Dynamics 365 Business Central.

Windows-1252

Use a codificação do Windows. Dependendo da instalação Microsoft Dynamics 365 Business Central, pode ser uma página de código diferente da do Windows-1252. Sempre que possível, utilizamos a codificação interna do Microsoft Dynamics 365 Business Central com o nome “Windows”.

MS Dos

Use uma página de código do DOS.

IBM-500

Não suportado em versões mais recentes do Microsoft Dynamics 365 Business Central utilizando o ServiceTier. Uma antiga codificação do mainframe. Não uses mais.

Default Field Type

É possível combinar campos de comprimento fixo e campos separados por um ou mais caracteres de controle no mesmo mapeamento. Esta propriedade especifica o tipo padrão, para que você não tenha que escolhê-la em cada linha de mapeamento.

Fixed Length

O comprimento do campo deve ser especificado e é uma contagem fixa de caracteres.

Variable

O campo é encerrado por um ou mais caracteres de controle.

Default Limiter

Você pode utilizar esta propriedade para especificar valores padrão globais para todo o mapeamento. Você pode substituir essa propriedade em cada linha de mapeamento EDI. Especifica os caracteres de controle que terminam um campo de comprimento variável. Você pode usar todos os caracteres especiais.

Default Length

Você pode utilizar esta propriedade para especificar um comprimento padrão para campos de comprimento fixo. Você pode substituir este valor para cada campo individual.

Fallback Communication Channel

Esta propriedade foi renomeada em Anveo EDI Connect 4.00 e o valor é agora opcional. Antes tinhas de definir um valor, mesmo que nunca tivesse sido usado. O nome anterior era Communication Channel. A lógica geral não mudou.

Especifica um EDI Communication Channel que é usado para enviar os dados de saída, se não for especificado antes. Você pode substituir isso a partir de códigos C/AL e AL, mapeamentos anteriores e especificá-lo usando Business Transactions. Esta propriedade é usada apenas como um fallback, se não houver um canal de comunicação definido antes.

Send Channel After Convert

Se os dados devem ser enviados automaticamente após a conversão desse mapeamento. Normalmente é uma boa ideia enviar os dados automaticamente.

Fallback Receiver Partner

Esta propriedade foi renomeada em Anveo EDI Connect 4.00.11 para melhor descrever a funcionalidade. O nome anterior era Receiver Party. A lógica não mudou.


Especifica um EDI Communication Partner que é utilizado como destinatário para dados de saída, se não for especificado anteriormente. Você pode substituir isso a partir de códigos C/AL e AL, mapeamentos anteriores e especificá-lo usando Business Transactions. Esta propriedade só é usada como um fallback, se não for definido um parceiro antes.

Propriedades da linha de exportação

Após criar uma linha de mapeamento EDI, você pode configurar as propriedades. Mostraremos apenas as propriedades das linhas de mapeamento EDI com a propriedade Type definida como Data como as outras propriedades se comportam como em qualquer outro mapeamento.

Field Name

O nome é mostrado na Linha de Mapeamento EDI como a primeira coluna. De um ponto de vista técnico, isso não tem efeito sobre o mapeamento, mas recomendamos que você o defina para o nome do campo de acordo com qualquer documentação que possa estar disponível, ou use um nome significativo para o campo de alguma outra forma.

Field Type

É possível especificar se o campo tem um comprimento fixo ou se está separado por um caractere de controle.

Variable

O campo é encerrado por um ou mais caracteres de controle.

Fixed Length

O campo tem um comprimento fixo.

Delimiter

Este campo só está disponível se a característica Field Type estiver definida como Variable. Especifica os caracteres de controle que terminam um campo de comprimento variável. Você pode usar todos os caracteres especiais.

Start Escape

Este campo só está disponível se a característica Field Type estiver definida como Variable. Especifica um caractere de escape inicial, que será escrito antes dos dados.

End Escape

Este campo só está disponível se a característica Field Type estiver definida como Variable. Especifica um caractere de escape final. Este caráter é escrito após os dados, antes do Delimiter.

Length

Este campo só está disponível se a propriedade Field Type estiver definida como Fixed Length ou se a propriedade Length Validation estiver definida em um campo variável. Especifica a contagem de caracteres que devem ser escritos. Você pode especificar o caractere de preenchimento com a propriedade Pad Char.

SourceExpr

É possível especificar de onde vem o valor. É possível encontrar mais informações na seção que utiliza a expressão de origem.

Format Type

É possível selecionar a categoria de dados dos dados a serem importados.

Os seguintes valores estão disponíveis:

Auto

O campo é formatado automaticamente, com base no tipo de dados de origem.

NAV Format String

Você pode usar uma string de formatação, como você pode usar para o Microsoft Dynamics 365 Business Central build-in AL / C/AL função FORMAT.

Date

Os dados são formatados como uma data. Você pode especificar o formato com a característica Format String

Time

Os dados são formatados como informações de tempo. Você pode especificar o formato com a característica Format String

Date/Time

Os dados são formatados como informações de data/hora. Você pode especificar o formato com a característica Format String

Number

Os dados são formatados como um valor numérico.

Format String

Apenas disponível, se a propriedade Format Type for se to date/time ou NAV format string.

Se a propriedade Format Type estiver definida como NAV Format String, você pode inserir a string de formato, como descrito na ajuda AL / C/AL.

Se definido como data/hora, é possível entrar uma cadeia de formato, como descrito no trabalho com cadeias de formato de data/hora.

Blank Zeros

Se disponível, especifica que os valores vazios devem ser enviados como um campo vazio em vez da representação vazia padrão.

Decimal Character

Apenas disponível, se a propriedade Format Type estiver definida como Number. Especifica qual caractere deve ser usado como separador decimal.

Thousands Separator Character

Apenas disponível, se a propriedade Format Type estiver definida como Number. Se milhares devem ser separados e se, qual caractere deve ser usado.

Max. Decimal Places

Apenas disponível, se a propriedade Format Type estiver definida como Number. A contagem máxima de casas decimais que devem ser emitidas.

Min. Decimal Places

Apenas disponível, se a propriedade Format Type estiver definida como Number. A contagem mínima de casas decimais que devem estar na saída. Isto preencherá automaticamente os lugares em falta com zeros.

Sign

Apenas disponível, se a propriedade Format Type estiver definida como Number. Se deve emitir o sinal positivo/negativo.

Negative Only

Apenas emite o sinal “-“.

Always

Emita o sinal “+” e “-“.

Sign after Value

Apenas disponível, se a propriedade Format Type estiver definida como Number. Se devemos colocar o sinal depois dos números.

Length Validation

Este campo só está disponível se a característica Field Type estiver definida como Variable. As ações possíveis são compartilhadas entre conversores, neste conversor você pode usar um tipo
de campo diferente para campos de comprimento fixo. Os seguintes valores são permitidos:

Ignore

Não verifique o comprimento da saída.

Max (Error)

Criar um erro se o valor for maior do que o permitido.

Max (Truncate with Warning)

Criar um aviso se o valor for maior do que o permitido e truncar a saída para o comprimento permitido.

Max (Truncate)

Truncar o valor, se ele é mais longo do que o permitido.

Max (Truncate…)

Truncar o valor, se ele é mais longo que o permitido e adicionar “…” no final para mostrar que o valor não está completo.

Exact (Error)

Criar um erro se a saída não tiver o comprimento especificado.

Exact (Truncate/Pad with Warning)

Truncar ou preencher o valor, se não tiver o comprimento especificado e criar um aviso.

Exact (Pad)

Criar um erro se o valor for maior do que o permitido. Aumente o valor se for muito curto.

Exact (Truncate/Pad)

Truncar ou rematar o valor para o número de caracteres dado.

Alignment

Este campo só está disponível se a propriedade Field Type estiver definida como Fixed Length ou se
a propriedade Length Validation estiver definida para preencher a saída. Onde a saída deve ser alinhada, se o valor é menor do que a contagem de caracteres para a saída.

Auto

Alinhar dependendo do tipo de dados da expressão de origem.

Left

Esquerda, alinhar o valor. Isto significa que o valor é emitido primeiro e depois o caractere de preenchimento é utilizado para preencher o campo.

Right

Comece com o acolchoamento e saia o valor alinhado à direita.

Pad Character

Este campo só está disponível se a propriedade Field Type estiver definida como Fixed Length ou a propriedade Length Validation estiver definida para preencher a saída. Qual caractere deve ser usado para estofamento, se o valor não for longo o suficiente.