Parámetros de configuración de Planning Analytics Spreadsheet Services/TM1 Web

Los parámetros de configuración para Planning Analytics Spreadsheet Services se almacenan en el archivo tm1web_config.xml .

El archivo tm1web_config.xml se encuentra en la siguiente ubicación:

<TM1 install location>\webapps\tm1web\WEB-INF\configuration\

Están disponibles los parámetros siguientes.

ActionButtonFullRecalculationEnabled

Determina el nivel de recálculo que se produce como parte de una ejecución del botón de acción. Este parámetro solo es aplicable a los botones de acción que utilizan Recalcular hoja de forma automática como tipo de Cálculo.

Si se establece en true (verdadero), se produce un recálculo completo en el libro de trabajo de destino.

Si se establece en false (falso), se produce un recálculo parcial en el libreo de trabajo de destino. Solo se recalculan las partes visibles del libreo de trabajo de destino. Este recálculo incluye los formularios activos, las fórmulas DBS/DBSW/DBR/DBRW/DBRA/DBSA y las dependencias de las celdas del área visible. Las partes más allá del límite de desplazamiento del libro de trabajo de destino no se recalculan. False es el valor predeterminado, que puede producir una mejora de rendimiento, especialmente en libros de trabajo grandes.

AdminHostName

Si se establece, a los usuarios no se les solicitará que especifiquen un valor para el host de administración en el inicio de sesión.

Consulte Configuración de la página de inicio de sesión Web TM1 mediante los parámetros AdminHostName y TM1ServerName.

AdminHostPort

Si se establece, el cliente intentará utilizar este puerto en lugar del puerto del host de administración predeterminado.

AdminHostSSLPort

Si se establece, el cliente intentará utilizar este puerto en lugar del puerto de host SSL de administración predeterminado.

CamLoginApiRedirectEnabled

El valor predeterminado es false.

Cuando está activada, la autenticación CAM desde la API ' TM1 Web (ya sea API URL o Biblioteca JavaScript ) realiza una redirección a la página de inicio de sesión CAM de ' Cognos® Analytics. Este comportamiento difiere del comportamiento predeterminado de mostrar la página de inicio de sesión de CAM de Cognos Analytics en un recuadro de diálogo. Este parámetro debe estar habilitado en los casos en los que Cognos Analytics incluye una cabecera X-Frame-Options con un valor de SAMEORIGIN o DENY, que se utiliza para mejorar la protección contra ataques de secuestro de pulsaciones.

CleanDimensionMetaDataCache

Durante el cálculo de la hoja web, el parámetro CleanDimensionMetaDataCache especifica si los elementos de dimensión se recuperan de ' TM1 Server ' o utilizando elementos almacenados en caché de ' TM1 Web.

Valor predeterminado: false

Si CleanDimensionMetaDataCache se establece en false, se utilizan los elementos de la memoria caché de tm1Web.
Si CleanDimensionMetaDataCache se establece en true: los elementos de dimensión tm1web se limpian de la caché y los elementos se recuperan directamente del ' TM1 Server.

CrossDomainAccessList

Especifica una lista de URL de dominios cruzados que pueden acceder a TM1 Web.

Puede utilizar este parámetro para especificar el dominio donde se está ejecutando IBM Cognos Workspace , si se está ejecutando en un dominio distinto de TM1 Web.

Utilice un asterisco (*) para permitir que cualquier dominio acceda a TM1 Web.

Si especifica varios URL, sepárelos con una coma.

Si este parámetro no está establecido o el valor del parámetro está vacío, no se permite ningún acceso entre dominios a TM1 Web .

CubeViewerColumnPageSize

Especifica el número de columnas para captar en una página Cube Viewer.

Consulte Cambio del tamaño de página de Cube Viewer.

CubeViewerHiddenDimensionsEnabled

Oculta dimensiones en el visor de cubos de TM1 Web .

Las dimensiones ocultas forman parte del contexto de una vista, pero no se muestran como dimensiones de contexto en el visor de cubos de TM1 Web . En su lugar, residen en una región de la barra de dimensiones con la etiqueta Oculto.

