Ir para o conteúdo

Conexão do Microsoft SharePoint Server no Jitterbit Studio

Introdução

Uma conexão do Microsoft SharePoint Server, criada usando o conector do Microsoft SharePoint Server, estabelece acesso ao Microsoft SharePoint Server. Essas atividades, uma vez configuradas, interagem com o Microsoft SharePoint Server através da conexão.

Criar ou editar uma conexão do Microsoft SharePoint Server

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

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

Configurar uma conexão do Microsoft SharePoint Server

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

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis do Jitterbit. Comece digitando um colchete de abertura [ no campo ou clique no ícone de variável para exibir um menu listando as variáveis existentes para escolher.

  • Connection name: Digite um nome para identificar a conexão. O nome deve ser único para cada conexão do Microsoft SharePoint Server e não deve conter barras (/) ou dois-pontos (:). Este nome também é usado para identificar o endpoint do Microsoft SharePoint Server, que se refere tanto a uma conexão específica quanto às suas atividades.

  • URL: Digite a URL.

  • SharePoint edition: Selecione a edição do SharePoint, uma das seguintes:

    • SharePoint Online

      • Auth scheme: Selecione o esquema de autorização, um dos seguintes:

        • AzureAD

          • Initiate OAuth: Selecione a configuração do OAuth, uma das seguintes:

            • OFF

              • OAuth access token: Digite o token de acesso do OAuth.

            • REFRESH

              • OAuth access token: Digite o token de acesso do OAuth.

            • GETANDREFRESH

          • OAuth refresh token: Digite o token de atualização do OAuth.

        • AzureServicePrincipalCert

          • Azure tenant: Digite o tenant do Azure.

          • OAuth JWT issuer: Digite o emissor do JWT do OAuth.

          • Initiate OAuth: Selecione a configuração do OAuth, uma das seguintes:

            • OFF

              • OAuth access token: Digite o token de acesso do OAuth.

            • REFRESH

              • OAuth access token: Digite o token de acesso do OAuth.

            • GETANDREFRESH

          • OAuth refresh token: Digite o token de atualização do OAuth.

  • Certificado OAuth JWT: Digite o certificado OAuth JWT.

            -   **Tipo de certificado OAuth JWT:** Selecione o tipo de certificado OAuth JWT, um dos seguintes:

            -   **USER**

            -   **MACHINE**

            -   **PFXFILE**

            -   **PFXBLOB**

            -   **JKSFILE**

            -   **JKSBLOB**

            -   **PEMKEY_FILE**

            -   **PEMKEY_BLOB**

            -   **PUBLIC_KEY_FILE**

            -   **PUBLIC_KEY_BLOB**

            -   **SSHPUBLIC_KEY_FILE**

            -   **SSHPUBLIC_KEY_BLOB**

            -   **P7BFILE**

            -   **PPKFILE**

            -   **XMLFILE**

            -   **XMLBLOB**

            -   **BCFKSFILE**

            -   **BCFKSBLOB**

        -   **Senha do certificado OAuth JWT:** Digite a senha do certificado OAuth JWT.

    -   **AzurePassword**

        -   **Usuário:** Digite o usuário.

        -   **Senha:** Digite a senha.

        -   **Locatário do Azure:** Digite o locatário do Azure.

        -   **ID do cliente OAuth:** Digite o ID do cliente OAuth.

    -   **AzureMSI**

    -   **PingFederate**

        -   **Usuário:** Digite o usuário.

        -   **Senha:** Digite a senha.

        -   **URL de login SSO:** Digite a URL de login SSO.

        -   **Domínio SSO:** Digite o domínio SSO.

        -   **Propriedades SSO:** Digite as propriedades SSO.

    -   **ADFS**

        -   **Usuário:** Digite o usuário.

        -   **Senha:** Digite a senha.

        -   **URL de login SSO:** Digite a URL de login SSO.

        -   **Domínio SSO:** Digite o domínio SSO.

        -   **Propriedades SSO:** Digite as propriedades SSO.

    -   **OneLogin**

        -   **Usuário:** Digite o usuário.

        -   **Senha:** Digite a senha.

        -   **URL de login SSO:** Digite a URL de login SSO.

        -   **Domínio SSO:** Digite o domínio SSO.

        -   **Propriedades SSO:** Digite as propriedades SSO.

    -   **Okta**

        -   **Usuário:** Digite o usuário.

        -   **Senha:** Digite a senha.

        -   **URL de login SSO:** Digite a URL de login SSO.

        -   **Domínio SSO:** Digite o domínio SSO.

        -   **Propriedades SSO:** Digite as propriedades SSO.

    -   **SharePointOAuth**

        -   **ID do cliente OAuth:** Digite o ID do cliente OAuth.

        -   **Segredo do cliente OAuth:** Digite o segredo do cliente OAuth.

    -   **NTLM**

        -   **Usuário:** Digite o usuário.

        -   **Senha:** Digite a senha.

    -   **Basic**

        -   **Usuário:** Digite o usuário.

        -   **Senha:** Digite a senha.

    -   **OAuth**

        -   **Iniciar OAuth:** Selecione a configuração OAuth, uma das seguintes:

            -   **OFF**

                -   **Token de acesso OAuth:** Digite o token de acesso OAuth.

            -   **REFRESH**

                -   **Token de acesso OAuth:** Digite o token de acesso OAuth.

            -   **GETANDREFRESH**

        -   **Token de atualização OAuth:** Digite o token de atualização OAuth.

    -   **OAuthJWT**

        -   **Locatário do Azure:** Digite o locatário do Azure.

        -   **Emissor OAuth JWT:** Digite o emissor OAuth JWT.

        -   **Iniciar OAuth:** Selecione a configuração OAuth, uma das seguintes:

            -   **OFF**

                -   **Token de acesso OAuth:** Digite o token de acesso OAuth.

            -   **REFRESH**

                -   **Token de acesso OAuth:** Digite o token de acesso OAuth.

            -   **GETANDREFRESH**

        -   **Token de atualização OAuth:** Digite o token de atualização OAuth.

        -   **Certificado OAuth JWT:** Digite o certificado OAuth JWT.

  • Tipo de certificado OAuth JWT: Selecione o tipo de certificado OAuth JWT, um dos seguintes:

                -   **USER**

            -   **MACHINE**

            -   **PFXFILE**

            -   **PFXBLOB**

            -   **JKSFILE**

            -   **JKSBLOB**

            -   **PEMKEY_FILE**

            -   **PEMKEY_BLOB**

            -   **PUBLIC_KEY_FILE**

            -   **PUBLIC_KEY_BLOB**

            -   **SSHPUBLIC_KEY_FILE**

            -   **SSHPUBLIC_KEY_BLOB**

            -   **P7BFILE**

            -   **PPKFILE**

            -   **XMLFILE**

            -   **XMLBLOB**

            -   **BCFKSFILE**

            -   **BCFKSBLOB**

        -   **Senha do certificado OAuth JWT:** Digite a senha do certificado OAuth JWT.

    • SharePoint OnPremise

      • Esquema de autenticação: Selecione o esquema de autorização, um dos seguintes:

        • NTLM

          • Usuário: Digite o usuário.

          • Senha: Digite a senha.

        • Negotiate

          • Usuário: Digite o usuário.

          • Senha: Digite a senha.

        • None

        • Basic

          • Usuário: Digite o usuário.

          • Senha: Digite a senha.

        • ADFS

          • Usuário: Digite o usuário.

          • Senha: Digite a senha.

          • URL de login SSO: Digite a URL de login SSO.

          • Domínio SSO: Digite o domínio SSO.

          • Propriedades SSO: Digite as propriedades SSO.

  • Schema: Selecione o schema, um dos seguintes:

    • SOAP

    • REST

    Importante

    A Microsoft está descontinuando a autenticação IDCRL, o que afeta conexões de schema SOAP com o SharePoint Online. Após 1º de maio de 2026, as operações que dependem de conexões usando o schema SOAP do SharePoint Online começarão a falhar. Para migrar:

    1. Crie uma nova conexão configurada com o schema REST.
    2. Defina Esquema de autenticação como uma opção compatível com REST. Para o SharePoint Online, os esquemas suportados incluem AzureAD, AzureServicePrincipalCert, AzurePassword, AzureMSI, SharePointOAuth, ADFS, Okta, PingFederate e OneLogin.
    3. Teste a conexão.
    4. Para cada atividade que usa a conexão SOAP antiga, abra a tela de configuração da atividade, passe o mouse sobre o nome do endpoint para exibir o ícone de edição , clique no menu do endpoint e selecione a nova conexão REST.
    5. Se você tiver problemas ao alternar o endpoint, crie novas atividades a partir do novo endpoint REST do zero e substitua-as manualmente em cada operação onde as atividades antigas foram usadas.
    6. Conclua as etapas de configuração de cada atividade. Como o schema REST expõe tabelas e colunas diferentes do SOAP, revise e atualize as seleções de tabelas e mapeamentos de campos conforme necessário.
    7. Reimplante todas as operações que dependem da conexão e execute-as para validar as atividades atualizadas.
    8. Desative a conexão antiga baseada em SOAP.

    Entre em contato com o suporte Jitterbit para obter assistência.

  • Usar configurações de proxy: Selecione para usar as configurações de proxy do agente privado.

  • Configurações avançadas: Quando selecionado, exibe a tabela Propriedades de configurações avançadas, que é usada para adicionar propriedades de configuração adicionais como pares chave-valor.

    • Adicionar: Adiciona uma linha à tabela. Digite um par chave-valor para cada propriedade.
    • Enviar: Salva o par chave-valor na tabela. Visível ao passar o mouse sobre uma linha no modo de edição.
    • Descartar: Descarta uma nova linha ou qualquer edição feita em uma linha existente. Visível ao passar o mouse sobre uma linha no modo de edição.
    • Editar: Permite editar um par chave-valor existente. Visível ao passar o mouse sobre uma linha existente.
    • Excluir: Exclui a linha da tabela. Visível ao passar o mouse sobre uma linha existente.
    • Limpar tudo: Exclui todas as linhas da tabela.

Nota

Os nomes de colunas e tabelas do Microsoft SharePoint Server podem conter caracteres especiais não suportados por outros serviços. Adicione a propriedade de configuração UseSimpleNames e defina-a como true para impor um esquema de nomenclatura restrito a caracteres alfanuméricos e sublinhado para colunas e tabelas. Caracteres não alfanuméricos são convertidos em sublinhados quando ativado.

Importante

Os campos na tabela Advanced Configurations Properties exibem o ícone de variável apenas no modo de edição. Para que os valores de variáveis desses campos sejam preenchidos em tempo de execução, a versão do agente deve ser pelo menos 10.75 / 11.13.

Os campos na tabela Advanced Configurations Properties não suportam o uso de variáveis para passar JSON bruto. Se seu caso de uso não suporta definir JSON bruto diretamente nos campos, escape o conteúdo JSON antes de passá-lo com uma variável. Por exemplo, escapar {"success": "true"}; se torna {\"success\": \"true\"};.

  • Testar: Clique para verificar a conexão usando a configuração especificada. 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 organizacional Disable Auto Connector Update.

  • 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.

Configurar conexões OAuth

Este conector suporta uma conexão usando OAuth por meio de propriedades de configuração específicas. Após selecionar um esquema de autenticação que inclua Initiate OAuth, você poderá especificar a configuração nos campos exibidos.

Nota

IDs adicionais, segredos, escopos e outros tokens de autenticação podem ser necessários para concluir com êxito a autenticação OAuth. Verifique a documentação do endpoint para obter informações adicionais sobre seus requisitos.

Para este conector, dois cenários são suportados. Em qualquer cenário, você precisará usar uma ferramenta de terceiros (como Postman ou uma ferramenta similar) para obter o token de acesso ou tokens necessários do endpoint envolvido. Ambos esses cenários funcionam apenas para grupos de agentes únicos. Estes são grupos de agentes que consistem em um único agente.

  • Cenário 1: Usando um token de acesso OAuth que expira após um período definido.

    Com esta configuração, você fornece um token de acesso OAuth que dura um período definido, conforme determinado pelo endpoint específico. O conector usará o token para fazer a conexão. No entanto, a conexão não funcionará mais após o token de acesso expirar. Você configuraria o conector para usar o token definindo estas propriedades:

    Propriedade de Configuração Valor
    Initiate OAuth OFF
    OAuth Access Token Defina como o valor do token de acesso OAuth obtido do endpoint

  • Cenário 2: Usando um token de acesso OAuth combinado com um token de atualização OAuth para permitir a atualização automática do acesso.

    Com esta configuração, o conector usará um token de atualização para obter um novo token de acesso após o token de acesso atual expirar. Este é geralmente o melhor método para configurar OAuth.

Você fornece um token de acesso OAuth e um token de atualização OAuth, conforme determinado pelo endpoint específico. Você configuraria o conector para usar esses tokens definindo estas propriedades:

Propriedade de Configuração Valor
Iniciar OAuth REFRESH
Token de Acesso OAuth Defina como o valor do token de acesso OAuth obtido do endpoint
Token de Atualização OAuth Defina como o valor do token de atualização OAuth obtido do endpoint

Nota

Se estiver usando múltiplas conexões OAuth do Microsoft SharePoint Server no mesmo agente privado, defina a propriedade de configuração OAuthSettingsLocation como um caminho de agente exclusivo e gravável para cada conexão. No arquivo jitterbit.conf do agente, defina EnableLocalFileLocation=true. Se você não executar essas duas etapas, as múltiplas conexões usarão o mesmo caminho padrão e sobrescreverão uma à outra.

Próximas etapas

Após criar uma conexão do conector Microsoft SharePoint Server, 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 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 detalhes, consulte Menus de ações em Noções básicas do conector.

Estes tipos de atividade estão disponíveis:

  • Consulta: Recupera registros de uma tabela no Microsoft SharePoint Server e é destinada a ser usada como fonte em uma operação.

  • Criar: Insere um registro em uma tabela no Microsoft SharePoint Server e é destinada a ser usada como destino em uma operação.

  • Atualizar: Atualiza um registro em uma tabela no Microsoft SharePoint Server e é destinada a ser usada como destino em uma operação.

  • Excluir: Exclui um registro de uma tabela no Microsoft SharePoint Server e é destinada a ser usada como destino em uma operação.

  • Executar: Executa um procedimento no Microsoft SharePoint Server e é destinada a ser usada como destino em uma operação.