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. Puede descargar el ejemplo desde aquí.
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:
- Descargar o clonar el informe de Muestras para que tenga una copia local.
- (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.
- 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 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, el ejemplo hará lo siguiente:
Programa de instalación
- Comprobaciones para la versión actual de la organización.
- Importación de una solución administrada (UpsertSample_1_0_0_0_managed.zip) que cree una entidad
sample_product
que tenga una clave alternativa denominadasample_productcode
. Compruebe que los índices para admitir la clave alternativa estén activos.
Demostración
- El método
ProcessUpsert
procesa datos ennewsampleproduct.xml
para representar nuevos productos y crea 13 nuevos registros. - La segunda vez que se llama al método
ProcessUpsert
, este procesa datos en el archivoupdatedsampleproduct.xml
para representar actualizaciones a productos creados anteriormente. - 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 entidades y los datos creados por el ejemplo. Puede eliminar manualmente los registros para obtener el mismo resultado.
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta:Enviar y ver comentarios de