Conexiones Globales¶

Introducción¶

La página Conexiones globales es donde administra las conexiones que se pueden usar en todos los proyectos en un ambiente. Cada ambiente se puede configurar con una configuración única de la conexión global que puede ser utilizada por cualquier proyecto en ese ambiente.

Desde la página Conexiones globales, puedes ver, crear, editar, y eliminar conexiones globales dependiendo de los niveles de acceso al ambiente concedido a su rol. Una vez que se agrega una conexión global a un ambiente, se vuelve visible para los usuarios en la paleta de componentes de diseño para usar en un proyecto.

Acceda a la Página de Conexiones Globales¶

Se puede acceder a la página Conexiones globales desde el menú de Harmony Portal o desde la paleta de componentes de diseño:

• Utilice el menú del Portal Harmony para seleccionar Cloud Studio > Conexiones globales:

  

• En la paleta de componentes de diseño pestaña Conexiones globales, haga clic en Administrar conexiones globales:

  

Tabla de Conexiones Globales¶

Las conexiones globales existentes se muestran en la tabla Conexiones globales dentro de la pestaña Conexiones:

Estos controles están ubicados en la parte superior derecha de la tabla:

• Buscar conexiones: Haga clic en el ícono de búsqueda para expandir un cuadro de búsqueda. Ingrese cualquier parte del nombre, tipo o descripción de la conexión global en el cuadro de búsqueda para filtrar las conexiones.

• Agregar nueva conexión: Haga clic en el ícono Agregar para abrir la configuración de conexión global pantalla para una nueva conexión.

• Actualizar: Haga clic en el icono de actualización para recargar la tabla.

La tabla incluye estas columnas:

• Nombre: El nombre de la conexión global proporcionada en la configuración.

• Tipo: El conector que utiliza la conexión global.

• Descripción: La descripción proporcionada en la configuración de conexión global.

• Ambientes: Los ambientes a los que se agrega la conexión global, según lo configurado en la configuración.

  Cuando la configuración de una conexión global utilizada por una operación implementada es editada y cualquier operación que utilice la conexión global editada en ese ambiente aún no se ha vuelto a desplegar, se muestra un ícono azul No implementado en la parte superior de la píldora del ambiente:

  

  Además, se puede hacer clic en cada ambiente para abrir un cajón de ambiente en la parte inferior de la página que proporciona información adicional y acciones que puede realizar, como desplegar cambios, abrir el proyecto u operación en Cloud Studio o eliminar la conexión.

• Creado: La fecha y hora del navegador local en que se creó la conexión global y el nombre de usuario del usuario que la creó.

• Modificado: La fecha y hora del navegador local en que se modificó por última vez la conexión global y el nombre de usuario del usuario que la modificó por última vez.

• Acciones: Pase el cursor sobre la fila de conexión global para mostrar las acciones disponibles para la conexión:

  • Editar conexión: Haga clic en el ícono de edición para abrir la configuración de conexión global pantalla para una conexión existente.

  • Eliminar conexión: Haga clic en el icono de eliminar para eliminar una conexión global que no se utiliza en ningún proyecto. Para obtener información adicional, consulte Eliminar una conexión global más adelante en esta página.

Cajón Ambiental¶

El cajón de ambiente se abre desde la parte inferior de la página cuando hace clic en un ambiente en la tabla Conexiones globales:

Se muestran pestañas en la parte superior del cajón para cada ambiente donde se ha agregado la conexión global.

Un ícono circular azul No implementado se muestra en una pestaña de ambiente cuando la conexión global de la que dependen las operaciones del proyecto ha tenido un cambio de configuración desde la última vez que se implementó la conexión global en este proyecto. Esto significa que debe volver a desplegar las operaciones que dependen de la conexión en este proyecto para utilizar la configuración más reciente de la conexión.

Puedes recorrer las pestañas usando las flechas izquierda y derecha .

Estos controles están ubicados en la parte superior derecha del cajón:

• Contraer: Haga clic en el icono Contraer para contraer el cajón del ambiente al final de la página de modo que solo la parte superior del cajón sea visible. Para restaurar el cajón a su estado anterior, haga clic en el ícono Regresar .

• Expandir: Haga clic en el ícono Expandir para expandir el cajón del ambiente hasta la parte superior de la página. Para restaurar el cajón a su estado anterior, haga clic en el ícono Regresar .

• Cerrar: Haga clic en el icono Cerrar para cerrar el cajón del ambiente.

