Solução de problemas da integração do SharePoint

Nota

Se você habilitou o modo somente Interface Unificada, antes de usar os procedimentos neste artigo, faça o seguinte:

1. Select Configurações () na barra de navegação.
2. Selecione Configurações Avançadas.

   

Este tópico explica como corrigir problemas comuns que podem ocorrer com o gerenciamento de documentos do SharePoint.

Botão Documentos Ausentes - validar e corrigir

Se Documentos estiver ausente das entidades como conta, use o seguinte para restaurar.

1. Verifique se você tem direito de acesso de Administrador do Sistema ou permissões equivalentes no Dynamics 365 Customer Engagement (on-premises). Verifique seu direito de segurança:

   1. Siga as etapas em Exibir seu perfil de usuário.
   2. Não possui as permissões corretas? Entre em contato com o administrador do sistema.

2. Corrija o botão Documentos ausente. Siga estas etapas:

   1. Identidade e entidade para os quais os links de documentos devem ser visíveis (por exemplo, conta, contato, oportunidade, etc.).
   2. Vá para Configurações>Configurações de Gerenciamento de Documentos.
   3. Certifique-se de que a entidade na qual deseja ter links de documento (selecionado na Etapa 1) está selecionada e uma URL do SharePoint válida é especificada.
   4. Concluir o assistente.
   5. Verifique se o botão Documentos é exibido.

Para obter mais informações, consulte Habilitar o gerenciamento de documentos do SharePoint para entidades específicas.

Grade associada de Documento Ausente - validar e corrigir

A grade associada de Documentos estiver ausente, use o seguinte para restaurar.

A causa mais comum da grade associada de Documentos não estar carregando é FetchXML e LayoutXML corrompidos. Essas seções podem ser corrompidas por muitos motivos. A mais comum é por meio de personalização da exibição de entidade/grade, adição remoção de colunas e outras personalizações semelhantes.

1. Verifique se você tem direito de acesso de Administrador do Sistema ou permissões equivalentes. Verifique seu direito de segurança: a. Siga as etapas em Exibir seu perfil de usuário. b. Não possui as permissões corretas? Entre em contato com o administrador do sistema.

2. Vá para Configurações>Personalizações>Soluções.

3. Criar uma solução (nomeado SharePointDocumentSolution). Para obter mais informações, consulte Criar uma solução.

4. Escolha Entidades>Adicionar Existente>Entidade> localize e adicione a entidade SharePoint Documento (selecione todos os campos, formulários, exibições).

5. Selecione Salvar e Fechar.

6. Publique todas as personalizações.

7. Selecione a solução criada (SharePointDocumentSolution).

8. Exporte a solução e escolha o tipo de pacote como "Não gerenciado". SharePointDocumentSolution.zip será baixado.

9. Extraia o arquivo compactado (arquivo baixado na Etapa 8).

10. Procure a pasta, localize e abra o customization.xml.

11. Buscar LayoutXml da grade associada do Documento (buscar por Documento associado).

    

12. Faça as alterações a seguir na seção do LayoutXML:

    <layoutxml>
      <grid name="sharepointdocument" jump="fullname" select="1" icon="0" preview="1">
        <row name="sharepointdocument" id="sharepointdocumentid">
          <cell name="fullname" width="300" imageproviderfunctionname="DocumentManagement.FileTypeIcon.loadSharePointFileTypeIcon" imageproviderwebresource="$webresource:SharePoint_main_system_library.js" />
          <cell name="relativelocation" width="200" />
          <cell name="modified" width="150" />
          <cell name="sharepointmodifiedby" width="150" />
          <cell name="sharepointcreatedon" width="300" />
          <cell name="title" ishidden="1" />
          <cell name="readurl" ishidden="1" />
          <cell name="editurl" ishidden="1" />
          <cell name="author" ishidden="1" />
          <cell name="absoluteurl" ishidden="1" />
          <cell name="filetype" ishidden="1" />
          <cell name="ischeckedout" ishidden="1" />
          <cell name="locationid" ishidden="1" />
          <cell name="iconclassname" ishidden="1" />
        </row>
      </grid>
    </layoutxml>
    

13. Faça as alterações a seguir na seção do FetchXml:

    <fetch distinct="false" mapping="logical">
      <entity name="sharepointdocument">
        <attribute name="documentid" />
        <attribute name="fullname" />
        <attribute name="relativelocation" />
        <attribute name="sharepointcreatedon" />
        <attribute name="ischeckedout" />
        <attribute name="filetype" />
        <attribute name="modified" />
        <attribute name="sharepointmodifiedby" />
        <attribute name="servicetype" />
        <attribute name="absoluteurl" />
        <attribute name="title" />
        <attribute name="author" />
        <attribute name="sharepointdocumentid" />
        <attribute name="readurl" />
        <attribute name="editurl" />
        <attribute name="locationid" />
        <attribute name="iconclassname" />
        <order attribute="relativelocation" descending="false" />
        <filter>
          <condition attribute="isrecursivefetch" operator="eq" value="0" />
        </filter>
      </entity>
    </fetch>
    

