Show Menu
TÓPICOS×

Invocar a funcionalidade do Report Builder a partir de funções do Microsoft Excel

Essa capacidade integra ainda mais o uso do Construtor de relatórios no fluxo de trabalho natural do Excel, sem exigir acesso à interface do usuário do Construtor de relatórios.
Por exemplo, você pode querer atualizar automaticamente as solicitações do Construtor de relatórios cujo filtro de entrada tem por base dados obtidos no Excel de outras fontes. Agora você pode fazer isso com função da sequência de caracteres RefreshRequestsInCellsRange(..) . Todas as chamadas são assíncronas. Elas retornam imediatamente e não aguardam para que a chamada seja totalmente executada.
É necessário ter o Construtor de relatórios 5.0 (ou posterior) instalado para que essa funcionalidade funcione.
Esta é uma tabela com a lista de funções expostas:
Nome da função
Descrição
string AsyncRefreshAll()
Atualiza todas as solicitações do Construtor de relatórios presentes em uma pasta de trabalho.
string AsyncRefreshRange(string rangeAddressInA1Format)
Atualiza todas as solicitações do Construtor de relatórios 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").
string AsyncRefreshRangeAltTextParam()
Atualiza todas as solicitações do Construtor de relatórios presentes no intervalo de células especificado que é passado para Texto alternativo do Controle de formulários da Ms.
string AsyncRefreshActiveWorksheet()
Atualiza todas as solicitações do Construtor de relatórios presentes na planilha ativa.
string AsyncRefreshWorksheet(string worksheetName)
Atualiza todas as solicitações do Construtor de relatórios presentes na planilha especificada (o nome da planilha como aparece na guia).
string AsyncRefreshWorksheetAltTextParam();
Atualiza todas as solicitações do Construtor de relatórios presentes no nome da planilha específica que foi passada para Texto alternativo do Controle de formulários da Ms
string GetLastRunStatus()
Retorna uma sequência de caracteres que descreve o status da última execução.
Para acessar essas funções no construtor de relatórios, vá até Fórmulas > Inserir função. Na parte inferior da lista de categorias, você encontrará Adobe.ReportBuilder.Bridge:

Use these functions in a formula

Por exemplo, a fórmula
=IF(OR(ISTEXT(P5),ISBLANK(P5)),AsyncRefreshRange("P9"),"")

diz "Se o valor na célula P5 é texto ou está em branco, atualize o intervalo na célula P9".

Use Report Builder functions with format control

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. Às vezes, você pode atualizar somente algumas solicitações, não todas.
  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 do construtor de relatórios (sem parâmetros ou parênteses).

Pass parameters to Report Builder functions via format control

As duas funções que captam um parâmetro podem ser usadas com Controle de formato, mas somente através do campo Texto alternativo:
  • AsyncRefreshRange(string rangeAddressInA1Format)
  • AsyncRefreshWorksheet(string worksheetName)
  1. Clique com o botão direito no controle e selecione Controle de formato .
  2. Clique na guia Texto alternativo.
  3. Em Texto alternativo, insira o intervalo de células que você deseja atualizar.
  4. Abra a lista de parâmetros do construtor de relatórios em Fórmulas > Inserir função > Adobe.ReportBuilder.Bridge.
  5. Selecione uma das duas funções que terminam com AltTextParam e clique em OK .