Confluence (original) (raw)

Ir al contenido principal

Puedes usar el conector de Confluence para realizar operaciones de inserción, eliminación, actualización y lectura en Confluence.

Antes de empezar

Antes de usar el conector de Confluence, haz lo siguiente:

Configurar el conector

Una conexión es específica de una fuente de datos. Esto significa que, si tiene muchas fuentes de datos, debe crear una conexión independiente para cada una de ellas. Para crear una conexión, sigue estos pasos:

  1. En la consola de Cloud, ve a la página Integration Connectors > Connections (Integration Connectors > Conexiones) y, a continuación, selecciona o crea un proyecto de Google Cloud.
    Ve a la página Conexiones.
  2. Haz clic en + CREAR NUEVA para abrir la página Crear conexión.
  3. En la sección Ubicación, elige la ubicación de la conexión.
    1. Región: selecciona una ubicación de la lista desplegable.
      Para ver la lista de todas las regiones admitidas, consulta Ubicaciones.
    2. Haz clic en SIGUIENTE.
  4. En la sección Detalles de la conexión, haz lo siguiente:
    1. Conector: selecciona Confluence en la lista desplegable de conectores disponibles.
    2. Versión del conector: seleccione la versión del conector en la lista desplegable de versiones disponibles.
    3. En el campo Nombre de conexión, introduce un nombre para la instancia de conexión.
      Los nombres de las conexiones deben cumplir los siguientes criterios:
      • Los nombres de conexión pueden contener letras, números o guiones.
      • Las letras deben estar en minúsculas.
      • Los nombres de conexión deben empezar por una letra y terminar por una letra o un número.
      • Los nombres de conexión no pueden tener más de 49 caracteres.
    4. Si quiere, puede introducir una Descripción para la instancia de conexión.
    5. También puedes habilitar Registro en la nube y, a continuación, seleccionar un nivel de registro. De forma predeterminada, el nivel de registro es Error.
    6. Cuenta de servicio: selecciona una cuenta de servicio que tenga los roles necesarios.
    7. Si quieres, selecciona Incluir espacios archivados para incluir contenido de espacios archivados en el resultado. El valor predeterminado es "false".
    8. También puedes introducir una clave de espacio para que la búsqueda muestre solo el contenido de ese espacio concreto.
    9. Si quieres, configura los ajustes del nodo de conexión:
      • Número mínimo de nodos: introduce el número mínimo de nodos de conexión.
      • Número máximo de nodos: introduce el número máximo de nodos de conexión.
        Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se necesitan más nodos para procesar más transacciones en una conexión y, a la inversa, se necesitan menos nodos para procesar menos transacciones. Para saber cómo afectan los nodos a los precios de los conectores, consulta la sección Precios de los nodos de conexión. Si no introduces ningún valor, de forma predeterminada, el número mínimo de nodos se establece en 2 (para mejorar la disponibilidad) y el número máximo de nodos se establece en 50.
    10. (Opcional) En la sección Configuración avanzada, selecciona la casilla Usar proxy para configurar un servidor proxy para la conexión y define los siguientes valores:
    • Esquema de autenticación de proxy: selecciona el tipo de autenticación para autenticarte con el servidor proxy. Se admiten los siguientes tipos de autenticación:
      * Básica: autenticación HTTP básica.
      * Resumen: autenticación HTTP de resumen.
    • Usuario proxy: nombre de usuario que se usará para autenticar el servidor proxy.
    • Contraseña de proxy: el secreto de Secret Manager de la contraseña del usuario.
    • Tipo de SSL de proxy: el tipo de SSL que se debe usar al conectarse al servidor proxy. Se admiten los siguientes tipos de autenticación:
      * Automático: es el ajuste predeterminado. Si la URL es una URL HTTPS, se usa la opción Tunnel. Si la URL es una URL HTTP, se usa la opción NUNCA.
      * Siempre: la conexión siempre tiene habilitado el protocolo SSL.
      * Nunca: la conexión no tiene habilitado el protocolo SSL.
      * Túnel: la conexión se realiza a través de un proxy de tunelización. El servidor proxy abre una conexión con el host remoto y el tráfico fluye de un lado a otro a través del proxy.
    • En la sección Servidor proxy, introduce los detalles del servidor proxy.
      1. Haga clic en + Añadir destino.
      2. Selecciona un Tipo de destino.
      * Dirección de host: especifica el nombre de host o la dirección IP del destino.
      Si quieres establecer una conexión privada con tu sistema backend, haz lo siguiente:
      * Crea una vinculación de servicio de PSC.
      * Crea un endpoint attachment y, a continuación, introduce los detalles del endpoint attachment en el campo Host address.
    1. También puedes hacer clic en + AÑADIR ETIQUETA para añadir una etiqueta a la conexión en forma de par clave-valor.
    2. Haz clic en SIGUIENTE.
  5. En la sección Destinations (Destinos), introduce los detalles del host remoto (sistema backend) al que quieras conectarte.
    1. Tipo de destino: selecciona un Tipo de destino.
      • Para especificar el nombre de host o la dirección IP de destino, selecciona Dirección de host y introduce la dirección en el campo Host 1.
      • Para establecer una conexión privada, selecciona Dirección del host y añade el adjunto de endpoint creado para SAP Gateway mediante el protocolo HTTPS.
        Si quieres establecer una conexión pública con tus sistemas backend con seguridad adicional, puedes configurar direcciones IP estáticas salientes para tus conexiones y, a continuación, configurar las reglas de tu cortafuegos para que solo se permitan las direcciones IP estáticas específicas.
        Para introducir más destinos, haga clic en +AÑADIR DESTINO.
    2. Haz clic en SIGUIENTE.
  6. En la sección Authentication (Autenticación), introduce los detalles de autenticación.
    1. Seleccione un tipo de autenticación e introduzca los detalles pertinentes.
      El conector de Confluence admite los siguientes tipos de autenticación:
      • Basic
      • APIToken
      • OAuth2.0

