Uso de funciones de Report Builder con Microsoft Excel

Última actualización: 2023-09-01

Temas:
Report Builder
Ver más sobre este tema

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.

Establezca el parámetro de macro.
Haga clic con el botón derecho en el control y seleccione Asignar macro.
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

Haga clic con el botón derecho del ratón en el control y seleccione Formato de control.
Haga clic en la ficha Texto alternativo.
En Texto alternativo, introduzca el rango de celdas que desee actualizar.
Abra la lista de parámetros del Report Builder en Fórmulas > Insertar función> Adobe.ReportBuilder.Bridge.
Elija una de las dos opciones que acaban con AltTextParam y haga clic en Aceptar.