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

Essa capacidade integra ainda mais o uso do Report Builder no fluxo de trabalho natural do Excel, sem exigir acesso à interface do usuário do Report Builder.

Por exemplo, você pode querer atualizar automaticamente as solicitações do Report Builder 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.

OBSERVAÇÃO

É preciso ter o Report Builder 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 Report Builder presentes em uma pasta de trabalho.
string AsyncRefreshRange(string rangeAddressInA1Format)	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").
string AsyncRefreshRangeAltTextParam()	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.
string AsyncRefreshActiveWorksheet()	Atualiza todas as solicitações do Report Builder presentes na planilha ativa.
string AsyncRefreshWorksheet(string worksheetName)	Atualiza todas as solicitações do Report Builder presentes na planilha especificada (o nome da planilha como aparece na guia).
string AsyncRefreshWorksheetAltTextParam();	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()	Retorna uma sequência de caracteres que descreve o status da última execução.

Para acessar essas funções no Report Builder, vá até Fórmulas > Inserir função. Na parte inferior da lista de categorias, você encontrará Adobe.ReportBuilder.Bridge:

Usar essas funções em uma fórmula

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".

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

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.

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

Passar parâmetros para funções do Report Builder pelo controle de formatos

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)

Clique com o botão direito no controle e selecione Controle de formato.
Clique na guia Texto alternativo.
Em Texto alternativo, insira o intervalo de células que você deseja atualizar.
Abra a lista de parâmetros do Report Builder em Fórmulas > Inserir função > Adobe.ReportBuilder.Bridge.
Selecione uma das duas funções que terminam com AltTextParam e clique em OK.