DocumentaçãoAnalyticsGuia de ferramentas

Usar funções do Report Builder com o Microsoft Excel

Last update: Fri Oct 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Usuário
  • Administrador
IMPORTANT
Um novo e simplificado Report Builder foi lançado em 16 de outubro de 2024. Ele é compatível com Mac, Windows e navegadores da Web.
Esta versão herdada do complemento do Report Builder ainda funciona. Você pode converter suas pastas de trabalho herdadas para a nova Report Builder.

Você pode usar as funções do Report Builder para acessar a funcionalidade sem acessar a interface do usuário do Report Builder.

Por exemplo, para atualizar automaticamente solicitações do Report Builder com filtros de entrada com base em dados extraídos de outras fontes para o Excel, use a função RefreshRequestsInCellsRange(…) de cadeia de caracteres. Todas as chamadas são assíncronas, retornam imediatamente e não aguardam a execução completa.

Requisitos

  • O Report Builder 5.0 (ou posterior) é necessário.

A tabela a seguir lista as funções expostas.

Nome da função
Tipo
Descrição
AsyncRefreshAll()
string
Atualiza todas as solicitações do Report Builder presentes em uma pasta de trabalho.
AsyncRefreshRange(string rangeAddressInA1Format)
string
Atualiza todas as solicitações do Report Builder presentes no endereço do intervalo de células especificado (uma expressão de cadeia de caracteres que representa um intervalo de células no formato A1, por exemplo "Sheet1!A2:A10").
AsyncRefreshRangeAltTextParam()
string
Atualiza todas as solicitações do Report Builder presentes no intervalo de células especificado que é passado para Texto alternativo do Controle de formulários da Ms.
AsyncRefreshActiveWorksheet()
string
Atualiza todas as solicitações do Report Builder presentes na planilha ativa.
AsyncRefreshWorksheet(string worksheetName)
string
Atualiza todas as solicitações do Report Builder presentes na planilha especificada (o nome da planilha como aparece na guia).
AsyncRefreshWorksheetAltTextParam();
string
Atualiza todas as solicitações do Report Builder presentes no nome da planilha específica que foi passada para Texto alternativo do Controle de formulários da Ms
string GetLastRunStatus()
string
Retorna uma sequência de caracteres que descreve o status da última execução.

Para acessar as funções do Report Builder, vá para Fórmulas > Inserir função. Use o campo de pesquisa para procurar uma função ou selecione uma categoria para listar as funções nessa categoria.

Captura de tela mostrando a janela Inserir Função com a lista de categorias expandida.

Exemplo section_034311081C8D4D7AA9275C1435A087CD

O exemplo a seguir mostra Se o valor na célula P5 for texto ou estiver em branco, atualize o intervalo na célula P9.

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

Usar funções do Report Builder com controle de formato section_26123090B5BD49748C8D8ED7A1C5ED84

Você pode atribuir uma macro a um controle criado e esse controle pode ser uma função que atualiza uma solicitação da pasta de trabalho. Por exemplo, a função AsyncRefreshActiveWorksheet atualizará todas as solicitações em uma pasta de trabalho. No entanto, às vezes, convém atualizar apenas determinadas solicitações.

  1. Definir o parâmetro da macro.
  2. Clique com o botão direito no controle e selecione Atribuir macro.
  3. Insira o nome da função Report Builder (sem parâmetros ou parênteses).

Captura de tela mostrando a janela Atribuir Macro.

Passar parâmetros para funções do Report Builder usando controle de formato section_ECCA1F4990D244619DFD79138064CEF0

Duas funções que usam um parâmetro podem ser usadas com o Controle de formato. Você deve usar o campo Texto alternativo::

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

Para passar parâmetros para funções do Report Builder usando o controle de formato

  1. Clique com o botão direito no controle e selecione Controle de formato.

    Captura de tela mostrando o Controle de Formato selecionado.

  2. Clique na guia Texto alternativo.

    Captura de tela mostrando a guia Texto Alternativo e o campo Texto Alternativo:.

  3. Em Texto alternativo, insira o intervalo de células que você deseja atualizar.

  4. Abra a lista de parâmetros do Report Builder em Fórmulas > Inserir Função> Adobe.ReportBuilder.Bridge.

  5. Selecione uma das duas funções que terminam com AltTextParam e clique em OK.

recommendation-more-help
a83f8947-1ec6-4156-b2fc-94b5551b3efc