Résoudre les problèmes d’intégration de SharePoint

Cette rubrique explique comment résoudre les problèmes courants qui peuvent se produire avec la gestion des documents SharePoint.

Bouton Documents manquant - valider et corriger

Si Documents est manquant des entités telles que Compte, utilisez les éléments suivants pour restaurer.

1. Assurez-vous de disposer du rôle de sécurité Administrateur système ou d’autorisations équivalentes. Vérifier votre rôle de sécurité : a. Suivez les étapes de la section Affichage de votre profil utilisateur. b. Vous ne disposez pas des autorisations appropriées ? Contactez votre administrateur système.

2. Corriger le bouton Documents manquant. Procédez comme suit :

   1. Identifiez l’entité pour laquelle le lien des documents doit être visible (par exemple Compte, Contact, Opportunité… etc.).
   2. Accédez à Paramètres>Paramètres de gestion des documents.
   3. Vérifiez que l’entité que vous avez souhaité avoir le lien de documents (sélectionné à l’étape 1) est sélectionnée et qu’une URL SharePoint valide est spécifiée.
   4. Terminez l’Assistant..
   5. Vérifiez que le bouton Documents s’affiche.

Pour plus d’informations, voir Activer la gestion des documents SharePoint pour des entités spécifiques.

Malformé FetchXML ou LayoutXML – valider et corriger

Un FetchXML ou LayoutXML mal formé peut provoquer l’un des problèmes suivants :

• Grille associée aux documents manquante
• Impossible d’afficher les dossiers
• Impossible d’afficher les documents dans les dossiers
• Le document n’est pas supprimé
• Message d’erreur - « Le paramètre requis est nul ou non défini : url » lors de l’ouverture de l’onglet documents
• Message d’erreur - « System.NullReferenceException » lors du chargement d’un document
• Document chargé au lieu d’ouvrir le document dans un nouvel onglet

Il peut y avoir de nombreuses raisons pour lesquelles FetchXML ou LayoutXML sont mal formés. La cause la plus courante est la personnalisation de la vue de l’entité/la grille, l’ajout/la suppression de colonnes, et autres personnalisations similaires.

Si FetchXML ou LayoutXML sont mal formés, utilisez ce qui suit pour restaurer.

1. Assurez-vous de disposer du rôle de sécurité Administrateur système ou d’autorisations équivalentes. Vérifier votre rôle de sécurité :

   1. Suivez les étapes de la section Affichage de votre profil utilisateur.
   2. Vous ne disposez pas des autorisations appropriées ? Contactez votre administrateur système.

2. Dans l’application Web, accédez à Paramètres () >Paramètres avancés, accédez à Paramètres>Personnalisations>Solutions.

3. Créez une solution (nommée SharePointDocumentSolution). Pour plus d’informations, voir Créer une solution.

4. Choisissez Entités>Ajouter existant>Entité> recherchez et ajoutez l’entité Document SharePoint (sélectionnez tous les champs, formulaires, vues).

5. Sélectionnez Enregistrer et Fermer.

6. Publiez toutes les personnalisations.

7. Sélectionnez la solution (SharePointDocumentSolution) créée.

8. Exportez la solution et choisissez le type de package « Non gérée ». SharePointDocumentSolution.zip sera téléchargé.

9. Supprimez la solution qui a été créée à l’étape 3 à partir de l’organisation.

10. Extrayez le fichier zip de la solution exportée (fichier téléchargé à l’étape 8).

11. Dans le dossier de contenu de la solution, localisez, puis ouvrez le fichier Solution.xml.

12. Modifiez la valeur suivante dans Solution.xml, puis enregistrez-la.
    De <Managed>0</Managed> à <Managed>1</Managed>.

13. Dans le dossier de contenu de la solution, localisez, puis ouvrez le fichier customization.xml.

14. Recherchez l’élément <SavedQuery> où l’attribut savedqueryid est égal à « 0016f9f3-41cc-4276-9d11-04308d15858d ».

15. Si vous ne trouvez pas une requête enregistrée avec l’ID spécifié à l’étape précédente, passez à l’étape 19. Cependant, si l’élément <SavedQuery> trouvé à l’étape 14 est similaire à <SavedQuery unmodified="1">, supprimez l’attribut unmodified="n".

16. Recherchez le fichier layoutxml de la grille associée au document (recherche de Document associé).

    

