Creación del Generador de Conectores¶

Introducción¶

Esta página describe cómo crear y configurar un nuevo conector o editar un conector existente usando Connector Builder.

Crear un Nuevo Conector¶

Cuando accede al Constructor de conectores, si no se puede acceder a ningún conector personalizado de Connector Builder, esta pantalla está en blanco. Haga clic en Nuevo conector para comenzar:

Al hacer clic en Nuevo conector, se abre la pantalla de creación del conector. Hay cuatro pasos de configuración, cada uno de los cuales se trata en las siguientes secciones:

• Paso 1: Configuración básica
• Paso 2: Autenticación
• Paso 3: Actividades del conector
• Paso 4: Resumen y Confirmación

Para demostrar la creación de un conector, estos pasos muestran cómo crear un conector personalizado usando Atlassian Jira como extremo.

Paso 1: Configuración Básica¶

• Cargar imagen: Utilice el enlace para Buscar archivos locales para seleccionar un archivo SVG que se utilizará como imagen en miniatura en el conector. La imagen no debe tener un tamaño superior a 120 KB. Para reemplazar una imagen que ya ha sido seleccionada, haga clic en Examinar archivos locales nuevamente para seleccionar un archivo diferente.

• Eliminar imagen: Para borrar una imagen que se ha seleccionado, haga clic en el enlace Eliminar imagen. Esto revierte la imagen a la imagen predeterminada de Connector Builder.

• Nombre del conector: Introduzca un nombre para el conector que se utilizará para registrar el conector con Harmony. El nombre del conector también se muestra a los usuarios finales como información sobre herramientas cuando pasan el cursor sobre el conector en la paleta de componentes de diseño.

  Solo se permiten letras, números o espacios (sin caracteres especiales). Es posible que se reserven algunos nombres que ya están en uso en otras áreas del producto, en cuyo caso un mensaje indica que el nombre ya está en uso.

• Nombre para mostrar: Introduzca un nombre para que el conector sea el nombre del conector principal que vean los usuarios finales.

• Versión #: Introduzca un número de versión que se utilizará para identificar este conector. Sólo se permiten letras y números (sin caracteres especiales ni espacios).

• Descripción: Introduzca una descripción del conector. Esta descripción aparece en el Constructor de conectores y puede ser útil para ayudar a los miembros de la organización con permiso de Administrador a comprender el conector. La descripción no se muestra a los usuarios finales.

• Siguiente: Haga clic para almacenar temporalmente la configuración para este paso y continuar con el siguiente.

• Guardar cambios: Haga clic para guardar la configuración de este paso y navegue hasta Paso 4: Resumen y confirmación.

• Eliminar: Después de abrir un conector existente para editarlo, haga clic para eliminar permanentemente el conector de la organización y cerrar la configuración. Para obtener más información, consulte Eliminar o cancelar la publicación de un conector más adelante en esta página.

• Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Paso 2: Autenticación¶

• Tipo de autenticación: Utilice el menú desplegable para seleccionar autenticación Anónima o Básica. Actualmente no se admiten otros tipos de autenticación.

  • Anónimo: Seleccione este tipo si no se requiere autenticación HTTP. Esto también se conoce como autenticación anónima, sin nombre de usuario ni contraseña.
  • Básico: Seleccione este tipo para utilizar la autenticación HTTP básica sin cifrado SSL. Tenga en cuenta que si se utiliza esta opción, la contraseña proporcionada se envía en texto sin cifrar.

• URL de prueba de autenticación: Cuando se selecciona Básico, ingrese una URL con la que desea que se pruebe con las credenciales de un usuario final cuando esté configurando este conector. Esto es con fines de validación para garantizar que se pueda establecer una conexión utilizando el tipo de autenticación configurado con las credenciales del usuario final. Este campo no está presente cuando se selecciona Anónimo.

  • Oculto: Si no desea que los usuarios finales vean el campo URL de prueba de autenticación al configurar este conector, seleccione esta casilla de verificación.
  • Candado: Aplicable solo cuando un campo no está oculto; el ícono del candado es una indicación de si el campo será de solo lectura o editable por los usuarios finales. Esto se provee únicamente para propósitos informativos; al crear un conector, no puede alternar esto.
    • Bloqueado: Un icono de candado cerrado indica que el campo es de solo lectura para los usuarios finales.
    • Desbloqueado: Un icono de candado abierto indica que el campo está disponible para que los usuarios finales lo editen. Este es el comportamiento predeterminado para los campos que no están ocultos y no se pueden cambiar.

