Dynamics 365 Customer Insights (Pré-visualização)
O conector do Dynamics 365 Customer Insights fornece um conjunto de APIs para interagir com instâncias do Dynamics 365 Customer Insights.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL |
Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Editora | Microsoft |
Para se inscrever no Dynamics 365 Customer Insights, clique aqui.
Para utilizar este conector no Power Apps, saiba mais aqui.
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Criar item (Pré-visualização) |
Esta operação cria um item em uma entidade |
| Envia o relatório de status |
Envia o relatório de status. |
| Envia o relatório de status V2 |
Envia o relatório de status V2. |
| Item de atualização (Pré-visualização) |
Esta operação atualiza um item em uma entidade |
| Obter entidades |
Esta operação obtém entidades de uma instância |
| Obter item |
Esta operação obtém um item de uma entidade |
| Obter itens de uma entidade |
Esta operação obtém itens de uma entidade. Dependendo da entidade, os campos podem ser definidos como filtros:
|
| Recuperar dados de uma partição (Visualização) |
Recuperar dados de uma partição. |
| Recuperar partições para uma entidade (Pré-visualização) |
Recuperar partições para uma entidade. |
| Recuperar partições para uma entidade V2 (Pré-visualização) |
Recuperar partições para uma entidade V2. |
Criar item (Pré-visualização)
Esta operação cria um item em uma entidade
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
Identificador de uma instância |
|
entityName
|
table | True | string |
Nome de uma entidade |
|
recordItem
|
item | True | dynamic |
Gravar para criar |
Envia o relatório de status
Envia o relatório de status.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da instância
|
dataset | True | string |
Selecione uma instância. |
|
Tipo de relatório
|
reportType | True | string |
Selecione um tipo de relatório. |
Envia o relatório de status V2
Envia o relatório de status V2.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da instância
|
dataset | True | string |
Selecione uma instância. |
|
Tipo de relatório
|
reportType | True | string |
Selecione um tipo de relatório. |
Item de atualização (Pré-visualização)
Esta operação atualiza um item em uma entidade
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
Identificador de uma instância |
|
entityName
|
table | True | string |
Nome de uma entidade |
|
itemIdentifier
|
id | True | string |
Identificador do item |
|
recordItem
|
item | True | dynamic |
Registo a atualizar |
Devoluções
Obter entidades
Esta operação obtém entidades de uma instância
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
Identificador de uma instância |
Devoluções
Representa uma lista de tabelas.
- Body
- TablesList
Obter item
Esta operação obtém um item de uma entidade
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
Identificador de uma instância |
|
entityName
|
table | True | string |
Nome de uma entidade |
|
itemIdentifier
|
id | True | string |
Identificador do item |
Devoluções
Obter itens de uma entidade
Esta operação obtém itens de uma entidade. Dependendo da entidade, os campos podem ser definidos como filtros:
- Entidade UnifiedActivity: campos ActivityId e CustomerId
- Entidade do cliente: campo CustomerId e quaisquer outros campos indexados na instância do Customer Insights
- Quaisquer outras entidades: campo CustomerId.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
Identificador de uma instância |
|
entityName
|
table | True | string |
Nome de uma entidade |
|
Filtrar consulta
|
$filter | string |
Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Contagem superior
|
$top | integer |
Número total de entradas a recuperar (padrão = todas). |
|
|
Selecionar consulta
|
$select | string |
Campos específicos para recuperar de entradas (padrão = todos). |
Devoluções
Recuperar dados de uma partição (Visualização)
Recuperar dados de uma partição.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
O conjunto de dados do Customer Insights
|
dataset | True | string |
O conjunto de dados do Customer Insights. |
|
A entidade
|
table | True | string |
A entidade. |
|
A referência (URI ou Nome) da partição
|
partitionUri | True | string |
A referência (URI ou Name) da partição. |
|
Uma linha de colunas separada por vírgulas
|
select | string |
Uma linha de colunas separada por vírgula. |
|
|
Posição a partir de onde começar a ler, em bytes
|
offsetStart | integer |
Posicione a partir de onde começar a ler, em bytes. |
|
|
Máximo de bytes para leitura
|
maxSize | integer |
Máximo de bytes para ler. |
|
|
Número máximo de registos a devolver
|
maxResults | integer |
Número máximo de registos a devolver. |
Devoluções
Os dados de uma partição.
Recuperar partições para uma entidade (Pré-visualização)
Recuperar partições para uma entidade.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
O conjunto de dados do Customer Insights
|
dataset | True | string |
O conjunto de dados do Customer Insights. |
|
A entidade
|
table | True | string |
A entidade. |
Devoluções
- response
- array of Table
Recuperar partições para uma entidade V2 (Pré-visualização)
Recuperar partições para uma entidade V2.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
O conjunto de dados do Customer Insights
|
dataset | True | string |
O conjunto de dados do Customer Insights. |
|
A entidade
|
table | True | string |
A entidade. |
|
O valor partitionDisplayName para filtrar
|
partitionDisplayName | string |
O valor partitionDisplayName para filtrar. |
Devoluções
A lista de partições
Acionadores
| Aciona um fluxo da fonte de dados quando a atualização falha |
Esta operação dispara um fluxo da fonte de dados quando a atualização é falhada no Dynamics 365 Customer Insights. |
| Aciona um fluxo da fonte de dados quando a atualização é concluída |
Essa operação dispara um fluxo da fonte de dados quando a atualização é concluída no Dynamics 365 Customer Insights. |
| Aciona um fluxo quando um limite de medida de negócios é ultrapassado |
Essa operação dispara um fluxo quando um limite de medida de negócios é ultrapassado no Dynamics 365 Customer Insights. |
| Aciona um fluxo quando um limite de segmento é ultrapassado |
Esta operação dispara um fluxo quando um limite de segmento é ultrapassado no Dynamics 365 Customer Insights. |
| Aciona um fluxo quando um processo no Customer Insights é concluído |
Um fluxo é acionado para atualizações agendadas do processo selecionado. Além disso, você pode optar por acionar um fluxo para atualizações manuais. |
| Aciona um fluxo quando uma atualização completa do Customer Insights é concluída |
Essa operação dispara um fluxo quando uma atualização completa do Customer Insights (fontes de dados, segmentos, medidas,...) é concluída. |
Aciona um fluxo da fonte de dados quando a atualização falha
Esta operação dispara um fluxo da fonte de dados quando a atualização é falhada no Dynamics 365 Customer Insights.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Meio Ambiente
|
dataset | True | string |
Nome do conjunto de dados. |
Devoluções
DataSourcesList
- Body
- DataSourcesList
Aciona um fluxo da fonte de dados quando a atualização é concluída
Essa operação dispara um fluxo da fonte de dados quando a atualização é concluída no Dynamics 365 Customer Insights.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Meio Ambiente
|
dataset | True | string |
Nome do conjunto de dados. |
Devoluções
DataSourcesList
- Body
- DataSourcesList
Aciona um fluxo quando um limite de medida de negócios é ultrapassado
Essa operação dispara um fluxo quando um limite de medida de negócios é ultrapassado no Dynamics 365 Customer Insights.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome da instância
|
dataset | True | string |
Selecione uma instância. |
|
Nome da Medida de Negócio
|
measure | True | string |
Selecione uma medida. |
|
Limite
|
threshold | True | double |
Defina qualquer número como limite. |
Devoluções
Dados do Business Measure
- Body
- MeasureData
Aciona um fluxo quando um limite de segmento é ultrapassado
Esta operação dispara um fluxo quando um limite de segmento é ultrapassado no Dynamics 365 Customer Insights.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome da instância
|
dataset | True | string |
Selecione uma instância. |
|
Nome do segmento
|
segment | True | string |
Selecione um segmento. |
|
Limite
|
threshold | True | integer |
Defina qualquer número como limite. |
Devoluções
Segmentar dados
- Body
- SegmentData
Aciona um fluxo quando um processo no Customer Insights é concluído
Um fluxo é acionado para atualizações agendadas do processo selecionado. Além disso, você pode optar por acionar um fluxo para atualizações manuais.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome da instância
|
dataset | True | string |
Selecione uma instância. |
|
Processo
|
process | string |
Selecione um processo. |
|
|
Incluir processo acionado manualmente
|
includingManualRefreshes | boolean |
Selecione sim se o processo acionado manualmente deve ser incluído. |
Devoluções
As informações sobre o processo executado
- Body
- ProcessData
Aciona um fluxo quando uma atualização completa do Customer Insights é concluída
Essa operação dispara um fluxo quando uma atualização completa do Customer Insights (fontes de dados, segmentos, medidas,...) é concluída.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome da instância
|
dataset | True | string |
Selecione uma instância. |
Devoluções
As informações sobre a atualização completa executada
Definições
DataSourcesList
DataSourcesList
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
valor
|
value | array of DataSource |
Lista de fontes de dados |
Fonte de dados
DataSource Classe
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
RefreshType
|
RefreshType | string |
O tipo para atualização de dados |
|
RefreshObjectId
|
RefreshObjectId | string |
A id do objeto de atualização |
|
RefreshObjectVersion
|
RefreshObjectVersion | integer |
A versão do objeto de atualização |
|
Funcionamento
|
Operation | string |
O nome da operação |
|
Tipo de trabalho
|
JobType | string |
O tipo de trabalho |
|
ErrorCode
|
ErrorCode | string |
O código de erro durante a atualização de dados. |
|
Mensagem de Erro
|
ErrorMessage | string |
A mensagem de erro durante a atualização |
|
ErrorSeverity
|
ErrorSeverity | string |
A serverity de erro durante a atualização |
|
StartTimeUtc
|
StartTimeUtc | string |
A hora de início da atualização de dados |
|
EndTimeUtc
|
EndTimeUtc | string |
A hora de término da atualização de dados |
SegmentData
Segmentar dados
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome
|
Name | string |
O nome do segmento |
|
Nome de Exibição
|
DisplayName | string |
O nome de exibição do segmento |
|
Data de avaliação
|
EvaluationDate | date-time |
A data de avaliação do segmento |
|
EntityCount
|
EntityCount | integer |
A contagem real de membros do segmento |
|
Limite
|
Threshold | integer |
O limiar do segmento |
MeasureData
Dados do Business Measure
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome
|
Name | string |
O nome da medida |
|
Nome de Exibição
|
DisplayName | string |
O nome de exibição da medida |
|
Data de avaliação
|
EvaluationDate | date-time |
Data de avaliação da medida |
|
Valor
|
Value | double |
O valor da medida |
|
ValueDisplayName
|
ValueDisplayName | string |
O nome para exibição do valor |
|
Limite
|
Threshold | double |
O limiar da medida |
FullRefreshProcessData
As informações sobre a atualização completa executada
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
NumberOfFailedTasks
|
NumberOfFailedTasks | integer |
O número de tarefas com falha |
|
StartTime
|
StartTime | date-time |
A hora de início da etapa do fluxo de trabalho |
|
EndTime
|
EndTime | date-time |
A hora de término da etapa do fluxo de trabalho |
|
Duração
|
Duration | integer |
A duração do processo em minutos |
|
Situação
|
Status | string |
O status da etapa do fluxo de trabalho |
|
StatusPage
|
StatusPage | string |
O link para a página de status |
ProcessData
As informações sobre o processo executado
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
StartTime
|
StartTime | date-time |
A hora de início da etapa do fluxo de trabalho |
|
EndTime
|
EndTime | date-time |
A hora de término da etapa do fluxo de trabalho |
|
Duração
|
Duration | integer |
A duração do processo em minutos |
|
Situação
|
Status | string |
O status da etapa do fluxo de trabalho |
|
StatusPage
|
StatusPage | string |
O link para a página de status |
Table
Representa uma tabela.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome
|
Name | string |
O nome da tabela. O nome é usado em tempo de execução. |
|
Nome de Exibição
|
DisplayName | string |
O nome para exibição da tabela. |
|
DynamicProperties
|
DynamicProperties | object |
Propriedades de tabela adicionais fornecidas pelo conector para os clientes. |
PartitionListResponse
A lista de partições
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Header
|
Header | string |
Cabeçalho contendo os atributos da entidade |
|
Partições
|
Partitions | array of Table |
Lista de partições |
PartitionDataResponse
Os dados de uma partição.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
OffsetStart
|
OffsetStart | integer |
A compensação inicial. |
|
OffsetEnd
|
OffsetEnd | integer |
A compensação final. |
|
Tamanho
|
Size | integer |
O número de dados retornados. |
|
Itens
|
Items | array of object |
O dicionário que contém dados de itens de tamanho máximo de uma partição, de deslocamento 'OffsetStart' para 'OffsetEnd'. |
|
items
|
Items | object |
Lista de Tabelas
Representa uma lista de tabelas.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
valor
|
value | array of Table |
Lista de Tabelas |