Sobre o armazenamento de dados persistente
O armazenamento de dados persistente é um conjunto de valores nomeados salvos como parte do esquema em um arquivo FileMaker Pro, não como dados de registro. Ao contrário das variáveis, que são armazenadas temporariamente na memória e são específicas do usuário, as entradas no armazenamento de dados persistente permanecem disponíveis nas sessões do FileMaker até serem explicitamente excluídas e estão acessíveis a todos os usuários do arquivo.
Cada entrada no armazenamento de dados persistente consiste no seguinte:
-
Nome: texto para o nome da entrada.
-
ID de instância: um identificador de texto adicional que você pode usar como um namespace ou identificador de proprietário para agrupar entradas que têm um propósito comum. Por exemplo, você pode usar o mesmo ID de instância para identificar todas as entradas nomeadas usadas por uma instância específica de um complemento.
A combinação de nome e ID de instância identifica exclusivamente uma entrada no armazenamento de dados persistente do arquivo.
-
Dados: um valor em qualquer tipo de dados FileMaker — texto, número, data, hora, data/hora ou container.
Quando usar o armazenamento de dados persistente
Use o armazenamento de dados persistente quando precisar armazenar:
-
Um número de versão ou outros metadados sobre o seu arquivo
-
Definições de configuração de complemento que persistem entre as sessões
-
Bibliotecas JavaScript ou outros recursos para uso em visualizadores da Web
-
Prompts de modelo de IA que são compartilhados entre vários scripts
-
Dados de script compartilhados entre scripts para uso por todos os usuários sem usar campos globais
Como acessar o armazenamento de dados persistente
Para trabalhar com o armazenamento de dados persistente, use:
-
Etapa de script Configurar dados persistentes: Define ou exclui uma entrada no armazenamento de dados persistente.
-
Função GetPersistentData: Retorna o valor de dados persistentes especificado por nome e ID de instância.
-
Função ListPersistentDataIDs: Retorna uma lista de IDs de instância para as entradas com o nome especificado no armazenamento de dados persistente. use quando precisar verificar quais instâncias existem antes de recuperar seus dados.
Notas
-
O armazenamento de dados persistente é acessível apenas dentro do contexto do arquivo atual.
-
Todos os usuários conectados ao arquivo compartilham o mesmo armazenamento de dados persistente. As alterações feitas por um usuário ficam imediatamente disponíveis para todos os outros usuários.
-
Quando você clona um arquivo, as entradas do armazenamento de dados persistente são incluídas no clone. Consulte Gravação e cópia de arquivos.
-
O armazenamento de dados persistente não é copiado para o arquivo de destino ao usar a FileMaker Data Migration Tool, porque não se trata de dados de registro. Consulte Guia da FileMaker Data Migration Tool.
-
Ao trabalhar com entradas existentes, nomes e IDs de instância não diferenciam maiúsculas de minúsculas.