Importante

Todos os atributos configurados no xml de layout exigem que os respectivos atributos correspondentes sejam apresentados no XML Fetch. A grade resultará em erro quando essa configuração estiver incorreta.

14. Salve o arquivo.
15. Compacte a pasta.
16. Abra o Dynamics 365 for Customer Engagement.
17. Navegue para Configurações>Soluções.
18. Importe a solução (arquivo compactado na Etapa 8).
19. Publique todas as personalizações.
20. Verifique se a grade associada do Documento está sendo exibida em todos os documentos do SharePoint necessários.

Validar e corrigir URLs de sites do SharePoint

No Customer Engagement (on-premises), os registros de locais de documentos e sites do SharePoint contêm links para conjuntos de sites, sites, bibliotecas de documentos e pastas do SharePoint. Esses registros são associados a registros do Customer Engagement (on-premises) de modo que os documentos correspondentes aos registros do Customer Engagement (on-premises) possam ser armazenados no SharePoint.

Quando os links entre o Customer Engagement (on-premises) e o SharePoint são desfeitos, você precisa validar e consertar os links para que os registros do Customer Engagement (on-premises) continuem a apontar para as bibliotecas de documentos e pastas corretas para o gerenciamento dos documentos.

1. Verifique se você tem direito de acesso de Administrador do Sistema ou permissões equivalentes no Microsoft Dynamics 365.

   Verifique seu direito de acesso

   • Siga as etapas em Exibir seu perfil de usuário.

   • Não tem as permissões corretas? Entre em contato com o administrador do sistema.

2. Localize e corrija as URLs. Para fazer isso, siga estas etapas:

   1. Vá para Configurações>Gerenciamento de Documentos.

   2. Clique em SharePointSites.

   3. Selecione as URLs de sites que você deseja validar e clique ou toque em Validar.

3. O Customer Engagement (on-premises) valida todas as URLs de sites selecionadas e as respectivas URLs subordinadas imediatas de bibliotecas de documentos e sites. Em seguida, ele exibe os resultados em Validando Sites.

4. Para corrigir uma URL, abra o registro do site e digite a URL correta. Mais informações: Criar ou editar registros do site.

5. Clique em Salvar e Fechar.

Os usuários recebem a mensagem "Você não tem permissões para visualizar arquivos nesse local"

Essa mensagem de erro pode ocorrer quando o site do SharePoint configurado com gerenciamento de documentos foi renomeado, mas o registro de URL dos sites do SharePoint não foi atualizado para refletir essa alteração.

1. Vá para Configurações>Gerenciamento de Documentos>Sites do SharePoint.

2. Abra o registro Site do SharePoint que foi renomeado e insira a URL Absoluta com a nova URL.

   

3. Selecione Salvar e fechar.

FetchXML ou LayoutXML incorreto – validar e corrigir

O FetchXML ou LayoutXML incorreto pode causar um dos seguintes problemas:

• A grade associada a documentos está ausente
• Não é possível exibir as pastas
• Não é possível exibir os documentos dentro das pastas
• O documento não está sendo excluído
• Mensagem de erro: "O parâmetro necessário é nulo ou indefinido: url" ao abrir a guia documentos
• Mensagem de erro: "System.NullReferenceException" ao carregar um documento
• O documento está sendo baixado, e não aberto em nova guia

É possível que haja muitas causas para que FetchXML ou LayoutXML estejam malformados. A causa mais comum é personalização da exibição de entidade/grade, adição remoção de colunas e outras personalizações semelhantes.

Se FetchXML ou LayoutXML estiverem malformados, use o seguinte para restaurar.

1. Verifique se você tem direito de acesso de Administrador do Sistema ou permissões equivalentes. Verifique seu direito de segurança:

   1. Siga as etapas em Exibir seu perfil de usuário.
   2. Não possui as permissões corretas? Entre em contato com o administrador do sistema.

2. No aplicativo Web, vá para Configurações () >Configurações Avançadas e acesse Configurações>Personalizações>Soluções.

3. Criar uma solução (nomeado SharePointDocumentSolution). Para obter mais informações, consulte Criar uma solução.

4. Escolha Entidades>Adicionar Existente>Entidade> localize e adicione a entidade SharePoint Documento (selecione todos os campos, formulários, exibições).

5. Selecione Salvar e Fechar.

6. Publique todas as personalizações.

7. Selecione a solução criada (SharePointDocumentSolution).

8. Exporte a solução e escolha o tipo de pacote como "Não gerenciado". SharePointDocumentSolution.zip será baixado.

9. Exclua a solução criada durante a etapa 3 da organização.

