Acción leer de un rango

Introducción

Una parte importante del uso del conector de Excel nativo es leer información desde el archivo de Excel. Para leer un rango de celdas y guardar su valor en una colección en el Modelo de datos de Bizagi use esta acción.

Si desea leer una única celda del archivo Excel, use la Acción de lectura.

Acción

La Acción leer de un rango permiten leer un rango de celdas y almacenarlo como una colección en el modelo de datos de Bizagi. Puede identificar esta acción por su borde naranja en el tercer panel.

Asígnele a esta acción un nombre significativo y seleccione la hoja donde se llevará a cabo la acción.

Una Acción leer de un rango puede leer un rango de columnas. Definir una salida para cada columna del rango. Cada columna en el rango está asociada a un atributo de la colección. Para configurar esta acción, debe configurar el rango y la definición de la columna.

En el panel de Definición de rango configure el rango usando coordenadas o usando un rango con nombre.

Para identificar un rango por sus coordenadas, seleccione la opción Coordenadas del rango y proporcione la coordenada de la celda superior izquierda y de la celda inferior derecha que conforman el rango.

Para identificar un rango por su nombre, seleccione la opción Nombre de rango en la lista desplegable y seleccione el nombre de la celda en las opciones disponibles. El nombre ya debe existir en el archivo de Excel para que se muestre en las opciones.

El panel calcula automáticamente el número de columnas que se deben configurar en ambos casos.

Después, configure las columnas en el panel de Definición de columnas. Debe tener una definición para cada columna del rango. Puede agregar una nueva definición de columna haciendo clic en el botón .

Si desea crear automáticamente el número esperado de columnas, haga clic en Autocompletar columnas.

Para cada definición de columna proporcione los siguientes parámetros:

•Nombre: Nombre de la columna. Este nombre le permitirá identificar esta entrada en el mapeo de datos.

•Tipo: El tipo de dato de la columna. Los valores posibles son: String, Boolean, Byte, Date, Decimal, Double e Integer.

Mapeo avanzado

Puede asignar a las entradas del conector las siguientes propiedades cuando utiliza la vista avanzada:

•Nombre de la hoja: en este campo se selecciona la hoja donde la acción se ejecuta dinámicamente. Use el nombre de la Hoja como se muestra en su archivo de Excel.

•Rango: en este campo se selecciona el rango de donde se lee la información. Si la celda está configurada para recibir una coordenada, debe proporcionar una coordenada. De la misma manera, si lo configura para recibir un nombre, debe proporcionar un nombre de celda disponible.

Ejemplo de configuración

Este ejemplo usa el siguiente archivo de Excel:

En archivo de Excel tiene una lista de nombres en el rango comprendido de la celda A2 a la celda A12, dos rangos vacíos (B2: B12 y C2: 12) y una columna en la que cada celda calcula la diferencia porcentual de las dos columnas anteriores. Finalmente, el rango B2: B12 se llama SystemList y el rango A2: A12 se llama ClientList.

En este ejemplo, el conector leerá la información de los rangos A2: A12 y D2: D12 cuando se ejecute. Dado que los rangos no son adyacentes entre sí, se configuran dos acciones diferentes.

Para la primera acción en la Definición de rango, seleccione Nombre del rango y en la lista desplegable seleccione ClientList(A2:A11).

En la Definición de columna, agregue una sola columna y asígnele el nombre Clients y asigne Decimal al tipo de dato.

Para la segunda acción en la Definición de rango, seleccione Coordenada del rango y escriba D2: D12.

En la Definición de columna, agregue una sola columna y asígnele el nombre CalculatedDiff y asigne Decimal al tipo de dato.