Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
74:cms_sharepoint [2019/10/11 11:03]
tssr
74:cms_sharepoint [2020/05/20 07:05] (current)
tssr [Sharepoint]
Line 8: Line 8:
 <​cms-type name="​sharepoint">​ <​cms-type name="​sharepoint">​
     <!-- Global Properties -->     <!-- Global Properties -->
-    <​cms-property name="​stages.server.url"​ value="​https://​stages.mycompany:​8080"​ /> 
-    <​cms-property name="​http.authentication.hostname"​ value="​nonempty"​ /> 
-    <​cms-property name="​http.max.connections"​ value="​100"​ /> 
-    <​cms-property name="​http.connection.timeout"​ value="​10000"​ /> 
-    <​cms-property name="​http.socket.timeout"​ value="​90000"​ /> 
-    <​cms-property name="​http.connection.pool.max.idle"​ value="​60000"​ /> 
-    <​cms-property name="​http.ssl.allow.all"​ value="​true"​ /> 
- 
-    <​cms-property name="​use.system.account.for.download"​ value="​true|false"​ /> 
- 
     <​cms-host ident="​sharepoint.example.ident"​ name="​https://​sharepoint.example.net:​1234"​ displayName="​Sharepoint Example Server">​     <​cms-host ident="​sharepoint.example.ident"​ name="​https://​sharepoint.example.net:​1234"​ displayName="​Sharepoint Example Server">​
         <!-- Host Properties -->         <!-- Host Properties -->
-        <​cms-property name="​state.attribute.name"​ value="​_Status"​ /> 
         <​cms-property name="​version.date.format"​ value="​dd.MM.yyyy HH:mm" />         <​cms-property name="​version.date.format"​ value="​dd.MM.yyyy HH:mm" />
-        <​cms-property name="​document.content.type.name"​ value="​Document"​ /> 
-        <​cms-property name="​link.content.type.name"​ value="​Link to a document"​ /> 
         <​cms-property name="​user"​ value="​sharepoint_username"​ />         <​cms-property name="​user"​ value="​sharepoint_username"​ />
-        <​cms-property name="​password"​ value="​sharepoint_username" />+        <​cms-property name="​password"​ value="​sharepoint_password" />
     </​cms-host>​     </​cms-host>​
 </​cms-type>​ </​cms-type>​
 +
 </​code>​ </​code>​
  
 === Global Properties === === Global Properties ===
  
-These configuration properties affect the behavior of every integrated SharePoint server. The configuration of them needs to be done in the **<​cms-type>​** section of config.xml.+These configuration properties affect the behavior of every integrated SharePoint server.
  
-**stages.server.url ​** (required)+*** ** ''​Required''​ \\ 
 +Properties marked with ** * ** are required ​for the adapter to work.
  
-   Default Value: N/A +**# ** ''​Required but can also be set in web-application''​ \\ 
-  Description:​ The URL under which Stages ​is accessible.+Properties marked with ** # ** are required but can also be set in the //File Management//​ section in the Stages ​web-application as well. The value entered in the web-application overrides the one from the config.xml.
  
-**http.authentication.hostname ​**  (required ​for NTLM authentication)+**** ''​Required but with default''​ \\ 
 +Properties marked with ** + ** are required, but there is a default value. This values can be overridden by configuring it in the config.xml.
  
-  ​Default Value: N/A +> http.connection.context.timeout ** + **
-  ​Description:​ The host name of the server that runs Stages and is allowed to authenticate via NTLM against the SharePoint server.+
  
-**upload.service**+   __Default Value__: 60000 
 +  ​__Description__:​ The maximum period of inactivity (in milliseconds) before an authentication context is considered obsolete and will be removed by the resource monitor.
  
-  * Default Value: Copy service +> http.connection.pool.max.idle ** + **
-  * Description:​ Either CopyService or RPCDefines the interface that is used for uploads to SharePointCopyService is the default setting, the only drawback is that it might create an additional version for the initial checkin depending of the SharePoint setting Checkout required+
  
