Início > Referência > Referência de funções > Funções Get

Funções Get

Use as funções Get em scripts para prevenção e verificação de erros ou para obter informações sobre o status de um arquivo de banco de dados ou elementos contidos neles ou uma ação sendo executada.

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 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 são atualizadas no momento em que o cálculo é executado.

Para acessar a lista de funções Get, na caixa de diálogo Especificar cálculo, escolha Exibir todas as funções por tipo ou Exibir funções Get. Quando escolher Exibir todas as funções por nome, será exibido apenas Get(sinalizador).

Nota  Para obter informações sobre como as funções são avaliadas diferentemente no host em comparação com o cliente, consulte a Base de conhecimento do FileMaker disponível em http://www.filemaker.com/br/support.

Clique em um nome de função para detalhes.

 

Essa função	Retorna
Get(AccountExtendedPrivileges)	Uma lista de palavras-chave para os privilégios estendidos, separadas por quebras de linha. A lista retornada tem como base a conta usada para abrir o arquivo de banco de dados.
Get(AccountName)	O nome da conta autenticada sendo usado para o arquivo de banco de dados ativo.
Get(AccountPrivilegeSetName)	O nome do conjunto de privilégios sendo usado pela conta usada para abrir o arquivo de banco de dados.
Get(ActiveFieldContents)	O conteúdo do campo que tem o foco.
Get(ActiveFieldName)	O nome do campo que tem o foco.
Get(ActiveFieldTableName)	O nome da tabela que contém o campo ativo (o campo que tem o foco).
Get(ActiveLayoutObjectName)	O nome do objeto de layout ativo na janela ativa do cálculo.
Get(ActiveModifierKeys)	Um número que representa as teclas de modificador de teclado (por exemplo, Shift) sendo pressionadas.
Get(ActivePortalRowNumber)	O número da linha de portal que tem o foco.
Get(ActiveRepetitionNumber)	Um número que representa a repetição ativa de um campo de repetição (a repetição que tem o foco).
Get(ActiveSelectionSize)	Um número que representa quantos caracteres estão selecionados.
Get(ActiveSelectionStart)	Um número que representa o caractere inicial do texto selecionado.
Get(AllowAbortState)	Um valor booleano que representa o estado atual da etapa de script Permitir anulação pelo usuário.
Get(AllowFormattingBarState)	Um valor booleano que representa se as barras de formatação podem ficar visíveis.
Get(ApplicationLanguage)	Texto que representa o idioma do aplicativo atual (por exemplo, inglês).
Get(ApplicationVersion)	Texto que representa a versão do aplicativo FileMaker.
Get(CalculationRepetitionNumber)	Um número que representa a repetição do campo de cálculo atualmente sendo calculado.
Get(ConnectionAttributes)	O nome do host do arquivo atual e o nome da autoridade de certificação que emitiu o certificado SSL usado para garantir a segurança da conexão.
Get(ConnectionState)	Um número que representa o estado da segurança de uma conexão de rede para o arquivo atual.
Get(CurrentDate)	Os dados atuais de acordo com o calendário do sistema.
Get(CurrentExtendedPrivileges)	Uma lista de palavras-chave para os privilégios estendidos da conta sendo usada para avaliar o cálculo.
Get(CurrentHostTimestamp)	A data e a hora atuais do host (até o segundo mais próximo) de acordo com o relógio do sistema.
Get(CurrentPrivilegeSetName)	O nome do conjunto de privilégios sendo usado para avaliar esse cálculo no banco de dados.
Get(CurrentTime)	A hora atual (até o segundo mais próximo) de acordo com o relógio do sistema.
Get(CurrentTimestamp)	A data e a hora atuais (até o segundo mais próximo) de acordo com o relógio do sistema.
Get(CurrentTimeUTCMilliseconds)	A hora atual com precisão de milissegundos de acordo com o Tempo Universal Coordenado (UTC).
Get(CustomMenuSetName)	O nome do conjunto ativo de menus personalizados.
Get(DesktopPath)	O caminho para a pasta da área de trabalho do usuário atual.
Get(Device)	Um número que indica o tipo de computador ou dispositivo iOS que está executando um produto do FileMaker.
Get(DocumentsPath)	O caminho para a pasta Documentos do usuário atual.
Get(DocumentsPathListing)	Uma lista de todos os arquivos e pastas na pasta Documentos retornada pela função Get(DocumentsPath).
Get(EncryptionState)	Um valor numérico que representa o estado atual da criptografia.
Get(ErrorCaptureState)	Um valor booleano que representa o estado da etapa de script Captura de erro.
Get(FileMakerPath)	O caminho para a pasta da cópia do FileMaker Pro que está atualmente em execução.
Get(FileName)	O nome do arquivo de banco de dados atualmente ativo.
Get(FilePath)	O caminho completo que indica o local do arquivo.
Get(FileSize)	O tamanho (em bytes) do arquivo de banco de dados atualmente ativo.
Get(FoundCount)	O número que representa o número de registros no conjunto encontrado atual.
Get(HighContrastColor)	O nome do esquema de cores padrão de alto contraste atual se Usar Alto Contraste estiver selecionada na caixa de diálogo Opções de Acessibilidade do sistema operacional Windows.
Get(HighContrastState)	Um valor booleano que representa o estado da caixa de seleção Usar Alto Contraste na caixa de diálogo Opções de Acessibilidade.
Get(HostApplicationVersion)	A versão do FileMaker Pro ou do FileMaker Server em execução no computador que está hospedando o banco de dados atual.
Get(HostIPAddress)	O endereço IP da máquina host do banco de dados atual.
Get(HostName)	O nome registrado do computador que está hospedando o arquivo de banco de dados.
Get(InstalledFMPlugins)	O nome de exibição, o número de versão (se houver) e o estado de ativação dos plug-ins instalados.
Get(LastError)	Um número que representa o erro, se houver, na execução da etapa de script executada mais recentemente.
Get(LastMessageChoice)	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.
Get(LastODBCError)	Uma cadeia que mostra o estado do erro publicado pelos padrões ODBC, com base nos padrões ISO/IEF.
Get(LayoutAccess)	Um número que corresponde aos privilégios de acesso de layout atribuídos por meio da caixa de diálogo Gerenciar segurança.
Get(LayoutCount)	O número total de layouts no arquivo de banco de dados.
Get(LayoutName)	O nome do layout atualmente exibido.
Get(LayoutNumber)	O número do layout atualmente exibido, de acordo com a lista na caixa de diálogo Gerenciar layouts.
Get(LayoutTableName)	O nome da tabela de que o layout está exibindo registros.
Get(LayoutViewState)	Informações sobre como o arquivo de banco de dados está sendo visualizado.
Get(ModifiedFields)	Uma lista de campos alterada no registro atual da tabela atual.
Get(MultiUserState)	Um número que representa o estado de vários usuários atual do arquivo de banco de dados.
Get(NetworkProtocol)	O nome do protocolo de rede que o FileMaker Pro está usando nesta máquina.
Get(NetworkType)	Um número que representa o tipo de rede que está sendo usado pelo FileMaker Pro para acessar o arquivo que está executando o script atual.
Get(PageNumber)	Um número que representa a página atual sendo impressa ou visualizada.
Get(PersistentID)	Texto que representa um identificador exclusivo do computador ou dispositivo no qual o FileMaker está sendo executado.
Get(PreferencesPath)	O caminho para a pasta de preferências do usuário atual.
Get(PrinterName)	Uma cadeia que identifica o nome da impressora padrão.
Get(QuickFindText)	O texto inserido na caixa Busca rápida.
Get(RecordAccess)	Um número que indica os privilégios de acesso do registro atual.
Get(RecordID)	O número de ID exclusiva do registro atual.
Get(RecordModificationCount)	O número total de vezes que as alterações no registro atual foram confirmadas.
Get(RecordNumber)	O número do registro atual no conjunto encontrado atual.
Get(RecordOpenCount)	O número total de registros abertos no conjunto encontrado atual que ainda não foram salvos.
Get(RecordOpenState)	Um número que representa o estado do registro atual.
Get(RequestCount)	O número total de solicitações de busca atualmente definidas para a tabela atual.
Get(RequestOmitState)	Um valor booleano que representa o estado da caixa de seleção Omitir no Modo de busca.
Get(ScreenDepth)	O número de bits necessários para representar a cor ou a sombra de cinza de um pixel na tela principal.
Get(ScreenHeight)	A altura, em pontos, da tela em que a janela do arquivo atual está aberta.
Get(ScreenWidth)	A largura, em pontos, da tela em que a janela do arquivo atual está aberta.
Get(ScriptAnimationState)	Um número que indica se as animações estão ativadas para o script que está em execução no momento.
Get(ScriptName)	O nome do script atualmente em execução (ou pausado).
Get(ScriptParameter)	O parâmetro de script passado ao script atual.
Get(ScriptResult)	O resultado do script a partir de um subscript executado.
Get(SortState)	Um valor numérico que representa o estado da classificação atual.
Get(StatusAreaState)	Um número que representa se a barra de ferramenta de status está oculta, visível, visível e bloqueada ou oculta e bloqueada.
Get(SystemDrive)	A letra da unidade (Windows) ou o nome do volume (OS X) em que o sistema operacional atualmente em execução está localizado.
Get(SystemIPAddress)	Os endereços IP de todas as máquinas conectadas a uma placa NIC (Network Interface Controller, controlador de interface de rede).
Get(SystemLanguage)	O idioma atualmente definido no sistema operacional.
Get(SystemNICAddress)	Os endereços de hardware de todas as placas NIC conectadas à máquina.
Get(SystemPlatform)	Um número que indica a plataforma atual.
Get(SystemVersion)	A versão do sistema operacional da máquina em que a função é executada.
Get(TemporaryPath)	O caminho da pasta temporária do usuário atual usada pelo FileMaker Pro.
Get(TextRulerVisible)	Um valor booleano que representa se a régua de texto está visível ou não.
Get(TotalRecordCount)	O número total de registros na tabela atual.
Get(TriggerCurrentPanel)	O número de índice e o nome do objeto do painel de guias ou do painel de slides dos quais alternar quando o AoAlternarPainel gatilho de script for ativado.
Get(TriggerGestureInfo)	Detalhes sobre o gesto que ativou um gatilho de script do AoGestoDeToque.
Get(TriggerKeystroke)	Uma cadeia contendo os caracteres que ativaram um gatilho de script AoPressionarTeclaEmObjeto ou AoPressionarTeclaNoLayout.
Get(TriggerModifierKeys)	O estado em que as teclas de modificador de teclado se encontravam quando o gatilho de script foi ativado.
Get(TriggerTargetPanel)	O número de índice e o nome do objeto do painel de guias ou do painel de slides dos quais alternar quando o gatilho de script de AoAlternarPainel for ativado.
Get(UserCount)	O número de usuários que estão atualmente acessando o arquivo.
Get(UserName)	O nome do usuário do FileMaker Pro, como especificado na guia Geral da caixa de diálogo Preferências.
Get(UseSystemFormatsState)	Um valor booleano que representa o estado do comando de menu Usar formatos do sistema.
Get(UUID)	Texto que representa um identificador único universal (UUID).
Get(WindowContentHeight)	A altura, em pontos, da área de conteúdo do FileMaker Pro.
Get(WindowContentWidth)	A largura, em pontos, da área de conteúdo do FileMaker Pro.
Get(WindowDesktopHeight)	A altura, em pontos, do espaço da área de trabalho.
Get(WindowDesktopWidth)	A largura, em pontos, do espaço da área de trabalho.
Get(WindowHeight)	A altura, em pontos, da janela em que o script está atuando (não necessariamente a janela em primeiro plano).
Get(WindowLeft)	A distância horizontal, em pontos, da borda externa da janela em que o script está atuando (não necessariamente a janela em primeiro plano) em relação à borda totalmente à esquerda da tela.
Get(WindowMode)	Um número que representa se o FileMaker Pro está no Modo de navegação, Modo de busca, Modo de visualização ou de impressão quando a função é avaliada.
Get(WindowName)	O nome da janela atual do arquivo em que o cálculo é definido.
Get(WindowOrientation)	Um número que indica a orientação da janela em que o script está atuando.
Get(WindowStyle)	Um número que indica se a janela aberta que está no topo é uma janela de documento, de documento flutuante ou de caixa de diálogo.
Get(WindowTop)	A distância vertical, em pontos, da borda externa da janela em que o script está atuando (não necessariamente a janela em primeiro plano) em relação à borda inferior da barra de menus.
Get(WindowVisible)	Um valor booleano que representa se a janela atual está visível ou não.
Get(WindowWidth)	A largura, em pontos, da janela em que o script está atuando (não necessariamente a janela em primeiro plano).
Get(WindowZoomLevel)	O nível de zoom da janela atual.

Exemplo de funções Get

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 email (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 email à 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]

      Halt Script

    Else If [Get(LastMessageChoice) = 2]

      Go to Layout ["Aviso de atraso"]

      Print []

    Else

      Send Mail [To: NomeBancoDados::Cliente; Subject: "Aviso de atraso"; Message: "Sua conta está vencida."]

    End If

  End If

  Ir para registro/solicitação/página [Sair depois do último, Próximo]

End Loop

Ir para layout [layout original]

Tópicos relacionados 

Sobre funções

Sobre fórmulas