Configuración de los informes y trabajos

ccppmop1571
HID_admin_configure_report_job_defs
Como administrador, puede configurar qué informes y trabajos pueden ejecutar los usuarios. Una definición de informe o trabajo consta de los siguientes elementos:
  • Propiedades generales
  • Parámetros para filtrar los datos de un informe o para especificar el alcance de un trabajo.
  • Trabajos e informes incompatibles que no se pueden ejecutar simultáneamente con el trabajo o el informe seleccionados.
  • Categorías asociadas para identificar grupos de informes y trabajos similares. Por ejemplo, se pueden agrupar los trabajos relacionados con la contabilidad en la categoría de procesamiento de la información financiera.
  • Derechos de acceso para definir los recursos, las unidades de OBS o los grupos de usuarios que pueden ejecutar o gestionar el informe o trabajo.
Como administrador, seleccione
Administración
,
Administración de datos
,
Informes y
Trabajos
para realizar cambios en la configuración. Para ver los trabajos e informes disponibles, los usuarios deben seleccionar
Página principal
,
Personal
,
Informes y
trabajos
.
2
Vídeo: Extracción de datos
El siguiente vídeo lo proporciona CA Technologies.

Para reproducir este vídeo en pantalla completa, haga clic en el logotipo de YouTube situado a la derecha del icono de configuración, en la parte inferior de la ventana.
Creación de una definición de trabajo
Use la página
Definiciones del trabajo
para ver una lista de todas las definiciones de informes y de trabajos disponibles. Se pueden editar solamente los informes y los trabajos definidos por el usuario.
Siga estos pasos:
  1. Abra
    Administración
    y, en
    Administración de datos
    , haga clic en
    Informes y
    trabajos
    .
  2. Haga clic en
    Nuevo
    .
  3. En el campo
    Tipo de ejecutable
    , especifique el método para ejecutar el informe o trabajo. El método está basado en la escucha del trabajo. Seleccione uno de los distintos tipos de ejecutables:
    • Informe
      : Se ejecuta un informe de Jaspersoft almacenado en el servidor de Jaspersoft. Para que el producto sea consciente de los informes, los archivos de definición hacen referencia al nombre del archivo ejecutable. El nombre del ejecutable almacena el archivo en el servidor de Jaspersoft.
    • Java:
      Ejecuta consultas. Se debe usar cuando no se pueda implementar el XBL de lógica de negocios. Java se considera un superconjunto de XBL y metadatos de persistencia (PMD). Por ejemplo, la siguiente declaración de Java realiza el
      Proceso de fondo del calendario
      :
      com.niku.calendar.scheduler.CalendarBackgroundProcess
    • Metadatos de persistencia (PMD)
      : Ejecuta un conjunto de consultas a intervalos regulares. Los metadatos de persistencia (PMD) no contienen lógica de negocio.
      Por ejemplo, la siguiente declaración de metadatos de persistencia (PMD) ejecuta el trabajo Registrar valores financieros del incidente:
      itl.incidentCostCalc
    • Procedimiento almacenado en SQL
      : Implementa lógica de negocios como un procedimiento almacenado cuando las operaciones requieren muchos datos. Para las operaciones que requieren muchos datos, se selecciona un procedimiento almacenado en SQL a través de Java para implementar la lógica de negocio. Por ejemplo, el siguiente procedimiento almacenado ejecuta el trabajo Eliminar registros del trabajo:
      cmn_job_logs_delete_sp
    • Lenguaje extensible de negocios (XBL)
      : Implementa la lógica de negocios y ejecuta consultas. XBL se considera como un superconjunto de metadatos de persistencia (PMD). Por ejemplo, las siguientes declaraciones de XQL y XBL ejecutan los trabajos de Registrar hojas de tiempo y Fijación de intervalos de tiempo, respectivamente:
      postTimesheets.xql
      blobcrack#blobcrack.xbl
    • Extracción, transformación y carga (ETL)
      : Ejecuta una extracción de ETL y una transformación de datos estructurados, y carga las tablas de datos transformados. Por ejemplo, el trabajo Carga del almacén de datos extrae datos de la base de datos de
      Clarity PPM
      . Este trabajo de ETL transforma los datos en un formato desnormalizado y, a continuación, los carga en el almacén de datos.
  4. En el campo
    Nombre del ejecutable
    , introduzca un nombre para el informe o trabajo. La convención de nomenclatura depende del tipo ejecutable. Consulte los ejemplos siguientes:
    • Nota
      : El nombre del informe en el servidor de JasperReports. Por ejemplo, /ca_ppm/reports/investment_management/CSK_INV_TimeAndEstimate.
    • Java
      : introduzca la ruta de la clase. Por ejemplo, com.myorg.projmgr.service.staffing.job.InvestmentAllocationJob o com.company.security.CleanUserSessionListener.
    • PMD
      : Introduzca un nombre descriptivo mediante la sintaxis de puntos; por ejemplo, itl.incidentCostCalc.
    • Procedimiento almacenado
      SQL
      : Introduzca un nombre descriptivo con caracteres de subrayado; por ejemplo, IMM_ASSIGN_INCIDENT.
    • XBL
      : Por ejemplo, projmgr#projects/purgeProjects.xbl
    • ETL
      : Introduzca el nombre de archivo del trabajo de ETL.
  5. Guarde los cambios.