• Método de prueba de autenticación: Cuando se selecciona Básico, use el menú desplegable para seleccionar el tipo de método a usar con la URL de prueba de autenticación ingresada arriba, seleccionando entre GET, PUT, o POST. Este campo no está presente cuando se selecciona Anónimo.

  Consejo

  Para elegir una URL y un método para probar la autenticación, recomendamos utilizar un sencillo GET pedido. Consulte la documentación de la API de su extremo para crear una URL con la que realizar extremo.

• Credenciales: Cuando se selecciona Básico, esta tabla muestra información sobre los campos que el usuario final utilizará para proporcionar sus credenciales:

  • Nombre de campo: El nombre del campo en Connector Builder. Esto no será visto por los usuarios finales y no se puede editar.
  • Nombre para mostrar: Este nombre será visto por el usuario final que configura la conexión. De forma predeterminada, es lo mismo que Nombre de campo. Puede cambiar el nombre de este campo utilizando las acciones disponibles en la última columna. Por ejemplo, es posible que desee cambiar el nombre de "Nombre de usuario" a "Dirección de Correo " o cambiar el nombre de "Contraseña" a "Token API ", según los requisitos específicos del extremo.
  • Acciones: Pase el cursor sobre la celda de la columna y haga clic en el icono de edición para realizar cambios en la fila. Cuando termine, haga clic en el botón Guardar que aparece dentro de esta celda.

• Siguiente: Haga clic para almacenar temporalmente la configuración para este paso y continuar con el siguiente.

• Guardar cambios: Haga clic para guardar la configuración de este paso y navegue hasta Paso 4: Resumen y confirmación.

• Eliminar: Disponible solo después de abrir un conector existente para editarlo, haga clic para eliminar permanentemente el conector de la organización y cerrar la configuración. Para obtener más información, consulte Eliminar o cancelar la publicación de un conector más adelante en esta página.

• Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Paso 3: Actividades del Conector¶

• URL base: Ingrese una URL base que desee utilizar para todas las actividades configuradas por el usuario final. No incluya ningún parámetro de consultar o ruta a menos que se utilicen para todas las actividades. (Un usuario final podrá especificar rutas y parámetros únicos durante la configuración de la actividad).

  Consejo

  Si se incluye una versión en la URL del punto final, es posible que desee incluirla como parte de la URL base. Si la versión requiere actualización, puede cambiarla aquí para que todas las actividades hereden la ruta de la nueva versión. (Tenga en cuenta que debe validar que las rutas sean válidas con una nueva versión).

  • Oculto: Si no desea que los usuarios finales vean el campo URL base al configurar este conector, seleccione esta casilla de verificación.
  • Candado: Aplicable solo cuando un campo no está oculto; el ícono del candado es una indicación de si el campo será de solo lectura o editable por los usuarios finales. Esto se provee únicamente para propósitos informativos; al crear un conector, no puede alternar esto.
    • Bloqueado: Un icono de candado cerrado indica que el campo es de solo lectura para los usuarios finales.
    • Desbloqueado: Un icono de candado abierto indica que el campo está disponible para que los usuarios finales lo editen. Este es el comportamiento predeterminado para los campos que no están ocultos y no se pueden cambiar.

• Encabezados de solicitud globales: Para agregar encabezados de solicitud que se apliquen a todas las actividades, use el enlace Agregar.Agregar ícono para insertar una nueva fila en blanco en la tabla debajo del enlace, luego complete los campos:

  • Nombre y Valor: Ingrese un nombre de encabezado y el valor correspondiente para usar en todas las actividades.

    Consejo

    Los encabezados de solicitud para ingresar se pueden encontrar en la documentación API del endpoint o probando con una herramienta de externo como Postman o SoapUI.

  • Acciones: Haga clic en el botón Guardar para guardar la fila. Para eliminar o editar una fila de encabezado que se ha guardado, coloque el cursor sobre la celda de la columna y haga clic en el icono de edición o eliminar icono, respectivamente, para realizar cambios o eliminar la fila del encabezado.

