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

Artigo
03/29/2023

Nota

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

Select Configurações () na barra de navegação.
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.

Documentos.

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

Grade associada de Documentos.

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.

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.
Vá para Configurações>Personalizações>Soluções.
Criar uma solução (nomeado SharePointDocumentSolution). Para obter mais informações, consulte Criar uma solução.
Escolha Entidades>Adicionar Existente>Entidade> localize e adicione a entidade SharePoint Documento (selecione todos os campos, formulários, exibições).
Selecione Salvar e Fechar.
Publique todas as personalizações.
Selecione a solução criada (SharePointDocumentSolution).
Exporte a solução e escolha o tipo de pacote como "Não gerenciado". SharePointDocumentSolution.zip será baixado.
Extraia o arquivo compactado (arquivo baixado na Etapa 8).
Procure a pasta, localize e abra o customization.xml.
Buscar LayoutXml da grade associada do Documento (buscar por Documento associado).

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>

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.

Salve o arquivo.
Compacte a pasta.
Abra o Dynamics 365 for Customer Engagement.
Navegue para Configurações>Soluções.
Importe a solução (arquivo compactado na Etapa 8).
Publique todas as personalizações.
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.

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.
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.
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.
Para corrigir uma URL, abra o registro do site e digite a URL correta. Mais informações: Criar ou editar registros do site.
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.

Vá para Configurações>Gerenciamento de Documentos>Sites do SharePoint.
Abra o registro Site do SharePoint que foi renomeado e insira a URL Absoluta com a nova URL.
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.

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.
No aplicativo Web, vá para Configurações () >Configurações Avançadas e acesse Configurações>Personalizações>Soluções.
Criar uma solução (nomeado SharePointDocumentSolution). Para obter mais informações, consulte Criar uma solução.
Escolha Entidades>Adicionar Existente>Entidade> localize e adicione a entidade SharePoint Documento (selecione todos os campos, formulários, exibições).
Selecione Salvar e Fechar.
Publique todas as personalizações.
Selecione a solução criada (SharePointDocumentSolution).
Exporte a solução e escolha o tipo de pacote como "Não gerenciado". SharePointDocumentSolution.zip será baixado.
Exclua a solução criada durante a etapa 3 da organização.

Extraia o arquivo compactado da solução exportada (arquivo baixado na Etapa 8).
Na pasta de conteúdo da solução, localize e abra Solution.xml.
Altere o valor a seguir em Solution.xml e salve o arquivo.
De <Managed>0</Managed> para <Managed>1</Managed>.
Na pasta de conteúdo da solução, localize e abra customization.xml.
Procure o elemento <SavedQuery> onde o atributo savedqueryid é igual a "0016f9f3-41cc-4276-9d11-04308d15858d".
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".
Pesquise layoutxml da grade associada do Documento (procure Documento Associado).

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.

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>

De forma semelhante, procure o elemento <SavedQuery> onde o atributo savedqueryid é igual a "a5b008ac-07d9-4554-8509-2c05767bff51".
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".
Pesquise o layoutxml de todo o documento do SharePoint (pesquise Todo o documento do SharePoint).

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>

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>

De forma semelhante, procure o elemento <SavedQuery> onde o atributo savedqueryid é igual a "cb177797-b2ac-42a8-9773-5412321a965c".
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".
Pesquise o layoutxml de todo o documento do OneNote SharePoint (pesquise Todo o documento do OneNote SharePoint).

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>

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>

Salve o arquivo.
Compacte a pasta.
Abra um aplicativo baseado em modelo no Dynamics 365.
Navegue para Configurações>Soluções.
Importe a solução (arquivo compactado na Etapa 8).
Publique todas as personalizações.
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

Compartilhar via

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

Botão Documentos Ausentes - validar e corrigir

Grade associada de Documento Ausente - validar e corrigir

Validar e corrigir URLs de sites do SharePoint

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

FetchXML ou LayoutXML incorreto – validar e corrigir

Confira também

Comentários

Recursos adicionais