Conexiones de Clarity: Integraciones de Rally

ccppmop1592
Las organizaciones pueden utilizar la nueva y mejorada integración de Rally con
Clarity
para garantizar que los datos fluyan de forma fluida entre las dos aplicaciones.
La nueva y mejorada integración de Rally con
Clarity
tiene las siguientes características:
  • Ampliable y configurable fácilmente: Se pueden asignar objetos y atributos entre
    Clarity
    y Rally para garantizar que la integración cumpla con los requisitos específicos del usuario.
  • Fácil de mantener: Los administradores de
    Clarity
    que tienen un conocimiento básico de la versión clásica de PPM pueden configurar y mantener la integración.
  • Validada y admitida por Broadcom: No es necesario realizar pruebas de regresión después de cada versión.
A continuación se revisan algunos pasos clave que se deben realizar para aprovechar esta integración.
Linked
  1. Complete los requisitos previos pertinentes para configurar la integración.
  2. Cree un objeto de integración para integrar
    Clarity
    con una instancia específica de Rally.
  3. Cree una asignación de integración.
  4. Ejecute el trabajo de importación de la asignación de integración para recuperar todos los objetos de tipo de elemento de la cartera de Rally y sus atributos asociados.
  5. Defina las asignaciones de objetos válidas.
  6. Defina las asignaciones de campos válidas.
  7. Especifique una inversión de
    Clarity
    que se asignará a un objeto de Rally.
  8. Ejecute el trabajo de información asignada sincronizada para sincronizar los datos entre
    Clarity
    y Rally.
  9. Revise la tabla de almacenamiento intermedio de
    Clarity
    para entender los cambios que se deben enviar de Rally a
    Clarity
    .
Revise cada uno de estos pasos detalladamente.
2
Requisitos previos para la integración
Se deben completar los siguientes pasos antes de configurar la nueva integración de
Clarity
con Rally.
  1. Asigne el derecho de acceso Asignación de la integración - Ir a a los administradores que configurarán la integración de
    Clarity
    con Rally. Los usuarios con el derecho de acceso Asignación de la integración - Ir a pueden ver y acceder al mosaico Integraciones (Beta) en la página Administración. Para obtener más información sobre este derecho de acceso, consulte la documentación sobre los derechos de acceso.
  2. Asegúrese de que está instalada la última versión del complemento de contenido del Acelerador de PMO. Con la última versión del Acelerador de PMO instalada,
    Clarity
    incluirá los atributos ID del objeto de Rally y Asignación de la integración para la configuración en Proyectos, Ideas e Inversiones personalizadas.
Creación de un objeto de integración en la versión clásica de PPM
Se puede configurar la nueva integración de
Clarity
con Rally mediante la creación de un objeto de integración. Se crea un objeto de integración en la página Integraciones de la versión clásica de PPM, que es el sistema de ventanilla única para definir y mantener toda la información de la integración.
Linked
Las partes clave de la información que necesita para crear un objeto de integración son las siguientes:
  • URL de integración
  • Instancia de la integración
  • Clave de la API de integración
  • Puerto proxy
Siga estos pasos:
  1. Inicie sesión en Versión clásica de PPM.
  2. Haga clic en
    Administración
    ,
    Valores de configuración generales
    ,
    Integraciones
    .
  3. Haga clic en
    Nuevo
    .
  4. Rellene los campos siguientes y haga clic en
    Guardar
    .
Nombre de campo
Descripción
Áreas
La aplicación de software o el área de negocio del distribuidor (por ejemplo, Agile).
Distribuidor
El nombre de la compañía con la que
Clarity
se está integrando (por ejemplo, Rally).
Suministrador
El nombre de la compañía que está implementando la integración (por ejemplo, Broadcom).
URL de integración
La dirección URL para la instancia de integración (por ejemplo, la dirección URL de la instancia de Rally).
Clave de la API de integración
La clave que se utiliza para acceder y recuperar los datos de Rally.
Instancia de la integración
El ID de espacio de trabajo de Rally.
Creación de una asignación de la integración en
Clarity
Después de crear un objeto de integración, cree una asignación de la integración.
Linked
Siga estos pasos:
  1. Inicie sesión en
    Clarity
    .
  2. Haga clic en
    Administración
    y seleccione la ficha
    Integraciones (Beta)
    para abrir la página Integraciones.
  3. Haga clic en Agregar fila e introduzca el nombre de la asignación de la integración.
    En esta versión, no se pueden usar los caracteres especiales al especificar el nombre de la asignación de la integración. Si usa un carácter especial como "&", el trabajo de sincronización de la información asignada se completará con un error y se producirá un error en el trabajo de importación de tablas del almacenamiento intermedio.
  4. En la columna Integración, seleccione el objeto de integración correspondiente.
  5. La asignación de la integración ahora está disponible.