Definición de los parámetros del informe o el trabajo
Los parámetros de informe o trabajo permiten a los usuarios que ejecutan informes o trabajos filtrar datos o especificar el alcance del informe o trabajo. Por ejemplo, suponga que se agrega un parámetro, se hace que uno existente sea obligatorio o se suprime un parámetro de una definición de informe o trabajo.
Defina todos los parámetros del informe o trabajo para transmitirlos al servidor de
Clarity PPM
. Defina los parámetros para indicar si el informe o trabajo se ejecuta directamente desde el producto o indirectamente desde un vínculo en otro informe o trabajo.
Siga estos pasos:
  1. Abra
    Administración
    y, en
    Administración de datos
    , haga clic en
    Informes y
    trabajos
    .
  2. Abra la definición de informe o trabajo.
  3. Haga clic en
    Parámetros
    y, a continuación, en
    Nuevo
    .
  4. Complete la información solicitada. Los campos siguientes requieren una explicación:
    • Código del vínculo del parámetro
      Define el código del vínculo del parámetro. Por ejemplo, el tipo ejecutable de trabajo es un procedimiento almacenado en SQL y que el nombre del parámetro de procedimiento es "P_JOB_RUN_ID". El código del vínculo del parámetro es "P_JOB_RUN_ID".
    • Tipo
      Especifica el tipo de campo de parámetro que se muestra a los usuarios cuando seleccionan parámetros para ejecutar trabajos.
      Valores:
      • Texto: Muestra un campo de texto a los usuarios que ejecutan trabajos.
      • Casilla de verificación: muestra los valores booleanos (verdadero o falso).
      • Menú desplegable: Muestra una lista de valores que los usuarios pueden seleccionar en un menú desplegable. Los usuarios hacen clic el icono Explorar icono para seleccionar un único valor en la búsqueda que aparece.
      • Examinar: Muestra una larga lista de valores que los usuarios pueden examinar. Los usuarios hacen clic el icono Explorar icono para seleccionar un único valor en la búsqueda que aparece.
      • Fecha: Muestra parámetros de fecha. Los usuarios que están ejecutando trabajos pueden introducir una fecha o seleccionar una fecha en un calendario.
      • Fecha relativa: Muestra un campo que permite a los usuarios seleccionar una fecha relativa al día en que se ejecuta el trabajo. Las fechas relativas están en una lista desplegable de períodos del calendario.
      • Período de tiempo: Muestra un campo desde el cual los usuarios puedan seleccionar un período de tiempo relativo al día en que se ejecuta el trabajo. La lista desplegable proporciona períodos definidos por el sistema.
      Guarde los cambios para definir valores predeterminados para tipos de parámetro de lista desplegable o de exploración.
    • Predeterminado
      Indica el valor de solo lectura del parámetro.
      Obligatorio:
      Si se selecciona el campo Solo lectura.
    • Solo lectura
      Indica si el parámetro es de solo lectura cuando se selecciona el campo. Si selecciona Solo Lectura, proporcione un valor para el parámetro en el campo Predeterminado.
  5. Guarde los cambios.
