Referência > Referências de etapas de script > Etapas de script de controle > Realizar script
 

Realizar script

Executa um script especificado a partir de uma lista ou calculado por nome.

Consulte também 

Opções 

Especificado:

Da lista permite selecionar o script a ser executado.

Por nome permite especificar o nome do script por um cálculo. O nome do script não faz distinção entre maiúsculas e minúsculas.

Parâmetro especifica um parâmetro de script para o script especificado.

Compatibilidade 

 

Produto 

Suportado 

FileMaker Pro Advanced 

Sim 

FileMaker Go 

Sim 

FileMaker WebDirect 

Sim 

FileMaker Server 

Sim 

Produto FileMaker Cloud 

Sim 

FileMaker Data API 

Sim 

Publicação na Web personalizada 

Sim 

Solução runtime 

Parcial 

Originado em 

FileMaker Pro 6.0 ou anterior

Descrição 

Não é necessário abrir um arquivo externo ao usar um script nele; o FileMaker Pro Advanced o abrirá para você.

Use scripts separados para fragmentar tarefas complexas em segmentos menores, o que geralmente facilita a solução de problemas. Outra maneira de economizar tempo é colocando tarefas comuns, como impressão e exportação de registros, em scripts separados, que podem ser acessados por mais de um script. Por exemplo, talvez seja necessário usar as mesmas opções de configuração de página e impressão em vários scripts. Definindo essas etapas uma vez e salvando-as em scripts separados, será mais fácil acessá-las várias vezes.

Use parâmetros de script para passar texto ou números para um script. Quando um parâmetro for especificado, ele poderá ser acessado em um script ou passado para outras etapas de script usando a Função Get (ScriptParameter).

Os parâmetros de script:

existem somente no script pai, a menos que seja explicitamente passado para o subscript. Se o script chamar outro script, os parâmetros no script chamado serão independentes dos parâmetros no script pai.

existirão somente enquanto o script existir. Os parâmetros de script são redefinidos sempre que um script é realizado.

podem ser usados (mas não modificados) em um script e passados para os subscripts por meio da função Get (ScriptParameter) como parâmetro do subscript. Você também pode especificar parâmetros diferentes sempre que um subscript for acionado usando Realizar script. Alterar os parâmetros passados para um subscript não modifica o valor dos parâmetros retornados de Get (ScriptParameter) no script pai.

podem conter diversos valores separados por retornos. Use a Função LeftValues, a Função MiddleValues e a Função RightValues para isolar um parâmetro específico.

Dica  Se você tiver executado um script externo e quiser retornar ao arquivo original, adicione a etapa Entrar em Modo de navegação ou Ir para layout imediatamente após a etapa Realizar script, para que o script retorne ao arquivo original.

Notas 

Se você usar Por nome para especificar um script em outro arquivo do FileMaker Pro Advanced file, o cálculo deverá ser avaliado como <nome da fonte de dados>::<nome do script>, como "Faturas::Fazer faturamento trimestral". Os nomes do script e da fonte de dados fazem distinção entre maiúsculas e minúsculas.

Se você estiver definindo um item de menu personalizado que executa um script, selecione o script e os parâmetros de script opcionais. Consulte Definição de menus personalizados.

Para scripts executados pelo FileMaker WebDirect, pelo FileMaker Data API ou pela Publicação na Web personalizada, os arquivos que contêm os scripts devem estar no mesmo host e ter os privilégios estendidos adequados habilitados para permitir acesso. Consulte Edição de privilégios estendidos para um conjunto de privilégios.

Uma solução de tempo de execução poderá executar um script externo somente se o arquivo externo estiver vinculado à solução.

Exemplo 1 

Executa o script "Imprimir relatório de fatura" sem nenhum parâmetro.

Ir para layout ["Relatório de fatura"]
Realizar script [Especificado: Da lista; "Imprimir relatório de fatura"; Parâmetro: ]

Exemplo 2 

Usa um valor de campo, Nome do cliente, como o parâmetro. Faturas do cliente atual são retornadas em uma nova janela com o layout Relatório da fatura.

Script principal: Faturas do cliente atual

Buscar registros correspondentes [Substituir; Faturas::ID do cliente]
#Chama o subscript "Exibir faturas do cliente" definido abaixo
Realizar script [Especificado: Da lista; "Exibir faturas do cliente"; Parâmetro: Faturas::Nome do cliente]

Subscript: Exibir faturas do cliente

Nova janela [Estilo: Documento; Nome: "Cliente: " & Get ( ScriptParameter ); Usando layout: "Relatório da fatura" (Faturas)]
Classificar registros [Restaurar; Com diálogo: Desativado]

Exemplo 3 

Exibe uma caixa de diálogo com o botão padrão e o botão 2, e executa o script chamado "Botão1" ou "Botão2" dependendo da escolha do usuário retornada em Get ( LastMessageChoice ).

Mostrar caixa de diálogo personalizada ["Deseja continuar?" ]
Realizar script [ Especificado: Por nome ; "Botão" & Get ( LastMessageChoice ) ; Parâmetro: ]

Tópicos relacionados 

Exemplos de Realizar script e parâmetro de script

Referência de etapas de script (lista em ordem alfabética)

Referência de etapas de script (lista de categoria)

Sobre fórmulas