Ejecución del trabajo de importación de la asignación de la integración en la versión clásica de PPM
El trabajo de importación de la asignación de la integración en la versión clásica de PPM permite a
Clarity
recuperar los objetos de tipo de elemento de la cartera y los atributos compatibles del espacio de trabajo de Rally configurado. Una vez importados, los objetos y los campos estarán disponibles en la ficha Objetos de Rally en
Clarity
.
Siga estos pasos:
  1. Inicie sesión en
    Clarity
    .
  2. Haga clic en
    Página principal
    ,
    Informes y trabajos
    ,
    Trabajos
    para abrir la ficha Trabajos.
  3. Asegúrese de que ha seleccionado
    Trabajos disponibles
    en la lista desplegable y abra el trabajo
    Importar asignaciones de la integración
    .
  4. Seleccione la asignación de la integración pertinente y haga clic en
    Enviar
    para ejecutar la integración de forma inmediata. También puede programar este trabajo para que se ejecute en una fecha posterior.
Después de ejecutar correctamente el trabajo, realice los siguientes pasos para ver los distintos objetos de tipo de elemento de la cartera de Rally.
Linked
  1. Inicie sesión en
    Clarity
    .
  2. Haga clic en Administración y seleccione la ficha
    Integraciones (Beta)
    para abrir la página Integraciones.
  3. Abra la asignación de la integración correspondiente y seleccione Objetos de Rally para ver los distintos objetos importados desde Rally.
Definición de asignaciones de objetos en
Clarity
Linked
Se pueden asignar inversiones seleccionadas de
Clarity
(Proyectos, Ideas e Inversiones personalizadas) a los elementos de la cartera de Rally seleccionados.
Por ejemplo, una organización ha finalizado su estrategia y ha utilizado inversiones personalizadas en
Clarity
para crear Temas, Épicas de negocio y Resultados del negocio. Estas inversiones se pueden asignar a los temas, las épicas y las capacidades de Rally. Si la organización ha creado proyectos individuales en
Clarity
, también se pueden asignar a un tipo de elemento de la cartera relevante como un proyecto en Rally.
Siga estos pasos:
  1. Inicie sesión en
    Clarity
    .
  2. Haga clic en
    Administración
    y seleccione la ficha
    Integraciones (Beta)
    para abrir la página Integraciones.
  3. Abra la asignación de la integración pertinente y vaya a la ficha
    Asignaciones de objetos
    .
  4. Haga clic en el icono Agregar fila e introduzca los detalles siguientes:
    1. Nombre: Proporcione el nombre de la asignación del objeto.
    2. Objeto de Rally: Seleccione el objeto de Rally que desee asignar a la inversión de
      Clarity
      .
    3. Dirección: Seleccione
      Clarity
      a Rally. En esta versión, la integración permite crear y actualizar una instancia de un tipo de elemento de la cartera en Rally, asociado con una inversión en
      Clarity
      . Esto significa que se creará una función en Rally asociada con una inversión en
      Clarity
      . Sin embargo, si se crea una función o cualquier otra instancia del tipo de elemento de la cartera en Rally, la integración no permitirá crear una inversión en
      Clarity
      .