-**initial.checkin.fix**+  ​__Default Value__: 60000 
 +  ​__Description__:​ The maximum period of inactivity (in milliseconds) until a server connection will be closed automaticallyFor technical reasons the sum of http.connection.pool.max.idle and http.connection.resource.check.interval has to be lower than the keep-alive timeout of SharePoint'​s IIS site (default: 120s).
  
-  ​Default Value: true +> http.connection.timeout ** + **
-  ​Description:​ If CopyService is used for uploads, causes Stages to repeat the initial checkin in case the comment or version are not created correctly in SharePoint.+
  
-**http.ssl.allow.all**+  ​__Default Value__: 10000 
 +  ​__Description__:​ The timeout in milliseconds until a connection to the server has to be established.
  
-  * Default Value: false +> http.connection.resource.check.interval ** + **
-  * Description:​ When set to true, disables any verification checks for certificates in case of SSL-secured HTTPS connectionsIt is recommended to only use this in test environments where no valid certificates exist (e.gself-signed certificates).+
  
-**http.max.connections**+  ​__Default Value__: 10000 
 +  ​__Description__:​ The interval (in milliseconds) between two consecutive resource monitor runs which check for idle or expired connections and obsolete authentication contexts.
  
-  ​Default Value: 100 +> http.socket.timeout ** + **
-  ​Description:​ The maximum number of simultaneous HTTP connections between Stages and SharePoint.+
  
-**http.connection.timeout**+  ​__Default Value__: 90000 
 +  ​__Description__:​ The maximum time of inactivity (in milliseconds) until a server connection is considered dead and will be closed forcefully. This value should be higher than http.connection.pool.max.idle.
  
-  ​Default Value: 10000 +> http.ssl.allow.all ** + **
-  ​Description:​ The timeout in milliseconds until a connection to the server has to be established.+
  
-**http.socket.timeout**+  ​__Default Value__: false 
 +  ​__Description__:​ When set to true, disables any verification checks for certificates in case of SSL-secured HTTPS connectionsIt is recommended to only use this in test environments where no valid certificates exist (e.g. self-signed certificates).
  
-  * Default Value: 90000 +http.max.connections ** + **
-  * Description:​ The maximum time of inactivity (in milliseconds) until a server connection is considered dead and will be closed forcefully. This value should be higher than http.connection.pool.max.idle.+
  
-**http.connection.pool.max.idle**+  ​__Default Value__: 100 
 +  ​__Description__:​ The maximum number of simultaneous HTTP connections between Stages and SharePoint.
  
-  * Default Value: 60000 +http.authentication.hostname
-  * Description:​ The maximum period of inactivity (in milliseconds) until a server connection will be closed automatically. For technical reasons the sum of http.connection.pool.max.idle and http.connection.resource.check.interval has to be lower than the keep-alive timeout of SharePoint'​s IIS site (default: 120s).+
  
-**http.connection.context.timeout**+  ​__Description__:​ The host name of the server that runs Stages and is allowed to authenticate via ntlm against the SharePoint server.
  
-  ​Default Value: 60000 +> cms.browser.activated ** + **
-  ​Description:​ The maximum period of inactivity (in milliseconds) before an authentication context is considered obsolete and will be removed by the resource monitor.+
  
-**http.connection.resource.check.interval**+  ​__Default Value__: true 
 +  ​__Description__:​ If set to false, it is not possible to browse through the files in the Stages web-application.
  
-  ​Default Value: 10000 +> upload.service ** + **
-  ​Description:​ The interval (in milliseconds) between two consecutive resource monitor runs which check for idle or expired connections and obsolete authentication contexts.+
  
 +  * __Default Value__: CopyService
 +  * __Description__:​ Either CopyService or RPC. Defines the interface that is used for uploads to SharePoint. CopyService is the default setting, the only drawback is that it might create an additional version for the initial checkin depending of the SharePoint setting Checkout required
 === Host Properties === === Host Properties ===
  
-**version.date.format **+These configuration properties affect the behavior of one SharePoint Online server.
  
-  ​Default Value: N/A +*** **  ''​Required'' ​ Properties marked with ** * **  are required for the adapter to work.
-  ​* ​Description:​ The localized date format that SharePoint is using.+
  
