Formato de archivo CSV para orígenes de datos ampliados

Finalidad

Utilice un archivo CSV para importar los siguientes tipos principales de orígenes de datos ampliados al catálogo: aplicaciones, definiciones de procedimiento almacenado y archivos. El archivo CSV utiliza una sintaxis específica para cada uno de estos activos para crearlos en el catálogo.

Plantillas y ejemplos

En el panel Importar orígenes de datos ampliados (Catálogo > Activos de información > Importar orígenes de datos ampliado), descargue el archivo comprimido que contiene archivos CSV con ejemplos de orígenes de datos ampliados de aplicación, definición de procedimiento almacenado y archivo. Los ejemplos tienen todas las secciones y columnas en la sintaxis correcta para cada activo. Modifique estos ejemplos para que se adapten a sus necesidades.

Sintaxis

La aplicación, las definición de procedimiento almacenado y los archivos tienen secciones exclusivas en el archivo CSV. Por ello, debe crear archivos CSV independientes para los tipos generales que desee importar. Para definir una aplicación, definición de procedimiento almacenado y archivo en el archivo CSV, siga estas reglas de sintaxis.

Secciones

Las secciones para aplicación, definición de procedimiento almacenado y archivo definen el contexto de cada activo que se va a importar al catálogo.

Debe listar las secciones del archivo CSV en la secuencia especificada del origen de datos ampliado, empezando por el nivel superior. La secuencia de secciones se lista en la tabla siguiente.

Por ejemplo, el archivo CSV para aplicación tiene una sección para activos de aplicación, seguida de secciones para activos de tipo de objeto, activos de método, activos de parámetro de entrada y activos de valor de salida. Si, en lugar de esta secuencia, coloca la sección de tipo de objeto antes de la sección de aplicación, el contexto de un activo de tipo de objeto hace referencia a un activo de aplicación que todavía no se ha creado en el catálogo. Como resultado, esa fila de la sección Tipo de objeto no se importa.

Para cada fila, especifique el nombre de sección en este formato:

+++ nombre_sección - Begin +++

+++ nombre_sección - End +++

donde nombre_sección corresponde al origen de datos ampliado que se va a importar.

La siguiente tabla lista los nombres de sección y su secuencia en el archivo CSV.

Tabla 1. Nombres de sección y su secuencia en el archivo CSV

Tipo principal de origen de datos ampliado a importar	Valor de nombre_sección y la secuencia de secciones en el archivo CSV
Application	Application Tipo de objeto Method Las siguientes secciones pueden estar en cualquier secuencia: Parámetro de entrada Valor de salida
Definición de procedimiento almacenado	Definición de procedimiento almacenado Las siguientes secciones pueden estar en cualquier secuencia: Parámetro de entrada Parámetro de salida Parámetro Inout Columna de resultados
Archivo	Archivo

Asegúrese de incluir un espacio antes y después del signo menos (-), entre los signos más (+++) y nombre_sección, y entre Begin y los signos más.

No ponga filas vacías dentro de una sección.

No existe límite para el número de filas de cada sección.

El nombre del origen de datos ampliado no distingue entre mayúsculas y minúsculas. Por ejemplo, los nombres myApp1 y MYAPP1 hacen referencia al mismo activo.

Columnas y cabeceras de columna

Las columnas de todas las secciones deben estar en esta secuencia:

1. Nombre del origen de datos ampliado

   Es necesario especificar un valor en este campo. Si no se especifica ningún nombre, la fila se ignora.

   No utilice los siguientes caracteres especiales en el nombre: , " [ ] '.

2. Padres del origen de datos ampliado, si tiene

   Las secciones Aplicación, Definición de procedimiento almacenado y Archivo no tienen esta columna.

   El resto de secciones contienen una columna para cada una de sus secciones padre, según su contexto. Por ejemplo, la sección para un activo de parámetro de entrada tiene tres columnas para los padres: aplicación, tipo de objeto y método. La sección para un activo de parámetro de entrada tiene una columna para el padre, definición de procedimiento almacenado.

   Si no se lista ningún valor en una columna padre o si el valor no coincide con el tipo de objeto de origen de datos ampliado, la fila se ignora. Por ejemplo, en una sección para un método, MyApp1 está en la columna Nombre, la columna Tipo de objeto está vacía y NewMethodTest está en la columna Método. Esta fila se ignora durante la importación porque un método debe tener un padre de tipo de objeto.

3. Descripción

   Especificar o no un valor en este campo es opcional. Es la última columna de cada sección.

Las cabeceras de columna son necesarias y deben estar en la fila inmediatamente posterior a la fila Begin de una sección.

No cambie el nombre de las cabeceras de columna y no suprima columnas.

Comentarios

• Para incluir un comentario en una fila, inserte un asterisco (*). Toda la fila se ignora durante la importación.
• Coloque un asterisco solamente al principio de la fila. No especifique comentarios dentro de una fila.
• Puede incluir filas vacías entre las secciones para facilitar la lectura del archivo CSV. No necesita un asterisco si toda la fila está vacía.

Caracteres especiales y soporte lingüístico

Comas

Si crea un archivo CSV en lugar de modificar una plantilla, el único delimitador aceptado es una coma (,).

Comillas

Las comillas (") son necesarias si el valor de un campo incluye caracteres alfanuméricos, tales como símbolos matemáticos o comas. Por ejemplo, el siguiente valor del campo Descripción debe estar incluido entre comillas por las comas que incluye: “Esta descripción es la primera, la del medio y la última de la aplicación.”

Si aparecen comillas en el texto, estas deben estar incluidas entre comillas (" " ").

Si el valor de un campo no incluye caracteres alfanuméricos, las comillas se eliminan durante la importación.

Los apóstrofos (') no son válidos y la fila se ignora durante la importación.

Soporte de idiomas

El archivo CSV debe estar en codificación UTF-8 o ANSI para ser compatible con todos los idiomas.

Puede especificar el valor en un campo en cualquier idioma, pero no cambie la cabecera de columna ni las cabeceras de sección. Las cabeceras deben estar en inglés.