Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
A função SPLITLISTBYLIMIT divide a lista especificada numa nova lista de sublistas (lotes). O número de registos em cada lote é calculado dinamicamente. Em seguida, a função devolve o resultado como um novo valor Lista de registos que consiste nos lotes.
Sintaxe
SPLITLISTBYLIMIT (list, limit value, limit source)
Argumentos
list: Lista de registos
O caminho válido de uma origem de dados do tipo de dados Lista de registos.
limit value: Número inteiro ou Real
O valor máximo do limite utilizado para dividir a lista original em lotes.
limit source: Campo
O caminho válido de um campo do tipo Número inteiro ou Real na lista especificada. O valor deste campo define o passo em que a soma total é aumentada.
Valores de retorno
Lista de registos
A lista de registos resultante.
Notas de utilização
A lista de lotes devolvidos contém os seguintes elementos:
Valor: Lista
A lista de registos que pertencem ao lote atual.
BatchNumber: Número inteiro
O número do lote atual na lista devolvida.
O limite não é aplicado a um único item da lista original se a origem do limite exceder o limite definido.
Exemplo
A ilustração seguinte mostra um formato de Relatórios eletrónicos (ER).
A ilustração seguinte mostra as origens de dados utilizadas para o formato.
A ilustração seguinte mostra o resultado quando o formato é executado. Neste caso, o resultado é uma lista não hierárquica de itens de mercadorias.
Nas ilustrações seguintes, o mesmo formato foi ajustado para apresentar a lista de itens de mercadorias em lotes se um único lote tiver de incluir mercadorias e o peso total não exceder um limite de 9.
A ilustração seguinte mostra o resultado quando o formato ajustado é executado.
Nota
O limite não é aplicado ao último item da lista original, porque o valor (11) da origem de limite (peso) excede o limite definido (9). Para ignorar as sublistas durante a geração de relatórios, utilize a função WHERE ou a expressão Ativado do elemento de formato correspondente, conforme necessário.