Después de definir la asignación de objetos, ya está listo para asignar los campos de
Clarity
y Rally. La asignación de campos ayuda a gestionar cómo se intercambiarán los datos entre
Clarity
y Rally.
Definición de las asignaciones de objetos en
Clarity
Linked
Las asignaciones de campos definidas especifican cómo se intercambian los datos entre las inversiones y campos de
Clarity
y los campos o elementos de la cartera de Rally. Las asignaciones de campos se asocian siempre con una asignación de objetos. Tenga en cuenta las siguientes técnicas de asignación de campos y objetos:
  • Revise la tabla de compatibilidad del tipo de datos para asegurarse de que está asignando tipos de campos admitidos.
    • La tabla está disponible en la ficha Compatibilidad de tipo de datos y se puede acceder a esta tabla desde la página Integraciones.
      Linked
  • Especifique la dirección del flujo de datos cuando defina la asignación. Se puede definir una asignación donde los datos fluyen de un campo de
    Clarity
    a un campo de Rally.
    • También se puede definir una asignación donde los datos fluyen de un campo de Rally a un campo en
      Clarity
      .
    • Sin embargo, en esta versión, no se admite la integración bidireccional.
    • Esto significa que si se ha creado una asignación para actualizar la fecha de inicio planificada en Rally con el campo Inicio en
      Clarity
      , no se puede configurar otra asignación para actualizar el campo Inicio de
      Clarity
      si se actualiza la fecha de inicio planificada en Rally.
    • Además, no se puede incluir el mismo campo en varias asignaciones.
  • Seleccione la opción de sincronización pertinente.
Siga estos pasos:
  1. Inicie sesión en
    Clarity
    .
  2. Haga clic en
    Administración
    y seleccione la ficha
    Integraciones (Beta)
    para abrir la página Integraciones.
  3. Abra la asignación de la integración pertinente y vaya a la ficha Asignaciones de objetos.
  4. Seleccione la asignación de objetos pertinente, haga clic en
    DETALLES
    y seleccione la ficha
    Asignaciones de campos
    .
  5. Haga clic en Expandir para abrir la ventana
    Asignaciones de campos
    .
  6. Especifique los detalles siguientes:
    1. Dirección: Seleccione
      Clarity
      a Rally o Rally a
      Clarity
      en función de los requisitos.
    2. Campo de
      Clarity
      : Seleccione el campo de
      Clarity
      relevante. Este campo se asocia con la inversión identificada durante la asignación de objetos.
    3. Campo de Rally: Seleccione el campo de Rally que se asignará al campo de
      Clarity
      . Asegúrese de seguir las instrucciones de compatibilidad del tipo de datos mientras se asignan los campos.
    4. Opción de sincronización: Seleccione una de las opciones Crear, Actualizar, Crear y Actualizar. Para obtener más información sobre estas opciones, consulte Ejecución del trabajo de sincronización de la información asignada.
  7. Cuando
    Clarity
    valida la asignación de campos, las columnas Tipo de datos se rellenan y se guardan.
  8. Verá un mensaje de error si se produce lo siguiente:
    1. Los campos que se están asignando no son compatibles.
    2. Cualquiera de los campos tiene una asignación existente.
Selección de inversiones de
Clarity
para sincronizarlas con Rally
Ahora que se ha configurado la integración y se han definido las asignaciones pertinentes, se puede seleccionar qué inversiones específicas de
Clarity
se sincronizarán con Rally. En esta versión, se pueden seleccionar proyectos, inversiones personalizadas e ideas específicos de
Clarity
para sincronizar con Rally.
Siga estos pasos:
  1. Inicie sesión en
    Clarity
    .
  2. Vaya a la página de la inversión pertinente y seleccione el diseño de cuadrícula.
  3. Utilice el selector de columna para agregar los atributos Objeto de Rally y Asignación de la integración a la cuadrícula.
  4. Seleccione la asignación de la integración relevante que desea asociar con la inversión.
Después de ejecutar el trabajo de información asignada sincronizada para sincronizar los datos entre
Clarity
y Rally correctamente, el campo Objeto de Rally se rellenará automáticamente.
Ejecución del trabajo de sincronizar la información asignada
El trabajo de sincronizar la información asignada en la versión clásica de PPM permite a los administradores sincronizar la información asignada entre
Clarity
y Rally. Según la dirección configurada y la opción de sincronización, el trabajo puede realizar las operaciones siguientes:
Dirección
Opción de sincronización
Comportamiento esperado
Clarity
a Rally
Crear
Si el objeto asignado no existe en Rally, este trabajo:
  1. Crea y rellena objetos y campos de Rally asignados.
  2. Rellena las tablas de almacenamiento intermedio de
    Clarity
    .
  3. Actualiza las tablas de objetos (y campos) de Rally en
    Clarity
    .
