Insertar Registro

UiPath.MicrosoftDynamics.Activities.InsertRecord

La actividad Insertar registro utiliza la operación POST de la API web para insertar un nuevo registro.

Después de insertar 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).

Si la solicitud tiene éxito, la actividad devuelve el identificador String asignado al nuevo registro. Por ejemplo, si quieres insertar una cuenta, puedes generar el valor de AccountId añadiendo una variable String utilizando el botón de configuración (consulta el ejemplo a continuación).

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 Insertar registro dentro de la actividad Ámbito de aplicación de Microsoft Dynamics .
4. Haz clic en el botón Configurar dentro de la actividad Insertar registro (esto abre el Asistente de objetos).
5. Seleccione el Objeto que desea insertar y agregue los campos (con valores) que desea completar.
6. 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 identificador String y los valores ResponseStatus a tus variables de propiedad de salida.
     
     

     

     
     

Configurar

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

Cuando selecciona un objeto usando el Asistentepara objetos, puede agregar los campos que desea incluir en el nuevo registro. 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 .