Differences

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

--- 74:cms_subversion [2019/10/11 10:56] – tssr
+++ 74:cms_subversion [2020/08/27 13:54] – [Subversion] fkjn
@@ Line 7: / Line 7: @@
 <code xml>
 <cms-type name="subversion">
-    <cms-property name="use.system.account.for.download" value="true|false" />
+    <!-- Global Properties -->
     <cms-host ident="subversion.example.ident" name="https://subversion.example.net:1234" displayName="Subversion Example Server">
+        <!-- Host Properties -->
         <cms-property name="user" value="subversion_username" />
         <cms-property name="password" value="subversion_password" />
     </cms-host>
 </cms-type>
 </code>
 === Host Properties ===
-**user**
+These configuration properties affect the behavior of one SharePoint Online server.
+*** ** ''Required'' \\
+Properties marked with ** * ** are required for the adapter to work.
+**# ** ''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.
+**+ ** ''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.
+> user ** # **
+   * __Description__: You may enter the Subversion 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 ** # **
+  * __Description__: You may enter the Subversion password for the Stages system account here instead of the corresponding field Password in the cms profile. If both values exist, the password from the cms profile is preferred.
+> http.connection.timeout ** + **
+  * __Default Value__: 30000
+  * __Description__: The timeout in milliseconds until a http connection has to be established and the maximum period of inactivity (in milliseconds) between two consecutive data packets before the socket is closed.
+> http.max.connections ** + **
+  * __Default Value__: 100
+  * __Description__: The maximum number of simultaneously used http connections between Stages and the Subversion server.
+> http.ssl.allow.all ** + **
+  * __Default Value__: false
+  * __Description__: When set to true, disables any verification checks for certificates in case of ssl-secured https connections. It is recommended to only use this in test environments where no valid certificates exist (e.g. self-signed certificates).
+> use.system.account.for.download ** + **
+  * __Default Value__: false
+  * __Description__: When set to true, files will be downloaded from stages using the system account.
+> domain
+  * __Description__: You may enter the Subversion default domain for the Stages system account, and all user accounts. (Only necessary for ntlm authentication)
+> http.authentication.hostname (required for ntlm authentication)
+  * __Description__: The host name of the server that runs Stages and is allowed to authenticate via ntlm against the Subversion server
+=== Repository Configuration ===
-   * Default Value: N/A
+Access to Subversion projects can be configured in Stages processes via “Management > File Management > Repositories”. [[https://doc.stagesasaservice.com/lib/exe/detail.php?id=74:cms_subversion&media=cms:svn-repository.png|{{  :cms:svn-repository.png  }}]]
-  * Description: You may enter the Subversion 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**
+> Name:  The name of this Subversion configuration. This name will be used by Stages to refer to this repository configuration (e.g. in repository plan)
-  * Default Value: N/A
+> Subversion Server:  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.
-  * Description: You may enter the Subversion password for the Stages system account here instead of the corresponding field Password in the CMS profile. If both values exist, the password from the CMS profile is preferred.
-**domain**
+> Repository Path  Define the path to the Subversion repository. This overwrites the **path**  from the URL entered in the configuration file (config.xml).
-  * Default Value: N/A
+Example:
-  * Description: You may enter the Subversion default domain for the Stages system account, and all user accounts. (Only necessary for NTLM authentication)
-**http.authentication.hostname **  (required for NTLM authentication)
+  * **config.xml**: //<nowiki><cms-host name="http://mySubversion.de:123/myPath/to/myRepository" /></nowiki>//
+  * Value in **Repository Path**: //myPath/to/another/Repository//
+  * Resulting **URL**: //<nowiki>http://mySubversion.de:123/myPath/to/another/Repository</nowiki>//
+  * The path from the config.xml gets overwritten by the value from Repository Path.
-  * Default Value: N/A
+> Enforce Usage of System Account  If this is set to //true//, Stages will use the user credentials from this repository configuration for **ALL**  operations. This means, every check-in, download or lock operation will be executed with the same username.
-  * Description: The host name of the server that runs Stages and is allowed to authenticate via NTLM against the Subversion server
-**http.connection.timeout**
+> Username:  Define a username for this repository configuration. This overwrites the property **username**  from the configuration file (config.xml).
-  * Default Value: 300000
+> Password  Define a username for this repository configuration. This overwrites the property **password**  from the configuration file (config.xml).
-  * Description: The timeout in milliseconds until a HTTP connection has to be established and the maximum period of inactivity (in milliseconds) between two consecutive data packets before the socket is closed.
-**http.max.connections**
+> Default Lifecycle  Select a lifecycle from the process metamodel as default for files from this repository.
-  * Default Value: 100
+==== Known Limitations ====
-  * Description: The maximum number of simultaneously used HTTP connections between Stages and the Subversion Server.
-**http.ssl.allow.all**
+== svn:needs-lock is actually not supported by Stages ==
-  * Default Value: false
+If the svn attribute [[svn:needs-lock|]] is set for a file this will be ignored by Stages
-  * Description: When set to <font inherit/Courier New,Courier,monospace;;inherit;;inherit>true</font>, disables any verification checks for certificates in case of SSL-secured HTTPS connections. It is recommended to only use this in test environments where no valid certificates exist (e.g. self-signed certificates).