Usar funções Report Builder com o Microsoft Excel

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

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

Requisitos

  • É necessário o Report Builder 5.0 (ou posterior).

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 da sequência 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 Report Builder, acesse 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 as 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 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 Texto alternativo: campo:

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

Para passar parâmetros para funções Report Builder usando 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 de 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