Khắc phục sự cố tích hợp SharePoint

Chủ đề này giải thích cách khắc phục các sự cố phổ biến có thể xảy ra với quản lý tài liệu SharePoint.

Tài liệu còn thiếu nút - xác nhận và sửa chữa

Nếu tài liệu là mất tích từ các thực thể như tài khoản, sử dụng sau đây để khôi phục lại.

Tài liệu.

  1. Đảm bảo rằng bạn có vai trò bảo mật Quản trị viên hệ thống hoặc quyền tương đương. Kiểm tra vai trò bảo mật của bạn: a. Làm theo các bước trong Xem hồ sơ người dùng của bạn. b. Không có đúng loại quyền? Liên hệ với quản trị viên hệ thống của bạn.

  2. Khắc phục nút Tài liệu còn thiếu. Làm theo các bước sau:

    1. Nhận dạng các thực thể mà các văn bản liên kết nên được nhìn thấy (ví dụ: tài khoản, số liên lạc, cơ hội... vv.).
    2. Chuyển tới Thiết đặt>Quản lý Tài liệu.
    3. Đảm bảo rằng các thực thể mà bạn muốn có tài liệu liên kết (đã chọn ở Bước 1) được lựa chọn và một URL SharePoint hợp lệ được chỉ định.
    4. Hoàn tất trình hướng dẫn.
    5. Xác minh các tài liệu nút xuất hiện.

Để biết thêm thông tin, hãy xem Kích hoạt quản lý tài liệu SharePoint cho thực thể cụ thể.

FetchXML hoặc LayoutXML bị lỗi - xác thực và sửa chữa

LayoutXML hoặc FetchXML bị định dạng sai có thể gây ra bất kỳ sự cố nào sau đây:

  • Thiếu lưới đã liên kết của Tài liệu
  • Không thể xem thư mục
  • Không thể xem tài liệu trong các thư mục
  • Tài liệu không bị xóa
  • Thông báo lỗi – "Tham số bắt buộc là null hoặc không xác định: url" trong khi mở tab tài liệu
  • Thông báo lỗi – "System.NullReferenceException" trong khi tải tài liệu lên
  • Tài liệu đang được tải xuống thay vì mở trong tab mới

Có thể có nhiều nguyên nhân khiến FetchXML hoặc LayoutXML bị định dạng sai. Nguyên nhân phổ biến nhất là tuỳ chỉnh thực thể/dạng xem lưới, thêm/xóa cột và các tùy chỉnh tương tự khác.

Nếu FetchXML hoặc LayoutXML bị lỗi, hãy sử dụng lệnh sau để khôi phục.

  1. Đảm bảo rằng bạn có vai trò bảo mật Quản trị viên hệ thống hoặc quyền tương đương. Kiểm tra vai trò bảo mật của bạn:

    1. Làm theo các bước trong Xem hồ sơ người dùng của bạn.
    2. Không có đúng loại quyền? Liên hệ với quản trị viên hệ thống của bạn.
  2. Trong ứng dụng web, hãy vào Cài đặt (Thiết đặt.) >Cài đặt nâng cao, hãy vào Cài đặt>Tùy chỉnh>Giải pháp.

  3. Tạo ra một giải pháp (tên là SharePointDocumentSolution). Để biết thêm thông tin, hãy xem Tạo giải pháp

  4. Chọn Thực thể>Thêm hiện có>Thực thể> tìm và thêm thực thể Tài liệu SharePoint (chọn tất cả các trường, biểu mẫu, dạng xem).

  5. Chọn LưuĐóng.

  6. Phát hành Tất cả Tùy chỉnh

  7. Tạo ra một giải pháp (tên là SharePointDocumentSolution).

  8. Xuất giải pháp và chọn loại Gói là "Không được quản lý". SharePointDocumentSolution.zip sẽ được tải về.

  9. Xóa giải pháp đã được tạo trong bước 3 khỏi tổ chức.

  10. Giải nén tệp zip giải pháp đã xuất (tệp tải về từ bước 8).

  11. Trong thư mục nội dung giải pháp, xác định vị trí và sau đó mở Solution.xml.

  12. Thay đổi giá trị sau đây trong Solution.xml, và sau đó lưu lại.
    Từ <Managed>0</Managed> đến <Managed>1</Managed>.

  13. Trong thư mục nội dung giải pháp, xác định vị trí và sau đó mở customization.xml.

  14. Tìm phần tử <SavedQuery> có thuộc tính savedqueryid bằng "0016f9f3-41cc-4276-9d11-04308d15858d".

  15. Nếu bạn không thể tìm thấy truy vấn đã lưu có ID được chỉ định ở bước trước, hãy chuyển sang bước 19. Tuy nhiên, nếu phần tử <SavedQuery> được tìm thấy trong bước 14 tương tự như <SavedQuery unmodified="1">, hãy loại bỏ thuộc tính unmodified = "n".

  16. Tìm layoutxml tài liệu liên quan đến mạng lưới (tìm kiếm tài liệu liên quan đến).

    Tìm kiếm tài liệu liên quan.

  17. Thực hiện thay đổi như dưới đây cho phần 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>
    

    Quan trọng

    Tất cả các thuộc tính được cấu hình trong bố cục xml đều yêu cầu phải có các thuộc tính tương ứng trong XML tìm nạp dữ liệu. Lưới sẽ trả về lỗi khi cấu hình này không chính xác.

  18. Thực hiện thay đổi như dưới đây cho phần 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. Tương tự, tìm phần tử <SavedQuery> có thuộc tính savedqueryid bằng "a5b008ac-07d9-4554-8509-2c05767bff51".

  20. Nếu bạn không thể tìm thấy truy vấn đã lưu có ID được chỉ định ở bước trước, hãy chuyển sang bước 24. Tuy nhiên, nếu phần tử <SavedQuery> được tìm thấy ở bước 19 tương tự như <SavedQuery unmodified="1">, hãy loại bỏ thuộc tính unmodified="n".

  21. Tìm kiếm layoutxml của Tất cả tài liệu SharePoint (tìm kiếm Tất cả tài liệu SharePoint).

    Tìm kiếm layoutxml cho Tất cả SharePoint Tài liệu.

  22. Thực hiện thay đổi như dưới đây cho phần 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. Thực hiện thay đổi như dưới đây cho phần 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. Tương tự, tìm phần tử <SavedQuery> có thuộc tính savedqueryid bằng "cb177797-b2ac-42a8-9773-5412321a965c".

  25. Nếu bạn không thể tìm thấy truy vấn đã lưu có ID được chỉ định ở bước trước, hãy chuyển sang bước 29. Tuy nhiên, nếu phần tử <SavedQuery> được tìm thấy trong bước 24 tương tự như <SavedQuery unmodified="1">, hãy loại bỏ thuộc tính unmodified = "n".

  26. Tìm kiếm layoutxml của Tài liệu SharePoint trên OneNote (tìm kiếm Tài liệu SharePoint trên OneNote).

    Tìm kiếm layoutxml cho  OneNote SharePoint Document.

  27. Thực hiện thay đổi như dưới đây cho phần 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. Thực hiện thay đổi như dưới đây cho phần 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. Lưu tệp.

  30. Zip vào thư mục.

  31. Mở ứng dụng dựa trên mô hình trong Dynamics 365.

  32. Điều hướng đến cài đặt>giải pháp

  33. Nhập khẩu các giải pháp (nén tập tin nén trong bước 8).

  34. Phát hành Tất cả Tùy chỉnh

  35. Xác minh rằng bất kỳ sự cố nào liên quan đến FetchXML hoặc LayoutXML bị định dạng sai đã được giải quyết. Ví dụ: kiểm tra để đảm bảo rằng lưới đã liên kết của Tài liệu hiển thị trong tất cả tài liệu SharePoint yêu cầu.