17. Apportez les modifications ci-dessous pour la section 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>
    

    Important

    Tous les attributs configurés dans le xml de disposition exigent que leurs attributs respectifs correspondants soient présents dans Fetch XML. La grille renvoie une erreur lorsque cette configuration est incorrecte.

18. Apportez les modifications ci-dessous pour la section 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 même, recherchez l’élément <SavedQuery> où l’attribut savedqueryid est égal à « a5b008ac-07d9-4554-8509-2c05767bff51 ».

20. Si vous ne trouvez pas une requête enregistrée avec l’ID spécifié à l’étape précédente, passez à l’étape 24. Cependant, si l’élément <SavedQuery> trouvé à l’étape 19 est similaire à <SavedQuery unmodified="1">, supprimez l’attribut unmodified="n".

21. Recherchez layoutxml de tous les documents SharePoint (rechercher Tout document SharePoint).

    

22. Apportez les modifications ci-dessous pour la section 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. Apportez les modifications ci-dessous pour la section 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 même, recherchez l’élément <SavedQuery> où l’attribut savedqueryid est égal à « cb177797-b2ac-42a8-9773-5412321a965c ».

25. Si vous ne trouvez pas une requête enregistrée avec l’ID spécifié à l’étape précédente, passez à l’étape 29. Cependant, si l’élément <SavedQuery> trouvé à l’étape 24 est similaire à <SavedQuery unmodified="1">, supprimez l’attribut unmodified="n".

26. Recherchez layoutxml de tous les documents OneNote SharePoint (rechercher Document OneNote SharePoint).

    

27. Apportez les modifications ci-dessous pour la section 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. Apportez les modifications ci-dessous pour la section 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. Enregistrez le fichier.

30. Compressez le dossier.

31. Ouvrez une application pilotée par modèle dans Dynamics 365.

32. Accédez à Paramètres>Solutions

33. Importez la solution (fichier compressé à l’étape 8).

34. Publiez toutes les personnalisations.

35. Vérifiez que tous les problèmes associés au FetchXML ou LayoutXML malformé sont résolus. Par exemple, vérifiez que la grille associée au document s’affiche dans tous les documents SharePoint requis.

Valider et corriger les URL de site SharePoint

Dans les applications d’engagement client (telles que Dynamics 365 Sales et Customer Service), les enregistrements de site et d’emplacement de documents SharePoint contiennent des liens vers des collections de sites, des sites, des bibliothèques de documents et des dossiers dans SharePoint. Ces enregistrements de site et d’emplacement de documents sont associés aux enregistrements pour que les documents associés aux enregistrements puissent être stockés dans SharePoint.

Lorsque les liens entre les applications d’engagement client et SharePoint sont rompus, vous devez valider et corriger ceux-ci afin que les enregistrements continuent à pointer vers les bibliothèques de documents et dossiers pour la gestion des documents.

1. Veillez à bien avoir le rôle de sécurité Administrateur système ou des autorisations équivalentes dans Microsoft Dynamics 365.

   Vérification de votre rôle de sécurité

   • Suivez les étapes de la section Affichage de votre profil utilisateur.

   • Vous ne disposez pas des autorisations appropriées ? Contactez votre administrateur système.

2. Recherchez et corrigez les URL. Pour ce faire, procédez comme suit.

   1. Accédez à Paramètres>Gestion des documents.

   2. Cliquez sur SharePointSites.

   3. Sélectionnez les URL de site à valider, puis cliquez ou appuyez sur Valider.

3. Les applications d’engagement client valident toutes les URL de site sélectionnées ainsi que les URL de leurs bibliothèques de documents et sites subordonnés immédiats. Il affiche ensuite les résultats dans Validation de sites.

4. Pour corriger une URL, ouvrez l’enregistrement de site, puis entrer l’URL. Plus d’informations : Créer ou modifier des enregistrements de site.

5. Cliquez sur Enregistrer et fermer.

Les utilisateurs reçoivent le message « Vous ne disposez pas des autorisations nécessaires pour afficher des fichiers à cet emplacement »

Ce message d’erreur peut se produire lorsque le site SharePoint qui est configuré avec la gestion des documents a été renommé, mais que l’enregistrement de l’URL du site SharePoint n’a pas été mis à jour pour refléter la modification.

1. Accédez à Paramètres>Gestion des documents>Sites SharePoint.

2. Ouvrez l’enregistrement Site SharePoint qui a été renommé et entrez l’URL absolue avec la nouvelle URL.

   

3. Cliquez sur Enregistrer et fermer.

Voir aussi

Résolution des problèmes liés à l’authentification basée sur serveur