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:
Name;Length;Type
Field 1;0;Variable
Field 2;10;Fixed
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
Se o usuário deseja importar ou exportar dados. Para importar um ficheiro de texto para o Microsoft Dynamics NAV 2016, configure-o para Import.
A codificação que deve ser usada. Por favor, note que a codificação é limitada
A codificação interna utilizada pelo Microsoft Dynamics NAV 2016.
Use a codificação do Windows. Dependendo da instalação Microsoft Dynamics NAV 2016, 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 NAV 2016 com o nome “Windows”.
Use uma página de código do DOS.
Não suportado em versões mais recentes do Microsoft Dynamics NAV 2016 utilizando o ServiceTier. Uma antiga codificação do mainframe. Não uses mais.
É 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.
O comprimento do campo deve ser especificado e é uma contagem fixa de caracteres.
O campo é encerrado por um ou mais caracteres de controle.
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.
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.
É 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.
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.
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.
É possível especificar se o campo tem um comprimento fixo ou se está separado por um caractere de controle.
O campo é encerrado por um ou mais caracteres de controle.
O campo tem um comprimento fixo.
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.
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.
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.
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.
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.
É 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.
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.
É possível selecionar a categoria de dados dos dados a serem importados.
Os seguintes valores estão disponíveis:
O campo é interpretado automaticamente, com base no tipo de dados de destino.
Os dados são interpretados como uma data. Você pode especificar o formato com a característica Format String
Os dados são interpretados como informações de tempo. Você pode especificar o formato com a característica Format String
Os dados são interpretados como informações de data/hora. Você pode especificar o formato com a característica Format String
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.
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.
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
Se o usuário deseja importar ou exportar dados. Para exportar dados do Microsoft Dynamics NAV 2016 para um ficheiro de texto, defina-o como Export.
A codificação que deve ser usada. Por favor, note que a codificação é limitada
A codificação interna utilizada pelo Microsoft Dynamics NAV 2016.
Use a codificação do Windows. Dependendo da instalação Microsoft Dynamics NAV 2016, 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 NAV 2016 com o nome “Windows”.
Use uma página de código do DOS.
Não suportado em versões mais recentes do Microsoft Dynamics NAV 2016 utilizando o ServiceTier. Uma antiga codificação do mainframe. Não uses mais.
É 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.
O comprimento do campo deve ser especificado e é uma contagem fixa de caracteres.
O campo é encerrado por um ou mais caracteres de controle.
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.
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.
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.
Se os dados devem ser enviados automaticamente após a conversão desse mapeamento. Normalmente é uma boa ideia enviar os dados automaticamente.
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.
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.
É possível especificar se o campo tem um comprimento fixo ou se está separado por um caractere de controle.
O campo é encerrado por um ou mais caracteres de controle.
O campo tem um comprimento fixo.
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.
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.
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.
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.
É possível especificar de onde vem o valor. É possível encontrar mais informações na seção que utiliza a expressão de origem.
É possível selecionar a categoria de dados dos dados a serem importados.
Os seguintes valores estão disponíveis:
O campo é formatado automaticamente, com base no tipo de dados de origem.
Você pode usar uma string de formatação, como você pode usar para o Microsoft Dynamics NAV 2016 build-in AL / C/AL função FORMAT.
Os dados são formatados como uma data. Você pode especificar o formato com a característica Format String
Os dados são formatados como informações de tempo. Você pode especificar o formato com a característica Format String
Os dados são formatados como informações de data/hora. Você pode especificar o formato com a característica Format String
Os dados são formatados como um valor numérico.
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.
Se disponível, especifica que os valores vazios devem ser enviados como um campo vazio em vez da representação vazia padrão.
Apenas disponível, se a propriedade Format Type estiver definida como Number. Especifica qual caractere deve ser usado como separador decimal.
Apenas disponível, se a propriedade Format Type estiver definida como Number. Se milhares devem ser separados e se, qual caractere deve ser usado.
Apenas disponível, se a propriedade Format Type estiver definida como Number. A contagem máxima de casas decimais que devem ser emitidas.
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.
Apenas disponível, se a propriedade Format Type estiver definida como Number. Se deve emitir o sinal positivo/negativo.
Apenas emite o sinal “-“.
Emita o sinal “+” e “-“.
Apenas disponível, se a propriedade Format Type estiver definida como Number. Se devemos colocar o sinal depois dos números.
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:
Não verifique o comprimento da saída.
Criar um erro se o valor for maior do que o permitido.
Criar um aviso se o valor for maior do que o permitido e truncar a saída para o comprimento permitido.
Truncar o valor, se ele é mais longo do que o permitido.
Truncar o valor, se ele é mais longo que o permitido e adicionar “…” no final para mostrar que o valor não está completo.
Criar um erro se a saída não tiver o comprimento especificado.
Truncar ou preencher o valor, se não tiver o comprimento especificado e criar um aviso.
Criar um erro se o valor for maior do que o permitido. Aumente o valor se for muito curto.
Truncar ou rematar o valor para o número de caracteres dado.
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.
Alinhar dependendo do tipo de dados da expressão de origem.
Esquerda, alinhar o valor. Isto significa que o valor é emitido primeiro e depois o caractere de preenchimento é utilizado para preencher o campo.
Comece com o acolchoamento e saia o valor alinhado à direita.
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.