Desarrollar políticas personalizadas

Para utilizar la API de revisión de política personalizada para escribir políticas, primero debe crear un administrador de políticas. Para añadir las políticas personalizadas, el administrador de la política debe incluir una referencia a cada política personalizada. Puede configurar una clase de administrador de políticas y una implementación de política y después añadir el administrador de políticas a su repositorio.

Antes de empezar

Procedimiento

  1. Configure el proyecto:
    1. Cree un proyecto Java para su política personalizada. Puede utilizar el administrador de políticas y las políticas de SampleGovernor.jar a modo de iniciación importándolas en su proyecto y modificándolas para crear políticas personalizadas.
    2. Importe el administrador de políticas de ejemplo en el subdirectorio /src del proyecto, pulsando con el botón derecho sobre el proyecto y seleccionando Importar.
    3. Seleccione Archivo de archivado y pulse Siguiente.
    4. Pulse Examinar y seleccione el archivo de archivado SampleGovernor.
    5. Pulse Finalizar. El contenido se añade a su proyecto nuevo.
  2. Añada las dependencias a su vía de acceso de construcción: Debe especificar cada archivo JAR que está incluido en la API Java RAM (en el archivo /ram/ramclient.zip ) individualmente en la vía de acceso de clases. El nombre del archivo JAR en la vía de acceso de clases debe incluir el nombre completo, por ejemplo: org.eclipse.emf.ecore.xmi_2.4.1.v200902171115.. jar.
    1. Para importar archivos desde el archivador ramclient, puede descargar el archivador de la página Ampliaciones. Para abrir dicha página, pulse el icono Ayuda y, a continuación, pulse Ampliaciones.
    2. Extraiga el contenido del archivo ram.client para añadir los archivos necesarios al proyecto nuevo.
    3. Pulse con el botón derecho del ratón y seleccione Vía de acceso de construcción > Añadir archivos externos.
    4. Navegue hasta donde ha extraído el archivo ramclient.zip y seleccione todos los archivos JAR com.ibm.ram.common,ramclient, jaxb y org.eclipse. Debe incluir los archivos JAR siguientes:
      com.ibm.ram.common
      ramclient
      jaxb-api
      jaxb-impl
      org.eclipse.emf.common
      org.eclipse.emf.ecore.xmi
      org.eclipse.emf.ecore
      org.eclipse.equinox.common
      org.eclipse.osgi
      En la versión 7.5 y versiones anteriores, debe añadir los archivos JAR siguientes a la vía de acceso de clases:
      • Desde la ubicación de instalación del producto (Directorio_de_instalación_de_WebSphere\profiles\<PROFILE>\installedApps\<APPLICATION>\com.ibm.ram.repository.web.war\WEB-INF\lib):
        com.ibm.ram.common.jar
      • Desde WebSphere Application Server (directorio_instalación_WebSphere\plugins):
        org.eclipse.emf.common.jar
        org.eclipse.emf.commonj.sdo.jar
        org.eclipse.emf.ecore.jar
        org.eclipse.emf.ecore.change.jar
        org.eclipse.emf.ecore.sdo.jar
        org.eclipse.emf.ecore.xmi.jar
  3. Escriba las políticas:
    1. Puede crear una política ampliando o no una de las políticas suministradas, como por ejemplo MyPolicy. Puede utilizar métodos de un archivo de política suministrada y cambiar los métodos. Por ejemplo, en el método test(), puede aprobar o fallar una prueba de política de activos en función de un conjunto específico de detalles de tipo de activo para su modelo de administración.

      Para obtener más información sobre las API que puede utilizar al escribir las políticas personalizadas, consulte APIs a utilizar en políticas personalizadas

      Nota: Puede almacenar políticas en una correlación y obtener una política por ID; por ejemplo, private Map policies;. Para recuperar una política de la correlación, especifique el ID de política en el método getPolicies().get(id).
    2. En la clase Governor, agregue una referencia a cada política nueva. Su clase de administrador debe incluir una referencia a cada política personalizada del administrador de políticas. Por ejemplo, para MyPolicy, estas líneas se añaden a la clase MyGovernor (en MyGovernor.java):
      	//My XML Policy
      		Policy policy = new MyPolicy(this);
      		policies.put(policy.getID(), policy);

      Puede utilizar las API Java de Rational Asset Manager para trabajar con el activo actual y otros activos dentro de una política personalizada. Para obtener ejemplos de cómo utilizar las APIs Java, consulte: Utilización de la API Java de Rational Asset Manager. Encontrará ejemplos e información adicional sobre las API que puede utilizar en la página wiki de políticas personalizadas en jazz.net

  4. Instale las políticas. Puede empaquetar las políticas personalizadas exportando el proyecto como archivo JAR y añadiéndolo como ampliación de política nueva.
    1. Exporte el proyecto como archivo JAR.
      Cuando guarde el paquete como un proyecto de Eclipse, también debe incluir estos archivos JAR, que son necesarios para utilizar la API Java de Rational Asset Manager en una política:
      • En WebSphere Application Server:
        • axis.jar
        • jaxrpc.jar
        • ramclient.jar
        • saaj.jar
        • wsdl47-1.5.1.jar
      • En Tomcat:
        • ramclient.jar
        • org.eclipse.equinox.common (para IProgressMonitor)

      En la versión 7.5.0.1 y posteriores, puede incluir varios archivos JAR (como ramclient.jar y el JAR de política) como un archivo .zip al cargar una política.

    2. Inicie sesión en el producto como administrador de repositorio.
    3. En la página Administración, pulse Ampliaciones personalizadas.
    4. Añada una ampliación de política nueva.
    5. Escriba el nombre de nombre de clase totalmente cualificado (paquete y clase) del administrador de políticas.
    6. Vaya hasta el archivo JAR que exportó en el paso 4a. Su política se puede utilizar en un proceso de ciclo de vida o de política.
    Para obtener instrucciones adicionales sobre cómo añadir su administrador, consulte Definir administradores de políticas externas.

Qué hacer a continuación

Probar y depurar la política. Para obtener instrucciones, consulte Probar y depurar políticas.

Comentarios