Ejemplo: creación de un rol de conexión recíprocaSample: Create a reciprocal connection role

Este ejemplo muestra cómo crear los roles de conexión recíproca.This sample shows how to create the reciprocal connection roles. 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.It creates a connection role for an account and a connection role for a contact, and then makes them reciprocal by associating them with each other. Puede descargar el ejemplo desde aquí.You can download the sample from here.

Cómo ejecutar esta muestraHow to run this sample

  1. Descargar o clonar el informe de Muestras para que tenga una copia local.Download or clone the Samples repo so that you have a local copy.
  2. (Opcional) Edite el archivo cds/App.config para definir una cadena de conexión que especifique la instancia de Common Data Service a la que desea conectarse.(Optional) Edit the cds/App.config file to define a connection string specifying the Common Data Service instance you want to connect to.
  3. Abra la solución de ejemplo en Visual Studio y presione F5 para ejecutar la muestra.Open the sample solution in Visual Studio and press F5 to run the sample. Una vez que especifique una cadena de conexión en cds/App.config, cualquier muestra que ejecute utilizará esa información de conexión.After you specify a connection string in cds/App.config, any sample you run will use that connection information.

Si no especifica una cadena de conexión en el archivo cds/App.config, se abrirá un diálogo cada vez que ejecute la muestra y tendrá que introducir información acerca de a qué instancia Common Data Service desea conectarse y qué credenciales desea usar.If you do not specify a connection string in cds/App.config file, a dialog will open each time you run the sample and you will need to enter information about which Common Data Service instance you want to connect to and which credentials you want to use. Este diálogo guardará en caché conexiones anteriores para que pueda elegir una conexión usada previamente.This dialog will cache previous connections so that you can choose a previously used connection.

Las muestras en este informe que requieran una conexión a una instancia de Common Data Service para ejecutarse incluirá una referencia vinculada al archivo cds/App.config.Those samples in this repo that require a connection to a Common Data Service instance to run will include a linked reference to the cds/App.config file.

Qué hace este ejemploWhat this sample does

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.The ConnectionRole and ConnectionRoleObjectTypeCode messages are intended to be used in a scenario where it contains data that is required to create a new connection role and connection role object type.

Cómo funciona esta muestraHow this sample works

Para simular el escenario descrito en Qué hace este ejemplo, la muestra hará lo siguiente:In order to simulate the scenario described in What this sample does, the sample will do the following:

ConfiguraciónSetup

  1. Comprobaciones para la versión actual de la organización.Checks for the current version of the org.
  2. El mensaje ConnectionRole crea roles de conexión necesarios para el ejemplo.The ConnectionRole message creates connection roles required for the sample.
  3. El mensaje ConnectionRoleObjectTypeCode crea el registro de código de tipo de objeto de rol de conexión para la cuenta.The ConnectionRoleObjectTypeCode message creates the connection role object type code record for account.
  4. El mensaje AssociateRequest asocia los roles de conexión entre sí.The AssociateRequest message associates the connection roles with each other.

DemostraciónDemonstrate

  1. Realizar la solicitud inicial y almacenar en caché los resultados, incluido el DataTokenPerform initial request and cache the results, including the DataToken
  2. Actualizar los registros creados en ConfiguraciónUpdate the records created in Setup
  3. Realice una segunda solicitud, esta vez pasando la DataVersion con el valor de DataToken recuperado de la solicitud inicial.Perform a second request, this time passing the DataVersion with the DataToken value retrieved from the initial request.
  4. Mostrar los cambios de entidad devueltos por la segunda solicitudShow the entity changes returned by the second request

LimpiarClean up

Muestra una opción para eliminar los datos de ejemplo creados en Configuración.Display an option to delete the sample data that is created in Setup. La eliminación es opcional en caso de que desee examinar las entidades y los datos creados por el ejemplo.The deletion is optional in case you want to examine the entities and data created by the sample. Puede eliminar manualmente los registros para obtener el mismo resultado.You can manually delete the records to achieve the same result.