# Acionador Personalizado de Projeto

Use o Acionador de Projeto para acionar automaticamente qualquer **Ação** em um projeto usando um arquivo de script ou uma função personalizada. Você pode definir regras e aplicar ações predefinidas em projetos que correspondam a essas regras. Os acionadores são úteis ao executar ações em outros módulos ou em aplicativos de terceiros.

## Configurando uma Nova Ação

Para criar um novo acionador personalizado para projetos:

- Vá para **Admin > Automação > Acionadores Personalizados** e selecione **Projetos**.
- Clique em **Nova Ação**.
- Insira um nome e uma descrição para a ação e selecione quando a ação deve ser executada.

![](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2021_07_09_08_09_292.png)

- Defina os critérios sob os quais a ação deve ser executada nos projetos. Você pode adicionar vários critérios clicando no ícone **+**. Alterne entre os operadores **AND** e **OR** entre os critérios conforme sua necessidade.

![](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2021_07_09_08_09_293.png)

- Selecione o **Tipo de Ação** (Funções Personalizadas/Scripts) e aponte para o arquivo de script correspondente que precisa ser acionado.

![](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2021_07_09_08_09_294.png)

Em **Executar Ação**, escolha se deseja executar um script ou uma função personalizada e configure da mesma forma usando as orientações a seguir:

- **Script:** Especifique o nome do arquivo de script. Por exemplo, `addComments.txt`.
- **Função Personalizada:** Ao executar funções personalizadas, você pode manipular dados no ServiceDesk Plus e em outros aplicativos externos. Escolha a função personalizada necessária ou adicione uma nova.
- **Operações de Retorno Suportadas:** `UPDATE_PROJECT` & `ADD_COMMENTS`
- Desmarcar a caixa de seleção **"Parar o processamento das ações subsequentes"** executará a ação seguinte mesmo após uma regra de ação ser aplicada em um projeto.

Certifique-se de inserir um nome exclusivo para a **Nova Ação**, para que o nome não entre em conflito com nomes de **Ação** existentes.

Certifique-se de que o arquivo de script seja armazenado apenas nos locais especificados. Armazene-o no diretório da seguinte forma:  
`[SDP_Home]/integration/custom_scripts/executor_files`

Por padrão, **"Parar o processamento das ações subsequentes"** está sempre habilitado e as ações serão executadas de acordo com a **Ordem das regras de ação**.

**"Organizar Ações"** na visualização em lista permite reorganizar a ordem em que as ações são executadas.

Em um script, você pode passar parâmetros de API como argumentos, por exemplo:  
`py addComments.py $TITLE $TYPE`

`projectObj` e `context` são os argumentos suportados em funções personalizadas.

### Argumentos para Scripts

Também podemos passar argumentos para os scripts personalizados. A tabela a seguir mostra os possíveis argumentos para scripts no Acionador Personalizado de Projeto.

**Possíveis argumentos para scripts no Acionador Personalizado de Projeto**

| PARÂMETRO | DESCRIÇÃO |
|---|---|
| $TITLE | Indica o título do projeto |
| $ID | Fornece o ID exclusivo gerado para o projeto |
| $CODE | Fornece o código exclusivo atribuído ao projeto |
| $PRIORITY | Indica o nível de prioridade do projeto |
| $STATUS | Indica o status do projeto |
| $TYPE | Indica o tipo do projeto |
| $ESTIMATED_HOURS | Fornece as horas estimadas para a conclusão do projeto |
| $ACTUAL_HOURS | Fornece as horas reais gastas para a conclusão do projeto |
| $ESTIMATED_COST | Fornece o custo estimado para a conclusão do projeto |
| $ACTUAL_COST | Fornece o custo real do projeto |
| $CREATED_BY | Fornece os detalhes do usuário/técnico que criou este projeto |
| $CREATED_TIME | Fornece o horário em que o projeto foi criado |
| $SCHEDULED_START_TIME | Fornece o horário de início agendado do projeto |
| $SCHEDULED_END_TIME | Fornece o horário de término agendado do projeto |
| $ACTUAL_START_TIME | Fornece o horário real de início do projeto |
| $ACTUAL_END_TIME | Fornece o horário real de término do projeto |
| $PROJECTED_END_TIME | Fornece o horário previsto de término do projeto |
| $OWNER | Indica o proprietário atribuído ao projeto |
| $DEPARTMENT | Indica o departamento ao qual o projeto pertence |
| $REQUESTER | Indica o usuário que solicitou este projeto |
| $SITE | Indica o site ao qual o projeto pertence |
| $TEMPLATE | Indica o modelo usado para o projeto |