Incorporar relatórios no Jelly

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 14 min. de leitura

    • Você pode incorporar relatórios em qualquer elemento baseado no Jelly, como uma página de IU.

    Incorporação

    Para habilitar a incorporação de relatórios no Jelly, adicione o seguinte elemento ao código do Jelly.

    <g:inline template="reporting_includes.xml" />

    Depois de adicionar este código, você pode incorporar um relatório existente ou gerar um relatório no código Jelly.

    Incorporar um relatório existente

    Você pode incorporar um relatório existente chamando o. ReportById(targetSpan, reportId) função.

    Por exemplo, adicione o seguinte ao bloco HTML/XML no registro da página de IU:
    <xml version="1.0" encoding="utf-8">
     <j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">
     <g:inline template="reporting_includes.xml" />
     <div id="report_stuff" />
     </j:jelly>
    E adicione o seguinte ao bloco de script do cliente no registro da página de IU. Substitua o <report sys_id> pelo sys_id real do relatório:
    var div = $j("#report_stuff");
embedReportById(div, <"report sys_id">);
    Como alternativa, você pode incorporar o JavaScript no código Jelly inteiramente no bloco HTML/XML. Adicione o código do bloco de script do cliente entre <script> tags:
    <xml version="1.0" encoding="utf-8">
     <j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">
     <g:inline template="reporting_includes.xml" />
     <div id="report_stuff" />     
     <script>
          var div = $j("#report_stuff");
          embedReportById(div, <"report sys_id">);
     </script>
     </j:jelly>
    Tabela 1. Parâmetros
    Parâmetro Descrição
    TargetSpan O elemento jQuery no qual incorporar o gráfico. O gráfico usa o tamanho deste elemento.
    reportId O sys_id do relatório que você deseja incorporar.

    Gere e incorpore um relatório

    Você pode incorporar um relatório na IU chamando o. Parâms embedReportByParams(targetSpan, parms) função. Ao incorporar um relatório dessa maneira, você pode gerar um novo relatório usando parâmetros ou especificar um sys_id de relatório para exibir esse relatório.

    Por exemplo, adicione o seguinte ao bloco HTML/XML no registro da página de IU:
    <xml version="1.0" encoding="utf-8">
     <j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">
     <g:inline template="reporting_includes.xml" />
     <div id="report_stuff" />
     </j:jelly>
    E adicione o seguinte ao bloco de script do cliente no registro da página de IU:
    var params = {sysparm_title: "Average for all ratings", sysparm_field: "category", sysparm_type: "bar", sysparm_table: "asmt_category_result", sysparm_aggregate: "AVG", sysparm_sumfield: "rating"}; 
var div = $j("#report_stuff");
embedReportByParams(div, params);
    Como alternativa, você pode incorporar o JavaScript dentro do código Jelly. Adicione o código do bloco de script do cliente entre <script> tags:
    <xml version="1.0" encoding="utf-8">
     <j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">
     <g:inline template="reporting_includes.xml" />
     <div id="report_stuff" />
     <script>
          var params = {sysparm_title: "Average for all ratings", sysparm_field: "category", sysparm_type: "bar", sysparm_table: "asmt_category_result", sysparm_aggregate: "AVG", sysparm_sumfield: "rating"};
          var div = $j("#report_stuff");
          embedReportByParams(div, params);
     </script>
     </j:jelly>
    Tabela 2. Parâmetros
    Parâmetro Descrição
    TargetSpan O elemento jQuery no qual incorporar o gráfico.
    parms Um objeto JSON que define o relatório. Os parâmetros disponíveis dependem do tipo de relatório.

    Gerando e incorporando um relatório de lista

    Ao incorporar um relatório de lista existente ou gerar um relatório de lista e incorporá-lo, insira mais uma linha de código.

    Adicione o seguinte ao bloco HTML/XML no registro da página de IU:
    <xml version="1.0" encoding="utf-8">
     <j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">
     <g:inline template="reporting_includes.xml" />
     <g:inline template="list2_js_includes.xml" />  
     <div id="report_stuff" />
     </j:jelly>
    Adicione o seguinte ao bloco de script do cliente no registro da página de IU. Substitua o <report sys_id> pelo sys_id real do relatório:
    var div = $j("#report_stuff");