• Actividades: Para agregar actividades que estarán disponibles para que las configure un usuario final, use el enlace Agregar.Agregar ícono para crear una nueva actividad en la tabla debajo del enlace. Para obtener información sobre cómo crear una nueva actividad, consulte Crear actividades de conector más adelante en esta página.

  Estas columnas se muestran en la tabla de actividades:

  • Nombre de la actividad y Nombre para mostrar: Estos campos muestran los valores ingresados durante la creación de la actividad.

  • Solicitud y Respuesta: Estos campos indican si se ingresó un esquema de solicitud o respuesta durante la creación de la actividad.

  • Acciones: Para eliminar o editar una fila de actividad que se ha guardado, coloque el cursor sobre la celda de la columna y haga clic en el ícono de edición o eliminar icono, respectivamente, para realizar cambios o eliminar la fila de actividad.

• Siguiente: Haga clic para almacenar temporalmente la configuración para este paso y continuar con el siguiente.

• Guardar cambios: Haga clic para guardar la configuración de este paso y continuar con el siguiente.

• Eliminar: Disponible solo después de abrir un conector existente para editarlo, haga clic para eliminar permanentemente el conector de la organización y cerrar la configuración. Para obtener más información, consulte Eliminar o cancelar la publicación de un conector más adelante en esta página.

• Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

• Prueba: Haga clic para abrir una pantalla separada donde puede probar el conector. Para obtener más información, consulte Probar un conector más adelante en esta página.

Paso 4: Resumen y Confirmación¶

• Configuración básica: En la parte superior hay un resumen de la información ingresada en Paso 1: Configuración básica, incluida la imagen, el nombre del conector, el nombre para mostrar, la versión y la descripción.

  Para realizar cambios, haga clic en el icono de edición para volver al Paso 1: Configuración básica.

• Autenticación: La siguiente sección es un resumen de la información ingresada en el Paso 2: Autenticación, incluido el tipo de autenticación. Si se utiliza autenticación básica, también se mostrará la URL de prueba de autenticación y el método utilizado para la prueba, indicando si este campo está oculto.

  Para realizar cambios, haga clic en el icono de edición para volver al Paso 2: Autenticación.

• Actividades del conector: La última sección es un resumen de la información ingresada en el Paso 3: Actividades del conector, incluida la URL base, los encabezados de solicitud globales y las actividades.

  Para realizar cambios, haga clic en el icono de edición para volver al Paso 3: Actividades del conector.

• Guardar: Haga clic para guardar y cerrar el conector. El conector se guardará en Cloud Studio, pero aún no está publicado ni disponible para que lo utilicen los usuarios finales. Cuando guarda un conector, la persona que lo creó y otros miembros de la organización que tienen permiso de Administrador pueden acceder a él desde la página Creador de conectores.

• Publicar: Haga clic para guardar y publicar el conector. Cuando publica, el conector se registra automáticamente con Harmony y se publica en el agente. Luego estará disponible para que lo utilicen los usuarios finales de la organización (consulte Configuración de usuario de Connector Builder).

  Si edita y luego vuelve a publicar un conector que ya se ha publicado, un mensaje le pedirá que confirme que desea sobrescribir la versión publicada anteriormente:

  

  Precaución

  Si el conector ya está en uso, dependiendo de los cambios, esto puede causar que algunas operaciones dejen de ser válidas. Recomendamos verificar cada lugar donde se utiliza el conector para validar que esté funcionando correctamente después de volver a publicarlo.

  Para determinar los proyectos donde se utiliza cada conector, puede intentar eliminar el conector. Los proyectos donde el conector está "en uso" se enumeran en el mensaje de error que indica que el conector no se puede eliminar porque está en uso (consulte Eliminar o cancelar la publicación de un conector más adelante en esta página).

  Una vez que sepa qué proyectos utilizan el conector, puede intentar eliminar la conexión dentro de esos proyectos. Los componentes que dependen de la conexión se enumeran en el mensaje de error que indica que la conexión no se puede eliminar porque tiene dependencias (consulte la opción Eliminar en Configurar una conexión en Configuración de usuario del Generador de conectores).