Reordenación de los parámetros de definición de informe o trabajo
Los parámetros se muestran en el orden en que se agregan a la definición de informe o trabajo. El orden de los parámetros es importante para los trabajos de Procedimiento almacenado en SQL. Para reordenar los parámetros de definición, como mínimo, se deberá definir un parámetro.
Siga estos pasos:
  1. Abra
    Administración
    y, en
    Administración de datos
    , haga clic en
    Informes y
    trabajos
    .
  2. Abra la definición de informe o trabajo para reordenar los parámetros.
  3. Seleccione
    Orden de los parámetros
    .
  4. Seleccione el parámetro y use las flechas para desplazar el parámetro hacia arriba o abajo en la lista.
  5. Guarde los cambios.
Identificación de las definiciones de informes o trabajos incompatibles
Algunos informes o trabajos, o ciertas instancias del mismo informe o trabajo, no se pueden ejecutar simultáneamente. Por ejemplo, no se puede ejecutar simultáneamente un trabajo con el trabajo Extracción de datamart si estos elementos dependen de los datos que resultan de la extracción de datamart.
Utilice la página de
Trabajos incompatibles
para identificar los trabajos que no se pueden ejecutar al mismo tiempo que el trabajo seleccionado. Si los trabajos se vuelven compatibles, elimínelos de la lista. Suprima los informes y trabajos si se vuelven compatibles. Por ejemplo, se programa la ejecución de un informe o trabajo incompatible de la lista. El tiempo de ejecución programado del informe o trabajo incompatible se aplaza hasta que finaliza la ejecución del informe o el trabajo. Siga estos pasos para recopilar una lista de informes o trabajos que no se puedan ejecutar simultáneamente.
Siga estos pasos:
  1. Abra
    Administración
    y, en
    Administración de datos
    , haga clic en
    Informes y
    trabajos
    .
  2. Abra la definición de informe o trabajo que se desea editar.
  3. Haga clic en
    trabajos incompatibles
    y haga clic en Agregar.
  4. Seleccione la casilla de verificación situada junto al informe o trabajo que no se puede ejecutar con este informe o trabajo y haga clic en
    Agregar
    .
Asociación de definiciones de informe o trabajo con categorías
Utilice el conjunto de categorías que se incluyen con el producto para agrupar los informes o trabajos de maneras significativas. Las categorías ayudan a filtrar los informes o trabajos. No se puede crear ni eliminar ninguna categoría nueva. Use la página
Categorías asociadas
de la definición de informe o trabajo para agregar trabajos a las categorías o bien eliminarlos de ellas.
Siga estos pasos:
  1. Abra
    Administración
    y, en
    Administración de datos
    , haga clic en
    Informes y
    trabajos
    .
  2. Abra la definición de informe o trabajo y haga clic en
    Categorías asociadas
    .
  3. Haga clic en
    Agregar
    .
  4. Seleccione la categoría que se desea asociar con el informe o trabajo y haga clic en
    Agregar
    .
Notificaciones de trabajos e informes
Como administrador, puede recomendar a los usuarios que configuren notificaciones si desean saber cuándo finaliza o produce un error un informe o trabajo. Los destinatarios pueden recibir notificaciones mediante una alerta o un correo electrónico o un mensaje de texto SMS. Se puede configurar el asunto y el cuerpo de las notificaciones del informe y el trabajo para cumplir los requisitos de la organización. Por ejemplo, un correo electrónico puede indicar el motivo por el que un trabajo ha producido un error.
Proporcione a los usuarios los siguientes pasos o un vínculo a Personalización de las notificaciones de CA PPM:
  1. Haga clic en
    Página principal
    ,
    Personal
    ,
    Valores de configuración de la cuenta
    .
  2. Haga clic en
    Notificaciones
    .
  3. Active la casilla de verificación situada junto a cada notificación que desea recibir y cada método.
  4. Guarde los cambios.
Activación o desactivación de un informe o trabajo
Active los informes o trabajos para ejecutarlos. Los informes o trabajos inactivos se muestran en la página de definiciones, pero la casilla de verificación en la columna Activo no está seleccionada.
Siga estos pasos:
  1. Abra
    Administración
    y, en
    Administración de datos
    , haga clic en
    Informes y
    trabajos
    .
  2. Seleccione
    Definiciones del trabajo
    .
  3. Realice uno de los pasos siguientes:
    • Seleccione el informe o trabajo inactivo y haga clic en
      Activar
      .
    • Seleccione el informe o trabajo activo y haga clic en
      Desactivar
      .