10. Extraia o arquivo compactado da solução exportada (arquivo baixado na Etapa 8).

11. Na pasta de conteúdo da solução, localize e abra Solution.xml.

12. Altere o valor a seguir em Solution.xml e salve o arquivo.
    De <Managed>0</Managed> para <Managed>1</Managed>.

13. Na pasta de conteúdo da solução, localize e abra customization.xml.

14. Procure o elemento <SavedQuery> onde o atributo savedqueryid é igual a "0016f9f3-41cc-4276-9d11-04308d15858d".

15. Se você não conseguir encontrar uma consulta salva com o ID especificado na etapa anterior, vá para a etapa 19. No entanto, se o elemento <SavedQuery> encontrado na etapa 14 for semelhante a <SavedQuery unmodified="1">, remova o atributo unmodified="n".

16. Pesquise layoutxml da grade associada do Documento (procure Documento Associado).

    

17. Faça as alterações como indicado abaixo para a seção layoutxml:

    <layoutxml>
     <grid name="sharepointdocument" object="9507" jump="fullname" select="1" icon="0" preview="1">
      <row name="sharepointdocument" id="sharepointdocumentid">
            <cell name="fullname" width="300" imageproviderfunctionname="DocumentManagement.FileTypeIcon.loadSharePointFileTypeIcon" imageproviderwebresource="$webresource:SharePoint_main_system_library.js" />
            <cell name="modified" width="150" />
            <cell name="sharepointmodifiedby" width="150" />
            <cell name="locationname" width="150" /> 
            <cell name="relativelocation" width="200" />
            <cell name="servicetype" width="90" />
            <cell name="documentid" ishidden="1" />
            <cell name="title" ishidden="1" />
            <cell name="author" ishidden="1" />
            <cell name="sharepointcreatedon" ishidden="1" />
            <cell name="sharepointdocumentid" ishidden="1" />
            <cell name="filetype" ishidden="1" />
            <cell name="readurl" ishidden="1" />
            <cell name="editurl" ishidden="1" />
            <cell name="ischeckedout" ishidden="1" />
            <cell name="absoluteurl" ishidden="1" />
            <cell name="locationid" ishidden="1" />
            <cell name="iconclassname" ishidden="1" />
      </row>
     </grid>
    </layoutxml>
    

    Importante

    Todos os atributos configurados no xml do layout exigem que seus atributos correspondentes estejam presentes no FetchXML. A grade retornará um erro quando esta configuração estiver incorreta.

18. Faça as alterações a seguir na seção do FetchXml:

    <fetch distinct="false" mapping="logical">
      <entity name="sharepointdocument">
        <attribute name="documentid" />
        <attribute name="fullname" />
        <attribute name="relativelocation" />
        <attribute name="sharepointcreatedon" />
        <attribute name="ischeckedout" />
        <attribute name="filetype" />
        <attribute name="modified" />
        <attribute name="sharepointmodifiedby" />
        <attribute name="servicetype" />
        <attribute name="absoluteurl" />
        <attribute name="title" />
        <attribute name="author" />
        <attribute name="sharepointdocumentid" />
        <attribute name="readurl" />
        <attribute name="editurl" />
        <attribute name="locationid" />
        <attribute name="iconclassname" />
        <attribute name="locationname" /> 
        <order attribute="relativelocation" descending="false" />
        <filter>
          <condition attribute="isrecursivefetch" operator="eq" value="0" />
        </filter>
      </entity>
    </fetch>
    

19. De forma semelhante, procure o elemento <SavedQuery> onde o atributo savedqueryid é igual a "a5b008ac-07d9-4554-8509-2c05767bff51".

20. Se você não conseguir encontrar uma consulta salva com o ID especificado na etapa anterior, vá para a etapa 24. No entanto, se o elemento <SavedQuery> encontrado na etapa 19 for semelhante a <SavedQuery unmodified="1">, remova o atributo unmodified="n".

21. Pesquise o layoutxml de todo o documento do SharePoint (pesquise Todo o documento do SharePoint).

    

22. Faça as alterações como indicado abaixo para a seção layoutxml:

    <layoutxml>
      <grid name="sharepointdocument" jump="fullname" select="1" icon="0" preview="1">
        <row name="sharepointdocument" id="sharepointdocumentid">
          <cell name="fullname" width="300" imageproviderfunctionname="DocumentManagement.FileTypeIcon.loadSharePointFileTypeIcon" imageproviderwebresource="$webresource:SharePoint_main_system_library.js" />
          <cell name="relativelocation" width="200" />
          <cell name="modified" width="150" />
          <cell name="sharepointmodifiedby" width="150" />
          <cell name="sharepointcreatedon" width="300" />
          <cell name="documentid" ishidden="1" />
          <cell name="title" ishidden="1" />
          <cell name="readurl" ishidden="1" />
          <cell name="editurl" ishidden="1" />
          <cell name="author" ishidden="1" />
          <cell name="absoluteurl" ishidden="1" />
          <cell name="sharepointdocumentid" ishidden="1" />
          <cell name="filetype" ishidden="1" />
          <cell name="ischeckedout" ishidden="1" />
          <cell name="locationid" ishidden="1" />
          <cell name="iconclassname" ishidden="1" />
        </row>
      </grid>
    </layoutxml>
    

