Partilhar via


Adicionar mapeamentos de transformação para importação

 

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

Use o mapeamento de transformação para modificar os dados antes de importá-los. Por exemplo, divida o nome completo contido no arquivo de origem em um nome e um sobrenome para corresponder aos atributos do destino de uma entidade.

Para implementar o mapeamento de transformação, use a entidade de mapeamento de transformação (TransformationMapping) e a entidade de mapeamento de parâmetro de transformação (TransformationParameterMapping).

Os dados transformados devem ser compatíveis com os tipos de atributos de entidade Microsoft Dynamics 365.

O tipo de transformação é descrito pela propriedade TransformationMapping.TransformationTypeName. Os valores válidos para essa propriedade são listados na tabela a seguir:

Campo

Valor

AddToCurrentDate

"Microsoft.Crm.Transformations.AddToCurrentDate"

AddToDate

"Microsoft.Crm.Transformations.AddToDate"

AdvancedAddToCurrentDate 

"Microsoft.Crm.Transformations.AdvancedAddToCurrentDate"

AssignValue

"Microsoft.Crm.Transformations.AssignValue"

Concatenate

"Microsoft.Crm.Transformations.Concatenate"

Replace

"Microsoft.Crm.Transformations.Replace"

Split

"Microsoft.Crm.Transformations.Split"

Substring

"Microsoft.Crm.Transformations.Substring"

As seções a seguir descrevem as transformações disponíveis.

Neste tópico

Concatenação

Divisão

Subcadeia de Caracteres

Substituir

Atribuir valor

Adicionar à data

Ajustar data atual e definir horário

Adição avançada à data atual

Concatenação

Concatena cadeias de caracteres e as separa com um delimitador.

Parâmetros de Entrada

Descrição

Prefixo

Cadeia de caracteres que é usada como um prefixo para a cadeia de caracteres concatenada.

Sufixo

Cadeia de caracteres que é usada como um sufixo para a cadeia de caracteres concatenada.

Delimitador

Um caractere ou uma combinação de caracteres que separam subcadeias de caracteres na cadeia de caracteres concatenada. O delimitador não é usado entre o prefixo e a subcadeia de caracteres ou entre o sufixo e a subcadeia de caracteres. Não use o caractere de retrocesso (\b), nova linha (\n) e voltar (\r) como delimitador.

<Variable>

Matriz de comprimento variável que contém subcadeias de caracteres.

Parâmetros de saída

Descrição

Cadeia de caracteres

Cadeia de caracteres concatenada.

Divisão

Separa uma cadeia de caracteres que inclui um delimitador de subcadeias de caracteres. Pode haver até dez subcadeias de caracteres.

Parâmetros de Entrada

Descrição

Cadeia de caracteres de entrada

Cadeia de caracteres que contém uma ou mais subcadeias de caracteres que é separada com delimitadores.

Delimitador

Um caractere ou uma combinação de caracteres que separam subcadeias de caracteres dentro da cadeia de caracteres. Não use o caractere de retrocesso (\b), nova linha (\n) e voltar (\r) ou uma cadeia de caracteres vazia como delimitador.

Parâmetros de saída

Descrição

Variável

Subcadeias de caracteres 1 até o máximo de 10.

Por exemplo, se a cadeia de caracteres de entrada contiver onze subcadeias de caracteres, a de saída contém dez subcadeias de caracteres, conforme mostrado no exemplo a seguir:

Cadeia de caracteres de entrada: a;b;c;d;e;f;g;h;i;j;k

Saída:

t

n

c

d

e

s

g

h

i

j;k

Subcadeia de Caracteres

Retorna uma subcadeia de caracteres de um comprimento especificado, começando em um ponto específico da cadeia de caracteres.

Parâmetros de Entrada

Descrição

Cadeia de caracteres de entrada

Cadeia de caracteres que contém uma subcadeia de caracteres.

Índice de início

Posição inicial da subcadeia de caracteres.

Comprimento

Comprimento da subcadeia de caracteres. Se o comprimento for nulo, retorna uma cadeia de caracteres completa a partir do índice de início.

Parâmetros de saída

Descrição

Subcadeia de Caracteres

Subcadeia de caracteres retornada.

Substituir

Substitui todas as ocorrências de uma cadeia de caracteres especificada por outra cadeia de caracteres especificada.

Parâmetros de Entrada

Descrição

Cadeia de caracteres de entrada

Cadeia de caracteres que contém uma cadeia de caracteres de pesquisa.

Cadeia de caracteres de pesquisa

Cadeia de caracteres de pesquisa. Não use o caractere de retrocesso (\b), nova linha (\n) e voltar (\r) como cadeia de caracteres de pesquisa.

Cadeia de caracteres de substituição

Cadeia de caracteres de substituição. Use uma cadeia de caracteres vazia para remover uma cadeia de caracteres de pesquisa. Não use o caractere de retrocesso (\b), nova linha (\n) e voltar (\r) como cadeia de caracteres de substituição.

Parâmetros de saída

Descrição

Valor

Valor de substituição (mesmo que o valor atribuído).

Atribuir valor

Substitui todos os valores por um valor especificado.

Parâmetros de Entrada

Descrição

Valor

Avaliar que você deseja atribuir.

Parâmetros de saída

Descrição

Valor

Valor de substituição (mesmo que o valor atribuído).

