Aprovisionamiento masivo de opciones de configuración

Para crear o modificar grandes cantidades de objetos, puede cargar un archivo separado por comas (CSV) que contenga opciones y valores nuevos y modificados del objeto. Puede introducir o modificar opciones y valores en las columnas adecuadas de cada objeto. Al cargarlos en GAX, se crean o modifican las opciones enumeradas en el archivo con base en la acción a tomar indicada en la columna Action.

También puede utilizar GAX para descargar (o exportar) información de opciones seleccionadas. Si lo desea, puede usar esta descarga para crear una "plantilla" para los datos de carga.

Esta funcionalidad de importación/exportación de opciones de configuración está disponible para todos los tipos de objetos.

Opciones de exportación

GAX permite exportar las opciones seleccionadas a una hoja de cálculo. Puede modificar la hoja de cálculo según sea necesarios, guárdela como un archivo .csv o .cfg y cárguela otra vez en GAX. O, puede eliminar los datos (pero no los encabezados de columna) del mismo y utilizar esta plantilla "vacía" para cargas actuales y futuras de opciones de configuración.

Para exportar opciones, realice lo siguiente:

[+] Mostrar pasos

1. En Configuration Manager, abra la ficha Opciones del objeto del cual desea exportar opciones.
2. Seleccione las secciones y opciones a exportar.
3. Haga clic en Exportar en el menúMás ubicado arriba de la lista de opciones en la esquina derecha.
4. En el cuadro de diálogo Exportar opciones seleccione el formato del archivo de salida, bien sea CFG o CSV y haga clic en Exportar.
   El archivo de salida se crea y descarga en su navegador, con un nombre de archivo en el formato
        <object type>_annex_<object DBID>.csv o cfg
   Por ejemplo:
        CfgPerson_annex_6378.cfg o CfgPerson_annex_6378.cfg

Cargar un archivo

Antes de cargar actualizaciones masivas, debe introducir los datos en la hoja de cálculo y guardarla como un archivo CSV. Tenga en cuenta las siguientes recomendaciones:

• Si la mayoría de sus actualizaciones son agregar nuevas opciones, haga una plantilla vacía y llene con los valores apropiados.
• Si principalmente realiza cambios a las opciones existentes, exporte solo las opciones que está cambiando y realice los cambios.

Para cargar los datos en GAX, realice lo siguiente:

[+] Mostrar pasos

1. En Configuration Manager, abra la ficha Opciones del objeto al cual desea cargar las opciones.
2. Haga clic en Exportar en el menú Más ubicado arriba de la lista de la opción en la esquina derecha.
3. En el cuadro de diálogo Importar objetos:
   1. Haga clic en Elegir archivo y seleccione el archivo .csv o .cfg con sus cambios.
   2. Seleccione Reemplazar las opciones existentes si está seguro de que su archivo contiene el valor exacto y más actualizado para las opciones que pueden existir en el objeto. De lo contrario, déjela en blanco.
   3. Haga clic en Cargar.
4. Cuando los registros se hayan procesado, aparecerá el cuadro de diálogo Operación completada mostrando un resumen de los resultados. Haga clic en Cerrar para regresar a la ficha Opciones.

Archivo fuente

GAX usa archivos .csv (valores separados por comas) y .cfg para importar y exportar opciones de configuración. Ambos formatos admiten únicamente la importación y exportación de opciones de cadena. Los otros tipos de opciones de configuración se ignoran y no se importan ni se exportan. Todas las cadenas en ese archivo deben codificarse en UTF-8.

Importante

El contenido del archivo se refiere a un solo objeto.

En un archivo fuente CSV, cada línea representa una sola opción de configuración. La misma opción puede aparecer en el archivo fuente solo una vez. Si la sección de opciones de configuración aún no existe en la configuración del objeto, se crea. El identificador único de la opción en el ámbito del archivo fuente es la combinación de los campos Sección y Clave. Hay tres columnas en el archivo—cada una para la sección de opción de configuración, el nombre de la opción (Clave) y el valor de la opción, nombradas por las entradas en la primera fila del archivo —Sección, clave y valor. El orden de las columnas no es importante. Se inserta una coma después de cada entrada de columna. El archivo fuente contiene las siguientes propiedades para cada opción: [+] Mostrar propiedades

Nombre	Tipo	Obligatorio	Descripción
Sección	Cadena	Sí	El nombre de la opción de configuración.
Clave	Cadena	Sí	El nombre de la opción
Valor	Cadena	No	El nuevo valor de la opción.

En un archivo CFG, cada sección y opción aparece en una línea separada, con los nombres de sección entre corchetes. Cada sección está seguida de una lista de opciones en esa sección, con los valores adecuados, como:

[section_name1]
option-name1=option_value2
...
option_nameN=option_valueN

[section_name2]
option-nameN+1=option_valueN+1
...

Ejemplo

Los siguientes datos se cargarán en GAX para agregar dos nuevas opciones para un objeto usuario existente:

[+] Mostrar datos

Sección	Clave	Valor
gaxproperties	datemodified	1478163902397
htcc	Funciones	Agente

El archivo CSV para esto se vería así:

Section,Key,Value
gaxproperties,datemodified,1478163902397
htcc,roles,Agent

Exportada desde GAX como archivo CFG, la misma información se vería así:

[gaxproperties]
datemodified=1478163902397
[htcc]
roles=Agent