Ir a lista de registros

Va a una presentación y devuelve el conjunto encontrado que especifica una lista de ID de registros.

Opciones 

• Lista de ID de registro es la lista de identificadores de los registros a los que se va a acceder. El orden de los ID de registro especifica el tipo de clasificación que se utilizará para el conjunto encontrado. Los ID de registro deben ser identificadores de registro válidos en la tabla asociada a la presentación especificada. Para conocer los formatos de lista admitidos, consulte Descripción.

• Mostrar registro utilizando presentación especifica la presentación del archivo actual que se utilizará para mostrar los registros de la lista. Si no se especifica ninguna presentación, se utilizará la presentación actual.

• Mostrar en ventana nueva permite especificar los registros relacionados en una ventana nueva y la configuración de la nueva ventana. Consulte paso de guión Nueva ventana.

  Consejo  Para traer la nueva ventana al frente automáticamente, añada el paso de guión Seleccionar ventana.

• Animación especifica la animación que se utilizará al mostrar los registros (solo en FileMaker Go).

Se origina en 

22.0

Descripción 

Este paso de guión accede a la presentación especificada en la ventana actual (o en una ventana nueva). A continuación, cambia el conjunto de registros encontrado y su orden de clasificación a aquellos especificados por Lista de ID de registro y pasa al primer registro de ese conjunto.

Puede especificar la opción Lista de ID de registro en cualquiera de estos formatos:

1
5
21
22
23
7

1
5
21-23
7

[1,5,21,22,23,7]

["1","5","21","22","23","7"]

["1","5","21-23","7"]

[
  {
    "recordId" : "1"
  },
  {
    "recordId" : "5"
  },
  {
    "recordId" : "21"
  },
  {
    "recordId" : "22"
  },
  {
    "recordId" : "23"
  },
  {
    "recordId" : "7"
  }
]

Los ID de registro consecutivos pueden indicarse como un rango (dos números separados por un guión) en una lista de valores (por ejemplo, 21-23) o en una matriz JSON de cadenas (por ejemplo, ["21-23"]). Un rango en una matriz JSON de números se considera contenido JSON no válido, lo que provoca que este paso de guión devuelva un error.

Si no se puede encontrar alguno de los ID de registro especificados (por ejemplo, si se han eliminado registros), estos se omitirán y el conjunto encontrado contendrá solo los registros que se hayan encontrado correctamente. Los registros del conjunto encontrado resultante se muestran en un orden de clasificación que coincide con la secuencia de los ID de registro proporcionados. En el cuadro de diálogo Ordenar registros, este estado de clasificación se indica con <Orden predefinido>.

Notas 

• Los ID de registro deben ser identificadores de registro válidos asignados por el cliente de FileMaker cuando se creó el registro. Se trata de los mismos ID de registro utilizados en otras ubicaciones, como aquellos que devuelven las funciones Get ( RecordID ) y GetRecordIDsFromFoundSet y las llamadas a FileMaker Data API y a la API de OData. No se admiten valores de campo de clave principal u otros identificadores personalizados.

• Si no se puede encontrar alguno de los registros especificados, este paso de guión devuelve el código de error 101 ("Falta un registro") o 401 ("Ningún registro coincide con la petición"), que se puede capturar con la función función Get ( LastError ).

• Cuando este paso de guión abre una nueva ventana, esta no activa elactivador de guión OnFirstWindowOpen o el activador de guión OnWindowOpen porque es posible que el guión activado no vaya a la presentación o la vista deseadas. Si desea que se ejecute un guión después de que este paso de guión abra una nueva ventana, añada Ejecutar guión como siguiente paso de guión.

• La opción Animación solo es compatible con FileMaker Go:

  • Solo puede utilizar animaciones para la ventana seleccionada.

  • No puede utilizar animaciones para desplazarse por los registros mediante el cursor deslizante o los botones de la barra de herramientas de estado.

Ejemplo 1 - Ir a los registros de una lista de valores

Accede a la presentación Contactos y muestra los registros especificados por una lista de ID de registro delimitada por retorno de carro.

Establecer variable [ $recordList ; Valor: "15¶8¶23¶4¶12" ]
Ir a la lista de registros [ Lista de ID de registro: $recordList ; Usando la presentación: "Contactos" (Contactos) ]

Ejemplo 2 - Ir a los registros desde una búsqueda semántica guardada

La búsqueda semántica realizada en el Ejemplo 2 de Realizar búsqueda semántica guardó la lista de registros en $$result como una matriz JSON de objetos con pares de clave-valor de recordId. (Tenga en cuenta que el formato JSON del resultado guardado de la búsqueda es compatible con el de Ir a la lista de registros). Más tarde, en la misma sesión de cliente de FileMaker, este guión abre una nueva ventana, accede a la misma presentación (Detalles de la reunión) y muestra el mismo conjunto encontrado. Si la operación no se realiza correctamente, el guión muestra un mensaje de error.

Ir a la lista de registros [ Lista de ID de registro: $$result ; Usando la presentación: "Detalles de la reunión" (Reunión) ; Nueva ventana ]

Si [ Get ( LastError ) ≠ 0 ]
    Mostrar cuadro de diálogo personalizado [ "Error" ; "No se ha podido acceder a los registros especificados. Error: " & Get ( LastError ) ]
End If

Ejemplo 3 - Volver a crear el conjunto encontrado del cliente en el anfitrión

Realiza una búsqueda en el cliente de FileMaker de productos con un bajo nivel de inventario (< 50) y, a continuación, obtiene los ID de registro del conjunto encontrado mediante la función función GetRecordIDsFromFoundSet. A continuación, el guión del cliente llama a un guión en el anfitrión y le transfiere la lista de ID de registro.

Ir a la presentación [ "Productos (Productos) ; Animación: Ninguna ]
Modo Buscar [ Pausa: Inactivo ]
Establecer campo [ Productos::Inventario ; "<50" ]
Realizar búsqueda [ ]

Establecer variable [ $foundSetIDs ; Valor: GetRecordIDsFromFoundSet ( ValueNumberRanges ) ]

Ejecutar guión en el servidor [ "Guión del anfitrión" ; Especificado: Desde lista ; Parámetro: $foundSetIDs ; Esperar a que termine: Activo ]

Mostrar cuadro de diálogo personalizado [ "Resultado" ; Get ( ScriptResult ) ]

El guión del anfitrión accede a la lista de registros de la presentación Productos, calcula el resultado y, a continuación, lo devuelve al guión del cliente.

Establecer variable [ $recordIDs ; Get ( ScriptParameter ) ]
Ir a la lista de registros [ Lista de ID de registro: $recordIDs ; Usando la presentación: "Productos" (Productos) ; Animación: Ninguna ]

# Procesar registros del conjunto encontrado y devolver $result
Salir del guión [ Resultado de texto: $result ]

Temas relacionados 

• Función GetRecordIDsFromFoundSet

• Paso de guión Realizar búsqueda semántica

• Paso de guión Ejecutar FileMaker Data API

• Referencia de pasos de guión