Função de ER SPLITLISTBYLIMIT

A função SPLITLISTBYLIMIT divide a lista especificada em uma nova lista de sublistas (lotes). O número de registros em cada lote é calculado dinamicamente. Em seguida, a função retorna o resultado como um novo valor de Lista de registros que consiste nos lotes.

Sintaxe

SPLITLISTBYLIMIT (list, limit value, limit source)

Argumentos

list: Lista de registros

O caminho válido de uma fonte de dados do tipo Lista de registros.

limit value: Inteiro ou Real

O valor máximo do limite usado para dividir a lista original em lotes.

limit source: Campo

O caminho válido de um campo do tipo Inteiro ou Real na lista especificada. O valor desse campo define a etapa em que a soma total é aumentada.

Valores de retorno

Lista de registros

A lista de registros resultante.

Notas de uso

A lista de lotes retornada contém os seguintes elementos:

• Valor: Lista

  A lista de registros que pertencem ao lote atual.

• BatchNumber: Inteiro

  O número do lote atual na lista retornada.

O limite não é aplicado a um único item da lista original, se a fonte do limite exceder o limite definido.

Exemplo

A ilustração a seguir mostra um formato de relatório eletrônico (ER).

A ilustração a seguir mostra as fontes de dados que são usadas para o formato.

A ilustração a seguir mostra o resultado quando o formato é executado. Nesse caso, a saída é uma lista simples de itens de mercadoria.

Nas ilustrações a seguir, o mesmo formato foi ajustado, de forma que apresente a lista de itens de mercadoria em lotes caso um lote único precise incluir mercadorias e o peso total não exceda um limite de 9.

A ilustração a seguir mostra o resultado quando o formato ajustado é executado.

Observação

O limite não será aplicado ao último item da lista original porque o valor (11) da fonte de limite (peso) excede o limite definido (9). Para ignorar as sublistas durante a geração de relatórios, use a função WHERE ou a expressão Habilitada do elemento de formato correspondente, conforme necessário.

Recursos adicionais

Funções de listagem