Observação

As transformações de data podem ser usadas apenas para datas corretamente formatadas. Para obter informações sobre como formatar datas, consulte a Ajuda do Microsoft Dynamics 365.

Adicionar à data

Adiciona um número específico de dias, meses e anos a uma data.

Parâmetros de Entrada

Descrição

Data

Cadeia de caracteres de data a ser alterada.

Compensação de ano

Valor positivo ou negativo a ser adicionado ao componente do ano de uma data inserida.

Compensação de mês

Valor positivo ou negativo a ser adicionado ao componente do mês de uma data inserida.

Compensação de dia

Valor positivo ou negativo a ser adicionado ao componente do dia de uma data inserida.

Parâmetros de saída

Descrição

Nova data

Nova cadeia de caracteres de dados que contém dia, mês e ano, adicionados nessa ordem.

Ajustar data atual e definir horário

Adiciona um número especificado de dias, meses e anos à data atual e define a hora especificada. As compensações só podem ser números inteiros.

Parâmetros de Entrada

Descrição

Compensação de ano

Valor positivo ou negativo a ser adicionado ao componente do ano de uma data atual.

Compensação de mês

Valor positivo ou negativo a ser adicionado ao componente do mês de uma data atual.

Compensação de dia

Valor positivo ou negativo a ser adicionado ao componente do dia de uma data atual.

horas

Valor usado para definir o componente de horas da data atual.

minutos

Valor usado para definir o componente de minutos da data atual.

Segundos

Valor usado para definir o componente de segundos da data atual.

Dia da semana

Dia da semana que pode ser segunda-feira, terça-feira, quarta-feira, quinta-feira, sexta-feira, sábado ou domingo. Os dias da semana representados por números inteiros, começando com o decimal 1 para a segunda-feira. Os valores de dias por semana estão contidos na enumeração DayOfWeek. Para obter mais informações sobre esta enumeração, consulte o tópico do MSDN DayOfWeekEnumeration.
Se a data atual calculada não recair no dia da semana especificado, ela será ajustada para a data anterior mais próxima que recair no dia da semana especificado. A data atual é sempre ajustada para uma data no passado.
Por exemplo, se você especificar quarta-feira como um dia da semana, e a data recém calculada for a terça-feira 9 de março, a data é ajustada para a quarta-feira 3 de março.

Parâmetros de saída

Descrição

Nova data

Nova cadeia de caracteres de dados que contém dia, mês e ano, adicionados nessa ordem.

Adição avançada à data atual

Adiciona um número específico de dias, meses e anos à data atual. Você pode especificar se as compensações são relativas à data atual ou são valores absolutos. As compensações só podem ser números inteiros.

Por exemplo, se você usar um valor absoluto de 3 para uma compensação do mês, o mês recém calculado é março. Se você definir uma compensação de mês da data relativa para a atual como 3, e o mês atual for abril, o mês recém calculado é julho.

Parâmetros de Entrada

Descrição

Compensação de ano

Valor positivo ou negativo a ser adicionado ao componente do ano de uma data atual ou ano absoluto.

Modo de compensação de ano

Especifique se a compensação é relativa à data atual ou ao valor absoluto, utilizando o atributo TransformationParameterMapping.Data. Se você estiver usando tipos associados precoces, pode usar a enumeração TransformationOffsetMode para especificar a compensação absoluta ou relativa. Para obter uma lista dos valores DataTypeCode, consulte os valores da lista de seleção para essa entidade.Para exibir os metadados de entidade da sua organização, instale a solução Navegador dos Metadados descrita em Procurar os metadados da sua organização. Também é possível exibir os metadados de uma organização não personalizada no arquivo do Excel chamado EntityMetadata.xlsx, incluído na pasta de nível superior do download do SDK.

Compensação de mês

Valor positivo ou negativo a ser adicionado ao componente do mês de uma data atual ou mês absoluto.

Modo de compensação de mês

Especifique se a compensação é relativa à data atual ou ao valor absoluto, utilizando o atributo TransformationParameterMapping.Data. Se você estiver usando tipos associados precoces, pode usar a enumeração TransformationOffsetMode para especificar a compensação absoluta ou relativa. Para obter uma lista dos valores DataTypeCode, consulte os valores da lista de seleção para essa entidade.

Compensação de dia

Valor positivo ou negativo a ser adicionado ao componente do dia de uma data atual ou dia absoluto.

Modo de compensação de dia

Especifique se a compensação é relativa à data atual ou ao valor absoluto, utilizando o atributo TransformationParameterMapping.Data. Se você estiver usando tipos associados precoces, pode usar a enumeração TransformationOffsetMode para especificar a compensação absoluta ou relativa. Para obter uma lista dos valores DataTypeCode, consulte os valores da lista de seleção para essa entidade.

horas

Valor que define o componente de horas da data atual.

minutos

Valor que define o componente de minutos da data atual.

Segundos

Valor que define o componente de segundos da data atual.

Parâmetros de saída

Descrição

Nova data

Nova cadeia de caracteres de dados que contém dia, mês e ano, adicionados nessa ordem. Em primeiro lugar, os componentes relativos são adicionados e em seguida, os valores absolutos são usados para formar uma data.

Confira Também

Importar dados
Criar mapas de dados para importação
Configurar importação de dados

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais