Ejemplo: creación de un rol de conexión recíproca

Este ejemplo muestra cómo crear los roles de conexión recíproca. Crea un rol de conexión para una cuenta y un rol de conexión para un contacto y, a continuación, los asocia entre sí para hacerlos recíprocos

Cómo ejecutar esta muestra

1. Descargar o clonar el informe de Muestras para que tenga una copia local.
2. (Opcional) Edite el archivo dataverse/App.config para definir una cadena de conexión que especifique la instancia de Microsoft Dataverse a la que desea conectarse.
3. Abra la solución de ejemplo en Visual Studio y presione F5 para ejecutar la muestra. Una vez que especifique una cadena de conexión en dataverse/App.config, cualquier muestra que ejecute utilizará esa información de conexión.

Si no especifica una cadena de conexión en el archivo dataverse/App.config, se abrirá un diálogo cada vez que ejecute la muestra y tendrá que introducir información acerca de a qué instancia de Dataverse desea conectarse y qué credenciales desea usar. Este diálogo guardará en caché conexiones anteriores para que pueda elegir una conexión usada previamente.

Las muestras en este informe que requieran una conexión a una instancia de Dataverse para ejecutarse incluirá una referencia vinculada al archivo dataverse/App.config.

Qué hace este ejemplo

Los mensajes ConnectionRole y ConnectionRoleObjectTypeCode se pueden usar en un escenario donde contiene los datos que se necesitan para crear un nuevo rol de conexión y un tipo de objeto de rol de conexión.

Cómo funciona esta muestra

Para simular el escenario descrito en Qué hace este ejemplo, el ejemplo hará lo siguiente:

Configuración

1. Comprobaciones para la versión actual de la organización.
2. El mensaje ConnectionRole crea roles de conexión necesarios para el ejemplo.
3. El mensaje ConnectionRoleObjectTypeCode crea el registro de código de tipo de objeto de rol de conexión para la cuenta.
4. El mensaje AssociateRequest asocia los roles de conexión entre sí.

Demostración

1. Realizar la solicitud inicial y almacenar en caché los resultados, incluido el DataToken
2. Actualizar los registros creados en Configuración
3. Realice una segunda solicitud, esta vez pasando la DataVersion con el valor de DataToken recuperado de la solicitud inicial.
4. Mostrar los cambios de la tabla devueltos por la segunda solicitud

Limpiar

Muestra una opción para eliminar los datos de ejemplo creados en Configuración. La eliminación es opcional en caso de que desee examinar las tablas y los datos creados por la muestra. Puede eliminar manualmente los registros para obtener el mismo resultado.

Uso de conexiones para vincular registros entre sí
Describir una relación entre tablas con roles de conexión
Ejemplo: Creación de una conexión
Ejemplo: Creación de un rol de conexión
Ejemplo: Consultar conexiones por registro (enlace en tiempo de compilación)
Ejemplo: Consultar roles de conexión por código de tipo de entidad (enlace en tiempo de compilación)
Ejemplo: Consultar conexiones por roles recíprocos (enlace en tiempo de compilación)
Ejemplo: Actualizar un rol de conexión (enlace en tiempo de compilación)