Comandos de administración de interceptor
Para el funcionamiento de la nueva funcionalidad del interceptor de BAM, se han agregado cuatro nuevos comandos a la utilidad de administración de BAM.
Estos comandos permiten la implementación, recuperación y eliminación de interceptores. También se incluye un comando para enumerar los interceptores configurados.
deploy-interceptor: implementa una configuración de interceptor.
get-interceptorlist: obtiene una lista de actividades en las que se implementa la interceptación.
get-interceptor: obtiene la configuración del interceptor.
remove-interceptor: quita una configuración del interceptor.
Nota
Puede habilitar el seguimiento en cualquier comando de la utilidad BM incluyendo el modificador de parámetro -Trace:on|off . Al utilizar el conmutador Trace, se invalidan las opciones de seguimiento del archivo de configuración. El conmutador puede utilizarse junto con cualquier comando normal de BM.
Nota
En un sistema que admita el Control de cuentas de usuario (UAC), es posible que deba ejecutar la herramienta con privilegios administrativos.
Comando deploy-interceptor:
Uso
bm.exe deploy-interceptor -FileName:<Configuration XML Filename> [-Force:True ] [-Server:<server>] [-Database:<database>]
Parámetros
| Parámetro | Descripción |
|---|---|
| FileName:<Configuration XML Filename> | nombre del archivo XML que contiene la configuración del interceptor. |
| Force:True | Opcional: fuerza la implementación de la configuración del interceptor cuando se detectan colisiones de nombres de origen de eventos. |
| Server:<server> | Opcional: nombre del servidor en el que se va a implementar el interceptor. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe. |
| Base de datos:<base de datos> | Opcional: nombre de la base de datos de importación principal de BAM en la que se va a configurar el interceptor. |
Este comando implementa la configuración del interceptor en la base de datos y el servidor especificados. Durante la implementación, la utilidad de administración de BAM lleva a cabo las validaciones siguientes:
Validación XSD: la configuración del interceptor se valida con el esquema de configuración común del interceptor.
Validación de que la actividad existe (está implementada en la base de datos de importación principal) y de que los puntos de control son válidos (existen y tienen un tipo de datos coincidente).
Si se detecta un conflicto en el nombre del origen del evento, se genera una advertencia que describe ese conflicto. En el caso de una colisión, se producirá un error en la implementación a menos que se use la marca de parámetro –Force:True .
Nota
El parámetro –Force:True puede quitar las configuraciones del interceptor que hacen referencia a orígenes de eventos con el mismo nombre. Debe usar el comando get-interceptor para crear una copia de seguridad de las configuraciones de interceptor existentes antes de usar el parámetro –Force:True .
Ejemplos
bm.exe deploy-interceptor -FileName:myInceptor.xml
bm.exe deploy-interceptor -FileName:myInceptor.xml -Force:True
Comando get-interceptorlist
Uso
bm.exe get-interceptorlist [-Server:<server>] [-Database:<database>]
Parámetros
| Parámetro | Descripción |
|---|---|
| Server:<server> | Opcional: nombre del servidor desde el que se va a devolver una lista de interceptores implementados. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe. |
| Base de datos:<base de datos> | Opcional: nombre de la base de datos de importación principal de BAM desde la que se van a recuperar los interceptores implementados. |
Este comando devuelve una lista de actividades (y de sus orígenes de eventos asociados) para las que se encuentra habilitada la interceptación.
Ejemplo
bm.exe get-interceptorlist
Comando get-interceptor
Uso
bm.exe get-interceptor [-Server:<server>] [-Database:<database>] -FileName: <Configuration XML Filename> [ -Activity: Activity: <Activity Name>] [-EventSource: <Event Source Name>]
Parámetros
| Parámetro | Descripción |
|---|---|
| Server:<server> | Opcional: nombre del servidor desde el que se va a recuperar el interceptor implementado. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe. |
| Base de datos:<base de datos> | Opcional: nombre de la base de datos de importación principal de BAM desde la que se va a recuperar el interceptor implementado. |
| FileName:<Configuration XML Filename> | nombre del archivo XML en el que escribir la configuración del interceptor. |
| Activity:<Activity Name> | Opcional: especifica la actividad para la que se va a devolver el interceptor configurado. Se puede usar junto con el parámetro EventSource para especificar aún más la configuración que se va a devolver. |
| EventSource:<Nombre del origen del evento> | Opcional: especifica el origen del evento para el que se va a devolver el interceptor configurado. Se puede usar junto con el parámetro Activity para especificar aún más la configuración que se va a devolver. |
Si no se proporciona ningún nombre de actividad o de origen de evento, el comando devuelve un archivo de configuración válido que contiene las configuraciones del interceptor para todos los orígenes de eventos y todas las actividades.
Si sólo se proporciona un nombre de actividad, el comando devuelve un archivo de configuración de interceptor válido para todos los orígenes de eventos de esa actividad.
Si sólo se proporciona un nombre de origen de evento, el comando devuelve un archivo de configuración de interceptor válido para ese origen de evento en todas las actividades.
Si se proporcionan tanto un nombre actividad como uno de origen de evento, entonces el comando devuelve un archivo de configuración de interceptor válido para ese origen de evento en esa actividad.
Ejemplos
bm.exe get-interceptor
bm.exe get-interceptor -Activity:ShippingPO
Comando remove-interceptor
Uso
bm.exe remove-interceptor [-Server:<server] [-Database:<database>] [ -Activity: Activity Name<>][-EventSource: <Event Source Name>>]
Parámetros
| Parámetro | Descripción |
|---|---|
| Server:<server> | Opcional: nombre del servidor en el que está configurado el interceptor. El servidor debe estar en el mismo dominio que el equipo desde el que se ejecuta bm.exe. |
| Base de datos:<base de datos> | Opcional: nombre de la base de datos en la que está configurado el interceptor. |
| Actividad: <Nombre de la actividad> | Opcional: especifica la actividad para la que se va a quitar el interceptor especificado. Se puede usar junto con el parámetro EventSource para especificar aún más la configuración que se va a devolver. |
| EventSource: <nombre del origen del evento> | Opcional: especifica el origen del evento para el que se va a quitar el interceptor especificado. Se puede usar junto con el parámetro Activity para especificar aún más la configuración que se va a devolver. |
Si sólo se proporciona un nombre de actividad, el comando elimina el interceptor de todos los orígenes de eventos de esa actividad.
Si sólo se proporciona un nombre de origen de evento, el comando elimina sólo esa porción del origen del evento para esa actividad.
Ejemplo
bm.exe remove-interceptor