Inclua código PHP em um projeto de plug-in
de código para modificar uma instância padrão quando ela for
gerada por um usuário padrão.
Antes de poder concluir esta tarefa, você deve concluir as seguintes tarefas:
É possível incluir o código PHP em um projeto de plug-in de código selecionando
um script PHP, que é executado quando uma instância padrão é gerada. Você pode decidir se
grava a saída desse script em um arquivo. Por
exemplo, é possível gravar um script PHP que cria um arquivo ESQL que
é usado no padrão definido pelo usuário.
Se você incluiu
suporte PHP quando criou o plug-in de código, um modelo PHP e
scripts de exemplo serão criados e incluídos no projeto. Alternativamente, é possível criar seu próprio script PHP. Independentemente
de como o script for criado, você deverá incluir seu próprio código
no script para concluir as etapas necessárias quando a instância de
padrão for gerada. Para obter exemplos de código PHP para concluir
tarefas comuns, consulte Exemplos de Código da API PHP. Para obter informações de referência sobre a API de criação de padrão PHP, consulte API PHP para Padrões Definidos pelo Usuário.
Para selecionar um script PHP para execução quando uma
instância de padrão for gerada:
- Se a janela Incluir Código Java ou PHP não estiver aberta, na
guia
Configuração Padrão do editor de Criação de Padrão, clique em
Incluir. A janela Incluir Código Java ou PHP será aberta.
- Na lista Tipo de Código, selecione PHP.
- Na lista Nome do Projeto, selecione
o projeto ou o plug-in que contém o script PHP que você deseja
executar quando uma instância padrão for gerada. Se o plug-in requerido estiver
instalado, mas não estiver em sua área de trabalho, clique em
Navegar e selecione o plug-in requerido.
- Na lista Nome do Arquivo PHP, selecione o nome do script que
você deseja executar quando uma instância padrão for gerada. A lista de nomes de arquivos PHP
mostra todos os scripts PHP no projeto ou plug-in selecionado.
- Opcional: Para gravar a saída do script PHP em um arquivo, selecione Gravar a
saída do arquivo PHP em um arquivo de saída.
- Na lista Projeto de Instância Padrão,
selecione o projeto de instância padrão no qual você deseja incluir o arquivo de
saída.
- No campo Nome do Arquivo de Saída, insira
um nome para o arquivo de saída. É possível incluir um caminho nesse campo, por exemplo,
scripts/example.mqsc, para gravar a saída
na pasta scripts.
- Clique OK. A janela Incluir
Código Java ou PHP é fechada e o script PHP
selecionado é mostrado na seção Código Java e PHP
da guia
Configuração Padrão.
- Opcional: O código Java e
PHP listado na seção Código Java e
PHP da guia
Configuração Padrão é executado
do início ao fim quando uma instância padrão é gerada. Para alterar
a ordem de execução do código, selecione a entrada que você deseja mover
na seção Código Java e PHP
e clique no botão Para Cima ou Para Baixo
para alterar a posição da entrada na lista.
Em seguida:
No script PHP selecionado para
execução quando a instância padrão é gerada, você deve agora gravar o
código para executar as etapas necessárias. Para obter exemplos de código PHP para concluir
tarefas comuns, consulte
Modificando Instâncias de Padrão Utilizando PHP. Para obter informações de referência sobre a API de criação de padrão PHP, consulte
API PHP para Padrões Definidos pelo Usuário.