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. Uma vez que uma conexão é configurada, é possível 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 uma destas localizações:

• A aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
• A página Endpoints Globais (veja Criar um endpoint global em Endpoints Globais).

Uma conexão existente do Microsoft SharePoint 365 pode ser editada a partir destas localizações:

• A aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
• A aba Componentes do painel do projeto (veja Menu de ações do componente em Aba Componentes do painel do projeto).
• A página Endpoints Globais (veja 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 utilizada 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 (Obsoleto): Esta opção autentica aplicativos usando o modelo de Adição 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: Insira um nome para identificar a conexão. O nome deve ser exclusivo 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 tanto a uma conexão específica quanto às suas atividades.

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

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

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

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

• Aserção do cliente: Insira a aserção do cliente, que pode ser gerada usando uma ferramenta como jwt.io ou utilizando 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, esta configuração pode ser selecionada 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 pelos agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta suspender o download da versão mais recente do conector usando a política organizacional Desativar Atualização Automática do Conector.

• Salvar Alterações: Clique para salvar e fechar a configuração da 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 pede para confirmar que você 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 (veja Dependências de componentes, exclusão e remoção). Uma mensagem pede para confirmar que você deseja excluir a conexão.

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

Se você estiver usando o conector Jitterbit Microsoft SharePoint 365 com autenticação do Azure Access Control Service, recomendamos que você mude para a autenticação do Microsoft Entra ID. Em 2 de abril de 2026, operações que utilizam uma atividade de endpoint do Microsoft SharePoint 365 com autenticação do Azure Access Control Service falharão com erros de autenticação ao fazer solicitações.

Se Azure Access Control Service (Obsoleto) 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 exclusivo 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 tanto a uma conexão específica quanto às 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 do Microsoft SharePoint 365 (descrito em Pré-requisitos).

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

• Tipo de autenticação: Selecione Azure Access Control Service (Obsoleto).

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

• Usar Configurações de Proxy (Apenas Agente Privado): Ao usar um agente privado, esta configuração pode ser selecionada 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 suporta suspender o download da versão mais recente do conector usando a política de organização Desativar Atualização Automática do Conector.

• Salvar Alterações: Clique para salvar e fechar a configuração da 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 pede para você confirmar 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 (veja Dependências de componentes, exclusão e remoção). Uma mensagem pede para você confirmar que 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 personalizada:

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

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

$adminUPN= "" $orgName=""

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

$userCredential set-spotenant -DisableCustomAppAuthentication $false

```

Próximos passos

Após a criação de uma conexão com o Microsoft SharePoint 365, você coloca 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 alvos (para consumir dados em uma operação).

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

Estes tipos de atividade estão disponíveis:

• Carregar Arquivo: Carrega um arquivo PDF ou de texto no Microsoft SharePoint 365 e é destinado a ser usado como um alvo em uma operação.

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

• Atualizar: Atualiza dados de objeto no Microsoft SharePoint 365 e é destinado a ser usado como um alvo em uma operação.

• Criar: Cria dados de objeto no Microsoft SharePoint 365 e é destinado a ser usado como um alvo em uma operação.

• Excluir: Exclui dados de objeto do Microsoft SharePoint 365 e é destinado a ser usado como um alvo em uma operação.