Configurar a integração do SharePoint

IMPORTANT
A nova integração do SharePoint foi lançada para produção com a versão 22.3 (julho de 2022). Embora seus usuários ainda possam acessar documentos vinculados por meio da integração herdada do SharePoint, eles devem usar a nova integração do SharePoint para vincular documentos do SharePoint.
  • A nova integração do SharePoint pode não exigir configuração por um administrador e pode ser configurada por usuários individuais. No entanto, para garantir uma transição suave para a nova integração do SharePoint, um administrador do Workfront deve fazer algumas pequenas alterações de configurações na área Configuração do Workfront.

    Para obter informações e instruções, consulte Configurar a integração herdada do SharePoint para acesso contínuo a documentos neste artigo.

  • Recomendamos que os usuários vinculem documentos que estão atualmente vinculados por meio da integração herdada do SharePoint por meio da nova integração.

    Para obter instruções sobre como vincular documentos, consulte Vincular documentos de aplicativos externos.

É possível integrar o Workfront ao SharePoint Online, proporcionando aos usuários a capacidade de navegar, vincular e adicionar documentos do SharePoint no Workfront. A funcionalidade fornecida é semelhante à de outras integrações do Workfront, como Google Drive, Box e Dropbox.

Esta integração é compatível somente com o SharePoint Online. Não há suporte para instâncias locais de SharePoint.

Requisitos de acesso

Expanda para visualizar os requisitos de acesso para a funcionalidade neste artigo.

Você deve ter o seguinte para executar as etapas deste artigo:

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Adobe Workfront plano Qualquer
Adobe Workfront licença

Novo: Padrão

Ou

Atual: Plano

Configurações de nível de acesso* Você deve ser um administrador Workfront.

Para obter mais detalhes sobre as informações nesta tabela, consulte Requisitos de acesso na documentação do Workfront.

Pré-requisitos

Você deve ter qualquer acesso ou permissão necessário no SharePoint para modificar ou configurar sua integração com o SharePoint.

Vincular documentos por meio da nova integração do SharePoint

Usuários individuais podem vincular documentos por meio da nova integração do SharePoint. A integração não requer configuração de administrador. Em vez disso, o usuário faz logon em sua conta do Microsoft ao vincular um documento, o que permite a integração para acessar documentos disponíveis no SharePoint do usuário.

Na primeira vez que um usuário conectar a integração do Workfront SharePoint à sua conta do SharePoint, ele verá e concordará com todas as permissões que o Workfront usa ao interagir com sua conta do SharePoint ou poderá solicitar permissões ao administrador do Microsoft. Permissões de leitura permitem que Workfront veja e acesse arquivos em SharePoint, e permissões de gravação permitem que o usuário carregue arquivos para SharePoint.

Permissões do SharePoint

Para obter instruções sobre como vincular documentos por meio da nova integração do SharePoint, consulte Vincular um documento externo a Workfront

NOTE
  • Dependendo da configuração do Microsoft da organização, os usuários podem ver uma página "Aprovação necessária" em vez de uma página "Permissões solicitadas". Nesse caso, os usuários podem usar essa página para solicitar que o administrador do Microsoft da organização conceda permissões para a integração com o Sharepoint.

  • Uma integração SharePoint pode se conectar a uma única instância SharePoint. Portanto, um usuário pode configurar uma integração para um SharePoint, mas não pode configurar uma integração para um segundo SharePoint, mesmo que tenha permissões para e documentos no segundo SharePoint.

  • Um usuário tem acesso aos mesmos sites, coleções, pastas, subpastas e arquivos por meio da integração do Workfront SharePoint como em sua conta do SharePoint.

Vincular documentos do SharePoint

Para obter instruções sobre como vincular documentos do SharePoint por meio da nova integração do SharePoint, consulte Vincular um documento externo ao Workfront.

Enviar documentos para o SharePoint

Para enviar um documento ao SharePoint:

  1. Clique no ícone Enviar para Enviar para e selecione SharePoint (API gráfica).

  2. (Opcional) Pesquise na barra de pesquisa o site ou pasta para onde deseja enviar o documento.

  3. Selecione o site ou pasta na lista.

    • Os sites estão marcados com ícone do site .

    • As pastas estão marcadas com ícone de Pasta .

    • Os arquivos não são marcados com um ícone.

  4. Clique em Salvar.

