Criar um Microsoft Dynamics conexão básica usando o Flow Service API
Uma conexão base representa a conexão autenticada entre uma origem e o Adobe Experience Platform.
Este tutorial guiará você pelas etapas para criar uma conexão básica para Microsoft Dynamics (a seguir designado por "Dynamics") usando o Flow Service API.
Introdução
Este manual necessita de uma compreensão funcional dos seguintes componentes da Adobe Experience Platform:
- Origens: o Experience Platform permite que os dados sejam assimilados de várias fontes e, ao mesmo tempo, fornece a capacidade de estruturar, rotular e aprimorar os dados recebidos usando os serviços da plataforma.
- Sandboxes: o Experience Platform fornece sandboxes virtuais que particionam uma única instância da Platform em ambientes virtuais separados para ajudar a desenvolver aplicativos de experiência digital.
As seções a seguir fornecem as informações adicionais que você precisará saber para conectar com êxito o Platform a uma conta do Dynamics usando o Flow Service API.
Coletar credenciais necessárias
A fim de Flow Service para se conectar a Dynamics, você deve fornecer valores para as seguintes propriedades de conexão:
table 0-row-2 1-row-2 2-row-2 3-row-2 | |
---|---|
Credencial | Descrição |
serviceUri |
O URL de serviço do Dynamics instância. |
username |
O nome de usuário do seu Dynamics conta de usuário. |
password |
A senha do Dynamics conta. |
table 0-row-2 1-row-2 2-row-2 | |
---|---|
Credencial | Descrição |
servicePrincipalId |
A ID do cliente do Dynamics conta. Essa ID é necessária ao usar a entidade de serviço e a autenticação baseada em chave. |
servicePrincipalKey |
A chave secreta da entidade de serviço. Essa credencial é necessária ao usar a entidade de serviço e a autenticação baseada em chave. |
Para obter mais informações sobre a introdução, consulte este Dynamics documento.
Uso de APIs da plataforma
Para obter informações sobre como fazer chamadas para APIs da Platform com êxito, consulte o manual em introdução às APIs da Platform.
Crie uma conexão básica
Uma conexão base retém informações entre sua origem e a Platform, incluindo as credenciais de autenticação da origem, o estado atual da conexão e sua ID de conexão base exclusiva. A ID de conexão básica permite explorar e navegar pelos arquivos de dentro da origem e identificar os itens específicos que deseja assimilar, incluindo informações sobre os tipos de dados e formatos.
Para criar um ID de conexão base, faça uma solicitação POST ao /connections
ao fornecer sua Dynamics credenciais de autenticação como parte dos parâmetros de solicitação.
Criar um Dynamics conexão básica
A primeira etapa na criação de uma conexão de origem é autenticar seu Dynamics origem e gere uma ID de conexão básica. Uma ID de conexão básica permite explorar e navegar pelos arquivos de dentro da origem e identificar itens específicos que você deseja assimilar, incluindo informações sobre os tipos de dados e formatos.
Para criar um ID de conexão base, faça uma solicitação POST ao /connections
ao fornecer sua Dynamics credenciais de autenticação como parte dos parâmetros de solicitação.
Formato da API
POST /connections
Para criar um Dynamics conexão básica usando autenticação básica, faça uma solicitação POST ao Flow Service ao fornecer valores para a configuração de serviceUri
, username
, e password
.
accordion | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Solicitação | ||||||||||||||
|
accordion | ||
---|---|---|
Resposta | ||
Uma resposta bem-sucedida retorna a conexão recém-criada, incluindo seu identificador exclusivo (
|
Para criar um Dynamics conexão básica usando autenticação baseada em chave de entidade de serviço, faça uma solicitação POST ao Flow Service ao fornecer valores para a configuração de serviceUri
, servicePrincipalId
, e servicePrincipalKey
.
accordion | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Solicitação | ||||||||||||||
|
accordion | ||
---|---|---|
Resposta | ||
Uma resposta bem-sucedida retorna a conexão recém-criada, incluindo seu identificador exclusivo (
|
Próximas etapas
Ao seguir este tutorial, você criou um Microsoft Dynamics conexão básica usando o Flow Service API. Você pode usar essa ID de conexão básica nos seguintes tutoriais: