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

Интеграция устранения неполадок в 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. Следуйте этим инструкциям: Просмотр профиля пользователя. b. У вас нет нужных разрешений? Обратитесь к администратору системы.

  2. Перейдите в раздел Параметры>Настройки>Решения.

  3. Создайте решение (с именем SharePointDocumentSolution). Дополнительные сведения см. в разделе Создание решения.

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

  5. Выберите Сохранить и Закрыть.

  6. Опубликуйте все настройки.

  7. Выберите созданное решение (SharePointDocumentSolution).

  8. Экспортируйте решение и выберите тип пакета «Неуправляемые». Будет загружен файл SharePointDocumentSolution.zip.

  9. Распакуйте ZIP-файл (файл, загруженный на шаге 8).

  10. Найдите папку, найдите и откройте файл customization.xml.

  11. Найдите LayoutXml связанной сетке документов (ищите Связанные документы).

    Поиск связанных документов.

  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. Импортируйте решение (упакованный ZIP-файл из шага 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-адресом.

    Введите относительный URL-адрес SharePoint.

  3. Выберите Сохранить и закрыть.

Неверно сформированный FetchXML или LayoutXML — проверить и исправить

Неправильный формат FetchXML или LayoutXML может вызвать следующие проблемы:

  • Отсутствует сетка, связанная с документами
  • Не удается просмотреть папки
  • Не удается просмотреть документы в папках
  • Документ не удаляется
  • Сообщение об ошибке "Обязательный параметр имеет значение null или не определено: url" при открытии вкладки документов
  • Сообщение об ошибке "System.NullReferenceException" при отправке документа
  • Документ загружается вместо открытия на новой вкладке

Может быть много причин неправильного формата 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>

    Внимание

    Все атрибуты, настроенные в XML-формате макета, требуют, чтобы их соответствующие атрибуты присутствовали в XML-файле на языке Fetch. Сетка вернет ошибку, если эта конфигурация неверна.

  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. Найдите layoutxml "Все документы 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. Найдите layoutxml "Документ 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. Импортируйте решение (упакованный ZIP-файл из шага 8).

  25. Опубликуйте все настройки.

  26. Убедитесь, что все проблемы, связанные с неправильным форматом FetchXML или LayoutXML решены. Например, убедитесь, что связанная сетка документов отображается во всех требуемых документах SharePoint.

См. также

Устранение неполадок с проверкой подлинности на основе сервера