How Portal Users Upload and View SharePoint Files
Once SharePoint is connected, portal users can open, upload and organize documents for their Dynamics 365 records from the portal. Documents they upload are stored in SharePoint and linked to the record in Dynamics 365, so your team sees them in the CRM without any manual sync.
Before you start
- Connect SharePoint to the portal and turn on SharePoint document management for the entities you need. See How to Integrate SharePoint with Dynamics 365 Portal.
- Give the portal user roles document rights: Document Access to add files and folders, and Delete to delete documents. See How to Create Portal User Roles and Permissions.
- You need access to the Design menu in the admin portal.
Choose where documents appear
There are two SharePoint widgets. Use one or both.
| Widget | Where you add it | Use it to |
|---|---|---|
| Sharepoint (form widget) | A form in Design → Form Builder, such as a Case detail form. | Show the documents of one record next to its details. |
| SharePoint Document (dynamic page widget) | A page in Design → Page Builder. | Give portal users a documents page in the portal. |
Add documents to a record form
- Go to Design → Form Builder.
- Open the form of an entity that has SharePoint turned on, for example the Case detail form.
- Drag the Sharepoint widget onto the grid where the documents should appear.
- Select the Settings icon on the widget.
- Fill in the settings in the table below.
- Select Save, then publish the form.
| Setting | What it does |
|---|---|
| Title | The heading of the documents section, for example Documents. |
| Upload Button Label | The label of the upload button, for example Upload File. |
| New Folder Button Label | The label of the button that creates a folder, for example New Folder. |
| Default Accordion Behavior | Expanded shows the documents when the form opens; Collapsed hides them until the portal user opens the section. |
| Select Design Layout | File Style or Grid Style. |
Add a documents page
- Go to Design → Page Builder and open or create the page.
- Select the SharePoint Document widget. It is added to the grid.
- Select the widget’s Settings icon.
- Fill in the settings in the table below.
- Select Save, then publish the page.
- Add the page to a navigation menu so portal users can find it. See How to Create Portal Navigation Menus.
| Setting | What it does |
|---|---|
| Title | The heading of the documents section, for example Document. |
| Upload Button Label | The label of the upload button, for example Upload File. |
| New Folder Button Label | The label of the button that creates a folder, for example New Folder. |
| Default Accordion Behavior | Whether the documents section is Expanded or Collapsed by default. |
| HTML Class | Custom CSS classes to style the widget. |
| HTML ID | A unique ID for the widget, for styling or scripts. |
| Card View | Shows the documents in a card-based layout. |
Set Page Access to Authenticate so only signed-in portal users can open the page. See How to Set Public and Login-Only Portal Pages.
What portal users see and do
Portal users sign in and open the record or page with the widget. The documents section shows:
- The title, for example Documents, at the top.
- The upload and new folder buttons, with the labels you set.
- An accordion with the folders and documents. Portal users open folders to find files.
What each portal user can do depends on their role:
| Task | Role right needed |
|---|---|
| View and open documents | SharePoint documents enabled for the entity, and the widget on the form or page. |
| Upload files and create folders | Document Access |
| Delete documents | Delete (in the role’s Documents section) |
Files a portal user uploads go to the record’s SharePoint folder and show in Dynamics 365. Sync is asynchronous; timing depends on your CRM’s API limits.
Troubleshooting
Portal users don’t see the upload or new folder buttons: Their role doesn’t have Document Access. Turn it on for the entity in the role’s Documents section.
The documents section is empty or missing for an entity: Check that SharePoint document management is turned on for the entity in Dynamics 365 and that the widget is on the form or page. Then publish the form or page again.
An upload fails: The file may be too large or of a type that isn’t allowed. Try a smaller file, and contact CRMJetty support if the problem continues.
Related articles
- How to Integrate SharePoint with Dynamics 365 Portal
- How to Create Portal User Roles and Permissions
- How to Enable Notes and Attachments in the Portal
- How to Create Pages in CRMJetty Portal
- How to Create a Portal Form for Any CRM Entity