A função getPage da extensão OutZoho permite controlar a paginação de funções que processam grandes volumes de dados ou fazem requisições para APIs externas.
Sintaxe da função
int ozh.getPage(string name);
Esta função é utilizada quando é necessário paginar a execução de uma função para processar uma grande quantidade de dados ou fazer seguidas requisições para APIs externas.
Parâmetros
- name - String com o nome da paginação.
Observação: Se esta paginação não existir, será criada uma nova e a página retornada será a 1.
Retorno
Inteiro com o valor da página atual.
Quando usar esta função
Toda vez que for necessário obter a página atual de uma paginação para processar dados em lotes.
Exemplo prático
Ao higienizar todo o cadastro de contatos para corrigir números de telefone, pode-se fazer uma função que obtém 100 registros por vez e os higieniza. A cada página higienizada, usa-se getPage no início da função e nextPage ao final para avançar para a próxima página.
Exemplo de uso
