Support for the API

All entities can be modified using the eSignLive for Microsoft Dynamics CRM API. The API in eSignLive for Microsoft Dynamics CRM can be accessed through the organization service called organization.svc.

By navigating to Settings > Customizations > Developer Resources, integrators can use the API to perform the following operations:

  • Create, update, and delete Convention records
  • Create, update, and delete new Signer Label records
  • Create, update, and delete new Text Tag records
  • Associate Conventions to Templates
  • Associate Conventions to Packages
  • Associate Signer Labels to Signers within a Package or Template
  • Create, update, and delete Field Mapping records
  • Enable or disable auto-prepare settings for a Package or a Template
  • Enable or disable insert settings for a Package or a Template
  • Activate or deactivate Conventions

For more information, consult the eSignLive for Microsoft Dynamics CRM API website.

This section describes the following:

Connecting to an Organization

Description/Purpose ServiceProxy: Provides an authenticated WCF channel to the organization service
Parameters
  • Uri: The URI of the organization service
  • HomeRealmUri: This parameter is set to a non-null value when a second ADFS instance is configured as an Identity Provider to the ADFS instance to which eSignLive for Microsoft Dynamics CRM has been configured for claims authentication. The parameter value is the URI of the WS-Trust metadata endpoint of the second ADFS instance.
  • ClientCredentials: The logon credentials of the client
  • DeviceCredentials: The Windows Live ID device credentials.
Returned values URI of the organization service

Refer to the following code snippet for the connection setup. This connects to a specific organization in eSignLive for Microsoft Dynamics CRM.

Creating a Record

Description/Purpose ServiceProxy.Create: Creates a new record
Parameters Entity: An entity instance that contains the properties to set in the newly created record. E.g. Account, Lead, etc.
Returned values GUID of the newly created record

To create a new entity record, refer to the following code snippet. Records can be created into any of the entities in eSignLive for Microsoft Dynamics CRM.

Updating a Record

Description/Purpose ServiceProxy.Update: Updates an existing entity
Parameters Entity: An entity instance that contains the properties to set in the newly created record. E.g. Account, Lead, etc.
Returned values  

To update a field value, refer to the following code snippet:

Deleting a Record

Description/Purpose ServiceProxy.Delete: Deletes an existing entity
Parameters

Entity: An entity instance that contains the properties to set in the newly created record. E.g. Account, Lead, etc.

GUID: The GUID of the record to delete.

Returned values  

To delete a record in an entity, refer to the following code snippet:

Associating an Entity Record to Another

Description/Purpose ServiceProxy.Associate: Associates an existing entity to another
Parameters

Entity: An entity instance that contains the properties to set in the newly created record. E.g. Account, Lead, etc.

GUID: The GUID of the record to delete.

Relationship: The name of the relationship to be used to create the link.

EntityReferenceCollection: A collection of entity references (to records) to be associated.

Returned values  

To associate one entity record to another, refer to the following code snippet:

Was this information helpful?
X