Поділитися через

Виправлення несправностей інтеграції з SharePoint

  • Стаття

Нотатка

Якщо ви ввімкнули режим лише єдиного інтерфейсу, перед використанням процедур, описаних у цій статті, виконайте такі дії:

  1. Виберіть Налаштування( Піктограма шестірні.) на панелі навігації.
  2. Виберіть Додаткові параметри.

    Розширені налаштування.

У цьому розділі описано вирішення загальних проблем, які можуть виникнути з керуванням документами SharePoint.

Кнопка "Відсутні документи" - перевірте та виправте

Якщо Документи відсутні в сутностях, такі як бізнес-партнери, використовуйте зазначені нижче дії для відновлення.

Документи.

  1. Переконайтеся, що ви маєте роль безпеки "Системний адміністратор" або еквівалентний дозвіл у Dynamics 365 Customer Engagement (on-premises). Перевірка вашої ролі безпеки:

    1. Дотримуйтесь інструкцій, наведених у розділі Перегляд профілю користувача.
    2. Немає відповідних дозволів? Зверніться до системного адміністратора.

  2. Виправте відсутню кнопку Документи. Виконайте такі кроки.

    1. Визначте сутність, для якої посилання на документи має відображатися (бізнес-партнера, контактної особи, потенційної угоди... тощо).
    2. Виберіть Параметри>Параметри керування документами.
    3. Переконайтеся, що сутності, з якими мають бути зв’язані ваші документи (вибрані на кроці 1), вибрано і для них вказано дійсну URL-адресу SharePoint.
    4. Дотримуйтесь вказівок майстра.
    5. Перевірте, чи відобразиться кнопка Документи.

Для докладніших відомостей див. Увімкнення або вимкнення керування документами SharePoint для певних сутностей.

Пов'язана сітка "Відсутній документ" - перевірте та виправте

Якщо пов'язаної сітки документів нема, використовуйте для відновлення вказані нижче.

Документи, пов’язані з сіткою.

Найпоширенішою причиною того, що сітка пов’язана з документами не завантажується, є пошкоджена FetchXML та LayoutXML. Ці розділи може бути пошкоджено через кілька причин. Найбільш поширена з них передається через настроювання подання сутності/сітки, додавання/видалення стовпців та інші аналогічні настроювання.

  1. Переконайтеся, що маєте роль безпеки «Системний адміністратор» або еквівалентний дозвіл. Перевірка вашої ролі безпеки: a. Дотримуйтесь інструкцій, наведених у розділі Перегляд профілю користувача. б. Немає відповідних дозволів? Зверніться до системного адміністратора.

  2. Перейдіть до розділу Налаштування>Налаштування>Рішення.

  3. Створення рішення (під назвою SharePointDocumentSolution). Щоб отримати докладнішу інформацію, перегляньте статтю Створення рішення.

  4. Виберіть Сутності>Додати наявні>Сутність> > знайдіть і додайте сутність Документ SharePoint (виберіть усі поля, форми, подання).

  5. Виберіть Зберегти й Закрити.

  6. Опублікувати всі настроювання.

  7. Виберіть створене рішення (під назвою SharePointDocumentSolution).

  8. Експортуйте рішення та виберіть тип пакета "Некерований". SharePointDocumentSolution.zip буде завантажено.

  9. Видобування zip-файлу (завантаженого файлу з кроку 8).

  10. Перейдіть до папки, знайдіть і відкрийте customization.xml.

  11. Пошук LayoutXml пов’язаної сітки документа (пошук Document Associated).

    Пошук пов’язаного документа.

  12. Внесіть зміни, як нижче для розділу 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. Внесіть зміни, як нижче для розділу 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>

Важливо

Для всіх атрибутів, налаштованих в xml макета, обов’язково повинні бути наявні відповідні атрибути в Fetch XML. Сітка відобразить помилку, якщо ця конфігурація буде невірною.

  1. Збережіть файл.
  2. Спакуйте папку в Zip.
  3. Відкрийте Dynamics 365 for Customer Engagement.
  4. Натисніть Параметри>Рішення
  5. Імпортуйте рішення (заархівований файл на кроці 8).
  6. Опублікувати всі настроювання.
  7. Перевірте, чи пов'язана сітка "Документ" відображається у всіх необхідних документах SharePoint.

