Configuração de Paginação

As várias zonas do explorador de dados no produto suportam a capacidade de configurar a paginação, de modo que um usuário possa 'deslocar pela página' um grande conjunto de resultados usando os botões "anterior" e "próximo" ou os links.

Há vários parâmetros de zona que são afetados ao tentar configurar essa funcionalidade. As etapas a seguir destacam a configuração.

  • O parâmetro Ativar Paginação deve ser configurado para definir a configuração básica da paginação para a zona. Este parâmetro define se as ações "anterior" e "próximo" são definidas como botões, links ou ícones e indica o local das ações. Também permite indicar se as linhas adicionais são simplesmente anexadas, em vez de mostradas em uma nova "página". Consulte a ajuda incorporada do parâmetro para obter informações sobre a sintaxe específica.

  • Recomendamos que a zona seja configurada com contagem de registro e informações de página, configurando adequadamente o parâmetro Exibição de Contagem do Registro. Consulte a ajuda incorporada do parâmetro para obter informações sobre a sintaxe específica.

  • Configure o parâmetro Número de Linhas para Recuperar do SQL para definir o número de registros exibidos por página. Se este parâmetro não for especificado, será usado o parâmetro Número de Linhas para Exibição.

  • Configure a chave que será usada para paginação, de modo que o sistema possa controlar a 'quebra de página'. Os dados devem ser classificados pela chave de paginação; como resultado, a decisão para identificação da chave de paginação deve considerar o design da zona e os dados que estão sendo exibidos. Além disso, a chave de paginação deve ser exclusiva para garantir que as quebras de página ocorram corretamente. Consulte abaixo os exemplos de configuração.

    • A Instrução SQL deve incluir as cláusulas adicionais PAGENEXT e PAGEPREV com base na chave de paginação. Além disso, conforme mencionado acima, a chave de paginação deve ser usada na cláusula ORDER BY.

    • Os parâmetros da Coluna SQL devem definir o mnemônico da chave de paginação a ser usado junto com as cláusulas de paginação da instrução SQL.

    • É recomendado configurar o parâmetro Coluna de Exibição de SQL para exibir os dados na mesma ordem que a cláusula ORDER BY.

Os tipos de zona a seguir suportam esta capacidade:

  • Explorador de Dados de Informações - SQL Único (F1–DE-SINGLE).

  • Explorador de Dados de Informações - Vários SQLs (F1–DE). Observe que as zonas deste tipo suportam a união dos resultados de todas as instruções de SQL. Como resultado, a paginação só poderá ser ativada para zonas deste tipo se for utilizado um SQL único. O sistema não consegue controlar a paginação em instruções SQL diferentes.

  • Explorador de Dados de Consulta - Vários SQLs (F1–DE-QUERY).

  • Explorador de Dados de Várias Consultas (F1–DE-MULQRY). As zonas deste tipo não incluem configuração de instruções SQL ou exibição da coluna. Porém, elas não incluem configuração para Ativar Paginação. Este parâmetro deve ser configurado na ordem de paginação nas zonas individuais para trabalho.

Observação:

Zonas usadas para Serviço de Negócios. Observe que a paginação é ignorada ao chamar uma zona do explorador de dados por meio de um serviço de negócios. Neste cenário, a zona retornará a primeira "parte" de linhas, conforme definido pelos parâmetros Número de Linhas.

Zonas com opções de visualização de dados. A paginação não é compatível com zonas que definem opções de visualização para mostrar dados em um formulário gráfico.

Exemplos

Chave de Paginação Simples

Neste exemplo, o Valor de Busca Extensível é definido como Coluna 1 (C1) e é marcado como a chave de paginação. Este campo é exclusivo para a tabela e funciona bem como uma chave de paginação simples.

SELECT A.F1_EXT_LOOKUP_VALUE,A.BUS_OBJ_CD
FROM 
  F1_EXT_LOOKUP_VAL A, 
  F1_EXT_LOOKUP_VAL_L B
WHERE 
A.BUS_OBJ_CD = :H1
AND A.BUS_OBJ_CD = B.BUS_OBJ_CD
AND A.F1_EXT_LOOKUP_VALUE = B.F1_EXT_LOOKUP_VALUE
AND B.LANGUAGE_CD = :LANGUAGE
[(F1) AND UPPER(A.F1_EXT_LOOKUP_VALUE) like UPPER(:F1)]
[(F2) AND ((UPPER(B.DESCR_OVRD) like UPPER(:F2))
OR (B.DESCR_OVRD = ' ' AND UPPER(B.DESCR) like UPPER(:F2)))]
[(PAGENEXT) AND A.F1_EXT_LOOKUP_VALUE > :C1]
[(PAGEPREV) AND A.F1_EXT_LOOKUP_VALUE < :C1]
ORDER BY A.F1_EXT_LOOKUP_VALUE

Chave de Paginação Complexa

Porém, a maioria das consultas não são classificadas por um valor exclusivo. Neste caso, a chave de paginação precisa ser definida com base na classificação da consulta e deve incluir um campo exclusivo, tal como a chave primária, como a última chave de paginação. Neste exemplo, a consulta está mostrando resultados classificados por Tipo de Atividade, Função e Usuário. Todos os campos, incluindo o ID de Entrada de Atividade (a chave primária) são marcados como chaves de paginação.

SELECT TD_TYPE_CD, ROLE_ID, ASSIGNED_TO, ASSIGNED_DTTM, TD_PRIORITY_FLG, TD_ENTRY_ID
FROM  CI_TD_ENTRY
WHERE 
ENTRY_STATUS_FLG IN ('O', 'W')
[(F1) and TD_TYPE_CD = :F1]
[(F2) AND ASSIGNED_TO = :F2]
[(F3) AND ROLE_ID = :F3]
[(PAGENEXT) and ((TD_TYPE_CD>:C1) or (TD_TYPE_CD=:C1 and ROLE_ID>:C2) or (TD_TYPE_CD=:C1 and ROLE_ID=:C2 
and ASSIGNED_TO>:C3) or (TD_TYPE_CD=:C1 and ROLE_ID=:C2 and ASSIGNED_TO=:C3 AND TD_ENTRY_ID>:C4))] 
[(PAGEPREV) and ((TD_TYPE_CD<:C1) or (TD_TYPE_CD=:C1 and ROLE_ID<:C2) or (TD_TYPE_CD=:C1 and ROLE_ID=:C2 
and ASSIGNED_TO<:C3) or (TD_TYPE_CD=:C1 and ROLE_ID=:C2 and ASSIGNED_TO=:C3 AND TD_ENTRY_ID<:C4))] 
ORDER BY TD_TYPE_CD, ROLE_ID, ASSIGNED_TO, TD_ENTRY_ID