Cada pestaña incluye esta información y estas acciones:

• Nombre: El icono y el nombre de la conexión global.

• Descripción: La descripción de la conexión global.

• Componentes en el ambiente: Se muestra una tabla para cada proyecto en el ambiente enumerado que tiene componentes que dependen de la conexión global:

  • Proyecto: El nombre del proyecto. La presencia de un icono de Cambios no implementados junto al nombre del proyecto indica que el proyecto contiene operaciones que dependen de la conexión global que han tenido otros cambios de configuración (como una actividad no relacionada o un etapa de operación de secuencia de comandos) que no aún no se ha implementado y también se desplegará cuando haga clic en el botón Desplegar para este proyecto.

  • Fecha de última modificación del proyecto: La fecha y hora en que se modificó el proyecto por última vez. La fecha y la hora son locales del proyecto y no se ven afectadas por modificaciones en las conexiones globales utilizadas por el proyecto.

  • Desplegar para este proyecto: Haga clic para desplegar operaciones que dependen de la conexión global en este proyecto únicamente. Después de la desplegar, la próxima vez que se ejecuten las operaciones de este proyecto, utilizarán la configuración de conexión global más reciente.

    Precaución

    Cualquier operación que se muestre con un icono de Cambios no implementados junto al nombre de la operación tienen otros cambios de configuración (como una actividad no relacionada o un etapa de operación de secuencia de comandos) que aún no se han implementado y también se desplegarán al hacer clic en este botón.

  • Ir al proyecto: Haga clic en el ícono de enlace para abrir el proyecto en Cloud Studio en una nueva pestaña.

  • Ocultar o mostrar proyecto: Haga clic en las flechas hacia arriba o hacia abajo para ocultar o mostrar la lista de operaciones que dependen de la conexión global del proyecto.

  • Operación: El nombre de cualquier operación que dependa de la conexión global. La presencia de un icono de Cambios no implementados junto al nombre de la operación indica que la operación ha tenido otros cambios de configuración (como una actividad no relacionada o un etapa de operación de secuencia de comandos) que aún no se han implementado y se también se desplegará al hacer clic en el botón Desplegar para este proyecto.

  • Componentes no utilizados en operaciones: El tipo y nombre de cualquier componente que exista fuera de los flujos de trabajo y que dependa de la conexión global. Estos componentes se enumeran únicamente con fines informativos; Si bien no afectan ninguna lógica implementada, su existencia en un proyecto le impedirá eliminar la conexión en este ambiente.

  • Acciones: Pasa el cursor sobre el ícono de enlace y haz clic en él para abrir el proyecto con la operación seleccionada en Cloud Studio en una nueva pestaña. Las acciones no son aplicables a componentes no utilizados en las operaciones.

• Desplegar para proyectos sin cambios: Haga clic para desplegar operaciones que dependen de la conexión global para proyectos en este ambiente donde los únicos cambios a desplegar son aquellos en la conexión global (excluye proyectos que tienen operaciones con Cambios no implementados). icono ). Después de la desplegar, la próxima vez que se ejecuten las operaciones de estos proyectos, utilizarán la configuración de conexión global más reciente.

• Desplegar para todos los proyectos: Haga clic para desplegar operaciones que dependen de la conexión global para todos los proyectos en este ambiente. Después de la desplegar, la próxima vez que se ejecuten las operaciones de estos proyectos, utilizarán la configuración de conexión global más reciente.

  Precaución

  Cualquier operación que se muestre con un icono de Cambios no implementados junto al nombre de la operación tienen otros cambios de configuración (como una actividad no relacionada o un etapa de operación de secuencia de comandos) que aún no se han implementado y también se desplegarán al hacer clic en este botón.

• Eliminar conexión: Haga clic para eliminar la conexión global del ambiente. Este botón se habilita solo después de la primera eliminación de componentes que hacen referencia a la conexión de todos los proyectos enumerados en la pestaña.

Crear una Conexión Global¶

Para crear una nueva conexión global, haga clic en el icono de agregar en la parte superior derecha de la tabla de Conexiones globales. Se abre la pantalla de configuración Nueva conexión global. Esta pantalla se describe a continuación.

Una conexión existente en un proyecto también se puede promover a una conexión global, que luego puedes editar una vez creada. Se puede acceder a la opción Promocionar a conexión global desde estas ubicaciones:

