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>