• Despublicar: Disponible solo para conectores que se han publicado, haga clic para ocultar el conector a los usuarios finales. Para obtener más información, consulte Eliminar o cancelar la publicación de un conector más adelante en esta página.

• Eliminar: Disponible solo después de abrir un conector existente para editarlo, haga clic para eliminar permanentemente el conector de la organización y cerrar la configuración. Para obtener más información, consulte Eliminar o cancelar la publicación de un conector más adelante en esta página.

• Exportar: Genera y descarga el conector como un archivo JSON con los metadatos del conector (consulte Exportaciones e importaciones de Connector Builder).

Probar un Conector¶

Probar un conector le permite probar la conexión antes de publicar.

La opción para probar un conector está disponible como botón en la parte inferior de Paso 3: Actividades del conector durante la creación del conector:

Al hacer clic en el botón Probar, se abre una pantalla separada donde puede probar el conector:

• URL base: Introduzca la URL base que se utilizará para probar el conector.

• Ruta: Si corresponde, ingrese una ruta que se agregará a la URL base que se utilizará para probar el conector.

• Verbo HTTP: Utilice el menú desplegable para seleccionar el método apropiado para probar el conector con la URL que aparece a la derecha. La URL se construye a partir de la URL base y la ruta proporcionadas. Puedes seleccionar entre GET, PUT, POST, DELETE, o PATCH.

• Nombre de usuario y Contraseña: Estas son las credenciales de Nombre de campo configuradas en Paso 2: Autenticación. Los campos Nombre para mostrar no se muestran.

• Cuerpo de la solicitud: Esta área está presente solo si el verbo HTTP seleccionado es PUT, POST, o PATCH. Ingrese o pegue manualmente el cuerpo de la solicitud en esta área. Puedes usar el ícono emergente para editar el cuerpo de la solicitud en un área más grande (después de abrir esa área, haga clic en el ícono de retorno para volver a esta pantalla). No se admite la carga de un archivo desde un esquema desde una URL o un archivo.

  

• Prueba: Al hacer clic en Prueba, aparece un mensaje al lado del botón indicando si la conexión se realizó correctamente o falló. Si la conexión falló, hay un enlace para obtener más detalles.

Crear Actividades de Conector¶

Se deben agregar actividades de conector para que los usuarios finales puedan configurarlas para interactuar con un extremo.

El área para agregar actividades del conector se encuentra en Actividades en Paso 3: Actividades del conector de la creación del conector.

Para agregar actividades que estarán disponibles para que las configure un usuario final, use el enlace Agregar.agregar para insertar una nueva actividad:

Al hacer clic en este enlace, se abre una nueva pantalla para introducir información sobre la actividad:

• Nombre de la actividad: Introduzca un nombre para la actividad. Esto solo lo verán aquellos que tengan acceso a la creación del conector y no lo verán los usuarios finales.

• Nombre para mostrar: Introduzca un nombre para la actividad que verán los usuarios finales que utilizarán el conector.

• Descripción: Introduzca una descripción de esta actividad. Esto solo lo verán aquellos que tengan acceso a la creación del conector y no lo verán los usuarios finales.

  Consejo

  Puede ser una buena idea usar el mismo nombre y descripción que se usa en la documentación API del punto final para ayudar a otras personas con acceso a la creación de conectores a comprender exactamente para qué sirve la actividad.

• Método: Utilice el menú desplegable para seleccionar el método apropiado, seleccionando entre GET, PUT, POST, DELETE, PATCH, o MERGE. Los métodos personalizados no son compatibles para la creación de conectores mediante Connector Builder, pero se pueden configurar mediante un extremo HTTP genérico en cambio.