Para utilizar dimensiones ocultas en el visor de cubos de TM1 Web , debe establecer CubeViewerHiddenDimensionsEnabled" ="true" en el archivo tm1web_config.xml . Cuando la característica está habilitada, la región Oculto aparece en el visor de cubos.

Puede arrastrar dimensiones desde y hasta la región Oculto del mismo modo que para las regiones Filas, Columnas y Contexto.

Cuando una vista incluye dimensiones ocultas, el número de dimensiones ocultas se muestra debajo de la etiqueta Oculto. Al pulsar la región Oculto, puede ver qué dimensiones y elementos están ocultos.

No puede cambiar el elemento para una dimensión oculta. Si desea cambiar un elemento, debe mostrar las dimensiones arrastrándolo hasta la región Filas, Columnas o Contexto y, después, cambiar el elemento. Después, puede devolver la dimensión a la región oculta.

CubeViewerRowPageSize

Especifica el número de filas que se deben recuperar de una página de Cube Viewer.

Consulte Cambio del tamaño de página de Cube Viewer.

CubeviewerStringWrap

Configuración de la derivación de celdas de cadena en el Cube Viewer.

Consulte Ajuste de valores de cadena en vistas de cubo.

CustomCAMLogoutUrl

Especifica la URL de una página de cierre de sesión dedicada para CA SiteMinder cuando " TM1 Server " está configurado para utilizar seguridad CAM (modo 4 o 5). A esta página de cierre de sesión debe accederse al cerrar la sesión para que la cookie de sesión de SiteMinder se pueda invalidar.

Cuando un usuario pulsa Cerrar sesión en TM1 Web, el cierre de sesión de CAM se produce en primer lugar. A continuación se llama a la página de cierre de sesión de SiteMinder.

EvaluationServiceURL

Especifica la ubicación del servicio de evaluación. El servicio de evaluación se incluye con IBM Planning Analytics Spreadsheet Services. Se utiliza para representar informes rápidos en las hojas web de TM1 Web y Planning Analytics .

El valor válido es hostname:port_number.

Si no hay ningún valor asignado, se presupone que el valor predeterminado es http://localhost:9510.

ExportCellsThreshold

Especifica el número máximo de celdas que puede contener una exportación de una hoja web o un vista de cubo. Si el número de celdas seleccionadas supera el umbral, se muestra un mensaje de aviso y la exportación no se inicia.

A partir de IBM Planning Analytics versión 2.0.7, el valor predeterminado es 1000000.

Edite el parámetro ExportCellsThreshold en el archivo tm1web_config.xml utilizando el formato siguiente:

<add key="ExportCellsThreshold" value="CellsThreshold" />

donde CellsThreshold es el umbral de recuento de celdas que se determina multiplicando el número de filas por el número de columnas por hoja y, después, multiplicando ese resultado por el número de iteraciones y los miembros de contexto para los cuales se ha seleccionado la exportación.

Por ejemplo, si una hoja web tiene dos hojas y cada hoja tiene 1000 filas y 25 columnas, y la exportación se ha seleccionado para cuatro miembros de contexto, el recuento de celdas se calcula como 25.000 * 2 hojas * 4 miembros de contexto = 200.000 celdas. Si <CellsThreshold> es 150.000, la exportación de esta hoja web será rechazada.

ExternalUrl

Establezca el parámetro ExternalUrl si utiliza ' TM1 Web y la autenticación de seguridad de Cognos (CAM) con un equilibrador de carga externo que modifica la URL inicio original para ' TM1 Web. El parámetro ExternalUrl proporciona la URL correcta para que la seguridad de Cognos pueda redirigir con éxito de nuevo a ' TM1 Web.

Establezca el valor en la misma URL que utiliza para iniciar ' TM1 Web, por ejemplo

 <add key="ExternalUrl" value="http://mycomputer/TM1Web" />

GzipCompressionEnabled

Determina si se comprimirán las respuestas del servidor web. Los valores válidos son true/false.

HideCubeviewerToolBar

Si se establece en true, no se mostrará ninguna de las barras de herramientas de Cube Viewer.

