Inicio rápido: registros

Información general

El propósito de esta guía es ayudarle a crear una muestra de trabajo que utilice las siguientes actividades de Microsoft Dynamics 365:

• Insertar Registro
• Buscar Registros
• Obtener Registro
• Eliminar registro

Esta muestra funcional le permite verificar rápidamente la conexión a su aplicación Microsoft Dynamics 365 y familiarizarse con los tipos de datos de entrada / salida de la actividad.

Después de completar los pasos de esta guía, tendrá una secuencia de automatización que hará lo siguiente:

1. Establece una conexión con tu aplicación Microsoft Dynamics 365 (Obtener credencial y Ámbito de aplicación de Microsoft Dynamics).
2. Inserta un nuevo registro de cuenta (Insertar registro).
3. Busca el registro de cuenta insertado (Buscar registros).
4. Actualiza el campo del sitio web del registro de la cuenta (Actualizar registro).
5. Verifica que el registro de la cuenta se haya actualizado correctamente (Obtener registro).

6. Elimina el registro de la cuenta insertado (Eliminar registro).

   Nota: aunque puede haber formas más eficientes de lograr el mismo resultado, el objetivo de esta secuencia es mostrar todas las actividades de grabación.

Requisitos previos

Antes de comenzar:

1. Complete los pasos de configuración de Microsoft Dynamics 365.

2. Utiliza el Administrador de paquetes para instalar el paquete Microsoft.Activities.Extensions (esto es para la actividad Buscar registros ).

   Nota: Esta guía usa CredencialesDelCliente como Tipo de autenticación en la actividad Ámbito de la aplicación Microsoft Dynamics . Si prefiere usar Credenciales de contraseña, puede omitir el paso 1 (agregar una actividad Obtener credencial ) y seguir los subpasos con viñetas del paso 2 (agregar la actividad Ámbito de aplicación de Microsoft Dynamics ).

Pasos

Construya su proyecto

1. Añade una actividad Obtener credencial .
2. Introduce el NombreDeActivo para el activo de credencial que creaste (durante la configuración) para el Secreto de cliente de la aplicación (por ejemplo, "MicrosoftDynamics365Credentials").
3. Crea e introduce una variable SecureString para la propiedad Contraseña (por ejemplo, clientSecret).
4. Crea e introduce una variable String para la propiedad Nombre de usuario (por ejemplo, clientId).
5. Agrega la actividad Ámbito de aplicación de Microsoft Dynamics 365 después de la actividad Obtener credencial .

6. Haz clic en el botón Configurar (se abre el Asistente de conexión), selecciona tu Tipo de autenticación, introduce tus credenciales y haz clic en el botón Probar conexión . Para obtener más información sobre la finalidad y el comportamiento de este asistente, consulte la sección.

   • Este paso es solo para fines de tiempo de diseño. Para rellenar las propiedades del Ámbito de la aplicación de Microsoft Dynamics , siga los pasos que se indican a continuación.

7. En la propiedad AuthenticationType , selecciona tu tipo de autenticación preferido.

   • Si seleccionas CredencialesDeContraseña, crea una variable String para el IDdeCliente (p. Ej., Nombre: clientId Predeterminado: "56X9aXXX-b5d9-4a90-XXXX-13XX9643XXXX")
8. En la propiedad ClientId , introduce la variable String que creaste para la actividad Obtener credencial o el subpaso anterior (p. Ej., ClientId).
9. En la propiedad SecretoDelCliente , introduce la variable SecureString que creaste para la actividad Obtener credencial (p. Ej., SecretoDelCliente).
   • Si seleccionaste CredencialesDeContraseña deja vacía la propiedad SecretoDelCliente .