23. Faça as alterações a seguir na seção do FetchXml:

    <fetch distinct="false" mapping="logical">
      <entity name="sharepointdocument">
        <attribute name="documentid" />
        <attribute name="fullname" />
        <attribute name="relativelocation" />
        <attribute name="sharepointcreatedon" />
        <attribute name="filetype" />
        <attribute name="absoluteurl" />
        <attribute name="modified" />
        <attribute name="sharepointmodifiedby" />
        <attribute name="title" />
        <attribute name="readurl" />
        <attribute name="editurl" />
        <attribute name="author" />
        <attribute name="sharepointdocumentid" />
        <attribute name="ischeckedout" />
        <attribute name="locationid" />
        <attribute name="iconclassname" />
        <filter>
          <condition attribute="isrecursivefetch" operator="eq" value="1" />
        </filter>
        <order attribute="relativelocation" descending="false" />
      </entity>
    </fetch>
    

24. De forma semelhante, procure o elemento <SavedQuery> onde o atributo savedqueryid é igual a "cb177797-b2ac-42a8-9773-5412321a965c".

25. Se você não conseguir encontrar uma consulta salva com o ID especificado na etapa anterior, vá para a etapa 29. No entanto, se o elemento <SavedQuery> encontrado na etapa 24 for semelhante a <SavedQuery unmodified="1">, remova o atributo unmodified="n".

26. Pesquise o layoutxml de todo o documento do OneNote SharePoint (pesquise Todo o documento do OneNote SharePoint).

    

27. Faça as alterações como indicado abaixo para a seção layoutxml:

    <layoutxml>
      <grid name="sharepointdocument" jump="fullname" select="1" icon="0" preview="1">
        <row name="sharepointdocument" id="sharepointdocumentid">
          <cell name="fullname" width="300" imageproviderfunctionname="DocumentManagement.FileTypeIcon.loadSharePointFileTypeIcon" imageproviderwebresource="$webresource:SharePoint_main_system_library.js" />
          <cell name="relativelocation" width="200" />
          <cell name="modified" width="150" />
          <cell name="sharepointmodifiedby" width="150" />
          <cell name="sharepointcreatedon" width="300" />
          <cell name="title" ishidden="1" />
          <cell name="readurl" ishidden="1" />
          <cell name="editurl" ishidden="1" />
          <cell name="author" ishidden="1" />
          <cell name="absoluteurl" ishidden="1" />
          <cell name="filetype" ishidden="1" />
          <cell name="ischeckedout" ishidden="1" />
          <cell name="locationid" ishidden="1" />
          <cell name="iconclassname" ishidden="1" />
        </row>
      </grid>
    </layoutxml>
    

28. Faça as alterações a seguir na seção do FetchXml:

    <fetch distinct="false" mapping="logical">
      <entity name="sharepointdocument">
        <attribute name="documentid" />
        <attribute name="fullname" />
        <attribute name="relativelocation" />
        <attribute name="sharepointcreatedon" />
        <attribute name="filetype" />
        <attribute name="modified" />
        <attribute name="sharepointmodifiedby" />
        <attribute name="title" />
        <attribute name="readurl" />
        <attribute name="editurl" />
        <attribute name="author" />
        <attribute name="absoluteurl" />
        <attribute name="ischeckedout" />
        <attribute name="locationid" />
        <attribute name="iconclassname" />
        <filter type="and">
          <condition attribute="documentlocationtype" operator="eq" value="1" />
          <condition attribute="isrecursivefetch" operator="eq" value="0" />
          <filter type="or">
            <condition attribute="filetype" operator="eq" value="one" />
            <condition attribute="filetype" operator="eq" value="onetoc2" />
          </filter>
        </filter>
        <order attribute="sharepointcreatedon" descending="true" />
      </entity>
    </fetch>
    

29. Salve o arquivo.

30. Compacte a pasta.

31. Abra um aplicativo baseado em modelo no Dynamics 365.

32. Navegue para Configurações>Soluções.

33. Importe a solução (arquivo compactado na Etapa 8).

34. Publique todas as personalizações.

35. Verifique se algum dos problemas associados ao FetchXML ou ao LayoutXML incorreto foi resolvido. Por exemplo, verifique se a grade associada ao documento é exibida em todos os documentos necessários do SharePoint.

Confira também

Solução de problemas de autenticação baseada em servidor