Creación de funciones en el Creador de funciones

En Creador de funciones, seleccione una función y especifique tanto la conexión como los miembros que debe utilizar. A continuación, Creador de funciones crea la función con la sintaxis correcta y la introduce en la celda seleccionada. Puede editar estas funciones.

Las selecciones disponibles en un campo concreto del Creador de funciones están limitadas por las selecciones realizadas en los otros campos del creador. Por ejemplo, sólo se muestran las conexiones que admite la función seleccionada o las dimensiones que admite la función seleccionada.

Se puede seleccionar una referencia de celda para cada argumento de función. Si conoce los valores de entrada de argumentos, se pueden crear funciones en modo fuera de línea. Hay disponible una funcionalidad de escritura para cada argumento.

Descripción de las funciones

Nota:

Puede utilizar las funciones que se han creado en una versión del creador de funciones anterior a la 11.1.2.2.310. Sin embargo, a partir de la versión 11.1.2.2.310, el creador de funciones utiliza comas (,) para separar los argumentos de la lista de miembros, en lugar de signos de punto y coma (;). El nuevo creador de funciones admite ambos caracteres, pero cuando se modifica una función creada en la versión anterior, se le pedirá que la convierta al nuevo formato separado por comas. Si decide no realizar la conversión, no se aplica ninguna de las modificaciones realizadas en la función.

