Conjuntos de valores en bibliotecas de variables

Los conjuntos de valores de una biblioteca de variables proporcionan conjuntos alternativos de valores para las variables definidas, escenarios auxiliares, como configuraciones específicas del entorno (por ejemplo, desarrollo, prueba, prod), pruebas A/B o cambio de origen de datos en la misma área de trabajo.

Cada conjunto de valores se crea como una colección de punteros al valor de variables predeterminado, que se puede invalidar según sea necesario. Solo un conjunto de valores puede estar activo a la vez para un área de trabajo determinada y los usuarios pueden cambiar fácilmente el conjunto activo a través de la interfaz de usuario o la API.

Los conjuntos de valores se denominan de forma única dentro de la biblioteca y se pueden cambiar de nombre, reordenar (solo a través de Git o la actualización con la API de definición) o eliminar (con medidas de seguridad para evitar la eliminación del conjunto activo sin reasignación). El sistema realiza un seguimiento de los cambios y aplica límites de tamaño para garantizar el rendimiento y cualquier modificación en los conjuntos de valores se valida antes de guardar. Esta estructura permite una administración de configuración sólida, lo que permite a los desarrolladores automatizar las implementaciones y mantener la coherencia en varios entornos y fases.

Estructura e implementación de conjuntos de valores

La definición del elemento Biblioteca de variables está estructurada para admitir varios conjuntos de valores. En el esquema del elemento (su definición JSON), todas las variables y sus valores predeterminados se enumeran en una sección principal (a menudo denominado archivo "Valores predeterminados" en Git). Cada conjunto de valores adicionales se almacena como una entidad independiente (o archivo) que contiene solo las variables que difieren del valor predeterminado. Es decir, si el valor de una variable en un conjunto de valores determinado es el mismo que el predeterminado, no se repite explícitamente en la definición del conjunto de valores.

• Valor predeterminado establecido: Siempre presente y contiene el valor de línea base de cada variable (junto con metadatos como nombre y tipo). El archivo de valores predeterminados enumera todas las variables con sus valores predeterminados (principal).

• Conjunto de valores alternativos: para cada conjunto de valores adicionales (por ejemplo, un conjunto de valores "Test" o "Prod"), la definición muestra solo las variables en las que el valor invalida el valor predeterminado. Si una variable no aparece en un archivo de conjunto de valores determinado, usa implícitamente el valor predeterminado para ese conjunto.

Ejemplo: Si tiene una variable ConnectionString con el valor predeterminado "dev-server" y crea un conjunto de valores "Production" que invalida esto en "prod-server", la definición predeterminada tendrá ConnectionString = "dev-server" y el archivo del conjunto de valores "Production" contendrá ConnectionString = "prod-server" (y nada para las variables que permanecen sin cambios). Este enfoque mantiene las definiciones de conjunto de valores ajustadas y resalta solo las diferencias.

Representación del control de código fuente

En la integración de Git de Fabric, el esquema anterior se traduce en varios archivos en la carpeta de la biblioteca de variables. Por diseño, cada conjunto de valores se serializa en su propio archivo JSON (denominado después del conjunto de valores) que contiene sus invalidaciones, independientes del archivo de valores predeterminados. Por ejemplo, un elemento de VL "MyVars" podría tener:

MyVars_Default.json: todos los valores predeterminados de las variables. MyVars_Prod.json: solo variables con valores diferentes para la fase "Prod". MyVars_Test.json: solo variables con valores diferentes para la fase "Prueba".

Esta separación clara significa que puede realizar un seguimiento de los cambios en la configuración de cada entorno de forma independiente en el control de código fuente.

Importantemente, la selección del conjunto de valores activos no forma parte de estos archivos de definición: se almacena como estado de elemento (una configuración de nivel de área de trabajo) para que la implementación o importación del elemento no sobrescriba qué conjunto de valores está activo actualmente en un área de trabajo determinada. (Más información sobre los conjuntos de valores activos a continuación).

Tipos de datos y esquemas

Los conjuntos de valores no introducen nuevos tipos de datos; contienen valores de los mismos tipos definidos por cada variable. La definición de elemento registra el nombre, el tipo, el valor predeterminado y la nota opcional de cada variable. Los tipos de variables complejos, como referencia de elemento , tienen esquemas estructurados (almacenando identificadores), pero esos valores se representan en cada conjunto de valores mediante una estructura JSON coherente (por ejemplo, una referencia de elemento almacena el identificador de área de trabajo y el identificador de elemento para el elemento de esa fase). Todos los archivos de conjunto de valores siguen la misma estructura de esquema que el valor predeterminado: básicamente una asignación de nombres de variable a los valores de ese conjunto (solo los que difieren del valor predeterminado).

Convenciones de nomenclatura para conjuntos de valores

El nombre de un conjunto de valores dentro de una biblioteca de variables debe seguir estas convenciones:

• No está vacío
• No tiene espacios iniciales ni finales
• Comienza con una letra o un carácter de subrayado
• Puede incluir letras, números, caracteres de subrayado y guiones
• No supera los 256 caracteres de longitud

Después de que una variable tenga un valor definido, si intenta cambiar su tipo, aparecerá un cuadro de diálogo de consentimiento. El cuadro de diálogo le avisa de que se restablecerán todos los valores de variable y que este cambio podría ser un cambio importante en el elemento de consumidor.

Consideraciones y limitaciones

Limitaciones para conjuntos de valores alternativos

• Los conjuntos de valores alternativos de una biblioteca de variables aparecen en el orden en que los agregó. Actualmente, no se pueden reordenar en la interfaz de usuario. Para cambiar el orden, edite el archivo JSON directamente.
• El nombre de cada conjunto de valores debe ser único dentro de una biblioteca de variables.
• Los nombres de variable deben ser únicos dentro de una biblioteca de variables. Puede tener dos variables con el mismo nombre en un área de trabajo si están en elementos diferentes.
• Siempre hay un valor activo (y solo uno) establecido en una biblioteca de variables a la vez. No se puede eliminar un conjunto de valores mientras está activo. Para eliminarlo, configure primero otro valor establecido para que esté activo. Puede tener un valor activo diferente establecido para cada fase de una canalización de implementación.