Creación de una definición de informe
Defina informes de Jaspersoft Studio en PPM para que los usuarios finales puedan ejecutar estos informes directamente en el producto en Página principal, Personal, Informes y trabajos. También puede ejecutar los informes de Jaspersoft Studio en la Generación de informes avanzada. Consulte
Generación de informes avanzada con Jaspersoft
,
Ejecución y programación de un informe avanzado
.
Use la página Definiciones del trabajo para ver una lista de todas las definiciones de informes disponibles. Solo puede crear y editar los informes definidos por el usuario.
Siga estos pasos:
  1. Haga clic en
    Administración
    ,
    Administración de datos
    ,
    Informes y trabajos
    .
  2. Haga clic en
    Nuevo
    e introduzca la siguiente información:
  • Nombre de la definición del trabajo
    Define el nombre del informe tal y como aparece en Jaspersoft. Por ejemplo, KPIs by Project Type tal y como se muestra en el campo Nombre en la siguiente imagen.
  • ID de la definición del trabajo
    Define el ID de recurso para el informe tal y como se especifica en Jaspersoft. Vaya a la Generación de informes avanzada y seleccione la opción Editar para el informe. El ID de recurso aparece en página Configuración del informe tal y como se muestra en la siguiente imagen:
    Resource_ID_JS.PNG
  • Origen del contenido
    Define el origen para el contenido del informe. Seleccione
    Cliente
    para los informes definidos por el usuario.
  • Descripción
    Describe el informe. Por ejemplo, el informe KPI by Project Type se describe como un informe de gestión de proyectos (Acelerador de PMO).
  • Activo
    Especifica si el informe está disponible para que los usuarios finales lo puedan ejecutar. Active el informe para hacerlo visible en PPM en
    Página principal
    ,
    Personal
    ,
    Informes y trabajos
    . Compruebe que el informe también está visible en Jaspersoft.
  • Tipo ejecutable
    Especifica el método para ejecutar el informe en función de la escucha. Seleccione
    Informe
    para ejecutar un informe de Jaspersoft Studio que está almacenado en el servidor de Jaspersoft. Para que el producto sea consciente de los informes, los archivos de definición hacen referencia al nombre del archivo ejecutable. El campo Nombre del ejecutable almacena la ruta del archivo en el servidor de Jaspersoft.
  • Nombre del ejecutable
    Define la ruta a la carpeta del repositorio donde se almacena el informe en Jaspersoft. Complete los pasos siguientes para especificar la ruta con precisión:
    1. En la Generación de informes avanzada, utilice las carpetas del repositorio para ir al informe.
    2. Haga clic con el botón secundario del ratón en el nombre del informe y seleccione
      Propiedades
      para ver la ruta completa al informe.
    3. Utilice las mismas mayúsculas y minúsculas que se muestran para la
      Ruta
      . El ejemplo siguiente muestra el nombre del ejecutable para el informe KPIs by Project Type:
      executable_name_JS.PNG
