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.