• Ruta: Introduzca una ruta que se debe agregar a la URL base proporcionada en Paso 3: Actividades del conector. Los parámetros de ruta que desea que configure el usuario final se pueden especificar entre llaves. Por ejemplo, /users/{firstname}/{lastname} define dos parámetros de ruta, firstName y lastName. Los parámetros de ruta ingresados de esta manera aparecerán automáticamente como filas en el campo Parámetros de ruta a continuación.

• Parámetros de ruta: Este campo muestra una tabla resumen de los parámetros de ruta ingresados en Ruta como se describe anteriormente, con estas columnas:

  • Nombre: Se muestra el nombre del parámetro de ruta ingresado anteriormente. Para editar el nombre de la ruta, edite el campo Ruta de arriba.
  • Nombre para mostrar: Este nombre será visto por el usuario final que configure la actividad. De forma predeterminada, este campo es el mismo que el campo Nombre. Puede cambiar el nombre de este campo utilizando las acciones disponibles en la última columna.
  • Tipo: De forma predeterminada, el tipo es string. Puede hacer que este campo sea editable usando las acciones disponibles en la última columna. Estos tipos de datos están disponibles en el menú desplegable: boolean, date, double, float, integer, long, string.
  • Acciones: Para eliminar o editar una fila de parámetros, coloque el cursor sobre la celda de la columna y haga clic en el icono de edición o eliminar icono, respectivamente, para realizar cambios o eliminar la fila de parámetros. Si la fila se puede editar actualmente, haga clic en el botón Guardar para guardar la fila.

• Parámetros de cadena de consulta: Para agregar parámetros de cadena de consultar para la actividad, use el enlace Agregar.Agregar icono para insertar una nueva fila en blanco en la siguiente tabla, luego complete los campos:

  • Nombre: Introduzca el nombre del parámetro de cadena de consultar que se utilizará.
  • Nombre para mostrar: Ingrese el nombre que desea mostrar en el conector para el parámetro de cadena de consultar. Este nombre será visto por el usuario final que configure la actividad.
  • Tipo: Utilice el menú desplegable para seleccionar entre estos tipos de datos: boolean, date, double, float, integer, long, string.
  • Obligatorio: Seleccione la casilla de verificación para que el usuario final que configura la actividad deba ingresar el parámetro de cadena de consultar.
  • Predeterminado: Si corresponde, ingrese un valor predeterminado para el parámetro de cadena de consultar que se proporcionará al usuario final que configura la actividad.
  • Acciones: Haga clic en el botón Guardar para guardar la fila. Para eliminar o editar una fila de parámetro de cadena de consultar que se ha guardado, coloque el cursor sobre la celda de la columna y haga clic en el icono de edición o eliminar icono, respectivamente, para realizar cambios o eliminar la fila del parámetro de la cadena de consultar.

• Encabezados de solicitud: Para agregar encabezados de solicitud para la actividad, use el enlace Agregar.Agregar icono para insertar una nueva fila en blanco en la siguiente tabla, luego complete los campos:

  • Nombre: Ingrese el nombre del encabezado de solicitud que se utilizará.
  • Nombre para mostrar: Ingrese el nombre que desea mostrar en el conector para el encabezado de solicitud. Este nombre será visto por el usuario final que configure la actividad.
  • Tipo: Utilice el menú desplegable para seleccionar entre estos tipos de datos: boolean, date, double, float, integer, long, string.
  • Obligatorio: Seleccione la casilla de verificación para que el usuario final que configura la actividad deba ingresar el encabezado de la solicitud.
  • Predeterminado: Si corresponde, ingrese un valor predeterminado para el encabezado de solicitud que se proporcionará al usuario final que configura la actividad.
  • Acciones: Haga clic en el botón Guardar para guardar la fila. Para eliminar o editar una fila de encabezado de solicitud que se ha guardado, coloque el cursor sobre la celda de la columna y haga clic en el icono de edición o eliminar icono, respectivamente, para realizar cambios o eliminar la fila del encabezado de la solicitud.