Clarity
a Rally
Crear y actualizar
Si el objeto asignado no existe en Rally, este trabajo:
  1. Crea y rellena objetos y campos de Rally asignados.
  2. Rellena las tablas de almacenamiento intermedio de
    Clarity
    .
  3. Actualiza las tablas de objetos (y campos) de Rally en
    Clarity
    .
En ejecuciones posteriores, este trabajo:
  1. Actualiza objetos y campos de Rally asignados.
  2. Rellena las tablas de almacenamiento intermedio de
    Clarity
    .
  3. Actualiza las tablas de objetos (y campos) de Rally en
    Clarity
    .
Clarity
a Rally
Actualizar
Si el objeto asignado existe en Rally, este trabajo:
  1. Actualiza objetos y campos de Rally asignados.
  2. Rellena las tablas de almacenamiento intermedio de
    Clarity
    .
  3. Actualiza las tablas de objetos (y campos) de Rally en
    Clarity
    .
Rally a
Clarity
Crear
No se admite.
Rally a
Clarity
Crear y actualizar
No se admite.
Rally a
Clarity
Actualizar
Si el objeto asignado existe en
Clarity
, este trabajo:
  1. Actualiza objetos y campos de
    Clarity
    asignados.
  2. Rellena las tablas de almacenamiento intermedio de
    Clarity
    .
  3. Actualiza las tablas de objetos (y campos) de Rally en
    Clarity
    .
Siga estos pasos:
  1. Inicie sesión en
    Clarity
    .
  2. Haga clic en
    Página principal
    ,
    Informes y trabajos
    ,
    Trabajos
    para abrir la ficha Trabajos.
  3. Asegúrese de que se han seleccionado Trabajos disponibles en la lista desplegable y abra el trabajo
    Sincronizar información asignada
    .
  4. Seleccione la asignación de la integración pertinente y haga clic en Enviar para ejecutar la integración de forma inmediata.
Después de ejecutar este trabajo correctamente,
Clarity
ejecuta automáticamente el trabajo de importación de tablas de almacenamiento intermedio para mover los datos desde la tabla de almacenamiento intermedio a
Clarity
.
Se puede programar la sincronización de la información asignada para que se ejecute en intervalos regulares. Sin embargo, si se activa manualmente el trabajo de sincronización de la información asignada, los trabajos programados no se ejecutarán simultáneamente.
Revisión de la tabla de almacenamiento intermedio en
Clarity
Linked
Cada asignación de la integración tiene una tabla de almacenamiento intermedio asociada en
Clarity
. Solo pueden acceder a la tabla de almacenamiento intermedio los miembros del grupo de administración del sistema de PMO. Si desea proporcionar manualmente acceso a la tabla de almacenamiento intermedio, puede utilizar la asignación de los siguientes derechos de acceso a un usuario o grupo:
  • <Nombre de la asignación de la integración> - Crear
  • <Nombre de la asignación de la integración> - Suprimir todo
  • <Nombre de la asignación de la integración> - Editar todo
  • <Nombre de la asignación de la integración> - Ver todo
  • <Nombre de la asignación de la integración> - Acceso de XOG
En esta versión, puede usar la tabla de almacenamiento intermedio para:
  • Revisar todos los datos que se copian de Rally a
    Clarity
    después de que se haya ejecutado correctamente el trabajo de sincronización de la información de la asignación.
  • Revisar los mensajes de error en caso de que se produzca un error en la sincronización de datos.
Siga estos pasos:
  1. Inicie sesión en
    Clarity
    .
  2. Haga clic en Administración y seleccione la ficha Integraciones (Beta) para abrir la página Integraciones.
  3. Abra la asignación de la integración pertinente y vaya a la ficha Tabla de almacenamiento intermedio. Únicamente se mostrarán los registros de esta tabla si se dispone de los derechos de acceso correspondientes.
  4. Agregue las columnas pertinentes al diseño de cuadrícula para revisar el estado de los registros que se han procesado. A continuación se muestran algunas de las columnas clave que se pueden agregar:
    1. ID de ejecución del trabajo
    2. Estado
    3. Clarity
      Objeto
    4. Nombre del objeto de
      Clarity
    5. Objeto de Rally
    6. Objeto de Rally
    7. Nombre
    8. Mensaje de error
