Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
74:cms_sharepoint_online [2019/10/14 08:49] – [Sharepoint Online] tssr | 74:cms_sharepoint_online [2020/05/20 07:05] – tssr | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | [[: | + | [[: |
- | # Sharepoint Online | + | ===== Sharepoint Online |
- | Example Configuration | + | === Example Configuration |
- | ``` xml | + | < |
+ | < | ||
+ | <!-- Global Properties --> | ||
+ | < | ||
+ | <!-- Host Properties --> | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
- | < cms-type name=" | + | </code> |
- | < !-- Global | + | === Host Properties |
- | < cms-host ident=" | + | These configuration properties affect the behavior of one SharePoint Online |
- | < !-- Host Properties | + | *** ** '' |
+ | Properties | ||
- | < cms-property name=" | + | **# ** '' |
+ | Properties marked with ** # ** are required but can also be set in the //File Management// | ||
- | < cms-property name=" | + | **+ ** '' |
+ | Properties marked with ** + ** are required, but there is a default | ||
- | < cms-property name=" | + | > client.id ** * ** |
- | < cms-property name=" | + | * Description: |
+ | * Links: [[https:// | ||
- | < /cms-host> | + | > client.secret ** * ** |
- | < /cms-type> | + | * Description: |
+ | * Links: [[https:// | ||
- | ``` | + | > tenant.id ** * ** |
- | ## Host Properties | + | * Description: |
+ | * Links: [[https:// | ||
- | These configuration properties affect the behavior of one SharePoint Online server. Properties marked with * are required for the adapter to work. Properties marked with + are required, but there is a default value. This values can be overridden by configuring it in the config.xml. | + | > loginserver ** + ** |
- | **\* Required** \ | + | |
+ | | ||
+ | | ||
- | **\+ Required with default value** | + | > scope ** + ** |
- | `* client.id` | + | |
+ | * Links: [[https:// | ||
- | * Description: | + | > state.attribute.name |
- | `* client.secret` | + | |
- | * Description: | + | > document.content.type.name ** + ** |
- | `* tenant.id` | + | |
+ | * Description: | ||
- | * Description: | + | > link.content.type.name ** + ** |
- | `+ loginserver` | + | * Default Value: Link to a document |
+ | * Description: | ||
- | * Default Value: | + | |
- | * Description: | + | > use.system.account.for.download |
- | `+ scope` | + | * Default Value: false |
+ | * Description: | ||
- | * Default Value: *offline_access User.Read Sites.ReadWrite.All* | + | ==== Azure Portal ==== |
- | `state.attribute.name` | + | === Authentication === |
- | * Description: | + | Every application registered at the Microsoft azure portal can register |
- | `document.content.type.name` | + | [[https:// |
- | * Default Value: Dokument | + | For the authentication process to work, you have to add the following redirect to the list:< |
- | `link.content.type.name` | + | < |
- | * Default Value: Link to a document | + | </ |
- | `use.system.account.for.download` | + | * Protocol: Microsoft only accepts __https__ |
+ | * Stages-hostname: | ||
+ | * Port: Port Stages is running on (80 for http, 443 for https) or any other custom port | ||
- | * Default Value: false | + | === API Permissions === |
- | * Description: | + | In addition |
- | ## Azure Redirect URI for Stages | + | [[https:// |
- | `[stages-server-url]/ | + | === Repository Configuration === |
+ | Access to SharePoint Online projects can be configured in Stages processes via “Management > File Management > Repositories”. | ||
+ | {{ :cms:spo-repository.png? | ||
- | ## Known Issues | + | > 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) | ||
- | #### Commit comments for file versions | + | > 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. | ||
+ | |||
+ | > 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. The connection string is build like that: // | host.url | : | port | | **/site/** | | documentLibrary | //. | ||
+ | |||
+ | This overwrites the **path** from the URL entered in the configuration file (config.xml). | ||
+ | |||
+ | Example: | ||
+ | |||
+ | * **config.xml**: | ||
+ | * Value in **Site**: // | ||
+ | * Resulting **URL**: //< | ||
+ | * The path from the config.xml gets overwritten by the value from Repository Path. | ||
+ | |||
+ | > Document Library: | ||
+ | Defines the name of the document library. The document library is one piece for the complete connection string to the SharePoint server. The connection string is build like that: // | host.url | : | port | | /site/ | | **documentLibrary** | //. | ||
+ | |||
+ | > Root Folder: | ||
+ | Defines a root folder **inside** the given document library. Every file linked or uploaded to a repository, which defines a root folder in the configuration, | ||
+ | |||
+ | > Default Lifecycle | ||
+ | Select a lifecycle from the process metamodel as default for files from this repository. | ||
+ | |||
+ | |||
+ | ==== Known Limitations ==== | ||
+ | |||
+ | == Commit comments for file versions | ||
For each checkin of a file, the user can attach a comment for the version which gets created. The Microsoft Endpoint, which is used to read that information, | For each checkin of a file, the user can attach a comment for the version which gets created. The Microsoft Endpoint, which is used to read that information, | ||
- | #### Behavior of Lock/Unlock | + | == Behavior of Lock/ |
Currently, the graph API only supports checkin/ | Currently, the graph API only supports checkin/ | ||
- | #### Initial commit | + | == Initial commit |
Creates two versions (one for the creation of a new file/ second for updating the properties) | 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. | ||