Configurar dados persistentes

Define ou exclui uma entrada no armazenamento de dados persistente.

Consulte também

Opções

  • Nome é um texto que especifica o nome da entrada de dados persistentes. O nome não pode estar vazio.

  • ID de instância é uma expressão de texto opcional que você pode usar para identificar a instância específica da entrada. Várias entradas podem ter o mesmo nome com IDs de instância diferentes.

  • Valor é uma expressão para os dados a serem armazenados. O tipo de dados é preservado quando o valor é armazenado.

  • Excluir entrada exclui a entrada especificada.

Compatibilidade

Produto Compatível
FileMaker Pro Sim
FileMaker Go Sim
FileMaker WebDirect Sim
FileMaker Server Sim
FileMaker Cloud Sim
FileMaker Data API Sim
Publicação na Web personalizada Sim

Originada na versão

26.0

Descrição

Se uma entrada com o nome especificado e o ID de instância já existir, esta etapa de script atualizará seu valor ou excluirá a entrada, dependendo se Valor ou Excluir entrada está selecionado. Se a entrada não existir, especificar Valor criará a entrada. Consulte Sobre o armazenamento de dados persistente.

Notas

  • Para recuperar o valor de uma entrada, use a função Função GetPersistentData.

  • Como o tamanho de uma fórmula de cálculo é limitado (consulte Limites técnicos do FileMaker Pro), você não pode inserir um valor de texto que exceda esse limite na opção Valor. Para especificar valores de texto maiores que esse limite, faça referência a um campo ou variável que contenha os dados para a opção Valor. Para primeiro colocar texto em um campo ou variável, você pode usar etapas de script como Inserir texto (para texto armazenado na própria etapa de script), Inserir do URL (para texto disponível por meio de um URL) ou Ler a partir do arquivo de dados (para texto em um arquivo local).

  • ID de instância pode ser não especificado (em branco) ou ser especificado uma string vazia ("").

  • Um ID de instância não especificado (em branco) é tratado da mesma forma que uma string vazia ("").

  • Excluir uma entrada que não existe retorna o código de erro 10 ("Os dados solicitados estão faltando").

Exemplo 1

Armazena um número de versão simples em uma entrada chamada AppVersion (sem ID de instância) no armazenamento de dados persistente do arquivo atual.

Copiar 
Configurar dados persistentes [ AppVersion ; Valor: "2.1.0" ]

Para ler esta entrada, consulte o Exemplo 1 para a função Função GetPersistentData.

Exemplo 2

Armazena vários valores de configuração para um complemento usando o ID de instância do complemento.

Copiar 
Definir Variável [ $instanceID ; Valor: "38EA3124-9CFD-4490-A634-A0A72A613145" ]
Configurar dados persistentes [ com.claris.myaddon.theme ; ID de instância: $instanceID ; Valor: "Escuro" ]
Configurar dados persistentes [ com.claris.myaddon.language ; ID de instância: $instanceID ; Valor: "en" ]
Configurar dados persistentes [ com.claris.myaddon.modificationdate ; ID de instância: $instanceID ; Valor: Get ( CurrentTimestamp ) ]

Exemplo 3

Exclui uma entrada de dados persistentes específica por nome e ID de instância.

Copiar 
Definir variável [ $instanceID ; Valore: "38EA3124-9CFD-4490-A634-A0A72A613145" ]
Configurar dados persistentes [ com.claris.myaddon.theme ; ID de instância: $instanceID ; Excluir ]

Tópicos relacionados