Compartir a través de

Ejemplo: agregar un registro a una cola (con enlace en tiempo de compilación)

  • Artículo

Este ejemplo muestra cómo agregar registros a una cola. Crea colas de origen y de destino. Agrega una actividad de carta a la cola de origen y luego la traslada a la cola de destino. Puede descargar el ejemplo desde aquí.

Este ejemplo requiere usuarios adicionales que no están en el sistema. Cree los usuarios manualmente en Office 365 para ejecutar el ejemplo sin errores. Para este ejemplo cree un perfil de usuario tal cual se muestra abajo.

Nombre: Kevin
Apellidos: Cook
Rol de seguridad: jefe de ventas
UserName: kcook@yourorg.onmicrosoft.com

Nota

Este ejemplo se aplica tanto a Dynamics 365 Customer Engagement (on-premises) como a Dataverse.

Cómo ejecutar esta muestra

Para obtener una copia local de todas las muestras y compilarlas, siga estos pasos:

  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 o la organización 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 abre un diálogo cada vez que ejecute la muestra y tendrá que introducir información acerca de a qué instancia u org desea conectarse y qué credenciales desea usar. Este diálogo guardará en caché conexiones anteriores para que pueda elegir una conexión usada previamente.

Qué hace este ejemplo

El mensaje AddToQueueRequest está diseñado para usarse en un escenario donde contenga datos necesarios para mover el registro de la entidad de una cola de origen a la cola de destino.

Cómo funciona esta muestra

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

Configuración

  1. Comprobaciones para la versión actual de la organización.
  2. El método Queue crea colas de origen y de destino y almacena sus GUID devueltas en variable.
  3. Crea una entidad Carta.
  4. El método AddToQueueRequest agrega un registro de entidad en una cola, en este ejemplo asocia la carta a la primera cola.
  5. Recupera el usuario creado manualmente en Office 365 para asignar los elementos de la cola a la cola de usuario.

Demostración

  1. El mensaje RetrieveUserQueueRequest recupera las colas privadas que el usuario conoce.
  2. El mensaje AddToQueueRequest agrega el registro de una cola de origen a la cola de destino.

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 entidades y los datos creados por el ejemplo. Puede eliminar manualmente los registros para obtener el mismo resultado.