Ir para Lista de registros

Vai para um layout e retorna o conjunto encontrado especificado por uma lista de IDs de registro.

Opções 

• A Lista de IDs de registro é a lista de identificadores para atribuir aos registros. A ordem dos IDs de registro especifica a ordem de classificação a ser usada para o conjunto encontrado. Os IDs de registro devem ser identificadores válidos na tabela associada ao layout especificado. Para ver os formatos de lista suportados, consulte Descrição.

• Mostrar registro usando layout especifica o layout no arquivo atual que será usado para exibir os registros da lista. Se nenhum layout for especificado, o layout atual será usado.

• Mostrar em nova janela mostra os registros relacionados em uma nova janela e permite especificar as configurações da nova janela. Consulte a Etapa de script Nova janela.

  Dica  Para trazer a nova janela para a frente automaticamente, adicione a etapa de script Etapa de script Selecionar janela.

• Animação especifica a animação a ser usada ao exibir os registros (somente FileMaker Go).

Originada na versão 

22.0

Descrição 

Esta etapa de script vai para o layout especificado na janela atual (ou em uma nova janela). Em seguida, altera o conjunto encontrado de registros e sua ordem de classificação para aqueles especificados pela Lista de IDs de registro e vai para o primeiro registro desse conjunto.

Você pode especificar a opção Lista de IDs de registro em qualquer um destes 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"
  }
]

IDs de registro consecutivos podem ser fornecidos como um intervalo (dois números separados por um hífen) em uma lista de valores (por exemplo, 21-23) ou em uma matriz JSON de strings (por exemplo, ["21-23"]). Um intervalo em uma matriz de números JSON é JSON inválido, o que faz com que esta etapa de script retorne um erro.

Se algum dos IDs de registro especificados não puder ser encontrado (por exemplo, se o registro tiver sido excluído), esse ID será ignorado e o conjunto encontrado conterá apenas os registros que foram localizados com sucesso. Os registros no conjunto encontrado resultante são exibidos em uma ordem de classificação que corresponde à sequência dos IDs de registro fornecidos. Na caixa de diálogo Classificar registros, esse status de classificação é indicado por <Ordem predefinida>.

Notas 

• Os IDs de registro devem ser identificadores válidos atribuídos pelo cliente FileMaker quando o registro foi criado. Esses são os mesmos IDs de registro usados em outros lugares, como os retornados pelas funções Get(RecordID) e GetRecordIDsFromFoundSet e pelas chamadas do FileMaker Data API e OData API. Valores de campo de chave primária ou outros identificadores personalizados não são suportados.

• Se algum dos registros especificados não puder ser encontrado, esta etapa de script retornará o código de erro 101 ("O registro está faltando") ou 401 ("Nenhum registro correspondeu com a solicitação"), que pode ser capturado com a função Função Get(LastError).

• Quando a etapa de script abrir uma nova janela, a nova janela não ativará o Gatilho de script AoAbrirPrimeiraJanela ou o Gatilho de script AoAbrirJanela, pois o script acionado pode não ir para o layout ou a exibição desejada. Se quiser que um script seja executado depois que esta etapa de script abrir uma nova janela, adicione Realizar script como a próxima etapa de script.

• A opção Animação é suportada apenas no FileMaker Go:

  • Você pode usar animações somente para a janela selecionada.

  • Você não pode usar animações para navegar entre registros usando o controle deslizante ou os botões da barra de ferramentas de status.

Exemplo 1 - Ir para registros em uma lista de valores

Vai para o layout Contatos e exibe registros especificados por uma lista de IDs de registro delimitada por quebras de linha.

Definir variável [ $recordList ; Valor: "15¶8¶23¶4¶12" ]
Ir para Lista de registros [IDs de Lista de registros: $recordList ; Usando o layout: "Contatos" (Contatos) ]

Exemplo 2 - Ir para registros a partir de uma busca semântica salva

A Pesquisa semântica realizada no Exemplo 2 em Realizar pesquisa semântica salvou a lista de registros em $$result como uma matriz JSON de objetos com pares chave-valor recordId. (Observe que o formato JSON do resultado salvo da pesquisa é compatível com o de Ir para Lista de registros.) Posteriormente, na mesma sessão do cliente FileMaker, este script abre uma nova janela, vai para o mesmo layout (Detalhes da reunião) e exibe o mesmo conjunto encontrado. Se não for bem-sucedido, o script exibe uma mensagem de erro.

Ir para Lista de registros [ IDs de Lista de registros: $$result ; Usando o layout: "Detalhes da reunião" (Reuniões) ; Nova janela ]

If [ Get ( LastError ) ≠ 0 ]
    Mostrar caixa de diálogo personalizada [ "Erro" ; "Não foi possível acessar os registros especificados. Erro: " & Get ( LastError ) ]
End If

Exemplo 3 - Recriar o conjunto encontrado do cliente no host

Executa uma pesquisa no cliente FileMaker para produtos com baixo estoque (< 50) e obtém os IDs de registro do conjunto encontrado usando a função Função GetRecordIDsFromFoundSet. O script do cliente então chama um script no host e passa a lista de IDs de registro.

Ir para layout [ "Produtos (Produtos) ; Animação: Nenhum ] Entrar no Modo de Encontrar [Pausa: Desligado]
Definir Campo [ Produtos::Inventário ; "<50" ]]
Realizar busca [ ]

Definir Variável [ $foundSetIDs ; Valor: GetRecordIDsFromFoundSet ( ValueNumberRanges ) ]

Realizar script em servidor [ "Script do host" ; Especificado: Da lista ; Parâmetro: $foundSetIDs ; Aguarde a conclusão: Ativo]

Mostrar caixa de diálogo personalizada [ "Resultado" ; Get ( ScriptResult ) ]

O script do host vai para a lista de registros no layout Produtos, calcula o resultado e passa o resultado de volta para o script do cliente.

Definir variável [ $recordIDs ; Get ( ScriptParameter ) ]
Ir para Lista de registros [ Lista de IDs de registro: $recordIDs ; Usando o layout: "Produtos" (Produtos) ; Animação: Nenhuma ]

# Processar registros no conjunto encontrado e retornar $result
Sair do Script [ Resultado do texto: $result ]

Tópicos relacionados 

• Função GetRecordIDsFromFoundSet

• Etapa de script Realizar pesquisa semântica

• Etapa de script Executar FileMaker Data API

• Referência de etapas de script