Ejemplo: Insertar o actualizar un registro mediante Upsert

Este código de ejemplo muestra cómo insertar o actualizar registros mediante el mensaje de UpsertReques.

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

El mensaje UpsertRequest está diseñado para usarse en un escenario donde contenga los datos necesarios para actualizar o insertar un registro.

Cómo funciona esta muestra

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

Configuración

1. Comprueba la versión actual de la organización.
2. Importe un solución administrada (UpsertSample_1_0_0_0_managed.zip) que cree una tabla sample_product que tiene un clave alternativa llamado sample_productcode. Compruebe que los índices para admitir la clave alternativa estén activos.

Demostración

1. El método ProcessUpsert procesa datos en newsampleproduct.xml para representar nuevos productos y crea 13 nuevos registros.
2. La segunda vez que se llama al método ProcessUpsert, este procesa datos en el archivo updatedsampleproduct.xml para representar actualizaciones a productos creados anteriormente.
3. El método UpsertRequest crea 6 registros actualizados.

Limpiar

Muestra una opción para eliminar la solución administrada creada 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.