Insertar Registro

UiPath.MicrosoftDynamics.Activities.InsertRecord

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

After inserting the record, the activity outputs the status of the request (success/failure information) in a ResponseStatus object (MicrosoftDynamicsStatus) that you can use in subsequent activities (e.g., conditional logic).

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. Añade la actividad Ámbito de aplicación de Microsoft Dynamics a tu proyecto.
3. Add the Insert Record activity inside the Microsoft Dynamics Application Scope activity.
4. Click the Configure button inside the Insert Record activity (this opens the Object Wizard).
5. Select the Object you want to insert and add the fields (with values) that you want to populate.
6. Crea e introduce una variable ResponseStatus para la propiedad Salida .

   • Los valores de propiedad 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

To enter your Insert Record property values, you must use the Object Wizard by clicking the Configure button.

Al seleccionar un objeto utilizando el Asistente de objetos, puedes añadir los campos que deseas 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

• AdditionalFields - A DataRow that includes the columns and values that you want to insert. Enter a DataRow variable.
  • To determine/validate your DataRow column names, click the Configure button, select your Object, and review the names shown in the Field column; your DataRow column names must match the shown value.
  • If you enter a value for a field in both the Object Wizard and the AdditionalFields property, the value entered in the Object Wizard takes precedent (overwriting the AdditionalFields value).

Común

• DisplayName - The display name of the activity. This field supports only Strings or String variables.

Otros

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

Salida

• ResponseStatus - The status of the request (success/failure information). Enter a ResponseStatus variable (UiPath.BAF.Models.ResponseStatus). The ResponseStatus object includes three properties that you can use in other activities.
  • Success - Boolean - Specifies whether the API request was successful.
  • ErrorCode - String - The response error if the API request is unsuccessful (Success=False).
  • Message - String - The error message.

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 .