GetRecordIDsFromFoundSet

Retorna os IDs de registro do conjunto encontrado atual como uma lista ou matriz JSON.

Formato 

GetRecordIDsFromFoundSet ( tipo )

Parâmetros 

tipo - uma expressão numérica que especifica o formato dos IDs de registro retornados. Veja a Descrição.

Tipo de dados retornado 

texto

Originada na versão 

22.0

Descrição 

Esta função retorna os IDs de registro de todos os registros no conjunto encontrado atual em sua ordem atual. IDs de registro são identificadores exclusivos que um cliente FileMaker atribui a cada registro em uma tabela quando o registro é criado e não podem ser alterados.

O parâmetro tipo determina o formato dos dados retornados. Use o nome da constante ou o valor numérico para especificar tipo.

Parâmetro tipo Retorna IDs de registro como Exemplos

ValueNumber (0)

Lista de valores delimitada por quebras de linha
Copiar 
1
5
21
22
23
7

JSONString (1)

Matriz JSON de valores como strings
Copiar 
["1","5","21","22","23","7"]

JSONNumber (2)

 Matriz JSON de valores como números
Copiar 
[1,5,21,22,23,7]

ValueNumberRanges (3)

Lista de valores com intervalos1
Copiar 
1
5
21-23
7

JSONStringRanges (4)

Matriz JSON como strings com intervalos1
Copiar 
["1","5","21-23","7"]

  1. Para ValueNumberRanges e JSONStringRanges, os IDs de registro consecutivos são compactados em intervalos para ajudar a reduzir o tamanho dos dados retornados.

Notas 

  • Os IDs de registro retornados podem ser usados com a etapa de script Etapa de script Ir para Lista de registros para recriar o mesmo conjunto encontrado ao especificar um layout baseado na mesma tabela.

  • Se nenhum registro for encontrado, esta função retorna um resultado vazio no formato especificado. Para uma lista vazia de valores, retorna uma string vazia (""). Para uma matriz JSON vazia, retorna "[]".

Exemplo 1 - Obter IDs de registro como uma lista de valores

Retorna IDs de registro como uma lista delimitada por quebras de linha.

Copiar 
GetRecordIDsFromFoundSet ( ValueNumber )

Se o conjunto encontrado atual contiver registros com IDs 101, 102 e 105, este exemplo retornará:

Copiar 
101
102
105

Exemplo 2 - Salvar conjunto encontrado para recriar mais tarde

Salva em um campo global um objeto JSON contendo os IDs de registro do conjunto encontrado atual e o nome do layout atual.

Copiar 
Definir variável [ $recordIDs ; Valor: GetRecordIDsFromFoundSet ( JSONStringRanges ) ]
Definir variável [ $currentLayout ; Valor: Get( LayoutName ) ]

Definir variável [ $foundSetInfo ; Valor:  
  JSONSetElement ( "{}" ; 
    [ "recordIDs" ; $recordIDs ; JSONArray ] ; 
    [ "layout" ; $currentLayout ; JSONString ] 
  )
]

Definir campo [ Global::LastFind ; $foundSetInfo ]

Para um conjunto encontrado no layout Contatos, o objeto JSON salvo em Global::LastFind pode ser assim:

Copiar 
{
  "recordIDs": ["1-3", "5", "7-9"],
  "layout": "Contatos"
}

Mais tarde, outro script pode ir para o mesmo layout e conjunto encontrado usando a etapa de script Etapa de script Ir para Lista de registros.

Copiar 
Definir variável [ $foundSetInfo ; Valor: Global::LastFind ]
Definir variável [ $recordIDs ; Valor: JSONGetElement ( $foundSetInfo ; "recordIDs" ) ]
Definir variável [ $layoutName ; Valor: JSONGetElement ( $foundSetInfo ; "layout" ) ]

Ir para Lista de registros [ Lista de IDs de registro: $recordIDs ; Usando o layout: $layoutName ; Animação: Nenhuma ]

Tópicos relacionados