Contract Express Integration

Sample Read Me
Overview
There are three steps you must go through to get your integration sample working with
your Contract Express. You must first allow your Contract Express application to be
embedded in another application; in this case in your integration sample. Then, you
must create a Contract Express client to use with your integration sample. Finally, you
must configure your integration sample to use your client.

Allowing your Contract Express to be embedded in

another application
You should allow your Contract Express to be embedded in another application as
follows,

1. Sign in to your Contract Express as a Contract Express Administrator.

2. Navigate to the Admin page.

3. Navigate to the Features section.

4. Enter the domain you wish to embed your Contract Express in; alternatively,
enter the wild card *.
Creating a Contract Express client
Now, you should create a Contract Express client as follows,

1. Sign in to your Contract Express as a Contract Express Administrator.

2. Navigate to the Admin page.

3. Navigate to the API Client section.

4. Click Add Client.

5. Give your client a name and an ID, these must be unique, and set the redirect
URI to https://localhost:44353/.
 6. Click Save.

Configuring your Contract Express integration sample

to use your client
Finally, you should configure your integration sample to use your client as follows,

1. Open your integration sample in Visual Studio and open the Web.config file.
2. Update the ContractExpressBaseUrl, on line 12; this should be the URL you
navigate to in your browser, for example, https://eu1.contractexpress.com/app/.

<add key="ContractExpressBaseUrl" value="https://eu1.contractexpress.com/app/"/>

3. Update the ClientId and ClientSecret, on lines 15 and 16, to match your Contract
Express client ID and secret.

<add key="ClientId" value="MyClient" />

<add key="ClientSecret" value="a79130cc-eecd-4f97-88c7-2427f144b133" />

Trouble Shooting
When you first run your integration sample in Visual Studio you may see an error
message saying that the “Process with an Id of #### is not running.”

It seems to be caused when you move a solution between environments or versions of

Visual Studio. To solve the problem,
 1. Close Visual Studio.
2. Navigate to your Contract Express Integration Sample solution folder and delete
the hidden .vs folder.
3. Restart Visual Studio.
4. Run your Contract Express Integration Sample.

For more details please see this Stack Overflow post.