Informações de segurança, acesso e autorização para a integração do SharePoint

Autenticação e autorização

Workfront usa OAuth2 para recuperar um token de acesso e um token de atualização. Este token de acesso é usado para autorização em todas as áreas SharePoint.

Acesso e permissões

Na primeira vez que um usuário adiciona um documento do SharePoint para o Workfront, ele é direcionado para a página Permissões solicitadas, onde pode conceder permissões para sua integração com o SharePoint.

NOTE
Dependendo da configuração do Microsoft da organização, os usuários podem ver uma página "Aprovação necessária" em vez de uma página "Permissões solicitadas". Nesse caso, os usuários podem usar essa página para solicitar que o administrador do Microsoft da organização conceda permissões para a integração com o Sharepoint.

As seguintes permissões são solicitadas:

Acesso
Motivo
Ter acesso total aos seus arquivos
Permite que Workfront acesse os arquivos de um usuário para vincular ativos. Quando os documentos são enviados de Workfront para SharePoint, Workfront requer acesso para criar o ativo.
Ler itens em todos os conjuntos de sites
Permite que Workfront leia os ativos para habilitar a navegação do usuário.
Editar ou excluir itens em todos os conjuntos de sites
Permite que Workfront crie ativos em sites e conjuntos de sites. Excluir é usado somente ao limpar após tentativas malsucedidas de link.
Manter acesso aos dados aos quais você concedeu acesso
Permite que Workfront gere um token de atualização.
Entrar e ler o perfil do usuário
Permite que Workfront use o token de acesso para agir em nome do usuário, por meio do fluxo de logon OAuth2.
  • Esse acesso é concedido pelo usuário na primeira vez que ele usa a integração e pode ser revogado a qualquer momento.
  • As permissões solicitadas para esta integração são de permissões delegadas.
  • Workfront solicita o acesso mínimo necessário para executar operações na integração.
  • O acesso para exibir, editar ou excluir um documento do Adobe Workfront vinculado ao SharePoint é baseado no acesso do usuário no Workfront. No entanto, qualquer navegação, download ou edição de um arquivo ou pasta SharePoint requer acesso a SharePoint, e o acesso a essas ações é controlado por SharePoint.
  • Os usuários podem exibir miniaturas e visualizar imagens originadas em SharePoint, e podem ver nomes de arquivos e pastas em SharePoint, sem fazer logon em SharePoint.
  • O token de acesso de um usuário é usado somente quando ele está offline e outro usuário exibe o conteúdo de uma pasta vinculada a Workfront. O token de acesso é usado para descobrir se algum documento na pasta foi adicionado, removido ou editado.

Segurança

Toda a comunicação entre Workfront e SharePoint é conduzida por HTTPS, que criptografa as informações.

Workfront não armazena, copia ou duplica dados de SharePoint. A única exceção é que Workfront armazena miniaturas de SharePoint para exibição na exibição de lista e na Pré-visualização.

Se um ativo foi carregado pela primeira vez para Workfront e enviado para SharePoint, Workfront retém os dados do primeiro arquivo porque os usuários podem baixar uma versão anterior de um documento Workfront. Se um documento foi criado em SharePoint, Workfront não armazena esses dados de arquivo.

Configure a integração herdada SharePoint para obter acesso contínuo aos documentos

Para garantir que seus usuários tenham acesso contínuo a documentos vinculados ao Workfront por meio da integração herdada do SharePoint, você deve reconfigurar o acesso à integração herdada do SharePoint e manter o Segredo do Cliente do SharePoint atualizado.

Reconfigurar o acesso à integração herdada SharePoint

A reconfiguração da integração herdada SharePoint permite que seus usuários acessem documentos vinculados por meio da integração herdada SharePoint, garantindo que seus usuários não possam vincular novos documentos por meio dessa integração.

