Acción leer de un rango

<< Clic para mostrar Tabla de Contenidos >>

Navegación:  Bizagi Studio > Asistente de Procesos > Integrar > Integración con aplicaciones > Conector de Excel >

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.

 

ExcelConector13

 

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

 

ExcelConector49

 

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.

 

ExcelConector50

 

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.

 

ExcelConector51

 

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.

 

ExcelConector52

 

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

 

ExcelConector53

 

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 ExcelConector25.

ExcelConector54

 

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

 

ExcelConector55

 

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

 

ExcelConector56

 

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.

 

note_pin

Si el rango tiene filas vacías, el conector crea registros vacíos en la colección en Bizagi.

 

Mapeo avanzado

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

 

ExcelConector57

 

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:

 

ExcelConector58

 

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.

ExcelConector59

 

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

 

ExcelConector60

 

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

 

ExcelConector61

 

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

ExcelConector62

 

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

ExcelConector63