Перевірка та виправлення URL-адрес сайтів SharePoint

Записи Customer Engagement (on-premises) SharePoint про розташування сайтів і документів містять посилання на колекції сайтів, сайти, бібліотеки документів і папки в SharePoint. Ці записи сайтів і місць розташування документів пов’язані із Customer Engagement (on-premises) записами, щоб документи для Customer Engagement (on-premises) записів можна було зберігати в. SharePoint

Коли зв’язки між Customer Engagement (on-premises) ними розриваються SharePoint , необхідно перевірити та виправити зв’язки, щоб записи Customer Engagement (on-premises) продовжували вказувати на правильні бібліотеки документів і папки для керування документами.

  1. Переконайтеся, що ви маєте роль безпеки «Системний адміністратор» або еквівалентний дозвіл у Microsoft Dynamics 365.

    Перевірка вашої ролі безпеки

  2. Пошук і та виправлення URL-адрес. Для цього виконайте такі кроки.

    1. Виберіть Параметри>Керування документами.

    2. Натисніть кнопку SharePoint Місця.

    3. Виберіть URL-адреси сайтів, які необхідно перевірити, потім натисніть Перевірити.

  3. У програмі Customer Engagement (on-premises) перевірте всі вибрані URL-адреси сайтів та їх безпосередньо підлеглих сайтів, а також URL-адреси бібліотек документів. Результати відобразяться в діалоговому вікні Перевірка місць.

  4. Щоб виправити URL, відкрийте запис місця і введіть правильний URL. Додаткові відомості: Створення або редагування записів сайтів.

  5. Натисніть «Зберегти та закрити».

Користувачі отримують повідомлення «У вас немає дозволів на перегляд файлів у цьому розташуванні»

Це повідомлення про помилку може з’являтися, якщо сайт SharePoint, налаштований для керування документами, було перейменовано, але URL-адреси сайтів SharePoint не було оновлено, щоб врахувати ці зміни.

  1. Перейдіть до Параметри>Керування документами>Сайти SharePoint.

  2. Відкрийте запис Сайт SharePoint, який було перейменовано, і введіть нову URL-адресу в поле Абсолютна URL-адреса.

    Введіть відносну SharePoint URL-адресу.

  3. Виберіть Зберегти та закрити.

Malformed FetchXML або LayoutXML - перевірте та виправте

Неправильно сформований FetchXML або LayoutXML може спричинити будь-яку з наступних проблем:

  • Відсутня пов’язана з документами сітка
  • Не вдалося переглянути папки
  • Не вдалося переглянути документи в папках
  • Документ не видаляється
  • Повідомлення про помилку – "Обов’язковий параметр нульовий або не визначений: URL-адреса" – під час відкриття вкладки документів
  • Повідомлення про помилку – "Система. Виняток нульового посилання" – під час вивантаження документа
  • Документ завантажується замість відкриття в новій вкладці

Може бути багато причин для FetchXML неправильного форматування або LayoutXML. Найбільш поширеною причиною є налаштування вигляду сутності/сітки, додавання/видалення стовпців та інші схожі налаштування.