embedReportById(div, <"report sys_id">);
    Ou incorpore o JavaScript no código Jelly inteiramente no bloco HTML/XML. Adicione o código do bloco de script do cliente entre <script> tags:
    <xml version="1.0" encoding="utf-8">
     <j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">
     <g:inline template="reporting_includes.xml" />
     <g:inline template="list2_js_includes.xml" />
     <div id="report_stuff" />     
     <script>
          var div = $j("#report_stuff");
          embedReportById(div, <"report sys_id">);
     </script>
     </j:jelly>
    Tabela 3. Parâmetros
    Parâmetro Descrição
    TargetSpan O elemento jQuery no qual incorporar o gráfico. O gráfico usa o tamanho deste elemento.
    reportId O sys_id do relatório que você deseja incorporar.

    Parâmetros de relatório incorporados

    Ao incorporar um relatório em um elemento Jelly, você pode definir um relatório a qualquer momento, passando parâmetros.

    Parâmetros comuns

    Determinados parâmetros são usados por vários tipos de relatório.

    Tabela 4. Parâmetros comuns
    Parâmetro Descrição Valor padrão
    jvar_report_id O sys_id de um registro de relatório. Se passar este parâmetro, não especifique outros parâmetros. Todos os valores são obtidos do registro do relatório.
    sysparm_report_id Use este parâmetro em vez de jvar_report_id quando quiser substituir qualquer um dos outros parâmetros do sysparm que existem no relatório.
    sysparm_title O título do relatório.
    sysparm_table A tabela para relatar. Especifique este valor ou sysparm_report_source_id, mas não ambos.
    sysparm_report_source_id O sys_id de uma origem de relatório. Especifique este valor ou sysparm_table, mas não ambos. Este valor é usado em vez de sysparm_table se você passar ambos.
    sysparm_type O tipo de relatório a ser criado.

    Valores possíveis: List, line, line_bar, area, spline, horizontal_bar, pareto, hist, pizza, rosca, semi_donut, velocímetro, mostrador, pivô, pivot_v2, funil, calendário, pirâmide, caixa, tendência, controle, caixa de tendências e mapa térmico.

    		 linha
    sysparm_field O campo da tabela especificada para agrupar os dados. Necessário para série temporal, coluna, barra, pizza, rosca, relatórios de funil, pirâmide, caixa, tendência e caixa de tendências. Opcional para relatórios de lista.
    sysparm_query O filtro a ser aplicado aos dados antes de gerar o relatório. Especifique uma cadeia de caracteres de consulta para este valor.

    Para classificar os resultados da consulta por um campo específico, adicione <field_name> ou <field_name> para o final da cadeia de caracteres de consulta. ORDERBY classifica a consulta por ordem crescente. ORDERBYDES classifica a consulta por ordem decrescente.
    sysparm_aggregate O tipo de agregação.

    Valores possíveis: AVG, COUNT, SUM e COUNT_DISTINCT

    		 CONTAGEM
    sysparm_sumfield O campo para agregar dados. Este parâmetro não se aplica ao usar um tipo de agregação de CONTAGEM.
    sysparm_display_grid Um valor verdadeiro/falso que controla se o relatório exibe uma grade de dados. falso
    sysparm_show_other Um valor verdadeiro/falso que controla se o outro grupo aparece no relatório. Este grupo aparece somente se o número de grupos exceder o número especificado no parâmetro sysparm_others. Este parâmetro se aplica a barra, pizza, funil, pirâmide, pivô, e relatórios de mapa térmico. verdadeiro
    sysparm_others O número máximo de grupos individuais de dados a serem exibidos. Todos os grupos de dados adicionais são combinados em outro grupo. Este parâmetro se aplica a barra, pizza, funil, pirâmide, pivô, e relatórios de mapa térmico.
    sysparm_source_type A origem do relatório incorporado. Opcional.

    Valores possíveis: Tabela, metricbase, origem, importação

    		 tabela
    sysparm_set_color A configuração de cor do relatório.

    Valores possíveis: One_color, color_palette, several_colors

    		 color_palette
    sysparm_color_palette A paleta de cores usada pelo relatório. Este parâmetro é usado quando sysparm_set_color é "color_palette".

    Valor possível: O sys_id de uma paleta de cores

    		 IU14 Padrão
    sysparm_color A cor usada pelo relatório. Este parâmetro é usado quando sysparm_set_color é "one_color".

    Valor possível: O sys_id de uma cor
    sysparm_chart_colors O conjunto de cores do gráfico que o relatório usa. Este parâmetro é usado quando sysparm_set_color é "several_colors".

    Valor possível: Uma lista separada por vírgulas de códigos hexadecimais de cores
    sysparm_show_marker Um marcador é o valor representado por um ponto em uma linha ou outro elemento gráfico em um gráfico. Este parâmetro é um valor verdadeiro/falso que controla se o marcador aparece. verdadeiro
    sysparm_show_empty Um valor verdadeiro/falso que controla se registros com agrupamento vazio ou valores de tendência aparecem no relatório. falso
    sysparm_stack_field O campo usado para controlar o empilhamento em relatórios de barra e coluna.
    sysparm_bar_unstack Um valor verdadeiro/falso que controla se os dados empilhados são apresentados como uma única barra ou coluna ou como várias barras. falso
    sysparm_box_field O campo numérico usado para medir os dados. Este parâmetro é necessário para relatórios de caixa e histograma.
    sysparm_trend_field O campo de data/hora usado para organizar dados de tendência. Este parâmetro é necessário para relatórios de série temporal, tendência e caixa.
    sysparm_trend_interval O intervalo para medir os valores de tendência.

    Valores possíveis: Ano, trimestre, mês, semana, diaofweek, hora e data.

    		 ano
    sysparm_compute_percent O valor a ser usado ao exibir porcentagens de relatório. Você pode exibir porcentagens com base na contagem total de registros ou no agregado especificado.

    Valores possíveis: Agregado e contagem

    		 contagem
    sysparm_funnel_neck_percent Um número de 1 a 100 que define a porcentagem de um relatório de funil que é o gargalo do funil. 30
    sysparm_show_chart_data_label Um valor verdadeiro/falso que controla se os rótulos de dados aparecem no relatório. falso
    sysparm_show_zero Um valor verdadeiro/falso que controla se zeros aparecem nos relatórios de dinâmica multinível e de mapa térmico.
    sysparm_ct_row O campo usado para definir as linhas no mapa de calor e relatórios de bolhas.
    sysparm_ct_column O campo usado para definir as colunas no mapa de calor e relatórios de bolhas.
    sysparm_y_axis_category_fields O campo usado para definir as linhas em relatórios dinâmicos multinível. Especifique até cinco nomes de campos separados por vírgulas.
    sysparm_x_axis_category_fields O campo usado para definir as colunas em relatórios dinâmicos multinível. Especifique até três nomes de campos separados por vírgulas.
    sysparm_list_ui_view O sys_id de uma exibição de lista a ser usada quando um usuário se aprofunda no relatório.
    sysparm_show_marker Um valor verdadeiro/falso que controla se os marcadores aparecem em todos os pontos plotados em um relatório. verdadeiro
    sysparm_apply_alias Um valor verdadeiro/falso que controla se os aliases configurados aparecem nos relatórios incorporados.

    Parâmetros do catálogo de serviços

    Determinados parâmetros se aplicam somente a relatórios criados em tabelas do catálogo de serviços, como a tabela Item solicitado [sc_req_item]. Esses parâmetros não estão disponíveis em relatórios de tipo de lista ou calendário.
    Tabela 5. Parâmetros do relatório do catálogo de serviços
    Parâmetro Descrição
    sysparm_sc_groupby_item_id O sys_id de um item do catálogo. Use este parâmetro com sysparm_sc_groupby_variable_idparâmetro para agrupar um relatório do catálogo de serviços com base em um valor de variável do catálogo. Esses parâmetros substituem o. sysparm_fieldparâmetro ao agrupar variáveis do catálogo de serviços.
    sysparm_sc_groupby_variable_id O sys_id da variável de item do catálogo usada para determinar como os dados são agrupados no relatório. Esta variável deve pertencer ao item do catálogo especificado em sysparm_sc_groupby_item_id parâmetro.
    sysparm_sc_stackby_item_id O sys_id de um item do catálogo. Use este parâmetro com sysparm_sc_stackby_variable_idparâmetro para empilhar um relatório do catálogo de serviços com base em um valor de variável do catálogo. Esses parâmetros substituem o. sysparm_stack_fieldparâmetro ao agrupar variáveis do catálogo de serviços. Somente relatórios compatíveis com empilhamento, como relatórios de barra, são compatíveis com esses parâmetros.
    sysparm_sc_stackby_variable_id O sys_id da variável de item do catálogo usada para determinar como os dados são agrupados no relatório. Esta variável deve pertencer ao item do catálogo especificado em sysparm_sc_stackby_item_id parâmetro.

    Parâmetros do MetricBase

    Para usar o MetricBase em um relatório incorporado, o parâmetro sysparm_source_type deve ser definido como "metricbase".

    O MetricBase também requer o parâmetro sysparm_custom_configuration, que tem a seguinte sintaxe:

    sysparm_custom_config: "{query_condition:\"\",transforms:[{transform:{transform:\"Reference\",name:\"chart-subjects\"},metric:\"mb_metricname\"}], group_by:\"\", table:\"mb_tablename\"}";
    Nesta sintaxe:
    • R transformação é uma cadeia de funções de transformação aninhadas. A última transformação de cada cadeia deve ser sempre a transformação de referência:
      {transform:\"Reference\",name:\"chart-subjects\"}
    • R métrica é um campo de métrica de uma tabela de métricas.
    • . agrupar por o campo é o campo na tabela de métricas selecionada pela qual a série temporal é agrupada.
    • tabela refere-se à tabela de métricas
    • mb_... são nomes de espaço reservado
    Todos os atributos são obrigatórios, exceto agrupar por .

    Parâmetros específicos do gráfico

    Determinados parâmetros estão disponíveis somente para tipos de relatório específicos.

    Tabela 6. Parâmetros do relatório de rosca
    Parâmetro Descrição Valor padrão
    sysparm_show_chart_total Um valor verdadeiro/falso que controla se a pontuação total do donut agrupado aparece no centro do relatório. falso
    sysparm_donut_width_percent Um número 1–100 que controla a espessura do relatório de rosca. 50
    Tabela 7. Parâmetros do mapa térmico
    Parâmetro Descrição Valor padrão
    sysparm_use_color_heatmap Um valor verdadeiro/falso que controla se o mapa térmico usa um gradiente para colorir o relatório. Quando verdadeiro, os valores sysparm_axis_max_color e sysparm_axis_min_color são usados. verdadeiro
    sysparm_axis_max_color A cor usada no gradiente do mapa térmico para indicar um valor alto. Este valor deve ser o sys_id de um registro de Definição de cor [sys_report_color]. Azul UI14
    sysparm_axis_min_color A cor usada no gradiente do mapa térmico para indicar um valor baixo. Este valor deve ser o sys_id de um registro de Definição de cor [sys_report_color]. branco
    Tabela 8. Parâmetros de discagem
    Parâmetro Descrição Valor padrão
    sysparm_gauge_autoscale Um valor verdadeiro/falso que controla se o mostrador calcula automaticamente a escala mínima e máxima no relatório. Se você definir este valor como falso, deverá especificar um valor sysparm_from e sysparm_to. verdadeiro
    sysparm_from Um número que define o valor mínimo para a escala do eixo.
    sysparm_to Um número que define o valor máximo da escala do eixo.
    sysparm_upper_limit Um número que define o limite superior da discagem. Se você não especificar um valor, o mostrador não terá limite superior.
    sysparm_lower_limit Um número que define o limite inferior da discagem. Se você não especificar um valor, o mostrador não terá um limite inferior.
    sysparm_direction Um valor que controla quais valores são considerados positivos no relatório, valores inferiores ou valores superiores.

    Valores possíveis: Minimizar e maximizar.

    		 minimizar

    Parâmetros de tamanho do gráfico

    Determinados parâmetros controlam a largura e a altura do relatório.
    Tabela 9. Parâmetros de tamanho
    Parâmetro Descrição Valor padrão
    sysparm_chart_size O tamanho do gráfico no relatório. Os valores válidos são pequeno, médio e grande. grande
    sysparm_custom_chart_size Ative este parâmetro para especificar valores personalizados de altura e largura do gráfico em vez de usar uma opção de tamanho do sysparm_chart_sizeparâmetro. falso
    sysparm_custom_chart_height A altura do gráfico no relatório, em pixels.
    sysparm_custom_chart_width A largura do gráfico no relatório, em pixels.

    Parâmetros de título do gráfico

    Determinados parâmetros estão disponíveis somente para relatórios que exibem um título. Esses tipos de relatório incluem séries temporais, barra, coluna, pizza, rosca, mostradores, tendência, caixa, caixa de tendência, histograma, relatórios de pirâmide, mapa térmico, funil e controle.
    Tabela 10. Parâmetros de título
    Parâmetro Descrição Valor padrão
    sysparm_report_title_size Um número que define o tamanho da fonte do título. 16
    sysparm_report_title_color A cor do texto do título. Este valor deve ser o sys_id de um registro de Definição de cor [sys_report_color]. preto
    sysparm_title_horizontal_alignment Onde o título é colocado horizontalmente em relação ao relatório. Este valor será usado somente se sysparm_custom_report_title_position for falso.

    Os valores possíveis são: Esquerda, centro e direita.

    		 center
    sysparm_title_vertical_alignment Onde o título é colocado verticalmente em relação ao relatório. Este valor será usado somente se sysparm_custom_report_title_position for falso.

    Valores possíveis: Superior, médio e inferior.

    		 superior
    sysparm_custom_report_title_position Um valor verdadeiro/falso que controla se as coordenadas x e y definem a posição do título do relatório em vez do alinhamento relativo. falso
    sysparm_report_title_x_position Um número que define a posição x do título no relatório. Este valor será usado somente se sysparm_custom_report_title_position for verdadeiro. 0
    sysparm_report_title_y_position Um número que define a posição y do título no relatório. Este valor será usado somente se sysparm_custom_report_title_position for verdadeiro. 0

    Parâmetros de borda do gráfico

    Determinados parâmetros estão disponíveis somente para relatórios que exibem uma borda. Estes tipos de relatório incluem: Séries temporais, barra, coluna, pizza, donuts, mostradores, tendência, caixa, caixa de tendência, histograma, relatórios de pirâmide, mapa térmico, funil e controle.
    Tabela 11. Parâmetros de borda
    Parâmetro Descrição Valor padrão
    sysparm_show_report_border Um valor verdadeiro/falso que controla se o relatório exibe uma borda. falso
    sysparm_report_border_width Um número que define a largura da borda, em pixels. 1
    sysparm_report_border_radius Um número que define o tamanho do raio dos cantos da borda, em pixels. 0

    Parâmetros de legenda

    Determinados parâmetros estão disponíveis somente para relatórios que exibem uma legenda. Esses tipos de relatório incluem pizza, rosca, barra empilhada, coluna empilhada, série temporal, caixa, histograma, pirâmide, controle, e relatórios de mapa térmico.
    Tabela 12. Parâmetros de legenda
    Parâmetro Descrição Valor padrão
    sysparm_show_legend Um valor verdadeiro/falso que controla se o relatório exibe uma legenda. verdadeiro
    sysparm_legend_horizontal_alignment Onde a legenda é colocada horizontalmente em relação ao relatório.

    Valores possíveis: Esquerda, centro e direita.

    		 center
    sysparm_legend_vertical_alignment Onde a legenda é colocada verticalmente em relação ao relatório.

    Valores possíveis: Superior, médio e inferior.

    		 parte inferior
    sysparm_show_legend_border Um valor verdadeiro/falso que controla se a legenda exibe uma borda. verdadeiro
    sysparm_legend_border_width Um número que define a largura da borda da legenda, em pixels. 1
    sysparm_legend_border_radius Um número que define o tamanho do raio dos cantos da borda da legenda, em pixels. 0

    Parâmetros do eixo X.

    Determinados parâmetros estão disponíveis somente para relatórios que usam um eixo X. Esses tipos de relatório incluem barra, barra horizontal, pareto, coluna, área de linha, spline, caixa, caixa de tendências, controle e relatórios de tendências.
    Tabela 13. Parâmetros do eixo X.
    Parâmetro Descrição Valor padrão
    sysparm_x_axis_title O nome a ser exibido no eixo x.
    sysparm_x_axis_title_size Um número que define o tamanho da fonte do título do eixo X.
    sysparm_x_axis_title_bold Um valor verdadeiro/falso que controla se o texto do título do eixo x está em negrito. verdadeiro
    sysparm_x_axis_opposite Um valor verdadeiro/falso que controla se o eixo x aparece na parte superior do relatório. falso
    sysparm_x_axis_display_grid Um valor verdadeiro/falso que controla se as linhas de grade verticais aparecem no eixo x. falso
    sysparm_x_axis_grid_dotted Um valor verdadeiro/falso que controla se as linhas da grade vertical são pontilhadas. falso
    sysparm_x_axis_label_size Um número que define o tamanho da fonte para rótulos de incremento no eixo x. 11
    sysparm_x_axis_label_bold Um valor verdadeiro/falso que controla se os rótulos de incremento do eixo X estão em negrito. falso

    Parâmetros do eixo Y.

    Determinados parâmetros estão disponíveis somente para relatórios que usam um eixo Y. Esses tipos de relatório incluem barra, barra horizontal, Pareto, coluna, área de linha, spline, caixa, caixa de tendências, controle e relatórios de tendências.
    Tabela 14. Parâmetros do eixo Y.
    Parâmetro Descrição Valor padrão
    sysparm_y_axis_title O nome a ser exibido no eixo y. Uma descrição gerada automaticamente da agregação de relatório
    sysparm_y_axis_title_size Um número que define o tamanho da fonte do título do eixo y.
    sysparm_y_axis_title_bold Um valor verdadeiro/falso que controla se o texto do título do eixo y está em negrito. verdadeiro
    sysparm_y_axis_opposite Um valor verdadeiro/falso que controla se o eixo y aparece à esquerda do relatório. falso
    sysparm_y_axis_display_grid Um valor verdadeiro/falso que controla se linhas de grade horizontais aparecem no eixo y. verdadeiro
    sysparm_y_axis_grid_dotted Um valor verdadeiro/falso que controla se as linhas de grade horizontais são pontilhadas. falso
    sysparm_y_axis_label_size Um número que define o tamanho da fonte para rótulos de incremento no eixo y. 12
    sysparm_y_axis_label_bold Um valor verdadeiro/falso que controla se os rótulos de incremento do eixo y estão em negrito. falso
    sysparm_y_axis_from Um número que define o valor mais baixo exibido no eixo y.
    sysparm_y_axis_to Um número que define o valor mais alto exibido no eixo y.