Véase el parámetroHideCubeviewerToolBar.

HideTabBar

Si se establece en true, no se mostrarán varias pestañas.

Véase el parámetroHideTabBar.

HideWebsheetToolBar

Si se establece en true, no se mostrarán todas las barras de herramientas de la hoja web.

Véase el parámetroHideWebsheetToolBar.

HomePageObject

Si está establecido, el tipo de objeto de hoja web, Cubeviewer o URL se mostrará después de que el usuario inicie sesión.

Consulte Configuración de una página inicial global para todos los usuarios.

HttpSessionTimeout

Este parámetro define el tiempo de espera (en minutos) de la sesión HTTP para ' TM1 Web. Si falta el parámetro, el valor es menor que 1, está en blanco o no es un valor numérico, se utiliza el tiempo de espera de sesión predeterminado definido para TM1 Web en el archivo web.xml .

Consulte Establecimiento del tiempo de espera de sesión de TM1 Web.

Nota: A partir de IBM Planning Analytics Local versión 2.0.6, no debe cambiar el valor session-timeout en el archivo web.xml .

LegacyUrlApiSessionDiscoveryEnabled

Utilice el parámetro de configuración ' LegacyUrlApiSessionDiscoveryEnabled ' para controlar cómo la API URL ' TM1 Web ' gestiona las sesiones de inicio de sesión. Configure este parámetro para especificar si la API URL hacer un seguimiento de las sesiones de inicio de sesión exclusivas separadas.

Este parámetro permite reutilizar la sesión de la API URL basándose en el host admin especificado, ' TM1 Server, y el nombre de usuario (opcional).

Si utiliza el inicio de sesión de señal de sesión con la API URL, debe establecer el parámetro de configuración LegacyUrlApiSessionDiscoveryEnabled en el archivo tm1web_config.xml en False.

Consulte Inicio de sesión de API deTM1 Web.

Utilice este formato:

<add key="LegacyUrlApiSessionDiscoveryEnabled" value=True or False/>

Por ejemplo:

<add key="LegacyUrlApiSessionDiscoveryEnabled" value="False"/>

El valor predeterminado es True.

True
TM1 Web intenta hacer coincidir la nueva solicitud de inicio de sesión con una sesión de inicio de sesión existente basándose en la información proporcionada (host de administración deTM1 , TM1 Server, nombre de usuario).

Este parámetro debe establecerse en True sólo si se produce un inicio de sesión único para una combinación exclusiva de host de administración de TM1 , TM1 Servery nombre de usuario.
False
Especifica que se debe proporcionar un token de sesión cada vez que se abra un objeto ' TM1 Web ' con la API URL ' TM1 Web '. De lo contrario, se solicita el usuario.

Establezca este parámetro en ' False si tiene previsto utilizar varias sesiones de inicio de sesión con la API URL ' TM1 Web. También puede utilizar esta configuración si está utilizando varias sesiones de inicio de sesión con la API URL y otros clientes ' TM1 Web ' como ' TM1 Web ' y TM1 Application Web. Esta configuración utiliza la señal de sesión para mantener las sesiones de usuario separadas y exclusivas.

MaximumConcurrentExports

Especifica el número máximo de exportaciones simultáneas que se pueden ejecutar desde TM1 Web. El valor predeterminado es 5.

Antes de IBM Planning Analytics versión 2.0.7, el valor predeterminado es 5.

A partir de IBM Planning Analytics versión 2.0.7, el valor predeterminado es 4.

Puede establecer MaximumConcurrentExports en 0 para permitir un número ilimitado de exportaciones simultáneas. Este valor es análogo al comportamiento de exportación en TM1 Web anterior a la versión 10.3.

Si se alcanza el número máximo de exportaciones simultáneas y, a continuación, se inician más exportaciones, las exportaciones adicionales se ponen en cola hasta que hay disponible una ranura de exportación. El iniciador de una exportación en cola no recibe notificación de la puesta en cola.

