Adicionar mapeamentos de transformação para importação
Publicado: janeiro de 2017
Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
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. |
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
Microsoft Dynamics 365
© 2017 Microsoft. Todos os direitos reservados. Direitos autorais