Início > Uso do FileMaker Pro Advanced > Uso das ferramentas avançadas do FileMaker Pro Advanced > Depuração de scripts (FileMaker Pro Advanced)

Depuração de scripts (FileMaker Pro Advanced)

Depurador de scripts é uma ferramenta interativa para solucionar problemas dos scripts do FileMaker.

Com o Depurador de scripts, é possível:

•	depurar scripts executados pelo menu Scripts ou atalhos de teclado

•	depurar scripts de inicialização (o menu Depurador de scripts será ativado mesmo se não houver nenhum arquivo aberto)

•	depurar um script ativado por um gatilho de script, botão ou menu personalizado

•	depurar totalmente um subscript para executá-lo uma etapa por vez ou depurar de maneira circular um subscript

•	definir ou remover pontos de interrupção no seu script

•	iniciar a depuração de qualquer etapa de script no script

•	visualizar subscripts conforme percorre scripts

•	depurar scripts de acesso restrito

•	pausar um script quando erros de script são encontrados

•	clicar em um número de erro de script para abrir um tópico de Ajuda

•	monitorar campos, variáveis e cálculos

•	desativar ou ativar temporariamente gatilhos de script enquanto trabalha no Depurador de scripts

Para depurar scripts:

1.	Para ativar o Depurador de scripts, escolha o menu Ferramentas > Depurador de scripts.

2.	Execute seu script.

3.	Escolha uma das seguintes opções:

 

Escolha	Para
Depuração parcial	Execute o script uma etapa por vez sem inserir os subscripts. Se a etapa de script for Realizar script, o Depurador de scripts executará o subscript e avançará para a próxima linha do script de chamada. O Depurador de scripts executará todas as etapas de subscript até encontrar um ponto de interrupção.
Depuração total	Execute o script uma etapa por vez e insira e mostre as etapas em subscripts. Se a etapa de script for Realizar script, o Depurador de scripts irá para a primeira linha do subscript e aguardará a inserção de dados pelo usuário antes de avançar para a próxima etapa do subscript.
Depuração circular	Execute todas as etapas de script no script atual e, se o script for um subscript, retorne para a linha após a etapa Realizar script no script de chamada. Se o script não for um subscript, o comando Depuração circular fará o Depurador de scripts executar todas as etapas restantes de script e subscript até encontrar um ponto de interrupção.
Definir próxima etapa	Defina o ponteiro de execução de etapa para a etapa de script realçada. Esse comando passa o controle para a etapa realçada, mas não executa a etapa. A etapa realçada é realizada quando a etapa de execução ou depuração do script é retomada. Todas as etapas de script entre a última etapa executada e a etapa seguinte atribuída não são executadas. Clique em uma etapa para realçá-la e depois em Definir próxima etapa.
Executar Pausar	Alterna entre a execução de todas as etapas de script até o final de um script ou ponto de interrupção ser encontrado e ocorrer a pausa. Quando um script é pausado, você pode clicar duas vezes em um script na lista Pilha de chamadas para editá-la. Cada script ativo é aberto em uma caixa de diálogo Editar script separada, para se possa editar vários scripts. A execução de scripts não é interrompida até você salvar as alterações. Você pode percorrer um script usando o botão Percorrer script quando um script é pausado.
Parar script	Interrompe a execução de um script.
Ativar/desativar gatilhos de script	Desative ou ative temporariamente todos os gatilhos de script em um arquivo. É necessário ter privilégios de Acesso total para desativar um gatilho de script. Os gatilhos de script são ativados por padrão. Quando o Depurador de scripts for fechado, todos os gatilhos de script desativados serão ativados. Você pode também escolher o menu Ferramentas > Controles de depuração > Desativar > Gatilhos de script ou Ativar gatilhos de script.
Definir/limpar ponto de interrupção	Defina ou remova um ponto de interrupção da linha selecionada. Os pontos de interrupção permitem que o Depurador de scripts executem seções grandes de um script, pausando apenas para inspecionar a seção marcada com um ponto de interrupção. Os pontos de interrupção são ignorados pelo FileMaker Pro quando o Depurador de scripts não está em uso. Você pode definir ou remover pontos de interrupção no Depurador de scripts ou ao criar scripts. Para definir um ponto de interrupção ao criar scripts, clique no lado esquerdo da etapa. Os pontos de interrupção são salvos com o script em que estão definidos. Você pode definir pontos de interrupção em várias etapas. Nota  Não é possível definir pontos de interrupção em etapas chamadas por um botão ou menu personalizado.
Editar script	Abra a caixa de diálogo Editar script para editar o script atual. É possível efetuar alterações em um script enquanto ele estiver em execução, mas quando as alterações forem salvas no script, a execução falhará. Nota  Para editar a etapa de script associada aos botões ou itens de menu personalizado, use a caixa de diálogo Configuração de botão ou Gerenciar menu personalizado.
Abrir/fechar Visualizador de dados	Abra (ou feche) a janela Visualizador de dados para que seja possível monitorar campos especificados, variáveis e fórmulas de cálculo. Consulte Uso do Visualizador de dados (FileMaker Pro Advanced).
Autenticar/anular autenticação do script	Desbloqueie o Depurador de scripts ou o Visualizador de dados para scripts que não permitam a modificação de privilégios. É necessário ter privilégios de Acesso total para autenticar um script. O nível mais alto de privilégios se aplica a todos os scripts, mas não a outros elementos do arquivo (por exemplo, registros e layouts). Seus privilégios de edição duram até você fechar o Depurador de scripts e o Visualizador de dados.

