Compartir a través de

Ejemplo: Insertar o actualizar un registro mediante Upsert

  • Artículo

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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.

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 Microsoft Dynamics 365 o Actualización de CRM Online 2016.

  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 8.0.0-preview o posterior. 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 haga clic en Administrar paquetes de NuGet.

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

  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 365 antes, deberá especificar información para ejecutar el código; si no, especifique el número de uno de los servidores de Dynamics 365 que configuró anteriormente.

    Pregunta

    Descripción

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

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

    Ejemplo:
    myservername
    myprefix.myservername:5500
    crm5.dynamics.com

    No incluya el nombre de la organización o protocolo de Internet (http o https). Se le pedirá esta información más adelante.

    Este servidor está configurado para Capa de sockets seguros (https) (s/n) [n]

    Escriba y si la dirección URL que utiliza para tener acceso a Microsoft Dynamics 365 empieza con https://, en caso contrario, escriba n.

    Está esta organización aprovisionada en Microsoft Office 365 ([s/n)n]

    Escriba s si se trata de una organización aprovisionada para Microsoft Office 365. De lo contrario, escriba n.

    Escriba domain\username

    Escriba su cuenta de Microsoft.
    Para Microsoft Dynamics 365, escriba el dominio de red y nombre de usuario separados por una barra diagonal inversa (\).

    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

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright