Definición de implementación para desencadenantes

La definición de implementación es un fragmento de XML en una definición de plantilla de elemento de campaña. Todos los desencadenantes deben tener una definición de implementación.

El fragmento de XML de definición de implementación define la siguiente información para un desencadenante:

El nombre exclusivo de la plantilla de elemento de campaña para el desencadenante.
Los parámetros que los usuarios de empresa pueden especificar en Management Center para el desencadenante. Para obtener más información, consulte Parámetros de plantilla de elementos de campaña.
El mandato de tarea asociado con el desencadenante, si el desencadenante tiene un mandato de tarea. Los desencadenantes deben tener un mandato de tarea si se cumple una de las siguientes sentencias:
- El desencadenante es un desencadenante de comprobación diaria, en lugar de un desencadenante de suceso de cliente.
- La interfaz de usuario para el desencadenante requiere validación cuando el usuario activa la actividad que contiene el desencadenante.
Para obtener más información, consulte Mandatos de tarea de elementos de campaña.

Dónde se almacenan las definiciones de implementaciones

Tabla de base de datos: DMELETEMPLATE
Columna: IMPLXML

Formato de las definiciones de implementación de desencadenante

Las definiciones de implementaciones utilizan el formato siguiente:


<Trigger type="UNIQUE_TRIGGER_NAME" callCmdOnMatch="COMMAND_INTERFACE_NAME">
 <Parameter name="parameter1" value="MARKETING_paramName"/>
 <Parameter name="parameter2" value="parameter2Value"/>
 <Implementation invocationType="TaskCommand">
  <Class name="TASK_COMMAND_CLASS_NAME"/>
 </Implementation>
</Trigger>

Parámetros de las definiciones de implementación de desencadenante

Cada parámetro que una definición de implementación de desencadenante puede contener, como se muestra en el ejemplo de formato anterior, se describe a continuación:

tipo: El nombre exclusivo para la plantilla de elemento de campaña de este desencadenante.
callCmdOnMatch: Opcional: Si necesita más procesos cuando el cliente accede a un elemento de desencadenante en una actividad, especifique el parámetro callCmdOnMatch. Este parámetro llama al método performExecute en el mandato de tarea especificado. El mandato al que se hace referencia en este parámetro debe implementar el método MarketingCampaignElementTaskCmd para llamar al método performExecute. En la mayoría de los casos, esta función no es necesaria. Ninguno de los desencadenantes proporcionados de forma predeterminada especifica este parámetro.

Para el elemento <Parameter>, el XML de la definición de implementación para un desencadenante puede tener ninguno o varios de estos parámetros de plantilla de elemento de campaña. Los parámetros identifican los datos que los usuarios de empresa pueden especificar en la interfaz para el desencadenante.

name: El nombre del parámetro que se debe pasar al mandato de tarea para su proceso.
valor: El valor del parámetro. Si el valor del parámetro proviene de la interfaz de usuario, el valor debe estar en el formato MARKETING_paramName. Si el valor del parámetro proviene de un lugar distinto de la interfaz de usuario, el valor no necesita el prefijo MARKETING_.

Para el elemento <Implementation>:

invocationType: Este valor siempre es TaskCommand.

Para el elemento <Class>, especifique el mandato de tarea asociado para el desencadenante, si el desencadenante tiene uno. El mandato de tarea debe ser una clase que implemente la interfaz MarketingCampaignElementTaskCmd:

name

El nombre de la clase de mandato de tarea de elemento de campaña para este desencadenante. Si crea un nuevo desencadenante, el nombre que especifique aquí debe coincidir con el nombre del mandato de tarea personalizado que cree para dar soporte al nuevo desencadenante. Por ejemplo:

com.your_company_name.marketing.commands.elements.CustomFraudDetectedTriggerTaskCmd

Ejemplos

Los siguientes fragmentos de código muestran ejemplos de fragmentos de XML para definiciones de implementación de desencadenantes:

Ejemplo de fragmento de XML para el desencadenante El cliente se registra, que se proporciona de forma predeterminada en el Marketing tool. Este desencadenante no tiene ningún mandato de tarea o parámetros, por lo que la definición de implementación especifica solamente el nombre exclusivo para la plantilla de elemento de campaña del desencadenante:
```
<Trigger type="Registers">
</Trigger>
```
Ejemplo de fragmento de XML para el desencadenante El cliente cumple años que se proporciona de forma predeterminada en el Marketing tool. Esta definición de implementación de desencadenante tiene dos parámetros. La definición también requiere un mandato de tarea, porque se trata de un desencadenante de comprobación diaria que exige validar parámetros de la interfaz de usuario.
```
<Trigger type = "birthdayTrigger">
 <Parameter name = "repeatSchedule" value = "MARKETING_repeatSchedule"/>
 <Parameter name = "numberOfDays" value = "MARKETING_numberOfDays"/>
 <Implementation invocationType = "TaskCommand">
  <Class name = "com.ibm.commerce.marketing.commands.elements.BirthdayTriggerTaskCmd"/>
 </Implementation>
</Trigger>
```