4.	Selecione Pausar ao encontrar erro se quiser que os scripts sejam pausados quando erros forem encontrados.

Para Último erro, clique no número do erro para abrir um tópico de Ajuda com detalhe sobre o erro. Consulte Códigos de erro do FileMaker Pro.

Nota  Ao usar o Depurador de scripts para percorrer os scripts ativados por um gatilho de script, você não poderá interagir com as janelas do documento, mover entre campos ou registros, alterar os dados, fechar a janela ou sair. Esse bloqueio da interação ocorre somente quando um script é acionado por meio de alguma ação. Quando estiver depurando um script não ativado por um gatilho de script, você poderá interagir normalmente com as janelas do documento, os campos e os registros.

Exibição de subscripts

É possível visualizar subscripts quando se percorre scripts no Depurador de scripts. Por exemplo, se o Script A chamar o Script B, que chama o Script C, você poderá ver as etapas nos três scripts.

1.	Escolha o menu Ferramentas > Depurador de scripts.

Para abrir o Depurador de scripts pela caixa de diálogo Gerenciar scripts, selecione um script, pressione Shift e clique em Realizar. Para fechar o Depurador de scripts, pressione Ctrl (Windows) ou Command (OS X) e clique em Realizar. Para obter mais informações sobre atalhos de teclado, consulte Atalhos de teclado do FileMaker Pro Advanced (Windows) e Atalhos de teclado do FileMaker Pro Advanced (OS X).

2.	Selecione uma etapa de script que chame um subscript.

3.	Clique em Depuração total.

A lista Pilha de chamadas mostra o subscript.

4.	Selecione um script na lista Pilha de chamadas para exibir as etapas desse script na área de exibição.

Notas

•	Definir próxima etapa está disponível apenas para o script sendo executado.

•

Para facilitar a depuração correta do script, o Depurador de scripts substitui algumas etapas do script. A etapa de script Permitir anulação pelo usuário com a opção definida como desativado não o impedirá de interromper a execução de um script. A etapa de script Ajustar janela com as opções de ocultar ou minimizar não ocultará ou minimizará a janela quando tiver sido encontrada com os botões Depuração parcial ou Depuração total.

•

Se um script com privilégios de acesso definido como Modificável executar um script com acesso Somente executável, o script Somente executável será executado integralmente sem mostrar suas etapas no Depurador de scripts. Se um script Somente executável executar um script com privilégios definidos como Modificável, somente as etapas no script Modificável serão exibidas no Depurador de scripts. Para editar um script, escolha Autenticar/anular autenticação do script. Para obter mais informações sobre privilégios de script e scripts de execução com acesso total, consulte Edição de privilégios de scripts.

Se você abrir o Visualizador de dados após escolher Autenticar/anular autenticação do script, seus privilégios de acesso serão mantidos no Visualizador de dados e no Depurador de scripts até você fechar o Depurador de scripts.

•	Você pode abrir uma caixa de diálogo Editar script por script.

•	É possível depurar um script de inicialização abrindo o Depurador de scripts antes de abrir seu arquivo de banco de dados.

•	Se você fechar o Depurador de scripts enquanto um script estiver pausado, a execução do script será retomada e concluída.

•	Quando um script Abrir arquivo é carregado, o Depurador de scripts exibe OnFirstWindowOpen.

•	Quando um script Fechar arquivo é carregado, o Depurador de scripts exibe OnLastWindowClose.

•

Quando você depura um script chamado de um botão, o botão é identificado na lista Pilha de chamadas pelo nome de arquivo e pelo layout em que o botão está localizado. O nome do botão é o nome do objeto de botão atribuído com o uso do Inspetor. Se nenhum nome tiver sido atribuído pelo Inspetor, <botão sem nome> seguido do nome de arquivo e do layout aparecerá na lista.

Quando o Depurador de scripts parar em uma etapa de script chamada por um botão na lista de etapas de script, o texto acima da lista mudará para Botão: <nome do botão> ou mudará para Botão: <botão sem nome> se nenhum nome tiver sido atribuído pelo Inspetor.

•

Quando você depura um script chamado de um menu personalizado, o item de menu é identificado na lista Pilha de chamadas pelo nome do item de menu e nome do arquivo. Quando o Depurador de scripts parar em uma etapa de script chamada por um menu personalizado na lista de etapas de script, o texto acima da lista mudará para Item de menu: <texto do item de menu personalizado>.

Tópicos relacionados 

Criação e edição de scripts

Uso do Visualizador de dados (FileMaker Pro Advanced)