• La pestaña Conexiones de la paleta de componentes de diseño (consulte Paleta de Componentes de Diseño).
• La pestaña Componentes del panel del proyecto (consulte Menú de acciones de componentes en Pestaña Componentes del panel de proyecto).

La pantalla de configuración Nueva Conexión Global tiene dos pasos de configuración:

• Paso 1: Seleccione un conector
• Paso 2: Configurar y probar la conexión, y agregar o eliminar ambientes

Paso 1: Seleccione un Conector¶

En este paso, selecciona un conector desde donde crear una nueva conexión global:

• Buscar: Ingrese cualquier parte del nombre para mostrar del conector en el cuadro de búsqueda para filtrar los conectores.

• Conectores: Haga clic para seleccionar un conector desde el cual crear una nueva conexión global. Todos los conectores de la organización excepto API, SOAP y Variable se enumeran los conectores, incluidos conectores personalizados. Los conectores que solo se pueden usar en ambientes asociados con un Grupo de Agentes Privados se indican con un punto rojo .

• Atrás: El ícono de atrás está deshabilitado, ya que no es aplicable a este paso.

• Siguiente: Haga clic en el icono siguiente para almacenar temporalmente la configuración de este paso y continuar con el siguiente. La configuración no se guardará hasta que haga clic en el botón Finalizar en el último paso.

• Cancelar: Haga clic para cerrar la configuración de conexión global sin crear una nueva conexión.

• Finalizar: Este control está deshabilitado, ya que no es aplicable a este paso.

Paso 2: Configurar y Probar la Conexión y Agregar o Eliminar Ambientes¶

En este paso, configurará y probará la conexión global, y agregará o eliminará ambientes donde se puede utilizar la conexión global:

• Nombre: Introduzca un nombre que se utilizará para identificar la conexión global. El nombre debe ser único para cada conexión global de un conector en particular y no debe contener barras diagonales. / o dos puntos :. Este nombre también se utiliza para identificar el extremo del conector, que hace referencia tanto a una conexión específica como a sus actividades.

• Descripción: Introduzca una descripción de la conexión global que se mostrará en la tabla de Conexiones globales.

• Extremos del ambiente: En esta área, agrega ambientes uno a la vez y configura y prueba la conexión global en cada ambiente. Dentro de la configuración de cada ambiente, también puedes eliminar la conexión del ambiente.

  Consejo

  Agregar ambientes y configurar y probar información de conexión se puede realizar más adelante, lo que permite a un usuario crear conexiones y a otro usuario crear conexiones y agregarlas a ambientes más adelante.

  • Agregar un ambiente: Haga clic en el ícono Agregar para abrir un menú de los ambientes de la organización al que aún no se ha agregado la conexión global. Si el conector seleccionado en el paso 1 está disponible solo en Agentes Privados, los ambientes asociados con un Grupo de Agentes en Nube están atenuados y no se pueden seleccionar. Seleccione un ambiente a la vez desde el menú, usando el ícono de agregar para agregar ambientes adicionales según sea necesario.

  • Pestaña Ambiente: A medida que se agrega cada ambiente, se agrega una pestaña a la sección Ambientes que contiene la configuración de conexión global para ese ambiente.

    • Campos de configuración: Configure cada campo para el conector específico como se describe en la documentación para el conector específico seleccionado en el paso 1. La documentación para cada conector se encuentra en Conectores sección.

    • Estado de prueba de conexión: Los siguientes íconos se muestran en la pestaña de un ambiente cuando se cumplen ciertas condiciones. Los iconos no persisten después de cerrar la pantalla de configuración.

      • Cambios no probados: Cuando un ambiente tiene cambios en la configuración de conexión que no se han probado, su pestaña muestra un ícono Cambios no probados .
      • Conexión fallida: Cuando la conexión probada de un ambiente no tiene éxito, su pestaña muestra un icono de Error .
      • Conexión exitosa: Cuando la conexión probada de un ambiente es exitosa, su pestaña muestra un ícono Éxito .

    • Eliminar conexión: Haga clic para eliminar la conexión global del ambiente. (La eliminación de la conexión global se puede realizar desde la tabla Conexiones globales.)

    • Probar conexión: Haga clic para probar la conexión global usando la configuración proporcionada.

• Atrás: Haga clic en el ícono Atrás para almacenar temporalmente la configuración de este paso y volver al paso anterior.

• Siguiente: El siguiente icono está deshabilitado, ya que no es aplicable a este paso.