Якщо FetchXML або LayoutXML неправильно сформовані, скористайтеся наступними способами для відновлення.

  1. Переконайтеся, що маєте роль безпеки «Системний адміністратор» або еквівалентний дозвіл. Перевірка вашої ролі безпеки:

    1. Виконайте дії, зазначені в статті Перегляд профілю користувача.
    2. У вас немає відповідних дозволів? Зверніться до системного адміністратора.

  2. У веб-додатку перейдіть до Налаштування( Параметри.) >Розширені налаштування, перейдіть до Налаштування>Налаштування>Рішення.

  3. Створення рішення (під назвою SharePointDocumentSolution). Додаткові відомості, див. Створення рішення.

  4. Виберіть Сутності>Додати наявні>Сутність> > знайдіть і додайте сутність Документ SharePoint (виберіть усі поля, форми, подання).

  5. Виберіть Зберегти й Закрити.

  6. Опублікувати всі настроювання.

  7. Виберіть створене рішення (під назвою SharePointDocumentSolution).

  8. Експортуйте рішення та виберіть тип пакета "Некерований". SharePointDocumentSolution.zip буде завантажено.

  9. Видаліть рішення, створене на кроці 3 з організації.

  1. Витягніть zip-файл експортованого рішення (завантажений файл з кроку 8).

  2. У папці вмісту рішення знайдіть та відкрийте файл Solution.xml.

  3. Змініть наступне значення у файлі Solution.xml та збережіть файл.
    З <Managed>0</Managed> на <Managed>1</Managed>.

  4. У папці вмісту рішення знайдіть та відкрийте файл customization.xml.

  5. Виконайте пошук елемента <SavedQuery> з таким значенням атрибута savedqueryid: "0016f9f3-41cc-4276-9d11-04308d15858d".

  6. Якщо не вдається знайти збережений запит із ідентифікатором, визначеним на попередньому кроці, перейдіть до кроку 19. Проте, якщо елемент <SavedQuery>, знайдений на кроці 14, ідентичний до <SavedQuery unmodified="1">, слід усунути атрибут unmodified="n".

  7. Проведіть пошук в LayoutXml пов’язаної сітки документа (шукайте Пов’язаний документ).

    Пошук пов’язаного документа.

  8. Внесіть зміни, вказані нижче для розділу 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>

    Важливо

    Необхідно, щоб усі атрибути, налаштовані в LayoutXML, мали відповідні атрибути у FetchXML. Якщо конфігурація неправильна, сітка поверне помилку.

  9. Внесіть зміни, як нижче для розділу 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>

  10. Подібним чином виконайте пошук елемента <SavedQuery>, де атрибут savedqueryid дорівнює "a5b008ac-07d9-4554-8509-2c05767bff51".

  11. Якщо не вдається знайти збережений запит із ідентифікатором, визначеним на попередньому кроці, перейдіть до кроку 24. Проте, якщо елемент <SavedQuery>, знайдений на кроці 19, ідентичний до <SavedQuery unmodified="1">, слід усунути атрибут unmodified="n".

  12. Виконайте пошук макету xml всього SharePoint документа (пошук всього SharePoint документа).

    Пошук layoutxml для Весь SharePoint документ.

  13. Внесіть зміни, вказані нижче для розділу 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>

  14. Внесіть зміни, як нижче для розділу 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>

  15. Подібним чином виконайте пошук елемента <SavedQuery>, де атрибут savedqueryid дорівнює "cb177797-b2ac-42a8-9773-5412321a965c".

  16. Якщо не вдається знайти збережений запит із ідентифікатором, визначеним на попередньому кроці, перейдіть до кроку 29. Проте, якщо елемент <SavedQuery>, знайдений на кроці 24, ідентичний до <SavedQuery unmodified="1">, слід усунути атрибут unmodified="n".

  17. Виконайте пошук макету xml OneNote SharePoint документа (пошук OneNote SharePoint документа).

    Шукайте layoutxml за запитом OneNote SharePoint Документ.

  18. Внесіть зміни, вказані нижче для розділу 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>

  19. Внесіть зміни, як нижче для розділу 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>

  20. Збережіть файл.

  21. Спакуйте папку в Zip.

  22. Відкриття програми на основі моделі у Dynamics 365.

  23. Натисніть Параметри>Рішення

  24. Імпортуйте рішення (заархівований файл на кроці 8).

  25. Опублікувати всі настроювання.

  26. Переконайтеся, що всі проблеми, пов’язані з неправильно сформованим FetchXML або LayoutXML, вирішені. Наприклад, упевніться, що пов’язана з документом сітка відображається в усіх необхідних документах SharePoint.

Див. також

Виправлення неполадок серверної автентифікації