4D Doc Center : Sequence number

4D v14.3

Sequence number


Sequence number {( tabela )} -> Resultado

Parâmetro	Tipo	Descrição
tabela	Tabela	Tabela para a qual devolver o número de sequência, ou tabela padrão, se omitido
Resultado	Inteiro longo	Número de sequência

Descrição

Sequence Number devolve o próximo número automático de tabela. O número de sequência é único para cada tabela. É um valor que não se repete e é incrementado para cada novo registro criado pela tabela. Normalmente, a numeração começa em 1. Pode mudar a numeração para uma tabela utilizando o comando SET DATABASE PARAMETER.

Deve utilizar a função Sequence Number em lugar do símbolo #N se for útil nos seguintes casos:

Se cria registros por meio de um método
Se a numeração deve começar em um número diferente de 1
Se a numeração deve ser incrementada em um número maior de 1
Se o número de sequência for parte de um código

Para armazenar o número de sequência com a ajuda de um método, crie um campo de tipo Inteiro longo na tabela e atribua o número de sequência ao campo.

O número de sequência devolvido por essa função para a tabela é o mesmo número que o gerado ao selecionar a opção Autoincrementar para um campo da tabela utilizando o inspetor de estrutura ou ao atribuído utilizando o símbolo #N como valor automático para um campo da tabela em um formulário. Para maior informação sobre a atribuição de valores, consulte o Manual de Desenho de 4D.

Nota: a numeração automática também pode ser atribuída através do atributo SQL AUTO_INCREMENT.

Se a numeração deve começar em um valor diferente de 1, simplesmente adiciona a diferença a Sequence Number. Por exemplo, se o número de sequência deve começar em 1.000, pode utilizar a seguinte linha de código para atribuir o número:

[Tabela1]NumAuto:=Sequence number([Tabela1])+999

Exemplo

O exemplo a seguir é parte de um método de formulário. Estas linhas de código testam se é um novo registro (se o número de fatura for igual a uma cadeia vazia). Se for um novo registro, o método atribui um número de fatura. O número de fatura está formado por duas partes: o número de sequência, e o identificador do operador, o qual foi introduzido ao abrir o banco. O número de sequência é formatado como uma cadeia de cinco caracteres:

  ` Se for uma nova fatura, criar um número de fatura

 If([Faturas]NumFatura="")

  ` O número de fatura é uma cadeia que termina pelo número de referência do usuário.

    [Faturas]NumFatura:=String(Sequence number;"00000")+[Faturas]Usuário

 End if