Site-wide Repository and Workflow Server Configuration#

The repositories and workflow servers to which Colectica Designer has access can be configured through the Colectica Designer user interface, as described in Configure a Remote Repository. You can also manually deploy repository and workflow server configuration files for a single user or for all users of a machine.

Configuring for all users#

To deploy a repository list for all users on a machine, you can provide a repository list file in one of two locations. By deploying these files for all your users, you can provide site-wide repository configuration, eliminating the need for individual users to configure a repository. The user will be prompted for a username and password when they attempt to connect to a repository.

Option 1#

Server Type	File Location
Repository	`%programdata%\Algenta\Colectica\repositories.conf`
Workflow Server	`%programdata%\Algenta\Colectica\workflowServers.conf`

Option 2#

Alternatively, you can specify the location of repository list file in Colectica’s configuration file. The configuration file is located at:

%programfiles%\Colectica\Colectica DesignerColecticaDesigner.exe.config`

Include the full path of the repository list file in the setting specified below. You can use a file on the local disk or on a network share.

Server Type	File Location
Repository	GlobalRepositoryConfigurationPath
Workflow Server	GlobalWorkflowServerConfigurationPath

Server list file format#

The format for the server list file is simply one server per line. Each line may contain three fields separated by a comma.

The first field is the URL of the server. If no port is specified, Colectica uses the default. For Colectica Repository this is 19893.
The second field is optional and specifies the authentication type: Windows or Username. If the field is not specified, Username is used as the default. If Windows authentication is specified, the user will not be prompted for a username and password when accessing a repository, but the user’s Windows credentials will be used instead.
The third field is optional and specifies the transport method: NetTcp, HttpsBasic, HttpsWs, or HttpPlainText.

The following is a sample repository list file:

repository1.example.org
repository2.example.org:19899
repository3.example.org,Windows
repository4.example.org,Windows,NetTcp

Configuration location for individual users#

To deploy a server configuration for a single user, deploy the configuration file as:

Server Type	File Location
Repository	`%appdata%\Algenta\Colectica\repositories.xml`
Workflow Server	`%appdata%\Algenta\Colectica\workflowServers.xml`

Repository Configuration File Format#

The repository configuration file is an XML format. A sample appears below. If the UserName and Password are not specified for a given RepositoryConnectionInfo element, the user will be prompted for this information the first time they attempt to access the repository. A sample appears below:

<?xml version="1.0" encoding="utf-8"?>
<RepositoryManager xmlns:xsd="http://www.w3.org/2001/XMLSchema"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <Repositories>
                <RepositoryConnectionInfo>
                        <Url>repository1.example.org</Url>
                        <UserName>user1</UserName>
                        <Password>password</Password>
                </RepositoryConnectionInfo>
                <RepositoryConnectionInfo>
                        <Url>repository2.example.org</Url>
                </RepositoryConnectionInfo>
        </Repositories>
        <AgencyID>example.org</AgencyID> <!-- The default agency ID -->
</RepositoryManager>

Workflow server configuration file format#

The workflow server configuration file is an XML format. A sample appears below:

<ArrayOfWorkflowServerConnectionInfo xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <WorkflowServerConnectionInfo>
    <Url>http://localhost:1943</Url>
    <AuthenticationMethod>UserName</AuthenticationMethod>
    <UserName>admin</UserName>
    <Password>password</Password>
  </WorkflowServerConnectionInfo>
</ArrayOfWorkflowServerConnectionInfo>