El valor de parámetro opcional depende de la capacidad de RAM y de los requisitos de usuario. Generalmente, cuanta más RAM tenga disponible para TM1 Web, más alto puede ser el valor del parámetro. El aumento del valor produce un aumento de consumo de memoria, pero reduce la cola de exportación. (Al establecer el parámetro en 0 se elimina la cola de exportación.) Y a la inversa, si se reduce el valor del parámetro, se reduce el consumo de memoria resultante de las exportaciones, pero la puesta en cola de exportación puede producirse con más frecuencia.

MaximumSheetsForExport

Especifica el número máximo de hojas que se permite exportar.

Antes de IBM Planning Analytics versión 2.0.7, el valor predeterminado es 100.

A partir de IBM Planning Analytics versión 2.0.7, el valor predeterminado es 50.

Consulte Establecimiento del número máximo de hojas para exportar desde una hoja web.

MixedCellPaste

Si el parámetro MixedCellPaste está establecido en true, al copia valores en un rango mixto de hojas y valores consolidados en una hoja web. los valores pegados coincidirán de forma exacta. El valor predeterminado es False.

Nota: Este parámetro sólo se aplica a hojas web; no se aplica a CubeViewer.

NavTreeCollapsedOnStart

Determina si el panel de navegación se contraerá o se expandirá después de que un usuario inicie sesión.

Véase el parámetroNavTreeCollapsedOnStart.

NavTreeDisplayServerView

Especifica si se mostrará el nodo Vista del servidor en el árbol de navegación. Los valores válidos son Y y N.

Consulte Visualización u ocultación del nodo Vistas en el panel de navegación.

NavTreeHidden

Determina si el panel de navegación se mostrará una vez que un usuario inicie sesión.

Véase el parámetroNavTreeHidden.

RecalcOnActivate

Si RecalcOnActivate está en true, se realiza un recálculo cada vez que se activa una hoja web o cubeview en ' TM1 Web, por ejemplo, al cambiar de pestaña.

Los valores válidos son true o false.

RecalcOnDataValidationChange

Especifica si se modificará el comportamiento de recálculo predeterminado cuando se cambie un valor en una lista de validación de datos.

Si se establece en verdadero, se activará un recálculo cuando se modifique un valor de la lista de validaciones de datos.

Si se establece en falso, no se activará un recálculo cuando cambie un valor de la lista de validaciones de datos.

RecalcOnPicklistChange

Especifica si el comportamiento de recálculo predeterminado se sobrescribirá al cambiar el valor de una lista de selección.

Si se establece en verdadero, se activará un recálculo cuando cambie un valor de la lista de selección.

Si se establece en falso, no se activará un recálculo cuando cambie un valor de la lista de selección.

RelationalResultMaxRows

Si se especifica un valor mayor de -1, la consulta relacional ResultSets estará limitada a devolver el número de filas especificado.

TM1DatabaseLabel

Si se establece en "Y", el nombre de la base de datos se visualiza con el usuario en el banner de TM1 Web . Por ejemplo, "Bienvenido: Administrador / Ejemplo de planificación". El valor predeterminado es "N". Cuando esta opción se establece en "N", no se visualiza nada con el usuario.

Consulte el parámetro TM1DatabaseLabel en Configuración de IBM TM1 Web Valores de inicio y aspecto.

TM1ServerName

Si se establece, no se solicitará a los usuarios que seleccionen un TM1 Server al que conectarse durante el inicio de sesión.

Consulte Configuración de la página de inicio de sesión Web TM1 mediante los parámetros AdminHostName y TM1ServerName.

UseBookRecalcSetting

El parámetro UseBookRecalcSetting se incluye en el archivo tm1web_config.xml. Cuando se establece en true, el servidor web utiliza el modo en el que se ha publicado la hoja Excel. Si la hoja Excel se publicó en modo de recálculo manual, los datos de la hoja web no se vuelven a enviar al cliente hasta que se realiza un recálculo.

El parámetro UseBookRecalcSetting utiliza el siguiente formato en el archivo tm1web_config.xml:

<add key="UseBookRecalcSetting" value="false" />

Donde el valor es "false" o "true"

Si establece UseBookRecalcSetting en true, ' TM1 Web ' respeta la configuración de recálculo de la hoja de cálculo de Excel.

