Uso de funciones de Report Builder con Microsoft Excel

Última actualización: 2023-09-01
  • Creado para:
  • User
    Admin

Puede utilizar funciones de Report Builder para acceder a la funcionalidad sin acceder a la interfaz de usuario del Report Builder.

Por ejemplo, para actualizar automáticamente las solicitudes de Report Builder con filtros de entrada basados en datos recuperados en Excel desde otros orígenes, utilice la cadena RefreshRequestsInCellsRange(…) . Todas las llamadas son asíncronas y se devuelven inmediatamente y no esperan a ejecutarse por completo.

Requisitos

  • Se requiere Report Builder 5.0 (o posterior).

En la tabla siguiente se enumeran las funciones expuestas.

Nombre de función Tipo Descripción
AsyncRefreshAll() string Actualiza todas las solicitudes de Report Builder presentes en un libro.
AsyncRefreshRange(string rangeAddressInA1Format) string Actualiza todas las solicitudes de Report Builder presentes en la dirección especificada del intervalo de celdas (una expresión de cadena que representa un intervalo de celdas en formato A1, por ejemplo, "Hoja1!A2:A10").
AsyncRefreshRangeAltTextParam() string Actualiza todas las solicitudes de Report Builder presentes en el intervalo de celdas especificado que pasan por el Texto alternativo de MS Form Control.
AsyncRefreshActiveWorksheet() string Actualiza todas las solicitudes de Report Builder presentes en el libro activo.
AsyncRefreshWorksheet(string worksheetName) string Actualiza todas las solicitudes de Report Builder presentes en el libro especificado (el nombre del libro tal y como aparece en la ficha).
AsyncRefreshWorksheetAltTextParam(); string Actualiza todas las solicitudes de Report Builder presentes en el libro concreto que se pasó por el Texto alternativo de MS Form Control.
String GetLastRunStatus() string Devuelve una cadena que describe el estado de la última ejecución.

Para acceder a las funciones del Report Builder, vaya a Fórmulas > Insertar función. Utilice el campo de búsqueda para buscar una función o seleccione una categoría para enumerar las funciones de esa categoría.

Captura de pantalla que muestra la ventana Insertar función con la lista de categorías expandida.

Ejemplo

El siguiente ejemplo muestra Si el valor de la celda P5 es texto o está en blanco, actualice el rango de la celda P9.

=IF(OR(ISTEXT(P5),ISBLANK(P5)),AsyncRefreshRange("P9"),"")

Usar las funciones de Report Builder con control de formato

Puede asignar una macro a un control que haya creado y ese control puede ser una función que actualice una solicitud de libro. Por ejemplo, la función AsyncRefreshActiveWorksheet actualizará todas las solicitudes de un libro. Sin embargo, a veces es posible que solo desee actualizar determinadas solicitudes.

  1. Establezca el parámetro de macro.
  2. Haga clic con el botón derecho en el control y seleccione Asignar macro.
  3. Introduzca el nombre de la función del Report Builder (sin parámetros ni paréntesis).

Captura de pantalla que muestra la ventana Asignar macro.

Pasar parámetros a funciones de Report Builder mediante el control de formato

Se pueden utilizar dos funciones que toman un parámetro con Control de formato. Debe utilizar el Texto alternativo: campo:

  • AsyncRefreshRange(string rangeAddressInA1Format)
  • AsyncRefreshWorksheet(string worksheetName)

Para pasar parámetros a funciones de Report Builder mediante el control de formato

  1. Haga clic con el botón derecho del ratón en el control y seleccione Formato de control.

    Captura de pantalla que muestra Control de formato seleccionado.

  2. Haga clic en la ficha Texto alternativo.

    Captura de pantalla que muestra la pestaña Texto alternativo y el campo Texto alternativo:.

  3. En Texto alternativo, introduzca el rango de celdas que desee actualizar.

  4. Abra la lista de parámetros del Report Builder en Fórmulas > Insertar función> Adobe.ReportBuilder.Bridge.

  5. Elija una de las dos opciones que acaban con AltTextParam y haga clic en Aceptar.

En esta página