Los siguientes parámetros de la línea de comandos están disponibles para la utilidad Carga de esquema. Después de ejecutar la utilidad, puede verificar los resultados; para ello, revise el archivo de excepciones y el archivo de registro. Si no se informa de ningún error en el archivo de registro, puede acceder a los metadatos y datos importados a la aplicación. No es necesario reiniciar el servidor de aplicaciones.
HspOutlineLoad [-f:passwordFile] /A:application /U:userName [/CP:commandPropertieFileName] [/M] [ [/I:inputFileName|/IR[:RDBConnectionPropertiesFileName]|/IRA|/E:outputFileName|/ED:outputFileNameStem] [/EDD:dataExportSpecification] [/ICB:blockSpecification] [/SDM:driverMemberSpecification] /D[U]:loadDimensionName|/DA:attributeDimensionName:baseDimensionName|TR] [/N] [[/R] [/DPU]] [/C] [/F] [/K] [/8] [/DF:datePattern] [/RIQ:inputQueryOrKey] [/RIC:catalog /RID:driver /RIR:url /RIU:userName [/RIP:password]] [/X:exceptionFileName] [L:logFileName] [/?]
Parámetro | Descripción |
---|---|
|
Opcional: si se configura un archivo de contraseñas cifradas, utilícelo como el primer parámetro en la línea de comandos para leer la contraseña desde la ruta de archivo completa y el nombre especificado en archivo_contraseñas. |
|
Este parámetro está obsoleto y los valores relacionados que se han especificado se ignoran. Si se utiliza, el sistema comprueba que el nombre de servidor especificado no sea nulo y que supere los 0 caracteres de longitud. Este parámetro sigue siendo compatible con versiones anteriores. El servidor (por defecto) para la utilidad de carga de esquema es siempre un host local. |
|
Nombre de la aplicación de Oracle Hyperion Planning a la que está realizando la importación. |
|
Nombre de usuario para iniciar sesión en la aplicación. |
|
Especifica un archivo que contiene argumentos de línea de comandos que, junto con los argumentos de la línea de comandos, constituye las opciones para la ejecución. Para los argumentos que aparecen tanto en el archivo de propiedades de comando como en la línea de comandos, los argumentos de la línea de comandos tienen prioridad. Consulte Archivo de propiedades de comandos. |
|
Genere registros de cabecera completos para dimensiones que se puedan cargar en la aplicación. Utilice |
|
Especifica el archivo de entrada de carga de datos que contiene un registro de cabecera y registros de datos con formato CSV. También debe especificar una opción de dimensión de carga de datos ( |
|
Especifica que los registros de entrada procederán de un origen de base de datos relacional. Al especificar el archivo de propiedades opcional, se designa que algunas o todas las propiedades de conmutador de conexión relacional necesarias ( |
|
Idéntico al conmutador |
|
Borra un bloque de Essbase antes de realizar una operación de importación ( |
|
Crea tablas de alias en la importación si no existen (valor predeterminado). Utilice |
|
Exporta la dimensión especificada con el valor |
|
Exporta los datos a los archivos de datos con formato de miembro de controlador de Planning. El conmutador |
|
Exporta una cabecera de dimensión en el formato HEADERBLOCK interno de Planning en el archivo de salida. Se utiliza en la importación para crear dinámicamente dimensiones base y de atributo antes de comenzar la importación. |
|
Especifica que se escribirán los registros de exportación en una tabla de base de datos relacional. Al establecer el conmutador |
|
Idéntico al conmutador |
|
Especifica el formato de los archivos de datos con formato de miembro de controlador de Planning exportados. Cadena con el formato |
|
Establece los miembros del controlador en la dimensión de carga base para la aplicación ( |
|
Dimensión que desea cargar, cuyos campos de miembro corresponden al registro de cabecera del archivo de carga. También debe especificar un archivo de carga ( Consulte las siguientes filas para cargar dimensiones y atributos definidos por el usuario mediante |
|
Dimensión definida por el usuario que desea cargar; se creará una dimensión con este nombre si no existe. |
|
Dimensión de atributo de texto que desea cargar; se creará una dimensión de atributo con este nombre, enlazada a la dimensión base, si no existe. |
|
Dimensión de atributo numérico que desea cargar; se creará una dimensión de atributo con este nombre, enlazada a la dimensión base, si no existe. |
|
Dimensión de atributo booleano que desea cargar; se creará una dimensión de atributo con este nombre, enlazada a la dimensión base, si no existe. |
|
Dimensión de atributo de fecha que desea cargar; se creará una dimensión de atributo con este nombre, enlazada a la dimensión base, si no existe. |
|
Cargue la dimensión HSP_Rates y cree tablas de tipos de cambio si no existen. |
|
Cargue la dimensión Smart Lists y las entradas de la dimensión Smart List. |
|
Establece el delimitador de campo en el carácter de coma \",\" (valor predeterminado) o en el carácter de tabulador. |
|
Carga datos cuando los miembros de controlador están especificados en el archivo de carga, en la columna Miembros de controlador. Todos los miembros, excepto el miembro de controlador, deben estar especificados en la columna Punto de vista. Con |
|
Heredar configuración de tipo de plan sin especificar del padre al agregar nuevos miembros (valor predeterminado). Utilice |
|
Realizar una "ejecución en seco" mediante el análisis del archivo de carga sin cargar datos ni metadatos. Utilice Nota: La realización de una ejecución en seco analiza el archivo de carga (por ejemplo, comprueba el registro de cabecera y si el número de valores coincide con el número del registro de cabecera), pero no comprueba la validez de los valores definidos en el archivo. |
|
Mantener el orden de los miembros en el archivo de carga al cargar, a excepción de los atributos definidos por el usuario (valor predeterminado). Utilice |
|
Ordenar los registros de entrada en orden padre-hijo, a excepción de los atributos definidos por el usuario (valor predeterminado). Utilice |
|
Suprimir todos los miembros de la dimensión de carga antes de realizar la carga. Utilice Nota: Tenga cuidado con |
|
Suprimir todas las unidades de planificación con el parámetro |
|
Suprime los miembros no especificados explícitamente en la carga. Los miembros no especificados explícitamente en el origen de entrada se suprimirán del esquema de Planning al finalizar la carga, a menos que: 1) se trate de un antecesor de un miembro especificado, o 2) se trate de un miembro de base de un miembro compartido que se haya especificado. ( |
|
Realizar una actualización de cubo después de la carga de metadatos. Utilice |
|
Crear filtros de seguridad al actualizar con la opción |
|
Bloquear la dimensión de carga antes de la carga (valor predeterminado), recomendado. Utilice |
|
Especifica la codificación UTF-8 en los archivos de entrada, salida, registro y excepción y agrega un marcador UTF-8 BOM al principio del archivo de salida (valor predeterminado). Utilice |
|
Reemplaza el patrón de fecha predeterminado en conversiones de datos de fecha al patrón especificado. El patrón debe ser uno de los siguientes:
Utilice |
|
Consulta SQL o clave del archivo de propiedades de argumentos de comandos (conmutador |
|
Nombre de catálogo JDBC RDB para la conexión RDB de entrada. Se debe establecer el conmutador |
|
Nombre de controlador JDBC RDB para la conexión RDB de entrada. Se debe establecer el conmutador |
|
URL JDBC RDB para la conexión RDB de entrada. Se debe establecer el conmutador |
|
Nombre de usuario JDBC RDB para la conexión RDB de entrada. Se debe establecer el conmutador |
|
Contraseña JDBC RDB para la conexión RDB de entrada. Se debe establecer el conmutador Introduzca la contraseña sin cifrar al especificarla por primera vez en el archivo .properties. Cuando la utilidad Carga de esquema se ejecuta, el archivo de propiedades se volverá a escribir con un valor cifrado para la contraseña |
|
Consulta SQL o clave del archivo de propiedades de argumentos de comandos (conmutador |
|
Nombre de catálogo JDBC RDB para la conexión RDB de exportación. Se debe establecer el conmutador |
|
Nombre de controlador JDBC RDB para la conexión RDB de exportación. Se debe establecer el conmutador |
|
URL JDBC RDB para la conexión RDB de exportación. Se debe establecer el conmutador |
|
Nombre de usuario JDBC RDB para la conexión RDB de exportación. Se debe establecer el conmutador |
|
Contraseña JDBC RDB para la conexión RDB de exportación. Se debe establecer el conmutador Si no se especifica este valor en el archivo de propiedades de comandos, se emitirá una petición de datos en la línea de comandos para obtener la contraseña. |
|
Asignación "Columna a alias" o cambio de nombre y exclusión de la columna de tiempo de ejecución. Este parámetro permite cambiar el nombre de una cabecera de columna en tiempo de ejecución, ignorar la columna, o ignorar o cambiar el nombre de las propiedades del tipo de plan específico. Nota: Si se especifica un alias en la columna, se reemplazan las asignaciones efectuadas por este comando. |
|
Ignora las cabeceras de columna no reconocidas y continúa con la carga. |
|
Especifique el archivo que contendrá las excepciones que se produzcan durante la carga. (Si no se especifica ningún nombre de archivo, la información se escribe en un archivo denominado |
|
Especifique el archivo que contendrá los mensajes de estado e informativos. (Si no se especifica ningún nombre de archivo, la información se escribe en un archivo denominado |
|
Muestra el texto de sintaxis. |
Ejemplo: cargue una dimensión de atributo y valores numéricos y asócielos a la dimensión Entity. (Se creará una dimensión de atributo si no existe, pero no se realizará ninguna asignación de valores de atributo a los números base.)
OutlineLoad /A:Test /U:admin /M /I:c:/outline1_attribvals_text.csv /DAN:NumericAttrib:Entity /L:c:/outlineLoad.log /X:c:/outlineLoad.exc
NumericAttrib,Parent
One,NumericAttrib
1,One
2,NumericAttrib
Ejemplo: cargue tipos de cambio, agregue EUR como miembro de la dimensión Currency y cambie el año en el archivo de carga para que coincida con un año existente en la aplicación de Planning. Se crea la tabla Tipo de cambio en la aplicación Planning si no existe.
OutlineLoad /A:Test /U:admin /M /I:c:/outline1_rates.csv /DX:HSP_Rates /L:c:/OutlineLogs/outlineLoad.log /X:c:/OutlineLogs/outlineLoad.exc Table, To Currency, From Currency, Method, Historical, Beg Balance, Year, Period, Average, Ending
FX1 , USD, EUR, multiply, 1, 2, FY08, Jan, 3, 4
FX1 , USD, EUR, , , , FY09, Feb, 5, 6
Ejemplo: establezca la distribución semanal en Use 445.
Account, Parent, Use 445
a11,a1,1
Ejemplo: cargue un archivo que contenga todas las propiedades disponibles para un atributo definido por el usuario. El atributo definido por el usuario se carga y se asocia a una dimensión, pero no se asigna a ningún miembro de la dimensión.
OutlineLoad /A:Test /U:admin /M /I:c:/outline1_uda.csv /D:UDA /L:c:/OutlineLogs/outlineLoad.log /X:c:/OutlineLogs/outlineLoad.exc
Dimension,UDA
Account,New2
Ejemplo: cargue un archivo para Currency que no especifique el símbolo de moneda. En este caso, el símbolo de esta moneda en la aplicación Planning está establecido en el símbolo ISO, EUR. La escala toma el valor predeterminado 1.
Currency,Parent,Symbol,Scale
EUR,,,
Ejemplo: cargue un archivo para Currency que establezca el símbolo en el nombre de la nueva moneda. El símbolo se establece automáticamente en NewCurr1 en la aplicación Planning para la moneda NewCurr1. Los nombres de moneda tienen una limitación de 8 caracteres.
Currency,Parent,Symbol,Scale
NewCurr1,,,
Ejemplo: utilice el parámetro -f
con una contraseña cifrada.
Si ha generado un archivo de contraseñas cifradas, puede utilizar -f
como primer parámetro en la línea de comando para ejecutar la utilidad Carga de esquema sin introducir ninguna contraseña. Por ejemplo, si ha utilizado la utilidad PasswordEncryption
para crear un archivo de contraseñas denominado encrypt.txt
, puede utilizar esta línea de comandos:
OutlineLoad -f:c:\encrypt.txt /A:acpt /U:admin /M /I:c:/outline1_accounts.csv /D:Account /L:c:/OutlineLogs/outlineLoad.log /X:c:/OutlineLogs/outlineLoad.exc
Ejemplo: parámetro /O
y orden del archivo de carga
En el siguiente archivo de carga, si los miembros de Entity e1 y e2 ya existen en la dimensión Entity, e3 se puede agregar como último hermano, incluso aunque sea el primero del archivo de carga. Si se utiliza /O
, e3 se carga como el primer hermano. Puesto que /O
es el valor predeterminado, debe especificar /-O
para cargar e3 como el último hermano.
Entity,Parent,Data Storage,TextAttrib
e3,Entity,Store,
e2,Entity,Store,
e1,Entity,Store,
Ejemplo: parámetro /H
y orden padre/hijo
Supongamos que el miembro e1 ya existe y que A y B son nuevos miembros que se van a cargar. Sin /H
, se mostrará un error porque el miembro B no existe. Con /H
, los miembros se ordenan internamente, de forma que B se carga primero como hijo de e1 y, a continuación, A se carga correctamente como hijo de B.
Entity,Parent,Data Storage
A,B,Store
B,e1,Store
Ejemplo: parámetro /R
Si algunos miembros ya existen en la dimensión, sólo los miembros del archivo de carga de entrada deben existir en la dimensión después de la carga. Si se produce un error durante la carga después de la operación de supresión, se pueden suprimir todos los miembros de la dimensión y la dimensión puede quedar vacía. Las dimensiones de atributo no se suprimen. Si hay una unidad de planificación iniciada, no se suprime ningún miembro de Entity porque el miembro de Entity de la unidad de planificación no se puede suprimir.
Entity,Parent,Data Storage,TextAttrib
e1,Entity,Store,
e11,e1,Store,orange
e2,Entity,Store,
e21,e2,Store,
e11,e2,shared,yellow
Ejemplo: parámetro /T
Cargue la dimensión Account con /T
para heredar tipos de plan no especificados explícitamente en el archivo de carga desde el padre al agregar nuevos miembros. Supongamos que el miembro a1 ya existe en la aplicación y es válido para los tres tipos de plan. Una vez terminada la carga, el miembro a11 es válido para los tres tipos de plan, incluso aunque sólo se hayan especificado Plan1 y Plan3 en el archivo de carga.
Account, Parent, Source Plan Type, Plan Type (Plan1), Plan Type (Plan2), Plan Type (Plan3)
a11,a1,Plan1,1,,1
Ejemplo: parámetro /-T
Cargue la dimensión Account con /-T
para forzar el ajuste explícito de tipos de plan para nuevos miembros. Supongamos que el miembro a1 ya existe en la aplicación y es válido para los tres tipos de plan. Después de la carga, el miembro a11 será válido sólo para los tipos de plan Plan1 y Plan3 especificados en el archivo de carga y no para Plan2.
Ejemplo: parámetro /TR
OutlineLoad /A:acpt1 /U:admin /M /I:c:\outline1data.csv /TR /L:c:/OutlineLogs/outlineLoad.log /X:c:/OutlineLogs/outlineLoad.exc
Value,Driver Member,Point-of-View,Data Load Cube Name
14,a1,"Jan,Local,e1,Current,Version1,FY08",Plan1
sl1_value2,a2,"Jan,Local,e1,Current,Version1,FY08",Plan1
Ejemplo: cargue las dimensiones Smart List y las entradas de dimensión Smart List con el parámetro /DS:HSP_SMARTLISTS
.
OutlineLoad /A:acpt /U:admin /M /I:c:/smartlist_create1.csv /DS:HSP_SMARTLISTS /L:c:/OutlineLogs/outlineLoad.log /X:c:/OutlineLogs/outlineLoad.exc
SmartList Name, Operation, Label, Display Order, Missing Label, Use Form Missing Label, Entry ID, Entry Name, Entry Label
SL1,addsmartlist,SL1Label,,,,,,
SL1,addEntry,,,,,,entry1,entrylabel1
SL1,addEntry,,,,,,entry2,entrylabel2
Ejemplo: realizar cargas de datos incrementales mediante el indicador LINEITEM
.
Puede incluir un indicador LINEITEM
en el archivo de carga de datos para realizar cargas de datos incrementales para un hijo de la dimensión de carga de datos según los identificadores únicos de dimensión de controlador. Esto especifica que se debe sobrescribir los datos si ya existe una fila con los identificadores únicos especificados en el formulario. Si no existe la fila, se introducen los datos si hay suficientes miembros hijos en el miembro padre de dimensión de carga de datos.
Por ejemplo, al cargar datos de empleado, puede cargar detalles de apunte de presupuesto para los niveles de salario predefinidos. Este ejemplo muestra un comando que se podría utilizar con un archivo de carga de datos que incluye el indicador LINEITEM
.
OutlineLoad /A:pln1dv /U:admin /M /I:c:\dataload_file.csv /D:"Budget Item"
Este archivo de carga de datos de ejemplo carga datos de la dimensión Elemento de presupuesto para hijos de cambios de niveles.
"Budget Item","Data Load Cube Name","Point-of-View","Grade Step","Option Value","Start Date","End Date"
"<LINEITEM("Grade Changes">","HCP","POVMembers","Step1","31721","7/1/09",""
"<LINEITEM("Grade Changes">","HCP","POVMembers","Step2","32673","7/1/09",""
"<LINEITEM("Grade Changes">","HCP","POVMembers","Step3","33654","7/1/09",""
"<LINEITEM("Grade Changes">","HCP","POVMembers","Step4","33654","7/1/09",""
En este caso, <LINEITEM("Grade Changes")>
busca el primer miembro disponible del elemento de presupuesto que es un hijo del miembro de cambios de niveles, según estos identificadores únicos seleccionados en la página Ajustes de carga de datos: Paso de nivel, Valor de opción, Fecha de inicio y Fecha de finalización.
Durante la carga de datos, si algún miembro hijo de Grade Changes
tiene datos para Step1
y 7/1/09
, el miembro correspondiente se utiliza para actualizar los valores de datos restantes. Si no, la siguiente fila de datos vacíos disponible se asigna al Step1
y 7/1/09
.
Al procesar la primera fila de datos, se asigna el miembro Grade1
. Por tanto, los dos siguientes miembros, Grade2
y Grade3
se asignan a la segunda y tercera fila de datos. Al procesar la cuarta fila de datos, Step1
y 7/1/09
ya se han asignado al miembro Grade1
, por lo que dicha fila se utiliza para actualizar el valor de los campos restantes.
Ejemplo: importe una jerarquía de unidades de planificación con el parámetro /D
.
OutlineLoad /A:acpt /U:admin /I:c:\puh1.csv /D:PUH1
Cuando utilice /D
para importar una jerarquía de unidades de planificación, debe especificar el nombre de una jerarquía de unidades de planificación (no de una dimensión). La jerarquía de unidades de planificación ya debe existir en una aplicación de Planning antes de cargar nuevos miembros en ella.
Ejemplo: exporte una jerarquía de unidades de planificación con el parámetro /E
.
OutlineLoad /A:acpt_580 /U:admin /M /E:puh_test2.csv /D:test2
Primary Member, Primary Enabled, Secondary Dimension, Secondary Parent, Relative Generation, Auto Include, Secondary Member, Include, Owner, Reviewers, Notifiees
e1, true, <none>, <none>, <none>, false, , true, <none>, admin, planner
e11, true, <none>, <none>, <none>, false, , true, <none>, <none>, <none>
e2, true, <none>, <none>, <none>, false, , true, <none>, <none>, <none>
e21, true, Account, a1, 1, false, , true, <none>, <none>, <none>
e21, true, Account, a1, 1, false, a11, true, <none>, <none>, <none>
e21, true, Account, a1, 1, false, a12, true, admin, <none>, "admin,admin"
e21, true, Account, a1, 1, false, a13, true, planner, "planner2,admin", admin
e21, true, Account, a1, 1, false, a14, true, <none>, <none>, <none>
e21, true, Account, a1, 1, false, a15, true, <none>, <none>, <none>
e21, true, Account, a1, 1, false, a16, true, <none>, <none>, <none>
e21, true, Account, a1, 1-2, false, a111, true, <none>, <none>, <none>
Nota:
No se especifican los miembros secundarios de los cuatro primeros registros.