-**raw.version.date.format ​**  ​(required)+****  ​''​Required but can also be set in web-application'' ​ Properties marked with ** # **  are required ​but can also be set in the //File Management// ​ section in the Stages web-application as well. The value entered in the web-application overrides the one from the config.xml.
  
-  ​Default Value: yyyy-MM-dd'T'HH:mm:ss'Z' +**+ **  ​''​Required but with default'' ​\\ Properties marked with ** + **  are required, but there is a default value. This values can be overridden by configuring it in the config.xml.
-  ​Description:​ The date format that SharePoint ​is using internally.+
  
-**document.content.type.name ​**  ​(required if Sharepoint Content Types are enabled)+> user ** **
  
-  * Default ValueDocument +  * __Description__You may enter the SharePoint username for the Stages system account here instead ​of the corresponding field Username in the cms profileIf both values exist, ​the username from the cms profile is preferred.
-  * Description:​ The configurable name of the content type "​Document"​The default value corresponds with the default name in english versions of SharePoint.+
  
-**link.content.type.name ​**  ​(required if Sharepoint Content Types enabled)+> password ​** **
  
-  * Default ValueLink to a document +  * __Description__You may enter the SharePoint password for the Stages system account here instead ​of the corresponding field Password in the cms profileIf both values exist, ​the password from the cms profile is preferred.
-  * Description:​ The configurable name of the content type "Link to a document"​The default value corresponds with the default name in english versions of SharePoint.+
  
-**user**+> domain ​** **
  
-  * Default Value: N/A +  * __Description__: You may enter the SharePoint ​domain ​for the Stages system account here instead of the corresponding field Default domain ​in the cms profile. If both values exist, the domain ​from the cms profile is preferred.
-  * Description: You may enter the SharePoint ​username ​for the Stages system account here instead of the corresponding field Username ​in the CMS profile. If both values exist, the username ​from the CMS profile is preferred.+
  
-**password**+> document.content.type.name ​** **
  
-  * Default ValueN/A +  * __Default Value__Document 
-  * DescriptionYou may enter the SharePoint password for the Stages system account here instead ​of the corresponding field Password in the CMS profileIf both values exist, ​the password from the CMS profile is preferred.+  * __Description__The configurable name of the content type ''​Document''​The default value corresponds with the default name in english versions of SharePoint.
  
-**domain**+> link.content.type.name ​** **
  
-  * Default ValueN/A +  * __Default Value__Link to a Document 
-  * DescriptionYou may enter the SharePoint default domain for the Stages system account here instead ​of the corresponding field Default domain in the CMS profileIf both values exist, ​the default ​domain from the CMS profile is preferred.+  * __Description__The configurable name of the content type ''​Link to a Document''​The default value corresponds with the default ​name in english versions of SharePoint.
  
-**state.attribute.name**  (required)+state.attribute.name
  
-  * Default Value: N/A 
   * Description:​ The optional SharePoint column to write the Stages state to.   * Description:​ The optional SharePoint column to write the Stages state to.
  
-**label.attribute.name**+label.attribute.name
  
-  * Default Value: N/A 
   * Description:​ The optional SharePoint column to read Stages labels from.   * Description:​ The optional SharePoint column to read Stages labels from.
  