Para crear funciones mediante el Creador de funciones:

  1. Conecte al origen de datos adecuado.

    El Creador de funciones soporta conexiones compartidas, privadas y URL. Como mejores prácticas, asegúrese de que está conectado en el nivel de cubo. Si está conectado en el nivel de aplicación, puede que reciba el mensaje "No se ha seleccionado ningún cubo" cuando utilice funciones de Smart View como HsGetValue o HsSetValue. Sin embargo, para Oracle Hyperion Financial Management, puede seguir conectado en el nivel de aplicación para utilizar las funciones de Smart View.

    Oracle Essbase: Si utiliza una conexión privada y la función va a utilizar una tabla de alias, debe verificar que se ha establecido la tabla de alias correcta o la tabla de alias "por defecto" para la conexión. En el panel de Smart View, haga clic con el botón derecho en el nombre de la base de datos y seleccione Establecer tabla de alias. Asegúrese de que está seleccionada la tabla de alias correcta y, a continuación, refresque la hoja.

  2. En la hoja, seleccione la celda en la que desee introducir la función.
  3. En el panel de Smart View, navegue hasta la base de datos en la que desea basar la función, haga clic con el botón derecho en el nombre de la base de datos y, a continuación, seleccione Crear función.

    Al acceder al Creador de funciones de esta forma se rellena previamente el campo Conexión del cuadro de diálogo Argumentos de función con información específica de la conexión, como se describe en el paso 4.

    Alternativamente, en la cinta de Smart View, seleccione Funciones y, a continuación, Crear función.

    Al acceder al Creador de funciones de esta forma, el campo Conexión del cuadro de diálogo Argumentos de función está en blanco. Puede proporcionar información de conexión, como se describe en el paso 4. O bien, si hay una conexión activa en la hoja, seleccione HSACTIVE en la lista desplegable.

  4. En Seleccionar función, seleccione una función de la lista y haga clic en Aceptar.

    Figura 17-1 Creador de funciones, cuadro de diálogo Seleccionar función


    El cuadro de diálogo Seleccionar función del creador de funciones con HsGetValue seleccionado, tal y como se describe en esta sección

    Nota:

    No todas las funciones están disponibles para todos los proveedores. Consulte Tabla 17-1 para obtener una lista de funciones y de proveedores soportados.

    Se muestra el cuadro de diálogo Argumentos de función, con el campo Conexión relleno automáticamente con la información de conexión en uno de los siguientes formatos.

    • Para conexiones compartidas:

      WSFN|ProviderType|Server|Application|Database

      El parámetro WSFN anterior indica que esta función es una función de área de trabajo y utiliza una conexión compartida. Las funciones de área de trabajo soportan conexiones de Oracle Hyperion Enterprise Performance Management Workspace y Oracle Enterprise Performance Management Cloud.

    • Para conexiones privadas:

      PrivateConnectionName

    • Para conexiones URL:

      URLFN|URL|Server|Application|Database

    Toda la información necesaria para realizar una conexión forma parte del símbolo, como se muestra más arriba: Si el símbolo contiene alguna información no válida, normalmente se muestra un error #NoConnection, con las siguientes excepciones para el símbolo del servidor:

    • Para los procesos de negocio de EPM Cloud, como Planning, el símbolo del servidor puede estar en blanco (o no ser válido)
    • El símbolo del servidor de Essbase solo puede estar en blanco
    • Financial Management requiere el parámetro de símbolo de servidor

    Para introducir manualmente la información de conexión, utilice la sintaxis anterior.

  5. En Argumentos de función, para cada argumento de la función seleccionada, siga uno de estos procedimientos:

    • Haga clic en el botón situado más a la derecha, El botón Selección de miembros, abre el cuadro de diálogo Selección de miembros.

      Por ejemplo, para HsGetValue, haga clic en El botón Selección de miembros, abre el cuadro de diálogo Selección de miembros para seleccionar miembros en Selección de miembros; para HsLabel y HsGetVariable, seleccione las etiquetas o variables en las listas desplegables.

      Essbase: tenga en cuenta que cuando los nombres de variables están duplicados, se muestra el nombre completo en la lista desplegable. Esto ayuda a identificar las variables definidas en bases de datos, aplicaciones y a nivel global.

    • Para introducir los argumentos manualmente, introduzca el argumento en el cuadro de texto. Por ejemplo, para introducir un miembro, utilice el formato: dimensión#miembro; por ejemploYear#Qtr1 o Year#Jan.

    • Para utilizar referencias de celdas, siga el procedimiento descrito en Uso de referencias de celdas.

    Figura 17-2 muestra un cuadro de diálogo Argumentos de función completado para la función HsGetValue.

    Figura 17-2 Creador de funciones, cuadro de diálogo Argumentos de función para HsGetValue según la base de datos básica de ejemplo de Essbase


    Creador de funciones, cuadro de diálogo Argumentos de función, para la función HsGetValue. Hay un campo Conexión y campos para introducir dimensiones y miembros para cada argumento de función.

    Los argumentos mostrados en Argumentos de función varían según la función seleccionada en el paso anterior.

    Nota:

    Tenga en cuenta las mejores prácticas siguientes:

    • Para HsGetSheetInfo, utilice una referencia de celda. Consulte Uso de referencias de celdas para obtener más información.

    • Solo para HsSetValue: Seleccione Datos o Referencia de celda e introduzca el valor que desea enviar.

    • Sólo para HsGetText y HsSetText:

      • Seleccione Comentarios o Referencia de la celda, y, a continuación, introduzca el texto de celda que se va a enviar

      • Seleccione Etiqueta de texto de celda y luego seleccione una etiqueta del menú desplegable

    • Si hay disponible una conexión de hoja de trabajo activa, puede seleccionar HSACTIVE en la lista desplegable Conexión.

  6. Haga clic en Validar y corrija los errores que puedan advertirse.

    Algunos de los errores que puede ver son los siguientes:

    • La conexión no es válida o está fuera de línea

    • Selección no válida

    • El nombre del miembro no es válido o no coincide con el alias seleccionado

    • El nombre de la dimensión no es válido o no coincide con el alias seleccionado

    • Dimensión incompleta#Combinación de miembros

    • "Error" genérico en casos en los que falten las comillas o otros errores de sintaxis secundarios

    Figura 17-3 muestra los errores en el cuadro de diálogo Argumentos de función después de hacer clic en el botón Validar. En el ejemplo siguiente de la aplicación de ejemplo Financial Management hay errores en la sintaxis de dos de las combinaciones Dimensión#Miembro. El primer error es que el nombre de la dimensión no es válido o no coincide con el alias seleccionado. El segundo error es que el nombre del miembro no es válido o no coincide con el alias seleccionado.

    Figura 17-3 Errores de validación del Creador de funciones


    Creador de funciones, cuadro de diálogo Argumentos de función, para la función HsGetValue. Hay errores en la sintaxis de dos de las combinaciones Dimensión#Miembro. El primer error es que el nombre de la dimensión no es válido o no coincide con el alias seleccionado. El segundo error es que el nombre del miembro no es válido o no coincide con el alias seleccionado.
  7. Cuando la validación de la función es correcta, haga clic en Aceptar para insertar la función en la celda seleccionada.
  8. Para ejecutar la función, siga el procedimiento descrito en Ejecución de funciones.