Para saber cómo configurar estos tipos de autenticación, consulta Configurar la autenticación.
2. Haz clic en SIGUIENTE. 7. Revisar: revisa los detalles de la conexión y la autenticación. 8. Haz clic en Crear.

Configurar la autenticación

Introduce los detalles en función de la autenticación que quieras usar.

Pasos adicionales después de crear la conexión

Si has seleccionado OAuth 2.0 - Authorization code para la autenticación, debes seguir estos pasos adicionales después de crear la conexión:

  1. En la página Conexiones, busca la conexión que acabas de crear.
    Verás que el estado del nuevo conector será Autorización obligatoria.
  2. Haz clic en Se requiere autorización.
    Se mostrará el panel Editar autorización.
  3. Copia el valor de URI de redirección en tu aplicación externa.
  4. Verifica los detalles de la autorización.
  5. Haz clic en Autorizar.
    Si la autorización se realiza correctamente, el estado de la conexión será Activa en la página Conexiones.

Reautorización del código de autorización

Si usas el tipo de autenticación Authorization code y has hecho algún cambio en la configuración de tu aplicación Confluence, debes volver a autorizar tu conexión de Confluence. Para volver a autorizar una conexión, sigue estos pasos:

  1. En la página Conexiones, haga clic en la conexión que quiera.
    Se abrirá la página de detalles de la conexión.
  2. Haz clic en Editar para modificar los detalles de la conexión.
  3. Verifica los detalles de OAuth 2.0 - Código de autorización en la sección Autenticación.
    Si es necesario, haz los cambios pertinentes.
  4. Haz clic en Guardar. Se te dirigirá a la página de detalles de la conexión.
  5. En la sección Autenticación, haga clic en Editar autorización. Se muestra el panel Autorizar.
  6. Haz clic en Autorizar.
    Si la autorización se realiza correctamente, el estado de la conexión será Activa en la página Conexiones.

Limitaciones del sistema

El conector de Confluence puede procesar 28 transacciones por segundo, por nodo, y limita las transacciones que superen este límite. De forma predeterminada, Integration Connectors asigna 2 nodos (para mejorar la disponibilidad) a una conexión.

Para obtener información sobre los límites aplicables a Integration Connectors, consulta Límites.

Usar la conexión de Confluence en una integración

Una vez que hayas creado la conexión, estará disponible tanto en Apigee Integration como en Application Integration. Puedes usar la conexión en una integración mediante la tarea Conectores.

Entidades, operaciones y acciones

Todos los conectores de integración proporcionan una capa de abstracción para los objetos de la aplicación conectada. Solo puedes acceder a los objetos de una aplicación a través de esta abstracción. La abstracción se te muestra como entidades, operaciones y acciones.

Acciones

El conector de Confluence proporciona acciones como DownloadAttachment y UploadAttachment. Para saber cómo configurar las acciones, consulta los ejemplos de acciones.

Ejemplos de acciones

En esta sección se describe cómo realizar algunas de las acciones de este conector.

Ejemplo: Descargar archivo adjunto

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Seleccione la acción DownloadAttachment y, a continuación, haga clic en Hecho.
  3. En la sección Entrada de tarea de la tarea Conectores, haz clic enconnectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campoDefault Value:
    {
    "AttachmentId": "xyz"
    }

Ejemplos de operaciones de entidades