Puntos clave que hay que recordar
:
  • La tabla de almacenamiento intermedio no muestra datos de salida de
    Clarity
    a Rally.
  • Los datos de la tabla de almacenamiento intermedio se eliminan de
    Clarity
    cada vez que se ejecuta el trabajo de sincronización de la información asignada.
  • Después de ejecutar el trabajo de sincronización de la información asignada, se otorgará automáticamente al usuario acceso a las tablas de almacenamiento intermedio.
  • Los derechos de acceso globales de la asignación de la integración (ver, editar y suprimir) se agregan automáticamente al grupo de administradores del sistema de PMO. Este proceso back-end permite el acceso a las tablas de almacenamiento intermedio.
Flujo de sincronización de los datos para la integración de Rally
Cuando se ejecuta el trabajo de sincronización de la información asignada después de configurar la integración de Rally, compruebe las inversiones asociadas de
Clarity
para ver si se actualiza el campo Objeto de Rally.
  • El campo Objeto de Rally está vacío antes de que
    Clarity
    cree un nuevo elemento de la cartera de Rally. Cuando se ejecuta el trabajo de sincronización, se actualiza el campo Objeto de Rally para la inversión correspondiente en
    Clarity
    . La próxima vez que se ejecute el trabajo,
    Clarity
    actualizará los campos pertinentes en Rally (asignación de
    Clarity
    a Rally). El trabajo también actualiza la tabla de almacenamiento intermedio y los campos de
    Clarity
    (asignación de Rally a
    Clarity
    ).
  • Si el campo Objeto de Rally no está vacío,
    Clarity
    actualiza directamente los campos importantes en Rally (asignación de
    Clarity
    a Rally). El trabajo también actualiza la tabla de almacenamiento intermedio y los campos de
    Clarity
    (asignación de Rally a
    Clarity
    ).
Puntos clave a tener en cuenta al aprovechar la integración
  • Siempre que un campo de
    Clarity
    se actualice con el valor de un campo de Rally asignado, el usuario que ejecuta el trabajo de la información asignada sincronizada se muestra en el registro de auditoría.
  • Los clientes pueden seguir utilizando tanto la nueva integración de Rally como las integraciones de la hoja de tiempo (
    Clarity
    ), inversiones y jerarquía de elementos de la cartera de Rally si están garantizadas.
    • Si un cliente ha configurado una integración con Agile, esta integración existente no se verá afectada después de la actualización.
    • Los nuevos trabajos (por ejemplo, importación de asignaciones de la integración, sincronización de la información asignada e importación de las tablas de almacenamiento intermedio) no son compatibles con los trabajos anteriores (por ejemplo, sincronización de Agile Central y creación de inversiones de Agile Central) para evitar que se ejecuten simultáneamente.
  • Si el trabajo de importación de la asignación de la integración no se ejecuta después de crear una nueva instancia de Asignaciones de la integración, los objetos de
    Clarity
    y Rally no estarán disponibles en sus respectivos menús desplegables.
    • Si se crean nuevos atributos personalizados (en
      Clarity
      o en Rally), se debe ejecutar el trabajo de importación de la asignación de la integración para asegurarse de que están disponibles en la cuadrícula de asignación de campos.
  • Campos de Rally que no se actualizan
    • Si un campo en cualquier sistema está regido por la lógica de negocios, no se admite el uso de ese sistema como destino
      Linked
  • El trabajo de sincronización de la información asignada solo devuelve cambios
    • La primera vez que se ejecuta el trabajo de sincronización de la información asignada,
      Clarity
      y Rally se sincronizarán.
    • Después de la ejecución del trabajo, un usuario de
      Clarity
      actualiza el campo % completado (que se origina en Rally).
    • Desde la perspectiva del rendimiento, la próxima vez que se ejecute el trabajo de sincronización de la información asignada, puesto que no se ha realizado ningún cambio en Rally, el sistema no actualizará el campo % completado de
      Clarity
      y ahora
      Clarity
      y Rally ya no estarán sincronizados.
    • El campo % completado de
      Clarity
      se sincronizará solamente cuando el elemento de la cartera asignado se actualice en Rally
    • Hasta ese momento, estos campos asignados continuarán sin sincronizarse.
  • Se puede aprovechar el registro de trabajos para solucionar los problemas del intercambio de datos de
    Clarity
    y Rally.
    Linked