10. En la propiedad URLDelPuntoFinal , cree e introduzca una variable String con la URL de la instancia de CRM a la que desea conectarse (p. Ej., Nombre: URLDelPuntoFinal Predeterminado: "https://uipath.crm4. )
11. En la propiedad TenantId , cree e introduzca una variable String para el ID de directorio (tenant) asignado a su tenant de Azure Active Directory (ADD) (p. Ej., Nombre: tenantId Predeterminado: "d8353d2a-b153-4d17-8827-902cXXXXXXX") .

    • Si has seleccionado CredencialesDeContraseña, selecciona tu preferencia de solicitud de contraseña (opciones).

      
      

      

      
      

12. Agrega la actividad Insertar registro dentro de la actividad Ámbito de aplicación de Microsoft Dynamics .

    1. Haz clic en el botón Configurar dentro de la actividad Insertar registro (esto abre el Asistente de objetos).

       1. En la lista desplegable Seleccionar entidad , selecciona Cuenta.
       2. En el campo accountId , crea e introduce una variable String (p. Ej., AccountId).
       3. En el cuadro de texto " Añadir un solo campo ", introduce el nombre y haz clic en Intro.
       4. En el campo del nombre , introduce un nombre de cuenta (por ejemplo, "Quickstart_Account").

       5. Haz clic en el botón " Listo ".

          
          

          

          
          
    2. Añade una actividad Añadir al diccionario después de la actividad Insertar registro .
    3. En la propiedad Diccionario , crea e introduce una variable Dictionary<String,String> según corresponda: Nombre: OpciónDeConsulta, Predeterminado: new Diccionario (De String, String) (puedes usar un valor de Nombre diferente, pero es obligatorio el valor Predeterminado ).
    4. En la propiedad Clave , introduce "$ filter".

    5. En la propiedad Valor , introduzca "name eq 'Quickstart_Account'" (Quickstart_Account es el nombre de la cuenta que insertó en los pasos anteriores. Si ha introducido un nombre diferente, utilice ese valor en su lugar).

       • Para obtener más información sobre los valores de consulta, consulta las páginas de metadatos de consulta y/o datos de consulta en la documentación de Microsoft.
    6. Agregue la actividad Buscar registros después de la actividad Añadir al diccionario .
    7. En la propiedad de Objeto , selecciona Cuenta.
    8. En la propiedad Opciones de consulta , introduce la variable Dictionary<String,String> que creaste anteriormente (p. Ej., OpciónDeConsulta).
    9. En la propiedad Resultado , crea e introduce una variable DataTable (p. Ej., SearchResults).
       
       

       

       
       

13. Añade una actividad Asignar después de la actividad Buscar registros .

    1. En la propiedad Para , crea e introduce una variable String (p. Ej., WebURL).

    2. En la propiedad Valor , introduce lo siguiente: resultadosDeBúsqueda.Rows (0) .Item ("URLDel sitio web"). Cadena de meta.

       • Para obtener más información sobre los nombres de columna de cada entidad, consulta la Referencia de tipo de entidad de la API web en la documentación de Microsoft.
    3. Añade una actividad Si después de la actividad Asignar .
    4. Cree una variable String con un valor predeterminado de una URL (por ejemplo, Nombre: sitio web, Predeterminado: "www.uipath.com").
    5. En la propiedad Condición , introduce lo siguiente: webURL = sitio web.
    6. En el cuadro Instrucción Entonces , agregue una actividad Escribir línea con el siguiente texto: "Sitio web presente".

    7. En el cuadro Instrucción Si no, añade la actividad Actualizar registro .

       1. Haz clic en el botón Configurar dentro de la actividad Actualizar registro (se abre el Asistente de objetos).

          1. En la lista desplegable Seleccionar entidad , selecciona Cuenta.
          2. En el campo accountId , introduce la variable String que creaste para la actividad Insertar registro (p. Ej., AccountId).
          3. En el cuadro de texto " Añadir un solo campo ", introduce URL del sitio web y haz clic en Intro.
          4. En el campo del nombre , introduce la variable String que creaste en el paso anterior (p. Ej., Sitio web).

          5. Haz clic en el botón " Listo ".

             
             

             

             
             

Pruebe su proyecto

1. Añade la actividad Obtener registro después de Actualizar registro (dentro del cuadro de instrucción Si no).

   1. Haga clic en el botón Configurar dentro de la actividad Obtener registro (esto abre el Asistente de objetos).

      1. En la lista desplegable Seleccionar entidad , selecciona Cuenta.
      2. En el campo accountId , introduce la variable String que creaste para la actividad Insertar registro (p. Ej., AccountId).
      3. En el cuadro de texto " Añadir un solo campo ", introduce URL del sitio web y haz clic en Intro.
      4. En el campo URLDel sitio web , crea e introduce una variable String (p. Ej., VerificaciónDelWeb).
      5. Haz clic en el botón " Listo ".
   2. Agrega una actividad Si después de la actividad Obtener registro (dentro del cuadro de instrucción Si no).
   3. En la propiedad Condición , introduce lo siguiente: website = websiteVerification.
   4. En el cuadro Instrucción Entonces , agregue una actividad Escribir línea con el siguiente texto: "¡La actualización del sitio web se realizó correctamente!".
   5. En el cuadro Instrucción Entonces , agregue una actividad Escribir línea con el siguiente texto: "Error en la actualización del sitio web".

2. Agregue la actividad Eliminar registro fuera de la primera actividad Si .

   1. En la propiedad de Objeto , selecciona Cuenta.
   2. En el campo ID , introduce la variable String que creaste para la actividad Insertar registro (p. Ej., AccountId).
   3. En la propiedad MicrosoftDynamicsStatus , crea e introduce una variable ResponseStatus (por ejemplo, respuestaStatus).

3. Añade una actividad Escribir línea después de la actividad Eliminar registro .

   1. En la propiedad Texto , ingresa lo siguiente: "Registro eliminado:" + EstadoDeRespuesta.Success.ToString.

4. Haz clic en Ejecutar y verifica que la ventana de Salida incluya los valores de línea de escritura esperados.

   
   

   

   
   

¡Ya está!

Para obtener más información sobre las actividades de Microsoft Dynamics 365 (incluidas las entradas / salidas de propiedades de ejemplo), consulta la página Actividades para obtener una lista completa de actividades y enlaces a las páginas de detalles de las actividades.