Uso da API setVariableValue em um script de história

Objective

After completing this lesson, you will be able to use a API setVariableValue para definir várias variáveis em um script de história.

API setVariableValue

Esta lição é relevante para desenvolvedores de histórias que trabalham com consultas de um sistema SAP Business Warehouse (SAP BW) como fonte de dados para suas histórias.

Pontos a considerar

Há duas coisas a considerar ao decidir se você deseja usar variáveis de uma consulta BEx de um sistema SAP BW em seus scripts, uma vez que essas variáveis são objetos muito caros de uma perspectiva de desempenho.

  1. Todos os valores que você define como valores de variável precisam ser validados antes de serem usados.

    A validação significa que existe um requisito para uma solicitação back-end adicional.

    Na caixa de diálogo Insights de desempenho, essas solicitações de validação serão exibidas como solicitações adicionais de metadados de modelo de consulta.

    Diálogo SAP Performance Insights exibindo solicitações de validação adicionais exibidas como solicitações adicionais de metadados de modelo de consulta.
  2. A modificação de uma única variável pode levar a uma nova renderização de vários widgets.

    Dependendo da configuração de processamento de variáveis (em toda a história ou específico do widget), o design da história em si e, se a variável for usada em vários widgets, a modificação de uma única variável pode levar à renderização de vários widgets novamente.

Recomendações

Depois de considerar como o uso de variáveis pode afetar o desempenho da sua história, existem duas recomendações para o uso eficaz de variáveis. Essas são apenas recomendações gerais e não devem ser seguidas como regras rígidas, pois podem ocorrer diferenças dependendo do design específico da história.

  1. Usando vários valores de variável.

    Se você quiser definir vários valores de variável em um script, mantenha as APIs setVariableValue() juntas, idealmente uma linha após a outra. Eles são, sempre que possível, consolidados automaticamente em uma solicitação. Isso reduz o número de viagens de ida e volta de back-end e aumenta o desempenho. Por exemplo:

    Code Snippet
    12
    Table_1.getDataSource().setVariableValue("U00_VAR_MON_001","201507"); Table_1.getDataSource().setVariableValue("U00_VAR_MON_002","201508");
    Caixa de diálogo Insights de desempenho mostrando a performance do script de evento onClick quando BTN_2var é selecionado. O código usado é escrito acima da imagem.

    Se você, por qualquer motivo, não puder gravá-los juntos, considere que algumas APIs (por exemplo, aquelas que referenciam a fonte de dados, ordenam os valores, etc.) impedem que o sistema consolide as solicitações. Por exemplo:

    Code Snippet
    123
    Table_1.getDataSource().setVariableValue("U00_VAR_MON_001","201507"); Table_1.sortByMember("0D_NW_PRID__0D_NW_PRCAT",SortOrder.Descending); Table_1.getDataSource().setVariableValue("U00_VAR_MON_002","201508");
    Caixa de diálogo Insights de desempenho mostrando a performance do script de evento onClick quando BTN_VarSortVar é selecionado. O código usado é escrito acima da imagem.
  2. Utilizar um filtro em vez de uma variável.

    Caso a variável dentro da consulta só seja usada para permitir que o usuário selecione um filtro para uma dimensão, considere usar um filtro.

    A definição de um valor de filtro com a API setDimensionFilter(), em geral, não requer a validação extra de ida e volta.