• Probar todas las conexiones: Haga clic para probar todos los extremos del ambiente en la conexión global. Después de hacer clic en Probar todas las conexiones, un cuadro de diálogo muestra una lista de los extremos del ambiente en la conexión global y su estado de conexión, ya sea con un icono de Éxito o un ícono de Error .

• Cancelar: Haga clic para cerrar la configuración de conexión global sin crear una nueva conexión.

• Finalizar: Haga clic para guardar la configuración de todos los pasos y cerrar la configuración de conexión global.

Editar una Conexión Global¶

Para editar una conexión global, coloque el cursor sobre una fila de conexión global existente en la tabla Conexiones globales y haga clic en el icono de edición .

Se abre la pantalla de configuración para una conexión global existente:

• Nombre: Introduzca un nombre que se utilizará para identificar la conexión global. El nombre debe ser único para cada conexión global de un conector en particular y no debe contener barras diagonales. / o dos puntos :. Este nombre también se utiliza para identificar el extremo del conector, que hace referencia tanto a una conexión específica como a sus actividades.

• Descripción: Introduzca una descripción de la conexión global que se mostrará en la tabla de Conexiones globales.

• Extremos del ambiente: En esta área, agrega ambientes uno a la vez y configura y prueba la conexión global en cada ambiente. Dentro de la configuración de cada ambiente, también puedes eliminar la conexión del ambiente:

  • Agregar un ambiente: Haga clic en el ícono Agregar para abrir un menú de los ambientes de la organización al que aún no se ha agregado la conexión global. Si el conector seleccionado en el paso 1 está disponible solo en Agentes Privados, los ambientes asociados con un Grupo de Agentes en Nube están atenuados y no se pueden seleccionar. Seleccione un ambiente a la vez desde el menú, usando el ícono de agregar para agregar ambientes adicionales según sea necesario.

  • Pestaña Ambiente: A medida que se agrega cada ambiente, se agrega una pestaña a la sección Ambientes que contiene la configuración de conexión global para ese ambiente.

    • Campos de configuración: Configure cada campo para el conector específico como se describe en la documentación para el conector específico seleccionado en el paso 1. La documentación para cada conector se encuentra en Conectores sección.

    • Estado de prueba de conexión: Los siguientes íconos se muestran en la pestaña de un ambiente cuando se cumplen ciertas condiciones. Los iconos no persisten después de cerrar la pantalla de configuración.

      • Cambios no probados: Cuando un ambiente tiene cambios en la configuración de conexión que no se han probado, su pestaña muestra un ícono Cambios no probados .
      • Conexión fallida: Cuando la conexión probada de un ambiente no tiene éxito, su pestaña muestra un icono de Error .
      • Conexión exitosa: Cuando la conexión probada de un ambiente es exitosa, su pestaña muestra un ícono Éxito .

    • Eliminar conexión: Haga clic para eliminar la conexión global del ambiente. (La eliminación de la conexión global se puede realizar desde la tabla Conexiones globales.)

    • Probar conexión: Haga clic para probar la conexión global usando la configuración proporcionada.

• Probar todas las conexiones: Haga clic para probar todos los extremos del ambiente en la conexión global. Después de hacer clic en Probar todas las conexiones, un cuadro de diálogo muestra una lista de los extremos del ambiente en la conexión global y su estado de conexión, ya sea con un icono de Éxito o un ícono de Error .

• Cancelar: Haga clic para cerrar la configuración de conexión global sin guardar.

• Guardar: Haga clic para guardar la configuración y cerrar la configuración de conexión global.

  Nota

  Cuando se edita una conexión global que se utiliza en un proyecto actualmente abierto en el diseñador, se muestra un mensaje en el diseñador para notificar a los usuarios que la conexión ha cambiado y debe volver a desplegarse para que los cambios surtan efecto..

Eliminar una Conexión Global¶

Para eliminar una conexión global, coloque el cursor sobre una fila de conexión global existente en la tabla Conexiones globales y haga clic en el icono de eliminar para eliminar una conexión global que no se utiliza en ningún proyecto.

Si se utiliza una conexión global en algún proyecto, el icono de eliminación está deshabilitado y la conexión global no se puede eliminar. Para ver una lista de proyectos que utilizan la conexión global, haga clic en la píldora de ambiente como se describe arriba en Ambientes en la tabla Conexiones globales. Luego abra cada proyecto, elimine la conexión global y vuelva a desplegar las operaciones del proyecto que ya no utilizan la conexión global.