Configure DocXtender Permissions

Skip to main content

Configure DocXtender Permissions

You are here:

The following section describes DocXtender configuration for set up.

User Configuration

The DocXtender Permission Set provides access to features for individual users.

Set user permissions

  1. Navigate to Users.
  2. Locate user, select icon, and select Edit (User Card opens).
  3. Scroll down to Permission Set.
  4. Input IWORKS COMMON permission set.
  5. Input Permission set for:
    • Administrator: DOCX-SETUP
    • User: DOCX-USER
  6. Close User Card (changes made are automatically saved).

Permissions Required for Document Attachments and DocXtender

Business Central and DocXtender use separate permissions for the Documents FactBox and the DocXtender drag-and-drop area that appears within it.

Base Business Central Documents area

The standard Documents area uses Microsoft’s Doc. Attachment List Factbox and the Document Attachment table.

Users require access to the Document Attachment table:

  • Read permission is required to view existing attachments.
  • Insert, Modify, and Delete permissions are required to fully manage attachments, including uploading files.

Microsoft’s standard D365 Basic – Read permission set provides read access to Document Attachment, while D365 Basic – Edit provides the additional Insert, Modify, and Delete permissions. These permissions are also included through broader standard Business Central permission sets such as D365 BUS FULL ACCESS.

If the entire Documents FactBox is missing, first verify that the user has the appropriate standard Business Central permissions.

DocXtender drag-and-drop area

DocXtender extends Microsoft’s Doc. Attachment List Factbox and adds the DocXtender drag-and-drop control to it.

Users who need to use DocXtender should be assigned:

DOCX-USER – DocXtender User

This permission set provides normal users with access to the DocXtender objects and read access to the DocXtender setup required by the drag-and-drop control.

Users responsible for configuring DocXtender can instead be assigned:

DOCX-SETUP – DocXtender Setup

The setup permission provides additional permissions to modify the DocXtender configuration.

Troubleshooting

If the Documents FactBox is visible but the DocXtender drag-and-drop area is missing, verify that the user has DOCX-USER assigned.

If the entire Documents FactBox is missing, verify the user’s standard Business Central permissions to the Document Attachment table first.

For users who upload documents through DocXtender, they normally require both the appropriate Business Central permissions for document attachments and the DOCX-USER permission set.

Was this article helpful?
4.5 out Of 5 Stars

1 rating

5 Stars 0%
4 Stars 100%
3 Stars 0%
2 Stars 0%
1 Stars 0%
5
How can we improve this article?
Please submit the reason for your vote so that we can improve the article.
Need help?

3 Comments

  1. Kelly Appiani
    Kelly Appiani September 10, 2022 at 4:32 am

    I have installed DocXtender & added permissions, but the Flow to Purch. Trx toggle is greyed out. Is this a permission issue?

    • Travis Plett
      Travis Plett September 16, 2022 at 7:25 am

      DocXtender is just a drag & drop interface for attachments, it does not manage attachments or flow functions. What you are describing is a base Business Central function (or some other addon app), so you would need to check with Microsoft or the addon provider.

  2. Gary Winey
    Gary Winey July 23, 2020 at 1:28 pm

    We had to play around with the SharePoint configuration a bit to get it to work the way we wanted.

    1. Mappings to DocXtender Setup SharePoint fields from SharePoint url

    https://your.sharepoint.com/sites/DMSDocXtender/Shared Documents/ClientName/plus/more/if/you/need/them
    | | | | | |
    ———————————- —————————- ——————–
    |-> SharePoint Host |-> SharePoint Site |-> SharePoint Folder
    your.sharepoint.com DMSDocXtender ClientName

    2. The Documents folder in the main SharePoint site or any other site ends up being Shared Documents in the generated url
    3. Any file path(s) specified in the SharePoint Folder will be generated, always as sub folder(s) under the Documents folder
    4. After attaching files, if you click the vertical ellipses and select edit
    a. Text files and PDFs will display the path specified in the SharePoint configuration
    https://your.sharepoint.com/sites/DMSDocXtender/Shared%20Documents/ClientName/Item/1000/DocXtender%20Test.txt

    b. All other files (including Csvs) will display a different path although the files will be in the proper place in SharePoint
    https://your.sharepoint.com/sites/DMSDocXtender/_layouts/15/Doc.aspx?sourcedoc=%7BC2D30022-F8E9-4D5A-994D-3FF1FD04C8CB%7D&file=DocXtender%20Test%20Upload.docx&action=default&mobileredirect=true

Leave A Comment

Table of Contents
Go to Top