Obtener Registro

UiPath.MicrosoftDynamics.Activities.GetRecord

La actividad Obtener registro utiliza la operación GET de la API web para recuperar un registro.

Después de recuperar el registro, la actividad genera el estado de la solicitud (información de éxito / error) en un objeto ResponseStatus (MicrosoftDynamicsStatus) que puedes usar en actividades posteriores (p. Ej., Lógica condicional).

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. Añadir una actividad o ejecutar un proceso externo que genere el identificador de registro (por ejemplo, Insertar registro, Buscar registros).
4. Agrega la actividad Obtener registro dentro de la actividad Ámbito de aplicación de Microsoft Dynamics .
5. Haga clic en el botón Configurar dentro de la actividad Obtener registro (esto abre el Asistente de objetos).
6. Seleccione el Objeto que desea recuperar, introduzca el identificador de registro y agregue los campos (con valores) que desea rellenar.
7. Crea e introduce una variable ResponseStatus para la propiedad Salida .
   • Los valores de tus propiedades de entrada se envían en la solicitud de operación POST .
   • La operación devuelve el ResponseStatus y el valor a tu variable de propiedad de salida.
     
     

     

     
     

Configurar

Para introducir los valores de la propiedad Obtener registro , debes utilizar el Asistente para objetos haciendo clic en el botón Configurar .

Cuando seleccionas un objeto utilizando el Asistente de objetos, puedes añadir los campos que deseas actualizar. Para obtener una lista completa de los campos disponibles para cada objeto, consulta la Referencia de tipo de entidad de la API web en la documentación de Microsoft.

Propiedades

Avanzado

• CamposAdicionales : un DataRow que incluye las columnas y valores que quieres insertar. Introduce una variable DataRow .
  • Para determinar / validar los nombres de sus columnas DataRow , haga clic en el botón Configurar , seleccione su Objetoy revise los nombres que se muestran en la columna Campo ; sus nombres de columna DataRow deben coincidir con el valor mostrado.
  • Si introduces un valor para un campo tanto en el Asistente para objetos como en la propiedad CamposAdicionales , el valor introducido en el Asistente para objetos tiene prioridad (sobrescribiendo el valor de CamposAdicionales ).

Común

• NombreParaMostrar: el nombre de la actividad que se muestra. Este campo solo admite variables Strings o String.

Otros

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

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.

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 .