Ejemplo: Insertar o actualizar un registro mediante Upsert

  • Artículo

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

SDK para .NET: código de ejemplo de Insertar o actualizar un registro utilizando Upsert

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.

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).