Analizar el archivo Config

La clase pasada creamos un proyecto REF, en su estructura de proyectos vimos que había un archivo llamado Config.xlsx, un Excel.
Para esta clase es necesario que tengas el archivo a la mano y lo abras, ya que durante la lectura lo iremos configurando para el proyecto que realizaremos e iremos analizando sus campos.

Estructura del archivo

Nuestro Config de Excel, cuenta con 3 hojas y 3 columnas en cada hoja, las hojas son las siguientes:

• Settings: Esta hoja se utiliza para colocar valores de configuración que por lo general no cambian una vez definidos, por ejemplo, nombre de archivos a generar, rutas de archivos, páginas web de sistemas a utilizar (más adelante configuraremos algunos valores para ejemplificar mejor); esta hoja contiene las 3 columnas siguientes:
  – Name: Colocamos aquí el nombre con el que llamaremos en código el valor contenido en Value.
  – Value: Colocamos aquí el valor que se proporcionará al código al ser llamado.
  – Description: Una breve descripción acerca del nombre y el valor del registro.
  
• Constants: Esta sección contiene variables constantes, generalmente se utiliza para colocar nombre de Logs, contadores de reintentos y funciones similares.
  – Name: Colocamos aquí el nombre con el que llamaremos en código el valor contenido en Value.
  – Value: Colocamos aquí el valor que se proporcionará al código al ser llamado.
  – Description: Una breve descripción acerca del nombre y el valor del registro.
  
• Assets: Esta hoja se utiliza para colocar valores de configuración que pueden cambiar y afectan al robot directamente, por ejemplo, credenciales, rutas dinámicas, correos destinatarios, etc (más adelante configuraremos algunos valores para ejemplificar mejor); esta hoja contiene las 3 columnas siguientes:
  – Name: Colocamos aquí el nombre con el que llamaremos en código el nombre del Asset.
  – Asset: Es el nombre del Asset como está registrado en el Orquestador.
  – Description: Una breve descripción acerca del Nombre y el Asset del registro.
  

Configurando variables en el archivo

A continuación, te mostraré la lista de valores en Setting y en Assets, que serán las configuraciones que usaremos en el desarrollo del proyecto REF en las siguientes clases.
Replicarlas en tu archivo
Para Settings deben añadir todas las variables del cuadro rojo y modificar los valores de las 2 variables preexistentes.

Para Constants Modificar los campos en rojo, para el segundo campo, tengan en cuenta que la ruta que yo coloqué es la ruta donde está mi proyecto guardado.

Para Assets Añadir los siguientes registros. Estos en la clase siguiente los vamos a crear en el Orquestador.

¿Cómo leemos el Config en el Proyecto REF?

Dentro de nuestro proyecto REF, en el estado de Inicialización, tenemos una validación de si el archivo de Config es vacío. Cuando ésta condición se cumple, se ejecutará entre las múltiples acciones un XAML llamado InitAllSettings.

Dentro de InitAllSettings.xaml tenemos las siguientes acciones:

• Assing out_Config, la función de esta asignación es inicializar el diccionario de datos.
  
• For Each Configuration Sheet, aquí se realiza una lectura de todos los datos encontrados en la hoja Setting y Constants.
  Primero en el Read Range activity se leen las hojas Settings y Constants.
  Luego en el foreach row interno, leemos cada registro de las hojas leídas y guardamos en el diccionario “out_Config” la llave (que corresponde a la columna Name) y el valor (que corresponde a la columna Value).
  
• Try Initializing Assets, En esta secuencia, se realiza una lectura de la hoja de Assets.
  Primero en el Read Range activity se lee la hoja Assets.
  Luego en el foreach row interno, leemos cada registro de las hojas leídas, posteriormente en el Get Orchestrator Asset, consultamos en el Orquestador el Asset que escribimos en la columna Asset.
  Guardamos en el diccionario “out_Config” la llave (que corresponde a la columna Name) y el valor (que viene del Asset que leímos el paso anterior).
  

¿Cómo utilizar los datos leídos?

Hasta ahora, hemos creado los registros en el archivo Config y hemos aprendido como el Robot los lee, pero nos falta saber utilizar los datos que el robot leyó y guardó en el diccionario llamado “config”.
Para leer los valores de nuestro diccionario debemos invocar la variable Config, abrir paréntesis, colocar entre comillas la palabra clave que registramos en la columna Name y añadir al final un .ToString
Config(“<PalabraClave>”).ToString
En la siguiente pantalla podemos ver como se invoca el Config (cuadros rojos) y el resultado (cuadros amarillos).

Nos vemos la próxima clase para conocer la estructura del Orquestador.