# Disparador personalizado de tareas

Use el Disparador de tareas para activar automáticamente cualquier "Acción" en una tarea mediante un archivo de script o una función personalizada. Puede definir reglas y aplicar acciones predefinidas en tareas que coincidan con esas reglas. Los disparadores son útiles cuando se realizan acciones en otros módulos o en aplicaciones de terceros.

## Configurar una nueva acción

Para crear un nuevo disparador personalizado para tareas:

- Haga clic en **Nueva acción**.
- Ingrese un nombre y una descripción para la acción y seleccione cuándo debe ejecutarse la acción.

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

- Establezca los criterios bajo los cuales debe ejecutarse la acción en las tareas. Puede agregar varios criterios haciendo clic en el ícono +. Cambie entre los operadores AND y OR entre los criterios según su necesidad.

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

- Seleccione el **Tipo de acción** (Funciones personalizadas/Scripts) y apunte al archivo de texto correspondiente que contiene el script que se activará.

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

En **Realizar acción**, elija si desea ejecutar un script o una función personalizada y configure lo mismo usando las siguientes indicaciones:

- **Script**: Especifique el nombre del archivo que contiene el script. Por ejemplo, `addcomments.txt`.
- **Función personalizada**: Al ejecutar funciones personalizadas, puede manipular datos en ServiceDesk Plus y en otras aplicaciones externas. Elija la función personalizada requerida o agregue una nueva.
- **Operaciones de retorno compatibles**: `UPDATE_TASK`, `ADD_COMMENTS` y `ADD_WORKLOG`.

Asegúrese de ingresar un nombre único para la "Nueva acción", de modo que el nombre no entre en conflicto con nombres de "Acción" existentes.

Asegúrese de que el archivo de texto que contiene el script se almacene solo en las ubicaciones especificadas. Guárdelo en el directorio de la siguiente manera:  
`[SDP_Home]/integration/custom_scripts/executor_files`

De forma predeterminada, "Detener el procesamiento de acciones posteriores" siempre está habilitado y las acciones se ejecutarán según el "Orden de reglas de acción".

"Organizar acciones" en la vista de lista le permite reorganizar el orden en que se ejecutan las acciones.

En un script, puede pasar parámetros de API como argumentos, por ejemplo:  
`py addComments.py $TITLE $TYPE`

`taskObj` y `context` son los argumentos compatibles en funciones personalizadas.

### Argumentos para scripts

También podemos pasar argumentos para los scripts personalizados. La siguiente tabla muestra los posibles argumentos para scripts en el Disparador personalizado de tareas.

**Posibles argumentos para scripts en el Disparador personalizado de tareas**

| PARÁMETRO | DESCRIPCIÓN |
|---|---|
| $TITLE | Indica el título de la tarea |
| $ID | Proporciona el ID único generado para la tarea |
| $PRIORITY | Indica el nivel de prioridad de la tarea |
| $STATUS | Indica el estado de la tarea |
| $TYPE | Indica el tipo de la tarea |
| $ASSOCIATED_ENTITY | Indica el elemento principal de la tarea |
| $PERCENTAGE_COMPLETION | Proporciona el porcentaje de finalización de la tarea |
| $ESTIMATED_EFFORT | Proporciona el esfuerzo estimado en días, horas y minutos |
| $ADDITIONAL_COST | Proporciona el costo adicional de la tarea |
| $CREATED_BY | Proporciona los detalles del usuario/técnico que creó esta tarea |
| $CREATED_TIME | Proporciona la hora en que se creó la tarea |
| $SCHEDULED_START_TIME | Proporciona la hora de inicio programada de la tarea |
| $SCHEDULED_END_TIME | Proporciona la hora de finalización programada de la tarea |
| $ACTUAL_START_TIME | Proporciona la hora de inicio real de la tarea |
| $ACTUAL_END_TIME | Proporciona la hora de finalización real de la tarea |
| $ISOVERDUE | Indica si la tarea está vencida |
| $OWNER | Indica el propietario asignado a la tarea |
| $GROUP | Indica el grupo bajo el cual está asignada la tarea (No aplica para tareas Generales, de Proyecto y de Hito) |
| $MARKED_OWNER | Indica el propietario marcado para la tarea |
| $MARKED_GROUP | Indica el grupo bajo el cual está marcada la tarea (No aplica para tareas Generales, de Proyecto y de Hito) |
| $TEMPLATE | Indica la plantilla utilizada para la tarea |