Kiểm tra và sửa URL site SharePoint

Trong các ứng dụng Customer Engagement (chẳng hạn như Dynamics 365 Sales và Customer Service), trang web SharePoint và bản ghi vị trí tài liệu chứa các đường liên kết đến tập hợp trang web, trang web, thư viện tài liệu và các thư mục trong SharePoint. Những bản ghi vị trí tài liệu và trang web này được liên kết với các bản ghi để các tài liệu của bản ghi có thể được lưu trữ trong SharePoint.

Khi các đường liên kết giữa ứng dụng Customer Engagement và SharePoint phá vỡ, bạn phải xác nhận và sửa chữa các liên kết để bản ghi ứng dụng tiếp tục trỏ đến các thư viện tài liệu chính xác và các thư mục để quản lý các tài liệu.

  1. Đảm bảo rằng bạn có vai trò bảo mật Quản trị viên Hệ thống hoặc quyền tương đương trong Microsoft Dynamics 365.

    Kiểm tra vai trò bảo mật của bạn

  2. Tìm và sửa chữa các URL. Để làm điều này, hãy làm theo các bước sau.

    1. Chuyển tới Thiết đặt>Quản lý Tài liệu.

    2. Bấm SharePoint Trang.

    3. Chọn URL trang web mà bạn muốn xác nhận, sau đó bấm hoặc chạm vào Xác thực.

  3. Ứng dụng Customer Engagement xác thực tất cả URL trang đã chọn và URL thư viện tài liệu cũng như trang bổ trợ trực tiếp của chúng. Nó sau đó sẽ hiển thị các kết quả trong xác nhận các trang.

  4. Để khắc phục một URL, mở các hồ sơ trang, và nhập URL chính xác. Thông tin thêm: Tạo hoặc chỉnh sửa bản ghi trang web.

  5. Nhấp vào Lưu & Đóng.

Người dùng nhận được thông báo "Bạn không có quyền xem các tệp trong vị trí này"

Thông báo này có thể xảy ra khi trang web SharePoint được cấu hình với quản lý tài liệu đã được đổi tên, nhưng bản ghi URL trang web SharePoint chưa được cập nhật để phản ánh thay đổi này.

  1. Chuyển tới Cài đặt>Quản lý tài liệu>Trang web SharePoint.

  2. Mở bản ghi Site SharePoint đã được đổi tên và nhập URL tuyệt đối với URL mới.

    Nhập  SharePoint URL tương đối.

  3. Chọn Lưu & Đóng.

Xem thêm

Khắc phục sự cố xác thực dựa trên máy chủ