Compatibilidad con la API

Todas las entidades se pueden modificar mediante la API de OneSpan Sign for Microsoft Dynamics CRM. La API de OneSpan Sign for Microsoft Dynamics CRM es accesible a través del servicio de la organización llamado organization.svc.

En Configuración > Personalizaciones > Recursos de desarrollador, los integradores pueden utilizar la API para realizar las siguientes operaciones:

• Crear, actualizar y eliminar registros de convenciones
• Crear, actualizar y eliminar nuevos registros de etiquetas de firmantes
• Crear, actualizar y eliminar nuevos registros de etiquetas de texto
• Asociar convenciones a formularios
• Asociar convenciones a transacciónes
• Asociar etiquetas de firmantes a los firmantes de una transacción o formulario
• Crear, actualizar y eliminar registros de asignación de campos
• Activar o desactivar ajustes de preparación automática de una transacción o formulario
• Activar o desactivar ajustes de inserción de una transacción o formulario
• Activar o desactivar convenciones

Para obtener más información, consulte este sitio web de la API.

En esta sección se describe lo siguiente:

• Conectarse a una organización
• Crear un registro
• Actualizar un registro
• Eliminar un registro
• Asociar un registro de entidad a otro

Conectarse a una organización

Descripción/finalidad	ServiceProxy: Proporciona un canal de WCF autenticado al servicio de la organización
Parámetros	Uri: El URI del servicio de la organización HomeRealmUri: Este parámetro se establece en un valor no nulo cuando se configura una segunda instancia de ADFS como un proveedor de identidad de la instancia de ADFS para la que se configuró OneSpan Sign for Microsoft Dynamics CRM para la autenticación de notificaciones. El valor del parámetro es el URI del extremo de metadatos de WS-Trust de la segunda instancia de ADFS. ClientCredentials: Las credenciales de inicio de sesión del cliente DeviceCredentials: Las credenciales del dispositivo de Windows Live ID.
Valores devueltos	URI del servicio de la organización

Consulte el siguiente fragmento de código para la configuración de la conexión. Conecta con una organización específica en OneSpan Sign for Microsoft Dynamics CRM.

Crear un registro

Descripción/finalidad	ServiceProxy .Create: Crea un nuevo registro
Parámetros	Entity: Una instancia de entidad que contiene las propiedades que se establecerán en el registro recién creado. Por ejemplo: Cuenta, Cliente potencial, etc.
Valores devueltos	GUID del registro recién creado

Para crear un nuevo registro de entidad, consulte el siguiente fragmento de código. Se pueden crear registros en cualquiera de las entidades de OneSpan Sign for Microsoft Dynamics CRM.

Actualizar un registro

Descripción/finalidad	ServiceProxy .Update: Actualiza una entidad existente
Parámetros	Entity: Una instancia de entidad que contiene las propiedades que se establecerán en el registro recién creado. Por ejemplo: Cuenta, Cliente potencial, etc.
Valores devueltos

Para actualizar el valor de un campo, consulte el siguiente fragmento de código:

Eliminar un registro

Descripción/finalidad	ServiceProxy .Delete: Elimina una entidad existente
Parámetros	Entity: Una instancia de entidad que contiene las propiedades que se establecerán en el registro recién creado. Por ejemplo: Cuenta, Cliente potencial, etc. GUID: El GUID del registro que se eliminará.
Valores devueltos

Para eliminar un registro de una entidad, consulte el siguiente fragmento de código:

Asociar un registro de entidad a otro

Descripción/finalidad	ServiceProxy .Associate: Asocia una entidad existente a otra
Parámetros	Entity: Una instancia de entidad que contiene las propiedades que se establecerán en el registro recién creado. Por ejemplo: Cuenta, Cliente potencial, etc. GUID: El GUID del registro que se eliminará. Relationship: El nombre de la relación que se utilizará para crear el vínculo. EntityReferenceCollection: Un conjunto de referencias de entidad (a registros) que se asociarán.
Valores devueltos

Para asociar un registro de entidad a otro, consulte el siguiente fragmento de código: