Formato de archivo de carga de solicitud

En este tema se describe el formato de las hojas de cálculo de Microsoft Excel que se utiliza para cargar elementos de solicitud.

Consideraciones

• Cada hoja de trabajo de un archivo de hoja de cálculo se corresponde con un punto de vista.

• Puede cargar varias hojas de trabajo en varios puntos de vista.

• Las hojas de trabajo (y sus puntos de vista correspondientes) deben utilizar etiquetas con 30 caracteres o menos.

  Nota:

  Si un nombre de punto de vista contiene más de 30 caracteres, deberá crear una etiqueta que se utilizará para la hoja de trabajo al cargar los elementos de la solicitud en un punto de vista. Consulte Inspección de un punto de vista para obtener más información sobre el uso de etiquetas.

• Las hojas de cálculo pueden contener fórmulas para derivar los valores de propiedad de las columnas estándar. Las fórmulas de hojas de cálculo también se pueden utilizar para propiedades específicas de la aplicación (FCGL, PLN) y propiedades personalizadas. Se omiten las celdas de propiedad con valores de fórmulas en blanco. Se omiten las celdas de propiedad con valores de fórmulas iguales a <clear> o <blank>.

• Las hojas de trabajo se procesan en orden de izquierda o derecha.

• Las filas duplicadas del archivo de importación no se procesan durante la carga.

• Las fechas y las marcas de hora de configuraciones regionales soportadas deben tener uno de los siguientes patrones de formato de fecha de Java:

  • Abreviado

  • Predeterminado

  • Largo

  • Mediano

  Nota:

  Para obtener más información sobre los formatos de hora y fecha de Java, consulte Uso de formatos predefinidos.

• Si tiene más de 10.000 nodos, cree varios archivos de carga, cada uno con menos de 10.000 nodos.

• Para los nodos que se agregan o se insertan en un punto de vista de jerarquía en el que no se conoce el padre, utilice la palabra clave <Unknown> en la columna Padre para hacer que se calcule y se almacene el valor del padre para cada elemento de solicitud. El administrador debe haber definido una expresión para calcular el valor del padre. Consulte Cálculo y almacenamiento del padre de un nodo.

• Para calcular los nombres de los nodos que se agregan o insertan, deje la columna de nombre en blanco o utilice las palabras clave <cn> o <cn ####>. El nodo debe estar configurado para calcular el valor de nombre. Consulte Cálculo y almacenamiento del nombre de un nodo.

Consideraciones sobre columnas

• La hoja de cálculo debe tener cabeceras de columna que coincidan con los nombres de columna reservados o con los nombres de propiedades. Consulte Nombres de columna reservados.

  Nota:

  No puede cargar una hoja si falta la columna Nombre.

• Las cabeceras de columna de las propiedades deben estar formadas por el nombre de la propiedad o la etiqueta mostrada personalizada de la propiedad si se ha configurado (esta opción se configura en el separador Propiedades del inspector de puntos de vista). El nombre de propiedad no puede incluir el espacio de nombre. Por ejemplo, Core.Description no es válida.
• Las columnas pueden estar en cualquier orden.
• Si la cabecera de una columna no coincide con ninguno de los nombres de columna reservados o los nombres de propiedad, la columna se ignora. Esto significa que la hoja de cálculo puede incluir comentarios que no se cargarán.
• Si el archivo de carga tiene una columna para la propiedad Nombre alternativo:
  • Si el tipo de nodo en el que se va a cargar contiene la propiedad Nombre alternativo, al cargar el archivo se realizan las siguientes operaciones:
    • Si una fila contiene un nombre de nodo, el nombre alternativo se carga en la columna Nombre alternativo.
    • Si una fila no contiene un nombre de nodo, el Nombre alternativo se utiliza para buscar un nodo coincidente en el punto de vista con el mismo valor de propiedad Nombre alternativo.

  • Si el tipo de nodo en el que se va a cargar no contiene la propiedad Nombre alternativo, se ignora la columna.

Orden de procesamiento de filas

Cuando se cargan registros de un archivo de solicitud, el proceso de carga ordena el contenido del archivo de manera que los nodos padre se agregan a un punto de vista delante de los nodos hijo. De este modo se evitan errores de validación si una fila de un nodo hijo precede a la fila de su nodo padre en el archivo de carga.