Cuando las opciones de cálculo se han establecido en Automático:

Si establece UseBookRecalcSetting = "true", la hoja web se recalcula automáticamente cuando cambia la función SUBNM.
Si establece UseBookRecalcSetting = "false", la hoja web se recalcula automáticamente cuando cambia la función SUBNM.

Cuando las opciones de cálculo se establecen en Manual:

Si establece UseBookRecalcSetting = "true", la hoja web no se recalcula automáticamente. Para recalcular, debe pulsar manualmente el botón recalcular.
Si establece UseBookRecalcSetting = "false", la hoja web se recalcula automáticamente cuando cambia la función SUBNM.

WebsheetBackgroundRecalculationMode

Especifica el nivel de recálculo en segundo plano que se efectúa para una hoja web.

Las llamadas de WebSheetService.scrollWebSheet pueden tardar varios segundos porque los datos no están disponibles inmediatamente. Utilice el parámetro WebsheetBackgroundRecalculationMode para recalcular el libro en segundo plano, de modo que los datos necesarios estén listos cuando se soliciten.

Si se establece en 0 (valor predeterminado), solo se calcula el área en búfer (visible) al renovar una hoja.

Si se establece en 1, se calcula el área adyacente al área en búfer, además del área en búfer. Esto mejora los tiempos de espera si el usuario se desplaza ligeramente fuera del área visible inicialmente.

Si se establece en 2, se calcula toda la hoja de trabajo actual. Esta mejora los tiempos de espera si el usuario se desplaza a cualquier área de la hoja actual.

Si se establece en 3, se calcula todo el libro de trabajo actual. Esta mejora los tiempos de espera si el usuario se desplaza a cualquier área de la hoja de trabajo actual o a otra hoja de trabajo.

Nota: Cuanto más alto sea el número de configuración, más celdas se calcularán, lo que significa que habrá una carga más alta en el servidor web.

WorkbookMaxCellCount

Especifica el recuento máximo de celdas de un libro de trabajo sin separadores de millares.

El servidor de aplicaciones TM1Web valida el tamaño de un libro de trabajo que se publica en TM1 Server. Los libros de trabajo que contienen ActiveForms se pueden cargar solo con su fila de control. Durante la publicación, el libro de trabajo puede tener varias filas, pero cuando se abre y se vuelve a crear, puede mostrar muchas más filas. Puede utilizar WorkbookMaxCellCount para evitar problemas al abrir los libros con muchas celdas.

Si este parámetro está presente en tm1web_config.xml y no es el valor predeterminado, cuando el usuario abre un libro de trabajo, el servidor valida su recuento de celdas con respecto a WorkbookMaxCellCount. Si el recuento de celdas del libro de trabajo excede WorkbookMaxCellCount, se registra un mensaje de error y el libro de trabajo no se abre. El usuario ve el mensaje de error de <book_name> excede el número máximo de celdas en el archivo tm1web.log.

Consulte Utilización del registro de IBM Planning Analytics TM1 Web.

Si se deja este parámetro en blanco o se establece en 0, o menos, indica que se permite un número de celdas ilimitado en los libros de trabajo.
Antes de la versión 2.0.7 de ' IBM Planning Analytics ', el valor por defecto es -1, lo que indica que se permite un número ilimitado de celdas en un libro de trabajo.
A partir de IBM Planning Analytics versión 2.0.7, el valor predeterminado es 500000.

Nota: Los cambios en este parámetro requieren un reinicio del servidor de aplicaciones.

CSPHeaderFrameAncestors

El parámetro ' CSPHeaderFrameAncestors ' permite establecer un valor para la directiva ' frame-ancestors '. Puede especificar los dominios que pueden incrustar hojas web dentro de un marco.

Se pueden configurar los siguientes valores:

'none': Este valor bloquea cualquier dominio de enmarcar hojas web.
'self': Este valor permite enmarcar las hojas web en cualquier padre.
'self' <space separated list of sources>: Este valor especifica los dominios a los que se permite incrustar hojas web dentro de un marco.

Si no se especifica " CSPHeaderFrameAncestors ", el valor por defecto será " 'self'".