NOTE
  • A integração herdada SharePoint é rotulada como "SharePoint".
  • A nova integração SharePoint é rotulada como "SharePoint (API gráfica)."
  1. Clique no ícone Menu Principal Menu Principal no canto superior direito do Adobe Workfront ou (se disponível) clique no ícone Menu Principal Menu Principal no canto superior esquerdo e clique no ícone Instalação Instalação .
  2. Selecione Documentos na navegação à esquerda e Provedores de nuvem.
  3. Verifique se as opções SharePoint e SharePoint (API gráfica) estão habilitadas.
  4. Clique em Salvar.
  5. Selecione Documentos na navegação à esquerda e SharePointIntegração.
  6. Selecione a marca de seleção à esquerda da lista para todas as integrações existentes e selecione Desativar.

Configure o Segredo do Cliente para obter acesso contínuo à integração herdada SharePoint

O segredo do cliente SharePoint expira uma vez por ano. Para garantir o acesso contínuo aos documentos na integração herdada do SharePoint, mantenha o Segredo do Cliente do SharePoint atualizado.

IMPORTANT
Como os Segredos do Cliente SharePoint são manipulados por Microsoft, os recursos e procedimentos do Segredo do Cliente podem ser alterados com base nas atualizações para SharePoint feitas por Microsoft. Sempre verifique a documentação do Microsoft para obter as informações mais recentes sobre procedimentos e recursos no SharePoint.
  1. Gere um novo segredo de cliente conforme descrito em Substituir um segredo de cliente que está expirando em um SharePoint Suplemento.
  2. Copiar este Segredo do Cliente para um local seguro.
  3. Entre em Workfront como administrador.
  4. No Workfront, clique no ícone Menu Principal Menu Principal no canto superior direito do Adobe Workfront ou (se disponível) clique no ícone Menu Principal Menu Principal no canto superior esquerdo e clique no ícone Instalação Instalação .
  5. No painel esquerdo, clique em Documentos > SharePointIntegração.
  6. Clique na integração SharePoint que deseja atualizar e em Editar.
  7. Localize a seção Informações de Conexão da janela de edição e digite o novo Segredo do Cliente no campo Segredo do Cliente do SharePoint.
  8. Clique em Salvar.

Solução de problemas

Problema: os usuários experimentam erros baseados em autenticação ao usar a integração SharePoint. problem-users-experience-authentication-based-errors-when-using-the-sharepoint-integration

Soluções:

Os usuários devem ter as permissões apropriadas para o site SharePoint.

Os usuários com acesso de Controle Total têm todas as permissões necessárias para a integração com o SharePoint. Se não quiser conceder acesso de Controle total aos usuários, você deverá conceder as seguintes permissões:

Design
Pode exibir, adicionar, atualizar, excluir, aprovar e personalizar
Editar
Pode adicionar, editar e excluir listas; pode exibir, adicionar, atualizar e excluir itens de lista e documentos
Contribute
Pode exibir, adicionar, atualizar e excluir itens de lista e documentos
Somente exibição
Pode exibir páginas, itens de lista e documentos (tipos de documento com manipuladores de arquivo do lado do servidor podem ser exibidos no navegador, mas não baixados)

Para obter instruções sobre como criar e editar níveis de permissão, consulte Como criar e editar níveis de permissão na documentação do Microsoft.

Problema: ao tentar procurar arquivos SharePoint em Workfront, não vejo nenhum ou todos os meus conjuntos de sites. problem-when-attempting-to-browse-sharepoint-files-in-workfront-i-do-not-see-any-or-all-of-my-site-collections

Soluções:

Para ver um conjunto de sites em Workfront, as seguintes condições devem ser atendidas:

  • O usuário deve ter acesso de visualização ao conjunto de sites em SharePoint.

    Para verificar isso em SharePoint, verifique as permissões do conjunto de sites no SharePoint.

Problema: Não consigo acessar pastas e documentos vinculados anteriormente em SharePoint. problem-i-cannot-access-previously-linked-folders-and-documents-in-sharepoint

Solução:

Se o usuário que vinculou uma pasta do SharePoint não puder mais se autenticar, o Workfront não poderá mais acessar o conteúdo da pasta. Isso pode acontecer, por exemplo, se o usuário que originalmente vinculou a pasta sair da empresa.

Para garantir acesso contínuo, um usuário com acesso à pasta deve vincular novamente a pasta.

Para obter informações sobre como vincular pastas de provedores externos, consulte Vincular documentos de aplicativos externos.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43