Relatórios › Tipos de relatório › Relatórios com parâmetros

Relatórios com parâmetros

Um relatório com parâmetros é um relatório (consulte o tópico Tipos de relatórios) em que nenhum valor foi especificado para um ou mais parâmetros no código usado para criar o relatório. Os valores específicos de cada campo são adicionados (usando serviços web ou a interface gráfica do usuário) cada vez que o relatório é gerado.

Em muitos casos, a única diferença no código usado para gerar dois relatórios diferentes pode ser o valor de um ou mais parâmetros em um conjunto de parâmetros, de outro modo, idênticos, por exemplo, Cliente_A versus Cliente_B ou fevereiro de 2011 versus janeiro de 2012.

O relatório cujo código de geração contém somente parâmetros, sem valores, é chamado de Relatório com parâmetros. Assim como com os relatórios gerados a partir da interface gráfica de usuário, é possível usar serviços web para chamar um relatório e passar a ele os valores dos parâmetros usando o método "GetMyReportsAdvanced".

Para gerar um relatório, valores específicos de cada parâmetro são inseridos no código XML do relatório, que então é executado e, em seguida, gera cada relatório. Por exemplo, o valor Consumo pode ser inserido para o parâmetro Tipo de métrica para gerar um relatório de consumo.

O código XML a seguir para gerar um relatório com parâmetros foi criado selecionando os parâmetros mostrados na figura abaixo e, em seguida, salvando (Salvar como) o relatório. O relatório pode agora ser acessado por meio da interface gráfica do usuário ou por meio de serviços web.

Valores específicos para cada um dos três parâmetros (Tipo_de_métrica, Cliente, Domínio_do_serviço) devem ser inseridos para executar o código.

<REPORT_PARAMETERS xmlns="">
         <REPORT_ITEM>
             <REPORT>
                <PARAMETERS>
                    <METRIC_TYPE IS_MANDATORY="N"></METRIC_TYPE>
                    <CUSTOMER IS_MANDATORY="N"></CUSTOMER>
                    <SERVICE_DOMAIN IS_MANDATORY="N"></SERVICE_DOMAIN>
                </PARAMETERS>
                <TIME IS_MANDATORY="Y">
                   <FROM_BEGINING>
                      <TIME_UNIT>MÊS</TIME_UNIT>
                   </FROM_BEGINING>
                 </TIME>
             </REPORT>
          </REPORT_ITEM>
</REPORT_PARAMETERS>