Acciones de crear, actualizar, eliminar y relacionar
Puede utilizar las acciones del conector de Dataverse para crear nuevas filas, modificar filas existentes y relacionar datos mediante las relaciones definidas. Cuando sea necesario, puede utilizar la acción de eliminar para eliminar filas. Las acciones de Dataverse también le permiten dirigirse a un entorno específico con acciones adicionales desde el entorno seleccionado.
Crear nuevas filas
Use la acción Agregar una nueva fila para crear nuevas filas en una tabla de Dataverse. Debe elegir un nombre de tabla y luego la acción le muestra dinámicamente las columnas superiores de esa tabla. Las columnas obligatorias se indican con un asterisco rojo junto al nombre de la columna. No puede guardar el flujo sin proporcionar información para cada columna requerida. Una columna obligatoria es cualquier columna de la tabla que esté configurada como Necesario para la empresa. Si marca otras columnas como Necesario para la empresa en la tabla después de crear un flujo, deberá actualizar su acción la próxima vez que actualice la columna para poder guardar el flujo.
Solo algunas columnas se muestran automáticamente en la pestaña Parámetros de la acción. Las columnas restantes están en Parámetros avanzados.
Actualizar filas
Utilice la acción Actualizar una fila para actualizar una fila de datos existente. Además, puede utilizar la acción para upsert (actualizar o insertar) cuando el id. no coincide con una fila existente; la acción puede crear una nueva fila en su lugar.
El id. de fila es obligatorio en la acción Actualizar una fila y solo necesita actualizar el GUID de la fila de datos. Si obtiene el id. de fila de otra acción o activador de conector de Dataverse, el id. de fila debe tener el mismo nombre que la tabla y la descripción de la columna será Identificador único de la tabla. No utilice la columna OData ID, que es diferente.
A diferencia de la acción Agregar una nueva fila que requiere columnas, la acción Actualizar una fila no requiere columnas. Sin embargo, solo debe cambiar los valores de las columnas cuando cambien los datos. Por ejemplo, pasar la columna Nombre de cuenta cuando no se modifica daría como resultado que otras automatizaciones busquen cambios en la tabla de cuentas que se ejecutará.
Para borrar un valor de columna existente, cambie la columna en la acción para usar una expresión nula.
Crear relaciones entre datos
Puede usar Dataverse para crear relaciones de uno a varios (o de varios a uno, si quiere la relación desde la otra dirección) y de varios a varios entre filas de la tabla. Hay dos opciones disponibles para relacionar filas de datos, según el tipo de relación y con qué fila de la relación está trabajando.
Cuando usa las acciones Agregar una nueva fila o Actualizar una fila, puede actualizar las columnas de búsqueda en la fila de datos que está agregando o actualizando. Por ejemplo, la tabla Cuenta tiene una columna de consulta de contacto principal que representa una relación de varios a uno con el Contacto. Cuando agrega o actualiza una cuenta, también puede establecer la relación con el contacto en la misma acción. No puede establecer esta relación si agrega o actualiza la fila Contacto porque no tiene la columna de búsqueda. La otra opción es utilizar la acción Relacionar filas para establecer la relación por separado.
Solo puede establecer relaciones de varios a varios si usa la acción Relacionar filas. El motivo es que ninguna de las filas de la relación tiene una columna de búsqueda en la que pueda establecer el valor en las acciones Agregar una nueva fila o Actualizar una fila.
Especificar el id. para cada fila
Cuando relaciona filas de datos, debe proporcionar el identificador único global (GUID) de la fila o una URL de fila. Asegúrese de observar la diferencia porque proporcionar un GUID o URL incorrecto genera un error.
Puede obtener el GUID (por ejemplo, fd140aaf-4df4-11dd-bd17-0019b9312238) para una fila que se encuentra en el resultado de un paso anterior de su flujo. Para hacerlo, seleccione el GUID del contenido dinámico mediante la búsqueda de la columna con el mismo nombre que su tabla y una descripción que diga Identificador único para tablename.
Para obtener la URL de la fila, busque en la lista de contenido dinámico el OData ID con una descripción del id. de la fila de OData. Puede redactar manualmente una URL de fila si combina el nombre del conjunto de entidades OData de la tabla con el GUID. El nombre del conjunto de entidades suele ser el nombre lógico de la tabla con la letra "s" agregada. Por lo tanto, el nombre lógico de la tabla Cuenta es cuenta, por lo que el nombre del conjunto de entidades sería cuentas. Una forma rápida de encontrar el nombre de una tabla es agregar una acción de Dataverse, configurar la tabla con el nombre de la tabla cuyo nombre de conjunto de entidades desea conocer y luego cambiar a la vista de código. En la vista de código, el valor EntityName es el nombre del conjunto de entidades que necesita para crear una URL de fila OData. Su URL de la fila de OData debería tener un aspecto similar al del siguiente ejemplo:
contoso_projects(fd140aaf-4df4-11dd-bd17-0019b9312238)
Utilizar la acción Agregar o actualizar una fila
Cuando utiliza la acción Agregar o actualizar una fila, debe especificar la URL de la fila con la que está creando la relación.
La siguiente captura de pantalla muestra cómo configurar el contacto principal en una fila de cuenta utilizando el OData ID.
La siguiente captura de pantalla muestra cómo configurar el contacto principal en una fila de cuenta utilizando el id. de fila.
Utilizar la acción Relacionar filas para establecer una relación de uno a varios
Al utilizar la acción Relacionar filas para establecer una relación entre dos filas, debe determinar qué tabla seleccionar en la acción. En una relación de uno a varios, usaría la tabla en un lado de la relación. Por ejemplo, piense en una situación en la que las filas de Cuenta tienen un contacto principal. La fila Cuenta se puede relacionar solo con una fila Contacto para esta relación, lo que coloca la fila Contacto en un lado de la relación.
A continuación, proporcione el id. de fila para la tabla que configuró. Este valor es un id. de fila, no una URL, por lo que solo debe proporcionar el GUID (por ejemplo, fd140aaf-4df4-11dd-bd17-0019b9312238).
Las tablas pueden tener múltiples relaciones, por lo que debe elegir qué relación establecerá a continuación. Si necesita ayuda con el nombre, puede consultar las propiedades de la tabla de la relación para encontrar el nombre de la misma.
El último paso es configurar la propiedad Relacionar con. Esta propiedad es una URL de fila, por lo que puede usar la columna de OData ID de un paso anterior o proporcionar la URL completa manualmente, como contoso_projects(fd140aaf-4df4-11dd-bd17-0019b9312238).
Utilizar la acción Relacionar filas para establecer una relación de varios a varios
Cuando trabaja con una relación de varios a varios, puede determinar qué tabla especificar en la acción al observar las propiedades de la tabla de la relación. La tabla que está en la columna Relacionar en la lista de relaciones es el nombre de la tabla que debe elegir al establecer una relación de varios a varios entre dos filas.
Para la opción Relacionar con, use la URL de la fila para la otra fila de la tabla.
