GetRecordIDsFromFoundSet

Devuelve los ID de registro del conjunto encontrado actual como una lista o una matriz de JSON. Para obtener los ID de los registros relacionados, especifique el nombre de una ocurrencia de tabla o portal.

Formato 

GetRecordIDsFromFoundSet ( tipo { ; ocurrenciaTablaOPortal } )

Parámetros 

tipo: una expresión numérica que especifica el formato de los ID de registro devueltos. Ver descripción.

ocurrenciaTablaOPortal: una expresión de texto que especifica el nombre de una ocurrencia de tabla relacionada o el nombre del objeto de un portal en la presentación actual.

Los parámetros entre llaves { } son opcionales.

Tipo de datos devuelto 

texto

Se origina en 

22.0

Descripción 

Esta función devuelve los ID de registro de todos los registros en el conjunto encontrado actual en su orden actual, o los ID de registro de todos los registros relacionados con el registro actual según la ocurrencia de tabla especificada o el portal. Los ID de registro son identificadores exclusivos que un cliente de FileMaker asigna a cada registro de una tabla cuando se crea el registro y no se pueden cambiar.

El parámetro tipo determina el formato de los datos devueltos. Utilice el nombre de la constante o el valor numérico para especificar el valor de tipo.

parámetro tipo Devuelve los ID de registro como Ejemplos

ValueNumber (0)

Lista de valores separados por retornos de carro
Copiar 
1
5
21
22
23
7

JSONString (1)

Matriz JSON de valores como cadenas
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 con rangos1
Copiar 
1
5
21-23
7

JSONStringRanges (4)

Matriz JSON como cadenas con rangos1
Copiar 
["1","5","21-23","7"]

  1. Para ValueNumberRanges y JSONStringRanges, los ID de registro consecutivos se comprimen en rangos a fin de ayudar a reducir el tamaño de los datos devueltos.

Para obtener los ID de los registros relacionados en una ocurrencia de tabla, use el parámetro tableOccurrenceOrPortal para especificar el nombre de una ocurrencia de tabla relacionada. Los ID de registro relacionados se devuelven en el orden de clasificación especificado por la relación. Consulte Crear y modificar relaciones.

Para obtener los ID de registros relacionados en un portal en la presentación actual, use el parámetro tableOccurrenceOrPortal para especificar el nombre del objeto del portal (consulte Asignar nombres a objetos). Los ID de registro devueltos se filtran y ordenan de acuerdo con la configuración del portal en el cuadro de diálogo Configuración del portal. Consulte Crear portales para mostrar registros relacionados.

Notas 

  • Los ID de registro devueltos pueden utilizarse con el paso de guión Ir a lista de registros para volver a crear el mismo conjunto encontrado al especificar una presentación basada en la misma tabla.

  • Si no se encuentra ningún registro, esta función devuelve un resultado vacío en el formato especificado. Para una lista vacía de valores, devuelve una cadena vacía (""). Para una matriz JSON vacía, devuelve "[]".

  • Si se especifica el parámetro tableOccurrenceOrPortal, esta función primero intenta hacer coincidir su valor con un nombre de ocurrencia de tabla. Si no lo consigue, intenta hacer coincidir el valor con el nombre del objeto de un portal. Si no se encuentra ninguna coincidencia, esta función devuelve "?".

Ejemplo 1 - Obtener ID de registro como una lista de valores

Devuelve los ID de registro como una lista separada por retorno de carro.

Copiar 
GetRecordIDsFromFoundSet ( ValueNumber )

Si el conjunto encontrado actual contiene registros con los ID 101, 102 y 105, este ejemplo devuelve:

Copiar 
101
102
105

Ejemplo 2 - Obtenga los ID de registros relacionados de un portal como una matriz JSON de números

Devuelve los ID de registros relacionados como una matriz JSON de números desde el objeto del portal llamado ContactsPortal.

Copiar 
GetRecordIDsFromFoundSet ( JSONNumber ; "ContactsPortal" )

Si el portal en el registro actual tiene tres registros relacionados que el portal ordena y filtra para tener los ID 1101, 702 y 1015, este ejemplo devuelve:

Copiar 
[1101,702,1015]

Ejemplo 3 - Guardar el conjunto encontrado para volver a crearlo más tarde

Guarda en un campo global un objeto JSON que contiene los ID de registro del conjunto encontrado y el nombre de la presentación actual.

Copiar 
Establecer variable [ $recordIDs ; Valor: GetRecordIDsFromFoundSet ( JSONStringRanges ) ]
Establecer variable [ $currentLayout ; Valor: Get ( LayoutName ) ]

Establecer variable [ $foundSetInfo ; Valor: 
  JSONSetElement ( "{}" ; 
    [ "recordIDs" ; $recordIDs ; JSONArray ] ; 
    [ "layout" ; $currentLayout ; JSONString ] 
  )
]

Establecer campo [ Global::LastFind ; $foundSetInfo ]

Para un conjunto encontrado en la presentación Contactos, el objeto JSON guardado en Global::LastFind podría presentar el siguiente aspecto:

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

Más adelante, otro guión puede ir a la misma presentación y conjunto encontrado mediante el paso de guión Ir a lista de registros.

Copiar 
Establecer variable [ $foundSetInfo ; Valor: Global::LastFind ]
Establecer variable [ $recordIDs ; Valor: JSONGetElement ( $foundSetInfo ; "recordIDs" ) ]
Establecer variable [ $layoutName ; Valor: JSONGetElement ( $foundSetInfo ; "layout" ) ]

Ir a la lista de registros [ Lista de ID de registro $recordIDs ; Usando la presentación: $layoutName ; Animación: Ninguna ]

Temas relacionados