Buscar Registros

UiPath.MicrosoftDynamics.Activities.SearchRecords

Usando tus parámetros de búsqueda (QueryOptions y Object), la actividad Buscar registros usa la operación GET de la API web para recuperar registros.

Después de recuperar los registros, la actividad genera los resultados en un objeto DataTable (Resultado) y el estado de la solicitud (información de éxito / error) en un objeto ResponseStatus (MicrosoftDynamicsStatus), que puede usar en actividades posteriores (p. ej., lógica condicional, Actualizar registro, Descargar archivo adjunto de actividad, etc.).

Cómo funciona

Los siguientes pasos y diagrama de secuencia de mensajes son un ejemplo de cómo funciona la actividad desde el momento de diseño (es decir, las dependencias de la actividad y las propiedades de entrada / salida) hasta el tiempo de ejecución.

1. Completa los pasos de configuración .
2. Agrega la actividad Ámbito de aplicación de Microsoft Dynamics a tu proyecto.
3. Agrega la actividad Buscar registros dentro de la actividad Ámbito de la aplicación Microsoft Dynamics .
4. Selecciona el Objeto que deseas recuperar e introduce tus parámetros de búsqueda en la propiedad Opciones .
5. Crea e introduce una variable DataTable y una ResponseStatus para las propiedades de salida .
   • Los valores de tus propiedades de entrada se envían en la solicitud de operación GET .
   • La operación devuelve los valores DataTable y ResponseStatus a tus variables de propiedad de salida.
     
     

     

     
     

En el cuerpo de la actividad

• Objeto : selecciona un objeto utilizando el Asistente de objetos.

Propiedades

Común

• Nombre para mostrar: el nombre para mostrar de la actividad. Este campo solo admite cadenas o variables String .

Otros

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.

Opciones

• OpcionesDeConsulta : los parámetros de búsqueda que quieres utilizar para recuperar tus registros. Introduce una variable Dictionary<String, String> o Dictionary<String, String> . Para obtener más información sobre los valores de consulta, consulta los metadatos de la consulta y las páginas de datos de la consulta en la documentación de Microsoft. Consulta los pasos a continuación para ver una forma de crear y rellenar una variable Dictionary<String, String> .
  Nota:

  La siguiente es una forma de rellenar una variable Dictionary<String, String> :

  • Instale el paquete Microsoft.Activities.Extensions .
  • Crear una nueva variable Dictionary<String, String> (p. Ej., OpciónDeConsulta).
  • Añade una actividad Añadir al diccionario .
  • Introduzca su variable de diccionario (p. Ej., OpciónDe consulta)
  • Introduzca un método de consulta único en la propiedad Clave (por ejemplo, "$ filter", "$ seleccionar", etc.)

  • Introduzca el valor que se aplicará al método de consulta (por ejemplo, "name eq 'Quickstart_Account'")

    • Repite el paso 3 para aplicar OpcionesDeConsultaadicionales.

Salida

• EstadoDeRespuesta : el estado de la solicitud (información de éxito / error). Introduce una variable ResponseStatus (UiPath.BAF.Models.ResponseStatus). El objeto ResponseStatus incluye tres propiedades que puedes usar en otras actividades.
  • Correcto - Boolean - Especifica si la solicitud de la API se realizó correctamente.
  • CódigoDeError - String : el error de respuesta si la solicitud de la API no tiene éxito (Éxito=Falso).
  • Mensaje - String : el mensaje de error.
• Resultado : los registros que coinciden con tus parámetros de búsqueda. Introduce una variable DataTable .

Ejemplo

La siguiente imagen muestra un ejemplo de la relación de dependencia de la actividad y los valores de las propiedades de entrada / salida.

Para obtener instrucciones paso a paso y ejemplos, consulta la guía de inicio rápido .