• Esquema del cuerpo de la solicitud y Esquema del cuerpo de la respuesta: Estas áreas se utilizan para proporcionar estructuras de solicitud y respuesta. Cuando el Método seleccionado es GET, se requiere proporcionar un Esquema del cuerpo de la solicitud y no es posible proporcionar un esquema de respuesta. Cuando el Método seleccionado es cualquier otro método, proporcionar cualquiera de los esquema es opcional.

  Si debe proporcionar estas estructuras depende de la llamada API específica. A menudo se pueden obtener ejemplos de estructuras de solicitud y respuesta de la documentación API de un punto final. Para verificar su exactitud, esas estructuras deben validarse utilizando una herramienta de externo como Postman o SoapUI.

  Si una API responde con más de una estructura de respuesta JSON posible, se recomienda combinar las estructuras de respuesta en una sola estructura para manejar todas las respuestas posibles, ya que todos los campos en una estructura JSON son opcionales.

  Los esquema cargados se utilizan únicamente con el fin de definir los esquemas de solicitud o respuesta de actividad de Connector Builder. A diferencia de un proyecto de Cloud Studio, los esquemas no se guardan y no están disponibles para su reutilización en ningún otro lugar dentro de Connector Builder o Cloud Studio.

  Después de editar los esquemas en un conector existente de Connector Builder que ya está en uso en el proyecto de Cloud Studio, el usuario del conector debe usar el botón Actualizar en el paso Esquema de datos para poder traer en el esquema definido actual (consulte Configuración de usuario del Generador de conectores).

  Precaución

  Las estructuras de solicitud o respuesta inexactas provocarán errores en Harmony. Se recomienda encarecidamente realizar pruebas con una herramienta de externo para verificar la precisión.

  • Cargar URL: Haga clic para abrir un cuadro de diálogo donde puede cargar un esquema desde una URL:

    

    • Tipo de archivo: Utilice el menú desplegable para seleccionar entre los tipos de archivos admitidos, incluidos JSON, XML y XSD.

    • URL: Ingrese una URL a la que se pueda acceder sin autenticación. Se pueden cargar archivos de hasta 5 MB de tamaño.

    • Cargar: Haga clic para cargar el esquema desde la URL. Tenga en cuenta que el archivo se recupera solo una vez para la generación del esquema.

      Nota

      Al cargar un archivo XSD que contiene varios elementos de nivel superior, se le solicita que seleccione el nodo raíz deseado. Seleccione el elemento y luego haga clic en Finalizar para cargar el archivo.

    • Cancelar: Haga clic en Cancelar para cerrar el cuadro de diálogo Cargar URL del esquema sin guardar.

  • Cargar archivo: Haga clic para abrir un cuadro de diálogo donde puede cargar un esquema desde un archivo al que se puede acceder desde la máquina actual:

    

    • Tipo de archivo: Utilice el menú desplegable para seleccionar entre los tipos de archivos admitidos, incluidos JSON, XML y XSD.

    • Archivo: Utilice el botón Examinar a la derecha para buscar un archivo que aún no se haya utilizado en el proyecto actual. Se pueden cargar archivos de hasta 5 MB de tamaño.

    • Cargar: Haga clic para cargar el esquema desde el archivo.

      Nota

      Al cargar un archivo XSD que contiene varios elementos de nivel superior, se le solicita que seleccione el nodo raíz deseado. Seleccione el elemento y luego haga clic en Finalizar para cargar el archivo.

    • Cancelar: Haga clic para cerrar el cuadro de diálogo Cargar archivo de esquema sin guardar.

  • Ver/Editar esquema: Si no está cargando un esquema, puede ingresar uno manualmente en el área de texto debajo de los botones Cargar URL y Cargar archivo. De lo contrario, después de cargar un esquema, puede verlo o esquema directamente dentro de esta área de texto.

    Para ver o editar el esquema en un área más grande, haga clic en el icono emergente (después de abrir esa área, haga clic en el icono de retorno para volver a esta pantalla).

    Esta área de texto también se puede copiar usando Control+C (Windows o Linux) o Command+C (macOS).