3. Haga clic en
Guardar y continuar
.
Se selecciona la ficha Parámetros. Continúe para definir parámetros para el informe.
Definición de los parámetros de informe
Los parámetros de informe permiten a los usuarios filtrar datos o especificar el alcance del informe. Por ejemplo, suponga que se agrega un parámetro, se hace que uno existente sea obligatorio o se suprime un parámetro de una definición de informe. Se recomienda agregar los parámetros de uno en uno, en lugar de todos a la vez. Si hay un problema, podrá utilizar el proceso de eliminación para seguir avanzando gradualmente. Debe definir un parámetro para cada control de entrada que existe para el informe de Jaspersoft. Además, debe definir los parámetros en el mismo orden que los controles de entrada.
Algunos parámetros como el tipo de estructura organizativa son las búsquedas dependientes en Jaspersoft. Cuando se selecciona un tipo de estructura organizativa, también se muestra una unidad OBS. En PPM, puede utilizar la exploración de la estructura organizativa para filtrar según una unidad OBS. No es necesario crear un parámetro para una búsqueda dependiente.
También se puede omitir la asignación de los parámetros para los controles de entrada de rellenar. Estos controles de entrada aparecen en el informe en Jaspersoft como casillas de verificación por motivos de rendimiento. Por ejemplo, el control de entrada "populateProject" aparece para el informe KPIs by Project Type. Al activar el control de entrada, el informe se rellena previamente con los proyectos.
Ejemplo:
La siguiente imagen muestra cómo las etiquetas de los parámetros en PPM se asignan a los controles de entrada de Jaspersoft para el informe KPIs by Project Type. No hay ninguna asignación de parámetro para el control de entrada projectOBSTypekey_1 debido a que es una búsqueda dependiente. Además, se omiten los controles de entrada de rellenar.
input_controls_JS.PNG
Requisito previo
Al asociar un parámetro a un tipo de campo que es una búsqueda, compruebe que existe el atributo de búsqueda en PPM. La búsqueda en PPM debe reflejar el comportamiento del control de entrada de Jaspersoft ya que ambos se utilizan para el mismo parámetro.
Siga estos pasos:
  1. Haga clic en
    Parámetros
    ,
    Nuevo
    .
  2. Introduzca la siguiente información:
    • Etiqueta del parámetro
      Define la etiqueta del parámetro que los usuarios ven cuando ejecutan el informe. Compruebe que la etiqueta se corresponde al control de entrada en Jaspersoft. Por ejemplo, para el informe KPIs by Project Type, el parámetro Tipo de proyecto se corresponde a la etiqueta Tipo de proyecto en Jaspersoft.
    • Código del vínculo del parámetro
      Vincula el parámetro con el control de entrada. El campo determina cómo el parámetro de PPM se transfiere como control de entrada a Jaspersoft. El código del parámetro de vínculo para un parámetro debe coincidir exactamente con el ID de control de entrada. Por ejemplo, para el informe KPIs by Project Type, el código del parámetro de vínculo para el parámetro Tipo de proyecto es projectTypeKey_1.
    • Tipo
      Especifica el tipo de campo del parámetro que los usuarios ven cuando seleccionan parámetros para ejecutar el trabajo. El tipo debe coincidir con el tipo de datos para el informe de Jaspersoft.
      Valores
      :
      • Texto
        : Muestra un campo de texto.
      • Casilla de verificación
        : Muestra valores booleanos (true o false).
      • Menú desplegable
        : Muestra una lista de valores que los usuarios pueden seleccionar en un menú desplegable. Si selecciona este tipo, seleccione también las siguientes opciones:
        • Estilo de búsqueda
          . Seleccione Selección única o Selección múltiple según qué estilo se selecciona para el control de entrada correspondiente en Jaspersoft.
        • Menú desplegable
          . Busque y seleccione una búsqueda para mostrarla para el campo.
      • Examinar
        : Muestra una larga lista de valores que los usuarios pueden examinar. Los usuarios hacen clic el icono Explorar icono para seleccionar un único valor en la búsqueda que aparece. Si selecciona este tipo, seleccione también las siguientes opciones:
        • Estilo de búsqueda
          . Seleccione Selección única o Selección múltiple según qué estilo se selecciona para el control de entrada correspondiente en Jaspersoft.
        • Explorar
          . Busque y seleccione una búsqueda para mostrarla para el campo.
      • Fecha
        : Muestra parámetros de fecha. Los usuarios pueden introducir una fecha o seleccionar una fecha en un calendario.
      • Fecha relativa
        : Muestra un campo que permite a los usuarios seleccionar una fecha relativa al día en que se ejecuta el informe. Las fechas relativas están en una lista desplegable de períodos del calendario.
      • Período de tiempo
        : Muestra un campo desde el cual los usuarios puedan seleccionar un período de tiempo relativo al día en que se ejecuta el trabajo. La lista desplegable proporciona períodos definidos por el sistema.
    • Predeterminado
      Especifica un valor predeterminado para el parámetro. Proporciona un valor predeterminado
      solo
      si un valor predeterminado está disponible para el control de entrada correspondiente en Jaspersoft.
      En PPM, si no se especifica un valor predeterminado, no aparecerá ningún valor predeterminado para el parámetro de informe. En Jaspersoft, el primer valor en una lista de valores siempre está seleccionado y aparece como valor predeterminado. Esto ocurre incluso si no se ha definido ningún valor predeterminado para el control de entrada.
  3. Especifique si el parámetro requiere un valor y si es de solo lectura.
  4. Después de crear y guardar todos los parámetros del informe, haga clic en
    Guardar y volver
    .
  5. Seleccione
    Orden de los parámetros
    . Especifique el orden en el que se mostrarán los parámetros en el informe. Siga el mismo orden que el de los controles de entrada en el informe de Jaspersoft.
  6. Haga clic en
    Guardar y continuar
    .
Definición de la incompatibilidad del informe
Debe especificar si el informe no es compatible para ejecutarse simultáneamente con otros informes o trabajos. Especifique también si no se pueden ejecutar simultáneamente varias instancias del mismo informe.
Siga estos pasos:
  1. Haga clic en
    Trabajos incompatibles
    .
  2. Seleccione
    Informe
    en
    Tipo de ejecutable
    .
  3. Agregue la siguiente información para la definición del informe según corresponda:
    1. Cualquier informe o trabajo que no se pueda ejecutar simultáneamente con el informe.
    2. Otra instancia del mismo informe.
  4. Haga clic en
    Volver
    cuando haya terminado.
Asociación de una categoría de informe
Puede asociar la definición del informe a las categorías existentes para ayudar con el filtrado. Verifique que las categorías coinciden con las que estén asociadas con el informe de Jaspersoft. Por ejemplo, el informe KPIs by Project Type está asociado con la categoría Gestión de proyectos. Para obtener más información, consulte
Asociación de definiciones de informe o trabajo con categorías
.
Definición del acceso a los informes
Como requisito previo, ya debe haber configurado los usuarios del informe en PPM con los derechos de acceso necesarios de la Generación de informes avanzada. Los derechos de acceso se asignan a los roles correspondientes de Jaspersoft. Consulte
Derechos de acceso de la Generación de informes avanzada
. Especifique los usuarios, grupos o unidades OBS que pueden acceder y ejecutar el informe, así como el tipo de acceso que tienen.
Por ejemplo, los siguientes grupos de acceso de PPM pueden acceder al informe KPIs by Project Type:
  • Generación de informes avanzada de PMO: Gestión de proyectos
  • Generación de informes avanzada de PMO: Todos los informes y dominios
Estos grupos de acceso se asignan al rol CSK_ROLE_PROJECT_MANAGEMENT en Jaspersoft.
Siga estos pasos:
  1. Haga clic en
    Acceso a este informe
    .
  2. Agregue los recursos, grupos o unidades OBS para proporcionarles acceso de edición, visualización o ejecución al informe.
  3. Haga clic en
    Volver
    cuando haya terminado.
Consulte
Jobs Reference
y la descripción del trabajo
Sincronizar roles de Jaspersoft
para obtener detalles sobre cómo se sincronizan los roles.
Creación de un trabajo
El software incluye una lista de trabajos de stock. Si los trabajos que se incluyen no cumplen los requisitos, puede crear nuevos trabajos. Para obtener una lista de los derechos de acceso necesarios para administrar trabajos (derechos de acceso de trabajos), consulte la
referencia de los derechos de acceso
.
Con experiencia de programación escribiendo consultas, declaraciones, procedimientos y clases Java, se pueden crear nuevos trabajos.
Siga estos pasos:
  1. Seleccione el método más adecuado para el trabajo que va a crear.
  2. Escriba las consultas, las declaraciones o los procedimientos para el nuevo trabajo utilizando Java y SQL.
  3. Implemente el archivo ejecutable.
  4. Cree una definición de trabajo haciendo referencia al tipo de ejecutable y al nombre del método.
