Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
74:cms_sharepoint_online [2021/03/09 16:29] – [Azure Portal] fnpk | 74:cms_sharepoint_online [2023/07/18 12:25] – fnpk | ||
---|---|---|---|
Line 3: | Line 3: | ||
===== Sharepoint Online ===== | ===== Sharepoint Online ===== | ||
- | === Example Configuration === | + | You are able to connect Stages with SharePoint Online. A typical URL to SharePoint Online looks like '' |
+ | |||
+ | ==== Example Configuration | ||
<code xml> | <code xml> | ||
< | < | ||
<!-- Global Properties --> | <!-- Global Properties --> | ||
- | < | + | < |
<!-- Host Properties --> | <!-- Host Properties --> | ||
< | < | ||
Line 21: | Line 23: | ||
</ | </ | ||
- | === Host Properties === | + | ==== Host Properties |
These configuration properties affect the behavior of one SharePoint Online server. | These configuration properties affect the behavior of one SharePoint Online server. | ||
Line 68: | Line 70: | ||
* Default Value: Document | * Default Value: Document | ||
* Description: | * Description: | ||
+ | * Since Stages 7.5.6.2, 7.6.2.4 and 7.7.0.0 it is possible to define multiple content types. Separate them with a #. For example: | ||
+ | <code xml> | ||
+ | < | ||
+ | </ | ||
> link.content.type.name | > link.content.type.name | ||
Line 73: | Line 79: | ||
* Default Value: Link to a document | * Default Value: Link to a document | ||
* Description: | * Description: | ||
- | |||
* Known Issue: Typo in Default Value. Has to be Link to a **D**ocument | * Known Issue: Typo in Default Value. Has to be Link to a **D**ocument | ||
+ | * Since Stages 7.5.6.2, 7.6.2.4 and 7.7.0.0 it is possible to define multiple link types. Separate them with a #. For example: | ||
+ | <code xml> | ||
+ | < | ||
+ | </ | ||
> use.system.account.for.download | > use.system.account.for.download | ||
Line 82: | Line 91: | ||
==== Azure Portal ==== | ==== Azure Portal ==== | ||
+ | |||
+ | The integration uses [[https:// | ||
=== Authentication === | === Authentication === | ||
Line 89: | Line 100: | ||
[[https:// | [[https:// | ||
- | For the authentication process to work, you have to add the following redirect to the list:< | + | For the authentication process to work, you have to add the following redirect |
- | < | + | https://< |
</ | </ | ||
- | * Protocol: | + | * Microsoft only accepts __https__ |
- | * Stages-hostname: | + | * Stages-hostname: |
- | * Port: Port Stages | + | |
- | == Example == | + | == Example == |
If the link to your Stages looks like this | If the link to your Stages looks like this | ||
- | | + | < |
+ | https:// | ||
+ | |||
+ | </ | ||
then your redirect URI is | then your redirect URI is | ||
- | | + | < |
+ | https:// | ||
+ | |||
+ | </ | ||
=== API Permissions === | === API Permissions === | ||
- | In addition to the Redirect URIs, the application needs permissions for file handling in behalf of the user: | + | In addition to the Redirect URIs, the application needs [[https:// |
* offline_access (Microsoft Graph, type delegated) | * offline_access (Microsoft Graph, type delegated) | ||
* Sites.ReadWrite.All (Microsoft Graph, type delegated) | * Sites.ReadWrite.All (Microsoft Graph, type delegated) | ||
* User.Read (Microsoft Graph, type delegated) | * User.Read (Microsoft Graph, type delegated) | ||
+ | |||
+ | In some cases an **admin consent is required**. This can be done by a Global Administrator, | ||
The picture below shows, how this should look like: | The picture below shows, how this should look like: | ||
Line 121: | Line 140: | ||
[[https:// | [[https:// | ||
- | === Repository Configuration === | + | === Certificates & secrets === |
+ | |||
+ | It is required to generate a client secret for Stages. It's recommended to choose expire never or a long duration. If the secret expires it must be changed in Stages and all users have to re-authenticate. | ||
+ | |||
+ | |||
+ | [[https:// | ||
+ | |||
+ | ==== Repository Configuration | ||
Access to SharePoint Online projects can be configured in Stages processes via “Management > File Management > Repositories”. [[https:// | Access to SharePoint Online projects can be configured in Stages processes via “Management > File Management > Repositories”. [[https:// | ||
- | If you go to the document library with your browser you will get a URL like this. We will use it in this example. | + | If you go to the document library with your browser you will get a URL like this. We will use it in this example.< |
- | | + | https:// |
- | > Name: The name of this SharePoint Online configuration. This name will be used by Stages to refer to this repository configuration (e.g. in repository plan) | + | </code> |
- | > Host: This selection field contains an entry for each cms-host section in the Stages configuration | + | > Name: The name of this SharePoint Online configuration. |
- | > Site: Define a site parameter for this repository configuration. The site is the path to the location, where your document libraries are located on the SharePoint server. The site is one piece for the complete connection string to the SharePoint server. | + | > Host: This selection field contains an entry for each cms-host section in the Stages configuration file (config.xml). You can select the host for this repository configuration. |
- | > According to the example URL the site-part is **sites/ | + | |
+ | > Site: Define a site parameter for this repository configuration. The site is the path to the location, where your document libraries are located on the SharePoint server. The site is one piece for the complete connection string to the SharePoint server. | ||
This overwrites the **path** | This overwrites the **path** | ||
Line 145: | Line 172: | ||
* The path from the config.xml gets overwritten by the value from Repository Path. | * The path from the config.xml gets overwritten by the value from Repository Path. | ||
- | > Document Library: | + | > Document Library: Defines the name of the document library. The document library is one piece for the complete connection string to the SharePoint server. If your document library contains a space it must be replaced by **%20** |
- | > According to the example URL the Document Library part is **Shared%20Documents** | + | |
+ | > Root Folder: Defines a root folder **inside** | ||
+ | |||
+ | > Default Lifecycle Select a lifecycle from the process metamodel as default for files from this repository. | ||
+ | |||
+ | ==== Known Limitations ==== | ||
+ | |||
+ | === Behavior of Lock/Unlock === | ||
+ | |||
+ | Currently, the graph API only supports checkin/ | ||
+ | |||
+ | === Initial commit === | ||
+ | |||
+ | Creates two versions (one for the creation of a new file/ second for updating the properties) | ||
+ | |||
+ | === Set State === | ||
+ | |||
+ | After setting the state of a Sharepoint Online document, the assignment to the Stages user gets lost. The modifier will be the Sharepoint Online user instead of the Stages user. | ||
+ | |||
+ | === Major / Minor Version === | ||
+ | |||
+ | The Graph API, wich is used by the SharePoint Online Adapter, does currently not support setting major/minor versions when uploading a file. | ||
+ | |||
+ | === Action before authentication === | ||
+ | |||
+ | If the current user is not authenticated yet and performs an action, the authentication dialog will be opened. After the authentication the user has to performs the action again. | ||
+ | |||
+ | |||
+ | ==== Troubleshooting ==== | ||
+ | |||
+ | === Error AADSTS50011: | ||
+ | |||
+ | Check the Redirect URI in Azure Portal | ||
+ | |||
+ | === Unknown certificates === | ||
+ | |||
+ | At the moment this public CAs are required: | ||
- | > Root Folder: | + | * DigiCert Global |
+ | * valid until 10 Nov 2031 00:00:00 GMT | ||
+ | * SHA1: A8: | ||
+ | * SHA256: 43: | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | * Microsoft RSA Root Certificate Authority 2017 | ||
+ | * Valid until Fri, 18 Jul 2042 23:00:23 GMT | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | * SHA256: CB: | ||
- | > Default Lifecycle | ||
+ | [[https:// | ||
+ | [[https:// |