Conexão do Microsoft SharePoint 365 no Jitterbit Studio

Introdução

Uma conexão do Microsoft SharePoint 365, criada usando o conector do Microsoft SharePoint 365, estabelece acesso ao Microsoft SharePoint 365. Após configurar uma conexão, você pode criar instâncias de atividades do Microsoft SharePoint 365 associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Criar ou editar uma conexão do Microsoft SharePoint 365

Uma nova conexão do Microsoft SharePoint 365 é criada usando o conector do Microsoft SharePoint 365 a partir de um destes locais:

• A guia Endpoints e conectores do projeto da paleta de componentes de design (consulte Paleta de componentes de design).
• A página Endpoints globais (consulte Criar um endpoint global em Endpoints globais).

Uma conexão existente do Microsoft SharePoint 365 pode ser editada a partir destes locais:

• A guia Endpoints e conectores do projeto da paleta de componentes de design (consulte Paleta de componentes de design).
• A guia Componentes do painel do projeto (consulte Menu de ações de componentes em Guia Componentes do painel do projeto).
• A página Endpoints globais (consulte Editar um endpoint global em Endpoints globais).

Configurar uma conexão do Microsoft SharePoint 365

Cada elemento da interface do usuário da tela de configuração da conexão do Microsoft SharePoint 365 é descrito abaixo.

A interface usada na configuração da conexão depende do Tipo de autenticação selecionado:

• Microsoft Entra ID: Esta opção autentica aplicativos registrados no Microsoft Entra ID (anteriormente conhecido como Azure Active Directory ou Azure AD).

• Serviço de Controle de Acesso do Azure (Descontinuado): Esta opção autentica aplicativos usando o modelo de Suplemento do SharePoint e o Serviço de Controle de Acesso do Azure (ACS).

Microsoft Entra ID

Se Microsoft Entra ID for selecionado como o Tipo de autenticação, a interface descrita abaixo será apresentada.

• Nome da conexão: Digite um nome para identificar a conexão. O nome deve ser único para cada conexão do Microsoft SharePoint 365 e não deve conter barras / ou dois-pontos :. Este nome também é usado para identificar o endpoint do Microsoft SharePoint 365, que se refere a uma conexão específica e suas atividades.

• URL do locatário do Office 365: Digite a URL do locatário do Microsoft Office 365.

• ID do cliente: Digite o ID do cliente do aplicativo do Microsoft SharePoint 365 (descrito em Pré-requisitos).

• ID do locatário: Digite o ID do locatário (descrito em Pré-requisitos).

• Tipo de autenticação: Selecione Microsoft Entra ID.

• Asserção do cliente: Insira a asserção do cliente, que pode ser gerada usando uma ferramenta como jwt.io ou usando a função CreateJwtToken em um script Jitterbit.

• Escopo: Insira o escopo OpenID Connect neste formato: https://jbexample.sharepoint.com/.default.

• Usar configurações de proxy (apenas agente privado): Ao usar um agente privado, é possível selecionar esta configuração para usar as configurações de proxy do agente privado.

• Testar: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector oferece suporte à suspensão do download da versão mais recente do conector usando a política organizacional Desabilitar atualização automática do conector.

• Salvar: Clique para salvar e fechar a configuração de conexão.

• Descartar alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem solicita que você confirme que deseja descartar as alterações.

• Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme que deseja excluir a conexão.

Serviço de Controle de Acesso do Azure (Descontinuado)

Se Serviço de Controle de Acesso do Azure (Descontinuado) for selecionado como o Tipo de autenticação, a interface descrita abaixo será apresentada.

• Nome da conexão: Insira um nome para identificar a conexão. O nome deve ser único para cada conexão do Microsoft SharePoint 365 e não deve conter barras / ou dois-pontos :. Este nome também é usado para identificar o endpoint do Microsoft SharePoint 365, que se refere a uma conexão específica e suas atividades.

• URL do locatário do Office 365: Insira a URL do locatário do Microsoft Office 365.

• ID do cliente: Insira o ID do cliente para o aplicativo Microsoft SharePoint 365 (descrito em Pré-requisitos).

• ID do locatário: Insira o ID do locatário.

• Tipo de autenticação: Selecione Serviço de Controle de Acesso do Azure (Descontinuado).

• Segredo do cliente: Insira o segredo do cliente para o aplicativo Microsoft SharePoint 365 (descrito em Pré-requisitos).

• Usar Configurações de Proxy (Apenas Agente Privado): Ao usar um agente privado, é possível selecionar essa configuração para usar as configurações de proxy do agente privado.

• Testar: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector oferece suporte à suspensão do download da versão mais recente do conector usando a política organizacional Desabilitar Atualização Automática de Conector.

• Salvar: Clique para salvar e fechar a configuração de conexão.

• Descartar alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem solicita que você confirme se deseja descartar as alterações.

• Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme se deseja excluir a conexão.

Possível erro de conexão

Se você receber este erro ao testar a conexão, execute o seguinte script no PowerShell para habilitar a autenticação de aplicativo personalizado:

{"error":"invalid_request","error_description":"Token type is not allowed."}

Install-Module -Name Microsoft.Online.SharePoint.PowerShell

$adminUPN= "<the full email address of the SharePoint administrator account, example: jan@mydomain.onmicrosoft.com>" $orgName="<mydomain>"

$userCredential = Get-Credential -<the username of the SharePoint administrator account> $adminUPN -Message "<the password of the SharePoint administrator account>" Connect-SPOService -Url https://$orgName-admin.sharepoint.com -Credential

$userCredential set-spotenant -DisableCustomAppAuthentication $false

Próximas etapas

Após criar uma conexão do Microsoft SharePoint 365, coloque um tipo de atividade na tela de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

As ações de menu para uma conexão e seus tipos de atividade são acessíveis no painel do projeto e na paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

Estes tipos de atividade estão disponíveis:

• Upload de Arquivo: Faz upload de um arquivo PDF ou de texto para o Microsoft SharePoint 365 e é destinado a ser usado como destino em uma operação.

• Consulta: Consulta dados de objeto no Microsoft SharePoint 365 e é destinada a ser usada como fonte em uma operação.

• Atualizar: Atualiza dados de objeto no Microsoft SharePoint 365 e é destinada a ser usada como destino em uma operação.

• Criar: Cria dados de objeto no Microsoft SharePoint 365 e é destinada a ser usada como destino em uma operação.

• Excluir: Exclui dados de objeto do Microsoft SharePoint 365 e é destinada a ser usada como destino em uma operação.