Para activar el programador de fondo para limpiar todos los trabajos de procesamiento en el inicio, configure el atributo isPrimary en el elemento jobSchedulerInstance de properties.xml como verdadero. Establecer este atributo como verdadero es útil cuando el servidor de fondo se cierra y se reinicia mientras está ejecutando un trabajo.
Directrices para procedimientos almacenados en SQL
Al crear un trabajo mediante procedimientos almacenados en SQL, deberá pasar los parámetros P_JOB_RUN_ID y P_JOB_USER_ID. El orden de los parámetros para los procedimientos almacenados en SQL es importante en SQL Server y Oracle. Lea y siga estas recomendaciones al escribir un procedimiento almacenado para SQL server y Oracle:
Recomendaciones de SQL Server
El procedimiento almacenado se debe iniciar así:
CREATE PROCEDURE OR REPLACE PROCEDURE <my new job> ( @P_JOB_RUN_ID NUMERIC, @P_JOB_USER_ID NUMERIC, )
Recomendaciones de Oracle
El procedimiento almacenado se debe iniciar así:
CREATE OR REPLACE PROCEDURE <my new job> ( P_JOB_RUN_ID IN NUMBER, P_JOB_USER_ID IN NUMBER, ) AS <procedure body>
Otros parámetros se pasan en el orden en que aparecen en las páginas de parámetros de la definición de trabajo.
Directrices de Java
Si selecciona Java como el tipo ejecutable, realice los pasos siguientes para crear las clases Java, implementarlas y registrarlas.
Siga estos pasos:
  1. Cree una clase Java que realice el procesamiento de fondo.
    Esta clase debe implementar la interfaz com.niku.union.interfaces.SchedulerListener. Usted solamente implementa el método scheduledEventFired() de esta interfaz.
  2. Implemente la clase Java usando el método scheduledEventFired() de la siguiente interfaz: com.niku.union.interfaces.SchedulerListener
  3. Compile la clase Java. Verifique que el compilador CLASSPATH conozca lo siguiente: $NIKU_HOME/lib/union.jar
    Consulte los sitios web de Oracle para obtener más información sobre cómo crear un archivo JAR. Por ejemplo, el siguiente comando JAR crea un archivo JAR a partir de una clase Java, jar cf myBackgroundJob.jar myBackgroundJob.class.
  4. Implemente la clase ubicando el ejecutable (por ejemplo, myBackgroundJob.class) en el directorio $NIKU_HOME/customlib.
  5. Registre este trabajo creando una definición de trabajo. Para el nombre del ejecutable, especifique una de las siguientes opciones:
    • Nombre de clase válido. Por ejemplo, myBackgroundJob.
    • El nombre de clase totalmente cualificado si esta clase forma parte de un paquete. Por ejemplo, com.myserver.jobs.background.myBackgroundJob.
Trabajos de fondo de clase Java (código de muestra)
import com.niku.union.interfaces.JobSchedulerContext; import com.niku.union.interfaces.SchedulerListener; /** * Kicks off a background process. * This class is primarily used by the Job Scheduler. * @author Ken Chen */ public class myBackgroundJob implements SchedulerListener { /** * Constructor for the myBackgroundJob object */ public myBackgroundJob() { } /** * Kicks off the background processing. * * @param jobContext_ Contains information required by job. * @exception Exception */ public void scheduledEventFired(JobSchedulerContext jobContext_) throws Exception { /** * The JobSchedulerContext parameter contains the Job definition ( * jobContext_.getJob() ) and the Job definition contains the value of the * OutputPath parameter. * * String outputPath = jobContext_.getJob().getRunOutputPath(); * File f = new File(outputPath, "myoutput.txt"); */ if(jobContext_ == null) { throw new Exception("Invalid JobContext"); } try { doSomeWork(); } catch (Exception e) { throw new Exception("Cannot doSomeWork()::" + e); } } private void doSomeWork(JobSchedulerContext jobContext_) throws Exception { } // Write your background processing logic here. // One important and useful thing you can get out of // jobContext_ is the SecurityIdentifier. // SecurityIdentifier gives you handle to current user // information under which job is executed. // The user who often schedules the job. // is "scheduler". String userName = jobContext_.getSecurityIdentifier().getUsername(); // // userName = "scheduler" // String sessionId = jobContext_.getSecurityIdentifier().getSessionId(); // // sessionId is the unique identifier for the job. // Every time job is invoked, sessionId is different. // ...job does its work. }
Actualización de las inversiones creadas antes de la versión 13.2 de
Clarity PPM
para mostrar los gastos capital y operativos
Si dispone de las inversiones que se crearon antes de la versión 13.2, puede actualizar las inversiones para mostrar los gastos operativos y de capital. Para actualizar las inversiones, ejecute los trabajos siguientes en este orden:
  • Activar la capitalización
  • Copiar Plan de costes del Código de cargo del registro con el Tipo de coste
Si se están procesando inversiones con cantidades grandes de datos, se limita el número de inversiones para una ejecución de trabajo. Cuando todas las inversiones se hayan procesado correctamente para mostrar los gastos operativos y de capital, se recomienda que se desactiven los trabajos. Las estadísticas de una ejecución de un trabajo se imprimen en un archivo de registro BG para el trabajo. Se puede abrir y leer el archivo de registro. El archivo de registro contiene información como el número de inversiones que se han procesado, omitido o que han dado error.
Para obtener más información sobre los trabajos, consulte la
Referencia a los trabajos
.