Por ejemplo, este archivo de carga contiene una fila padre, Analytics, precedida en el archivo por dos filas hijo, Emily y Jack, y ambas tienen a Analytics como padre:

Cuando se carga este archivo, Analytics se agrega primero y, a continuación, Emily, Jack y Mary.

Procesamiento de <Blank> y <Clear> frente a campos vacíos

La introducción de las palabras clave <blank> o <clear> y dejar vacías las celdas en el archivo de carga de solicitud se gestionan de forma diferente cuando se procesa un archivo de solicitud:

• La palabra clave <clear> borra los valores existentes de una propiedad.
• La palabra clave <blank> establece un valor definido en blanco para la propiedad.
• Se ignoran las celdas vacías del archivo.

Las palabras clave <blank> y <clear> y las celdas vacías están soportadas para todos los tipos de datos. Sin embargo, para los tipos de datos de lista, las entradas en blanco dentro de una lista no están soportadas. Es decir, la lista en sí puede estar vacía, pero una entrada dentro de la lista no puede estarlo.

Algunos ejemplos:

• Valor de lista: '<blank>' está soportado. Tenga en cuenta que la importación de un valor en blanco para una lista sustituirá todos los valores definidos, heredados o predeterminados existentes en la lista.
• Valor de lista: 'A,B,C' está soportado.
• Valor de lista: 'A,,C' no está soportado.

Realización de operaciones Copiar y Modelar después en un archivo de carga de solicitud

Utilice las columnas Copy Node y Copy Action para crear un nodo nuevo basado en una operación de copia de un nodo existente o en una operación Modelar después (en un punto de vista de jerarquía) de un nodo existente con un archivo de carga de solicitud. (Consulte Adición de un nodo mediante la acción Modelar después en un nodo existente para obtener más información sobre la operación Modelar después).

Consideraciones

• Las columnas Copy Node y Copy Action se utilizan solo en las operaciones Agregar o Actualizar. Si la columna Action Code contiene cualquier otra operación, se ignoran las columnas Copy Node y Copy Action.
• Si la columna Copy Node contiene un nodo para el que ya haya un elemento de solicitud en el archivo de carga, las columnas Copy Node y Copy Action de ese nodo se ignoran.
• Si la propiedad Core.Name del tipo de nodo que se agrega mediante una operación Copiar o Modelar después se ha configurado para calcularse y almacenarse (consulte Propiedades calculadas y almacenadas), el nombre del nuevo nodo se calcula automáticamente.
• Utilice la palabra clave <Ignore> de la columna padre para indicar que se debe ignorar el padre durante una operación Modelar después. El nuevo nodo solo se inserta bajo los padres del nodo que se copia.

Para realizar una operación Copiar o Modelar después en un archivo de carga de solicitudes:

• Utilice la columna Copy Node para especificar el nodo que se va a copiar o después del que se va a modelar.
• Utilice la columna Copy Action para especificar el tipo de operación de copia. Especifique uno de estos valores:
  • Properties: permite realizar una operación de copia para el nodo especificado en la columna Copy Node. La operación de copia duplica los valores de propiedad de nivel de relación y nodo definidas del nodo especificado y las incluye como acciones Actualizar para el elemento de solicitud. (Este es el valor predeterminado si no especifica el tipo de operación de copia).
  • Model After (solo puntos de vista de jerarquía): realiza una operación Modelar después para el nodo especificado en la columna Copy Node. Con la operación Modelar después se realiza lo siguiente:
    • Copia las relaciones padre del nodo especificado y las incluye como acciones Insertar para el elemento de solicitud.
    • Copia los valores de propiedad de nivel de relación definidas para cada padre y las incluye como acciones Actualizar para el elemento de solicitud.

    Nota:

    La operación Modelar después utilizando puntos de vista relacionados no está soportada durante las cargas de archivos de solicitud. Por lo tanto, no se puede realizar ninguna operación Modelar después al cargar archivos de solicitud en puntos de vista de lista.

Trabajar con orígenes de datos en archivos de carga de solicitudes

Mejores prácticas

Aunque puede agregar elementos de solicitud de varios orígenes de datos en un solo archivo de carga, se recomienda crear un archivo de carga independiente para cada uno de los orígenes de datos. Un elemento de solicitud de un archivo de carga solo puede tener un origen de datos, por lo que si carga un archivo de solicitud con un nodo con el mismo nombre de varios orígenes de datos, solo se conserva el primer origen de datos. Al crear archivos de carga independientes para cada uno de los orígenes de datos podrá ejecutar una coincidencia para ese nodo para todos los orígenes de datos.

Columna Origen de datos

Los elementos de solicitud del archivo de carga se actualizan con el origen de datos que especifique en la columna Origen de datos (consulte Descripción de los orígenes de datos). Esto les permite enlazarse o compararse y fusionarse con los nodos existentes del punto de vista (consulte Acerca de los enlaces de nodos y Coincidencia y fusión de elementos de solicitud).

Consideraciones

• Puede utilizar el origen de datos Código o Nombre para identificar el origen de datos en el archivo de carga. Le recomendamos utilizar el código del origen de datos, ya que el nombre puede cambiar con el tiempo.
• Puede cargar nodos de orígenes de datos registrados solo si el archivo de carga se ha generado originalmente en un origen de datos registrado (por ejemplo, al volver a cargar un archivo de solicitud de subscripción generado). Las filas del archivo de carga deben contener el ID de nodo de origen y el tipo de nodo de origen generados de los orígenes de datos registrados que se van a cargar.
• Si el elemento de solicitud ya hace referencia a otro origen de datos diferente al de la fila, la fila se omite.

Nombres de columna reservados

Consideraciones

• Si una propiedad tiene el mismo nombre que una columna reservada, puede utilizar un nombre de columna alternativo. Por ejemplo, si tiene una propiedad denominada Data Source, puede utilizar un nombre alternativo como Data_Source, DataSource o {Data Source}.

• Si la hoja de cálculo se está cargando en un punto de vista para una lista, las columnas y las acciones para jerarquías se ignoran. Por ejemplo, las acciones Mover e Insertar se ignorarían en un punto de vista de lista.

Tabla 10-3 Códigos de acción

Código de acción	Descripción
Add	Crea un nodo nuevo.
Delete	Suprime un nodo.
<Celda vacía>	Si la celda Action Code está vacía, la fila se procesa utilizando el código de acción Update.
Insert	Inserta un nodo existente en una jerarquía del nodo especificado por las celdasParent y Parent Node Type.
Move	Mueve un nodo existente a una nueva posición de una jerarquía, por lo que elimina el nodo de su posición existente.
Prop_Update	Actualiza el valor de la propiedad solo para un nodo existente. Para realizar otras acciones, utilice el código de acción Update. Puede borrar el valor de la propiedad de una propiedad definida. Al borrar el valor de la propiedad, se suprime el valor almacenado y devuelve el valor al valor predeterminado o heredado. Por ejemplo, la acción Prop_Update siguiente borra el valor de descripción.
Rename	Cambia el nombre de un nodo existente.
Reorder	Reordena un nodo en un punto de vista de jerarquía. Solo puede reordenar los nodos de un punto de vista que utilice un conjunto de jerarquías que permita la reordenación para ese tipo de nodo (nodo padre e inferior). Para obtener más información, consulte Reordenación de un nodo.
Remove	Elimina el nodo del nodo padre especificado.
Update	Actualiza los valores de propiedades de un nodo existente. Con la acción Update también se realizan acciones adicionales si las celdas de una fila indican que se requieren dichas acciones. En la siguiente lista se describe cómo funciona: Si el nodo no existe, se agrega el nodo. Si el punto de vista es jerárquico, el nodo se inserta en la posición de la jerarquía especificada por las celdas Parent y Parent Node Type. Si el punto de vista es jerárquico y el nodo existe, pero no en el padre especificado, la acción resultante depende de si el conjunto de jerarquías permite los nodos compartidos: Si se permiten los nodos compartidos, el nodo se inserta en el padre especificado. Si no se permiten los nodos compartidos, el nodo se mueve al padre especificado. Puede actualizar una propiedad en un valor en blanco si la propiedad permite valores en blanco. Debe utilizar el indicador <blank> en la celda; una celda vacía no produce los mismos resultados. Por ejemplo, la acción de actualización siguiente define la propiedad de entidad jurídica en un valor en blanco. Aunque la celda para la descripción está vacía, la descripción existente para EMA no cambia.