Funções Get
As funções Get monitoram erros em scripts ou coletam informações sobre o status do arquivo ou as ações que estão sendo executadas.
Muitas funções Get retornam informações que são alteradas regularmente. Por exemplo, quando a função Get(CurrentTime) é colocada em um campo de cálculo armazenado, a hora será atualizada apenas quando um novo registro for criado. Se o cálculo tiver outros campos nele, mas o resultado do cálculo ainda retornar a hora atual, o resultado do cálculo armazenado será atualizado apenas quando esses outros campos tiverem sido modificados no registro atual. Se algum desses cálculos for não armazenado, a hora será atualizada conforme necessário. Para fins de desempenho, tornar um campo de cálculo não armazenado não é sempre a melhor ideia. As funções Get são mais bem usadas em um script, em que as informações de status de uma função Get estão atualizadas no momento em que o cálculo é executado.
|
Essa função |
Retorna |
|
Retorna uma lista de palavras-chave, com base na conta usada para abrir o arquivo, para os privilégios estendidos ativados. |
|
|
Retorna o nome do grupo da conta atual. |
|
|
Retorna o nome da conta autenticada que está sendo usada pelo usuário atual do arquivo. |
|
|
Retorna o nome do conjunto de privilégios que está sendo usado pela conta usada para abrir o arquivo. |
|
|
Retorna o tipo de autenticação da conta atual. |
|
|
Retorna o conteúdo do campo ativo. |
|
|
Retorna o nome do campo ativo. |
|
|
Retorna o nome da ocorrência da tabela que contém o campo ativo. |
|
|
Retorna o nome do objeto de layout ativo na janela atual do cálculo. |
|
|
Retorna o número das teclas modificadoras de teclado que estão sendo pressionadas. |
|
|
Retorna um número que representa a linha de portal ativa. |
|
|
Retorna um número que representa o registro no conjunto encontrado atual. |
|
|
Retorna um número que representa a repetição ativa em um campo de repetição. |
|
|
Retorna um número que representa quantos caracteres estão selecionados. |
|
|
Retorna um número que representa o caractere inicial do texto selecionado. |
|
|
Retornará 1 (true) se a etapa de script Permitir anulação pelo usuário estiver ativa; caso contrário, retornará 0 (false). |
|
|
Retornará 1 (true) se a barra de formatação estiver visível; caso contrário, retornará 0 (false). |
|
|
Retorna a arquitetura do aplicativo atual. |
|
|
Retorna o texto que representa o idioma atual do aplicativo. |
|
|
Retorna o nome e a versão de produto do cliente FileMaker. |
|
|
Retorna um número que representa a repetição do campo de cálculo que está sendo calculado. |
|
|
Retorna o nome do host do arquivo atual e a autoridade de certificação que emitiu o certificado SSL usado para garantir a segurança da conexão. |
|
|
Retorna um número que representa o estado da segurança da conexão de rede para o arquivo atual. |
|
|
Retorna a data atual de acordo com o calendário do sistema. |
|
|
Retorna uma lista de palavras-chave, com base na conta usada para avaliar este cálculo, para os privilégios estendidos ativados. |
|
|
Retorna a data e a hora atuais do host (até o segundo mais próximo) de acordo com o relógio do sistema. |
|
|
Retorna o nome do conjunto de privilégios que está sendo usado para avaliar este cálculo no arquivo. |
|
|
Retorna a hora atual (até o segundo mais próximo) de acordo com o relógio do sistema. |
|
|
Retorna a data e a hora atuais (até o segundo mais próximo) de acordo com o relógio do sistema. |
|
|
Retorna a hora atual com precisão de milissegundos de acordo com o Tempo Universal Coordenado (UTC). |
|
|
Retorna o nome do conjunto de menus personalizados ativo. |
|
|
Retorna o caminho para a pasta da área de trabalho do usuário atual. |
|
|
Retorna um número representando o tipo de computador ou dispositivo móvel que está executando o produto FileMaker. |
|
|
Retorna o caminho para a pasta Documentos do usuário atual. |
|
|
Retorna uma lista de todos os arquivos e pastas na pasta Documentos retornados pela função Get(DocumentsPath). |
|
|
Retorna um valor que representa o estado atual de criptografia do arquivo. |
|
|
Retornará 1 (true) se a etapa de script Definir captura de erro estiver ativa; caso contrário, retornará 0 (false). |
|
| Get(FileLocaleElements) | Retorna um objeto JSON com informações sobre o local do arquivo atual. |
|
Retorna o caminho para a pasta da cópia do produto FileMaker em execução no momento. |
|
|
Retorna o nome do arquivo ativo no momento, sem a extensão do nome de arquivo. |
|
|
Retorna o caminho completo do local do arquivo ativo no momento. |
|
|
Retorna o tamanho, em bytes, do arquivo ativo no momento. |
|
|
Retorna o número de registros no conjunto encontrado no momento. |
|
|
Retornará 1 (true) se o alto contraste estiver disponível e ativo; caso contrário, retornará 0 (false). |
|
|
Retorna o nome e a versão de host do cliente FileMaker. |
|
|
Retorna o endereço IP do computador host do arquivo atual. |
|
|
Retorna o nome do host atual. |
|
|
Retorna o nome, o número de versão e o estado de ativação dos plug-ins instalados. |
|
| Get(InstalledFMPluginsAsJSON) | Retorna um objeto JSON com os atributos dos plug-ins instalados. |
|
Retorna um número para o erro que ocorreu na execução da etapa de script executada mais recentemente. |
|
|
Retorna texto sobre erros que são retornados por Get(LastError). |
|
|
Retorna o nome do script, o nome da etapa e o número de linhas de erros que são retornados por Get(LastError). |
|
|
Retorna um número que corresponde ao botão clicado em uma mensagem de alerta exibida pela etapa de script Mostrar caixa de diálogo personalizada. |
|
|
Retorna um número com base nos privilégios de acesso ao registro disponíveis no layout atual. |
|
|
Retorna o número total de layouts no arquivo. |
|
|
Retorna o nome do layout exibido no momento. |
|
|
Retorna o número do layout (especificado na caixa de diálogo Gerenciar layouts) exibido no momento. |
|
|
Retorna o nome da ocorrência da tabela que está exibindo registros no layout atual. |
|
|
Retorna um número que representa a exibição do arquivo ativo no momento. |
|
|
|
|
|
Retorna uma lista dos campos que foram alterados no registro atual da tabela atual. |
|
|
Retorna um número que representa o nível de compartilhamento do arquivo usando a Rede FileMaker. |
|
|
Retorna o nome do protocolo de rede (TCP/IP) que um cliente FileMaker está usando nesta máquina. |
|
|
No FileMaker Go, retorna um número que representa o tipo de rede que está sendo usado para acessar o arquivo atual. |
|
|
Retorna o ID do arquivo e o caminho de cada arquivo de dados aberto. |
|
|
Retorna um número que representa a contagem total de páginas na tarefa de impressão atual durante a impressão. |
|
|
Retorna um número que representa a página atual que está sendo impressa ou visualizada. |
|
|
Retorna um texto que representa um identificador exclusivo do computador ou dispositivo que está executando um cliente FileMaker. |
|
|
Retorna o caminho para as preferências e a pasta de opções padrão do usuário atual. |
|
|
Retorna um texto que identifica o nome da impressora padrão. |
|
|
Retorna o texto que está armazenado na caixa de busca rápida. |
|
|
Retorna um número que representa os privilégios de acesso do registro atual atribuídos por meio da caixa de diálogo Privilégios do registro personalizado. |
|
|
Retorna o número da ID exclusiva do registro atual. |
|
|
Retorna o número total de vezes que as alterações no registro atual foram confirmadas. |
|
|
Retorna um número que representa a posição de um registro no conjunto encontrado atual. |
|
|
Retorna o número total de registros abertos no conjunto encontrado no momento que ainda não foram salvos. |
|
|
Retorna um número que representa o estado do registro atual. |
|
|
Retorna eventos que causaram a execução do script especificado na etapa de script Configurar monitor da região. |
|
|
Retorna o número total de solicitações de busca definidas para a tabela atual. |
|
|
Retornará 1 (true) se a opção Omitir estiver selecionada na solicitação de busca atual; caso contrário, retornará 0 (false). |
|
|
Retorna o número de bits necessários para representar a cor ou tom de cinza de um pixel na tela principal. |
|
|
Retorna a altura, em pontos, da tela em que a janela do arquivo atual está aberta. |
|
|
Retorna o fator de escala da tela na qual o arquivo atual está aberto. |
|
|
Retorna a largura, em pontos, da tela na qual a janela do arquivo atual está aberta. |
|
|
Retornará 1 (true) se as animações estiverem ativadas para o script atual; caso contrário, retornará 0 (false). |
|
|
Retorna o nome do script em execução ou pausado no momento. |
|
|
Retorna o parâmetro de script enviado ao script atual. |
|
|
Retorna o resultado do script de um subscript executado. |
|
|
Retorna a etapa de script Definir identificador de sessão. |
|
|
Retorna um valor que representa o estado da classificação atual. |
|
|
Retorna um número que representa o estado atual da barra de ferramentas de status. |
|
|
Retorna o nome da aparência do sistema operacional atual. |
|
|
Retorna a letra da unidade (Windows) ou o nome do volume (macOS) em que o sistema operacional em execução está localizado. |
|
|
Retorna uma lista dos endereços IP de todos os computadores conectados a uma placa NIC (Network Interface Controller, controlador de interface de rede) ativa. |
|
|
Retorna o idioma atualmente definido no sistema atual. |
|
| Get(SystemLocaleElements) | Retorna um objeto JSON com informações sobre o local do sistema do cliente. |
|
Retorna os endereços de hardware de todas as placas NIC (Network Interface Controller, controlador de interface de rede) conectadas ao computador. |
|
|
Retorna um número que representa a plataforma atual. |
|
|
Retorna a versão do sistema operacional atual. |
|
|
Retorna o caminho para a pasta temporária atual do FileMaker. |
|
|
Retornará 1 (true) se a régua de texto estiver visível; caso contrário, retornará 0 (false). |
|
|
Retorna o número total de registros na tabela atual. |
|
|
Retornará 1 (true) se o teclado de toque estiver definido para ser exibido automaticamente quando necessário; caso contrário, retornará 0 (false). |
|
|
Retornará 1 (true) se a transação está aberta; caso contrário, retornará 0 (false). |
|
|
Retorna o índice e o nome do objeto do painel de origem de alternação quando o gatilho de script AoAlternarPainel está ativado. |
|
|
No FileMaker Go, retorna um número que representa o evento que ativou um gatilho de script AoReceberComandoExterno. |
|
|
Retorna os detalhes sobre o gesto que ativou um gatilho de script AoGestoDeToque. |
|
|
Retorna os caracteres que ativaram um gatilho de script AoPressionarTeclaEmObjeto ou AoPressionarTeclaNoLayout. |
|
|
Retorna o estado das teclas modificadoras de teclado quando um gatilho de script AoPressionarTeclaEmObjeto ou AoPressionarTeclaNoLayout foi ativado. |
|
|
Retorna o índice e o nome do objeto do painel de destino de alternação quando o gatilho de script AoAlternarPainel está ativado. |
|
|
Retorna o número de clientes que estão acessando o arquivo no momento. |
|
|
Retorna o nome do usuário do FileMaker, como especificado na aba Geral da caixa de diálogo Preferências. |
|
|
Retornará 1 (true) se a opção Usar formatos de sistema no menu Formatar estiver ativada; caso contrário, retornará 0 (false). |
|
|
Retorna um texto que representa um identificador único universal (UUID). |
|
|
Retorna um número que representa um grande identificador único universal (UUID). |
|
|
Retorna a altura, em pontos, da área de conteúdo da janela. |
|
|
Retorna a largura, em pontos, da área de conteúdo da janela. |
|
|
Retorna a altura, em pontos, do espaço da área de trabalho. |
|
|
Retorna a largura, em pontos, do espaço da área de trabalho. |
|
|
Retorna a altura, em pontos, da janela na qual o script está atuando. |
|
|
Retorna a distância horizontal, em pontos, da borda externa da janela na qual o script está atuando em relação à borda totalmente à esquerda da tela. |
|
|
Retorna um número que representa o modo do produto do FileMaker quando a função é avaliada. |
|
|
Retorna o nome da janela na qual o script está atuando. |
|
|
Retorna um valor que representa a orientação da janela na qual o script está atuando. |
|
|
Retorna o estilo da janela na qual o script está atuando. |
|
|
Retorna a distância vertical, em pontos, da borda externa da janela na qual o script está atuando em relação à borda superior da tela no Windows ou à borda inferior na barra de menus no macOS. |
|
|
Retornará 1 (true) se a janela estiver visível; retornará 0 (false) se a janela estiver oculta usando a opção Ocultar janela. |
|
|
Retorna a largura, em pontos, da janela na qual o script está atuando. |
|
|
Retorna a porcentagem de zoom da janela atual. |
Exemplo 1
Este script usa a função Get(CurrentDate) para verificar em cada registro do conjunto encontrado se uma conta está vencida. Se uma conta estiver vencida, o script mostrará uma mensagem e solicitará que o usuário clique em um botão Ignorar, Enviar carta ou Enviar e-mail (configure por meio da etapa de script Mostrar caixa de diálogo personalizada). O script captura a resposta do usuário utilizando Get(LastMessageChoice). Em seguida, com base na resposta do usuário, o script executa uma ação: cancela o restante do script, imprime uma carta de "pagamento atrasado" ou envia um e-mail à conta associada.
Ir para layout ["NomeLayout"]
Ir para registro/solicitação/página [Primeiro]
Loop
If [NomeBancoDados::Data < Get(CurrentDate) - 30]
Show Custom Dialog ["30 ou mais dias em atraso"]
If [Get(LastMessageChoice) = 1]
Parar script
Else If [Get(LastMessageChoice) = 2]
Go to Layout ["Aviso de atraso"]
Print []
Else
Enviar e-mail [Enviar por cliente de e-mail; Com caixa de diálogo: Desativado; Para: NomeBancoDados::Cliente; Subject: "Aviso de atraso"; Message: "Sua conta está vencida."]
End If
End If
Ir para registro/solicitação/página [Próximo; Sair depois do último: Ativado]
End Loop
Ir para layout [layout original]