Ejemplo: enumerar todas las solicitudes

En este ejemplo se enumeran todas las solicitudes de la entidad Requests.

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Solicitudes en la lista Entity.
  3. Selecciona la operación LIST y, a continuación, haz clic enHecho.

Ejemplo: Obtener un usuario de un ID de cuenta específico

En este ejemplo se obtiene el usuario con el valor 6035864ce2020c0070b5285b en el campo AccountId de la entidad Users.

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Users en la lista Entity.
  3. Selecciona la operación LIST y, a continuación, haz clic enHecho.
  4. En la sección Entrada de tarea de la tarea Conectores, haga clic en filterClause y, a continuación, introduzca AccountId=6035864ce2020c0070b5285b en el campo Valor predeterminado.
    En este caso, AccountId es el valor de clave principal de la entidad Users.

Ejemplo: páginas de lista

En este ejemplo se enumeran las páginas de la entidad Pages.

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Pages en la lista Entity.
  3. Selecciona la operación LIST y, a continuación, haz clic enHecho.

Ejemplo: Get Pages

En este ejemplo se obtiene un registro de página de la entidad Pages.

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Pages en la lista Entity.
  3. Selecciona la operación GET y, a continuación, haz clic enHecho.
  4. En la sección Entrada de tarea de la tarea Conectores, haga clic en entityId y, a continuación, introduzca 123 en el campo Valor predeterminado.
    En este caso, 123 es un identificador único de la entidad de recurso Pages.

Ejemplo: crear páginas

En este ejemplo se crea un registro de página en la entidad Pages.

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Pages en la lista Entity.
  3. Selecciona la operación CREATE y, a continuación, haz clic enHecho.
  4. En la sección Entrada de tarea de la tarea Conectores, haz clic enconnectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campoDefault Value:
    {
    "SpaceId": "12345",
    "Status": "Current",
    "Title": "FROM XYZ",
    "Storage": "XYZ1234"
    }

Example - Update Pages

This example updates a page record in the Pages entity.

  1. In the Configure connector task dialog, click Entities.
  2. Select Pages from the Entity list.
  3. Select the UPDATE operation, and then click Done.
  4. In the Task Input section of the Connectors task, click connectorInputPayload and then enter a value similar to the following in the Default Value field:
    {
    "Title": "Update abc"
    }
  5. En la sección Entrada de tarea de la tarea Conectores, haga clic en entityId y, a continuación, introduzca 12345 en el campo Valor predeterminado.

Si la integración se realiza correctamente, el campo connectorOutputPayload de la tarea del conector tendrá la respuesta de la operación de actualización.

{ "Id": 1234 }

Ejemplo: eliminar una página

En este ejemplo se elimina una página de la entidad Pages.

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Pages en la lista Entity.
  3. Selecciona la operación DELETE y, a continuación, haz clic en Hecho.
  4. En la sección Entrada de tarea de la tarea Conectores, haga clic en entityId y, a continuación, introduzca 123 en el campo Valor predeterminado.
    Si la entidad tiene claves primarias compuestas en lugar de especificar el entityId, puedes definir el filterClause. Por ejemplo, Id='123'.

Crear conexiones con Terraform

Puedes usar el recurso de Terraform para crear una conexión.

Para saber cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform.

Para ver una plantilla de Terraform de ejemplo para crear una conexión, consulta la plantilla de ejemplo.

Cuando crees esta conexión con Terraform, debes definir las siguientes variables en el archivo de configuración de Terraform:

Nombre del parámetro Tipo de datos Obligatorio Descripción
proxy_enabled BOOLEAN Falso Seleccione esta casilla para configurar un servidor proxy para la conexión.
proxy_auth_scheme ENUM Falso Tipo de autenticación que se usará para autenticar el proxy ProxyServer. Los valores admitidos son BASIC, DIGEST y NONE.
proxy_user STRING Falso Nombre de usuario que se usará para autenticar el proxy ProxyServer.
proxy_password SECRET Falso Contraseña que se usará para autenticarse en el proxy ProxyServer.
proxy_ssltype ENUM Falso El tipo de SSL que se debe usar al conectarse al proxy ProxyServer. Los valores admitidos son AUTO, ALWAYS, NEVER y TUNNEL.

Puedes publicar tus preguntas y hablar sobre este conector en la comunidad de Google Cloud, en los foros de Cloud.

Siguientes pasos

A menos que se indique lo contrario, el contenido de esta página está sujeto a la licencia Reconocimiento 4.0 de Creative Commons y las muestras de código están sujetas a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio web de Google Developers. Java es una marca registrada de Oracle o sus afiliados.

Última actualización: 2026-01-14 (UTC).