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/05/05 09:17] – 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> | ||
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 91: | Line 102: | ||
For the authentication process to work, you have to add the following redirect for **Web** | For the authentication process to work, you have to add the following redirect for **Web** | ||
- | < | + | https://< |
</ | </ | ||
- | * Protocol: | + | * Microsoft only accepts __https__ |
- | * Stages-hostname: | + | * Stages-hostname: |
- | * Port: Port Stages | + | |
== Example == | == Example == | ||
Line 114: | Line 124: | ||
</ | </ | ||
+ | |||
=== 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) | ||
Line 129: | 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:// | ||
Line 160: | Line 178: | ||
> Default Lifecycle Select a lifecycle from the process metamodel as default for files from this repository. | > 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: | ||
+ | |||
+ | * DigiCert Global Root CA | ||
+ | * valid until 10 Nov 2031 00:00:00 GMT | ||
+ | * SHA1: A8: | ||
+ | * SHA256: 43: | ||
+ | * DigiCert Assured ID Root G2 | ||
+ | * Valid unitl: 15 Jan 2038 12:00:00 GMT | ||
+ | * SHA1: A1: | ||
+ | * SHA256: 7D: | ||
+ | * Microsoft RSA Root Certificate Authority 2017 | ||
+ | * Valid until Fri, 18 Jul 2042 23:00:23 GMT | ||
+ | * SHA1: 73: | ||
+ | * DigiCert Global Root G2 | ||
+ | * Valid until Fri, 15 Jan 2038 12:00:00 GMT | ||
+ | * SHA1: DF: | ||
+ | * SHA256: CB: | ||
+ | |||
+ | |||
+ | [[https:// | ||
+ | [[https:// |