• Aplicar: Haga clic para aplicar la actividad a la configuración del conector y regresar a la pantalla principal de Paso 3: Actividades del conector con la actividad agregada como una fila en la tabla. Para guardar la actividad, haga clic en el botón Guardar cambios en Paso 3: Actividades del conector.

• Aplicar y Nuevo: Haga clic para aplicar la actividad a la configuración del conector y abrir otra pantalla donde se puede agregar información para otra actividad nueva. Para guardar la actividad, haga clic en el botón Guardar cambios en Paso 3: Actividades del conector.

• Cancelar: Haga clic para cerrar la pantalla de actividad sin guardar y volver a la pantalla principal de Paso 3: Actividades del conector.

Eliminar o Cancelar la Publicación de un Conector¶

Antes de eliminar o cancelar la publicación de un conector, todos los componentes creados a partir de ese conector en proyectos deben eliminarse primero como se describe en Eliminar dependencias del conector abajo. Una vez hecho esto, consulte Eliminar un conector o Anular publicación de un conector abajo.

Eliminar Dependencias del Conector¶

Antes de eliminar o cancelar la publicación de un conector, primero se deben eliminar todos los componentes que utilizan el conector y los componentes anteriormente dependientes se deben volver a desplegar en la nube de Harmony:

1. Elimine cualquier actividad creada a partir de conexiones creadas utilizando el conector. Para eliminar una actividad, primero elimínela de cualquier operación donde se utilice. Luego elimine la actividad del panel del proyecto usando su menú de acciones. Para ambas opciones, consulte Menú de acciones de actividad en Conceptos básicos del conector.
2. Elimine cualquier conexión creada desde el conector. Consulte la opción Eliminar en Configurar una conexión en Configuración de usuario del Generador de conectores.
3. Vuelva a desplegar cualquier operación que anteriormente dependiera de las actividades ahora eliminadas. Alternativamente, puede volver a desplegar todas las operaciones utilizadas por los flujos de trabajo de un proyecto. Consulte Despliegue del proyecto.

Esto eliminará todas las referencias al conector tanto en los proyectos como en las implementaciones en la nube de Harmony.

Eliminar un Conector¶

Al eliminar un conector, se elimina permanentemente el conector de la organización.

La opción para eliminar un conector está disponible como enlace en la parte inferior de cada paso de configuración:

Al hacer clic en Eliminar, un mensaje le pide que confirme que desea eliminar el conector:

Al hacer clic en Continuar, el conector se elimina permanentemente y se cierra la configuración.

Si los componentes que dependen del conector todavía existen en la nube de Harmony, un mensaje de error proporciona los nombres de los proyectos donde el conector todavía está "en uso":

En este caso, siga los pasos descritos en Eliminar dependencias del conector anterior para eliminar primero los componentes que dependen del conector y luego volver a desplegar los componentes restantes previamente dependientes en la nube de Harmony, como las operaciones que anteriormente hacían referencia a las actividades.

Anular la Publicación de un Conector¶

Al cancelar la publicación de un conector, se oculta el conector a los usuarios finales. Cuando un conector no se publica, aún es accesible en la página Creador de conectores para la persona que lo creó y los miembros de la organización con permiso de Administrador, pero ya no es visible para los usuarios finales. Los conectores no publicados se pueden volver a publicar utilizando el botón Publicar.

La opción para cancelar la publicación de un conector está disponible como enlace en la parte inferior de Paso 4: Resumen y configuración sólo para conectores que hayan sido publicados:

Al hacer clic en Despublicar, el conector se despublica inmediatamente.

Si los componentes que dependen del conector todavía existen en la nube de Harmony, un mensaje de error proporciona los nombres de los proyectos donde el conector todavía está "en uso":

En este caso, siga los pasos descritos en Eliminar dependencias del conector anterior para eliminar primero los componentes que dependen del conector y luego volver a desplegar los componentes restantes previamente dependientes en la nube de Harmony, como las operaciones que anteriormente hacían referencia a las actividades.

Próximos Pasos¶

Después de publicar un conector, los miembros de la organización Harmony donde se publica tendrán acceso para configurar y usar el conector en proyectos de Cloud Studio. Obtenga más información en Configuración de usuario del Generador de conectores.