-**label.attribute.delimiter**+label.attribute.delimiter ​** + ** 
 + 
 +  * __Default Value__: '',''​ 
 +  * __Description__:​ A delimiting character or string that separates single labels. 
 + 
 +> raw.version.date.format ** + ** 
 + 
 +  * __Default Value__: ''​yyyy-MM-dd'​T'​HH:​mm:​ss'​Z'​ ''​ 
 +  * __Description__:​ The date format that SharePoint is using internally. 
 + 
 +> version.date.format 
 + 
 +  * __Description__:​ The localized date format that SharePoint is using. 
 + 
 +> major.versions ** + ** 
 + 
 +  * __Default Value__: true 
 +  * __Description__:​ This optional property can be used to specify whether major versions (e.g 2.0) or minor versions (e.g. 0.2) are to be created on checkin. By default major versions are created (major.versions=true). Set major.versions=false if minor versions shall be created instead. A more fine-grained configuration which version type is created on which state change can be defined for document lifecycles in the metamodel. 
 + 
 +> page.size ** + ** 
 + 
 +  * __Default Value__: 1000 
 +  * __Description__:​ Item count of one page received from the Sharepoint server. 
 + 
 +> page.url.override 
 + 
 +  * __Description__:​ N/A 
 + 
 +> use.system.account.for.download ** + ** 
 + 
 +  * __Default Value__: false 
 +  * __Description__:​ When set to true, files will be downloaded from stages using the system account. 
 + 
 +=== Repository Configuration === 
 +Access to SharePoint projects can be configured in Stages processes via “Management > File Management > Repositories”. 
 +{{ :​cms:​sp-repository.png?​ |}} 
 + 
 +> Name: 
 +The name of this SharePoint configuration. This name will be used by Stages to refer to this repository configuration (e.g. in repository plan) 
 + 
 +> 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. 
 + 
 +> Default Domain: 
 +Define a domain for this repository configuration,​ which will be used when Stages is logging in to the SharePoint server. This overwrites the property **domain** from the configuration file (config.xml). 
 + 
 +> 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**:​ //<​nowiki><​cms-host name="​http://​mySharePoint.de:​123/​myPath/​to/​mySite"​ /></​nowiki>//​ 
 +  * Value in **Site**: //​myPath/​to/​another/​Repository//​ 
 +  * Resulting **URL**: //<​nowiki>​http://​mySharePoint.de:​123/​myPath/​to/​another/​Repository</​nowiki>//​ 
 +  * 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,​ will be **inside** this root folder. 
 + 
 +> Username: 
 +Define a username for this repository configuration. This overwrites the property **username** from the configuration file (config.xml). 
 + 
 +> Password 
 +Define a username for this repository configuration. This overwrites the property **password** from the configuration file (config.xml). 
 + 
 +> Default Lifecycle 
 +Select a lifecycle from the process metamodel as default for files from this repository. 
 + 
 + 
 + 
 +=== Host-Properties which are not in use since Stages v7.+ === 
 + 
 +> stages.server.url 
 + 
 +  * __Description__:​ The url to this Stages server. 
 + 
 +> initial.checkin.fix ** + **
  
-  * Default ValueN/A +  * __Default Value__true 
-  * DescriptionA delimiting character ​or string that separates single labels.+  * __Description__If CopyService is used for uploads, causes Stages to repeat the initial checkin in case the comment ​or version are not created correctly in SharePoint.
  
-**element.url.attribute.name**+element.url.attribute.name
  
-  * Default Value: N/A +  * __Description__: The optional SharePoint column where external links to Stages may be stored as a back-reference
-  * Description: The optional SharePoint column where external links to Stages may be stored as a back-reference+
  
-**major.versions**+> validateFilename
  
-  * Default Value: true +  * <​nowiki>​^[^~"#​%&​*:<>?/​{|}]+$</​nowiki>​
-  ​DescriptionThis optional property can be used to specify whether major versions (e.g 2.0) or minor versions (e.g. 0.2) are to be created on checkin. By default major versions are created (major.versions=true). Set major.versions=false if minor versions shall be created instead. A more fine-grained configuration which version type is created on which state change can be defined for document lifecycles in the metamodel.+
  
-**use.system.account.for.download**+> validatePath
  
-  * Default Valuefalse +  * <​nowiki>​^([^~"#​%&​*:<>?/​{|}.]|[^~\"#​%&​*:<>?/​\\\\{|}.][^~\"#​%&​*:<>?/​\\\\{|}]*[^~\"#​%&​*:<>?/​\\\\{|}.])?​([\\\\/​]([^~\"#​%&​*:<>?/​\\\\{|}.]|[^~\"#​%&​*:<>?/​\\\\{|}.][^~\"#​%&​*:<>?/​\\\\{|}]*[^~\"#​%&​*:<>?/​\\\\{|}.]))*[\\\\/​]?​$</​nowiki>​
-  ​DescriptionWhen set to true, files will be downloaded from stages using the system account.+