Compartir a través de


Ejemplo: Insertar o actualizar un registro mediante Upsert

 

Publicado: noviembre de 2016

Se aplica a: Dynamics CRM 2015

Este código de ejemplo muestra cómo insertar o actualizar registros mediante el mensaje de Upsert. Para obtener más información acerca de la característica que este ejemplo demuestra, consulte Use Upsert para insertar o actualizar un registro.

Este ejemplo es para Actualización 1 de Microsoft Dynamics CRM Online 2015. Esta opción está disponible para descargar de Insertar o actualizar un registro con Upsert.

Requisitos previos

  1. Obtenga acceso a una organización de Actualización 1 de Microsoft Dynamics CRM Online 2015.

  2. Descargue el proyecto UpsertSample Visual Studio.

  3. Abra el proyecto UpsertSample Visual Studio e instale el paquete NuGet de Microsoft.CrmSdk.CoreAssemblies versión 7.1.0-preview. Vea Instalar paquetes NuGet para obtener instrucciones.

  4. Después de instalar los paquetes NuGet, consulte Ejecutar el ejemplo para obtener instrucciones sobre cómo ejecutar el ejemplo y qué esperar.

En este tema

Qué hace este ejemplo

Instalar paquetes NuGet

Ejecutar el ejemplo

Qué hace este ejemplo

  1. El método Run de la clase ProductUpsertSample llama al método ImportUpsertSampleSolution que primero detecta si la solución administrada de UpsertSample ya está instalada. Si no lo está, el archivo UpsertSample_1_0_0_0_managed.zip se importa para instalar esta solución administrada.

    Esta solución administrada contiene una entidad sample_product personalizada que se utiliza para este ejemplo. Esta entidad tiene una clave alternativa de sample_productcode que crea una restricción única en los valores almacenados en ese atributo.

  2. El método WaitForEntityAndKeysToBeActive es necesario porque las claves alternativas necesarias para este ejemplo no pueden estar listas inmediatamente después de que se instale la solución UpsertSample. Este método sondea los metadatos para la entidad de sample_product para retardar la ejecución del resto del ejemplo hasta que las claves alternativas estén listas.

  3. La primera vez que se llama al método ProcessUpsert, este procesa datos en el archivo newsampleproduct.xml para representar nuevos productos. La UpsertRequest se pasa al método Execute para crear 13 nuevos registros.

    La propiedad UpsertResponse.RecordCreated devuelve verdadero para indicar que se crearon nuevos registros.

    Antes de que el método ProcessUpsert se complete, el programa preguntará si desea ver los registros de entidad del producto de ejemplo. Si el contestar con"y" el programa intentará abrir Internet Explorer en una vista que muestre los registros recién creados.

  4. 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. El mensaje Upsert se usa para actualizar 6 registros. La propiedad UpsertResponse.RecordCreated devuelve falso, lo que muestra que los registros se actualizaron.

    Una vez más, el método ProcessUpsert preguntará si desea ver los registros del explorador. Si ya tiene abierta la vista, puede simplemente actualizar la vista para observar los cambios.

  5. Finalmente, la DeleteUpsertSampleSolution le pedirá que elimine la solución administrada de ejemplo de Upsert.

    Si elige" y", la solución administrada se eliminará incluida la entidad de sample_product y todos los datos que contiene. Su organización se quedará sin nada agregado.

    Si elige "n", puede inspeccionar los detalles de la solución incluidos los datos creados por el ejemplo. Pero debe eliminar manualmente la solución administrada para devolver a su organización al estado original.

Instalar paquetes NuGet

Use los siguientes pasos para instalar los ensamblados necesarios para este ejemplo:

  1. Descargue este ejemplo y extraiga los archivos.

  2. Navegue a la carpeta de C# y abra el archivo UpsertSample.sln con Visual Studio.

  3. En Visual Studio, haga clic con el botón secundario en el proyecto UpsertSample y elija Administrar paquetes de NuGet.

  4. Para la versión de vista previa, asegúrese de seleccionar Incluir vista previa en lugar de Solo estable en los criterios de búsqueda. A continuación busque "Microsoft Dynamics CRM 2015 SDK core assemblies". Asegúrese de seleccionar la versión 7.1.0-preview.

  5. Haga clic en Instalar. Necesitará aceptar los términos de licencia para completar la instalación de este paquete.

Ejecutar el ejemplo

  1. En Visual Studio, con la solución abierta y los paquetes NuGet necesarios instalados, presione F5.

  2. Si no ha ejecutado anteriormente uno de los ejemplos de código administrado de Microsoft Dynamics CRM antes, deberá especificar información para ejecutar el código; si no, especifique el número de uno de los servidores de CRM que configuró anteriormente.

    Pregunta

    Descripción

    Escriba un nombre de servidor y un puerto de CRM [crm.dynamics.com]

    Escriba el nombre del servidor de Microsoft Dynamics CRM. El valor predeterminado es Microsoft Dynamics CRM Online (crm.dynamics.com) en Norteamérica.

    Ejemplo:
    crm5.dynamics.com

    Está esta organización aprovisionada en servicios en línea de Microsoft (y/n) [n]

    Escriba y si esta es una organización aprovisionada en servicios en línea de Microsoft. De lo contrario, escriba n.

    Escriba domain\username

    Escriba su cuenta de Microsoft.

    Escriba la contraseña

    Escriba la contraseña. Los caracteres se mostrarán en la ventana como "*". Su contraseña se guardará con seguridad en el Administrador de credenciales de Microsoft para poder utilizarla posteriormente.

    Especifique un número de organización (1-n) [1]

    En la lista de organizaciones que muestra que usted pertenece, escriba el número correspondiente. El valor predeterminado es 1, que indica la primera organización de la lista.

  3. El ejemplo realizará las operaciones descritas en Qué hace este ejemplo y puede pedirle opciones adicionales.

  4. Cuando se completa el ejemplo, presione Entrar para cerrar la ventana de la consola.

Ver también

Use Upsert para insertar o actualizar un registro

© 2017 Microsoft. Todos los derechos reservados. Copyright