Se usó la API de Cloud Translation para traducir esta página.

Jira Server (Data Center)

El conector de Jira Server (Data Center) te permite conectarte a Jira Software Data Center y realizar operaciones de inserción, eliminación, actualización y lectura.

Versiones compatibles

Este conector admite las versiones V2 y V3 de la API de Jira Server Data Center.

Antes de comenzar

En tu proyecto de Google Cloud, realiza las siguientes tareas:

Asegúrate de que la conectividad de red esté configurada. Para obtener información sobre los patrones de red, consulta Conectividad de red.
Otorga el rol de IAM roles/connectors.admin al usuario que configura el conector.
Otorga los roles de IAM roles/secretmanager.viewer y roles/secretmanager.secretAccessor a la cuenta de servicio que deseas usar para el conector.
Habilita los siguientes servicios:
- secretmanager.googleapis.com (API de Secret Manager)
- connectors.googleapis.com (API de conectores)
Para comprender cómo habilitar servicios, consulta Habilita servicios. Si estos servicios o permisos no se habilitaron antes para tu proyecto, se te solicitará que los habilites cuando configures el conector.

Configura el conector

Una conexión es específica de una fuente de datos. Significa que, si tienes muchas fuentes de datos, debes crear una conexión independiente para cada fuente. Para crear una conexión, haz lo siguiente:

En la consola de Cloud, ve a la página Conectores de Integration > Conexiones y, luego, selecciona o crea un proyecto de Google Cloud.
Ir a la página Conexiones
Haz clic en + CREAR NUEVO para abrir la página Crear conexión.
En la sección Ubicación, elige la ubicación para la conexión.
1. Región: selecciona una ubicación de la lista desplegable.
  Para obtener la lista de todas las regiones compatibles, consulta Ubicaciones.
2. Haz clic en SIGUIENTE.
En la sección Detalles de la conexión, completa lo siguiente:
1. Conector: Selecciona Jira Server (Data Center) en la lista desplegable de conectores disponibles.
2. Versión del conector: selecciona la versión del conector de la lista desplegable de versiones disponibles.
3. En el campo Nombre de la conexión, ingresa un nombre para la instancia de conexión.
  Los nombres de las conexiones deben cumplir con los siguientes criterios:
  - Los nombres de las conexiones pueden usar letras, números o guiones.
  - Las letras deben estar en minúsculas.
  - Los nombres de las conexiones deben comenzar con una letra y terminar con una letra o un número.
  - Los nombres de las conexiones no pueden superar los 49 caracteres.
4. De manera opcional, ingresa una Descripción para la instancia de conexión.
5. De manera opcional, habilita Cloud Logging y, luego, selecciona un nivel de registro. De forma predeterminada, el nivel de registro se establece en Error.
6. Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
7. Para usar la conexión en las suscripciones a eventos, selecciona Habilitar suscripción a eventos. Aparecerán las siguientes opciones:
  - Habilitar la suscripción al evento con entidades y acciones: Selecciona esta opción para usar la conexión tanto para la suscripción al evento como para las operaciones del conector (entidades y acciones).
  - Habilitar solo la suscripción a eventos: Selecciona esta opción para usar la conexión solo para la suscripción a eventos. Si seleccionas esta opción, haz clic en Siguiente y, luego, configura la suscripción a eventos.
  Nota: Los siguientes pasos adicionales de configuración de la conexión son necesarios si eliges habilitar entidades, operaciones y acciones para la conexión:
  - Destinos
  - Authentication
8. De manera opcional, configura los parámetros de nodo de conexión:
  - Cantidad mínima de nodos: Ingresa la cantidad mínima de nodos de conexión.
  - Cantidad máxima de nodos: Ingresa la cantidad máxima de nodos de conexión.
  Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se requieren más nodos para procesar más transacciones para una conexión y, del mismo modo, se requieren menos para procesar menos transacciones. Para comprender cómo los nodos afectan el precio del conector, consulta Precios de nodos de conexión. Si no ingresas ningún valor, se establecen de forma predeterminada los nodos mínimos en 2 (para una mejor disponibilidad) y los nodos máximos se establecen en 50.
9. (Opcional) En la sección Configuración avanzada, selecciona la casilla de verificación Usar proxy para configurar un servidor proxy para la conexión y establecer los siguientes valores:
10. De manera opcional, si deseas usar SSL, selecciona Habilitar SSL. Se mostrarán los detalles de la configuración de SSL.
  1. Selecciona un tipo de almacén de confianza. Puede ser Público, Privado o Conexión no segura.
  2. Selecciona los certificados como se muestra en función de la selección del almacén de confianza.
  3. Si usas mTLS, selecciona los certificados del almacén de claves en la sección Almacén de claves.
  Nota:
  - Todos tus certificados deben ser certificados X.509 y deben estar en formato PEM (correo con privacidad mejorada).
  - No puedes seleccionar un certificado directamente cuando configuras SSL. Debes almacenar todos tus certificados y claves privadas como un Secret de Secret Manager y, luego, seleccionar el Secret necesario durante la configuración de SSL.
11. De forma opcional, haz clic en + AGREGAR ETIQUETA para agregar una etiqueta a la conexión en forma de un par clave-valor.
12. Haga clic en SIGUIENTE.
En la sección Destinos, ingresa los detalles del host remoto (sistema de backend) al que deseas 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, luego, ingresa la dirección en el campo Host 1.
  - Para establecer una conexión privada, selecciona Adjunto de extremo y elige el adjunto requerido de la lista Adjunto de extremo.
    Nota: Para comprender cómo crear un adjunto de extremo, consulta adjunto de servicio de PSC y adjunto de extremo. Después de crear el adjunto del extremo, este se mostrará en la lista Adjunto del extremo.
  Si deseas establecer una conexión pública con tus sistemas de backend con seguridad adicional, puedes configurar direcciones IP salientes estáticas para tus conexiones y, luego, configurar tus reglas de firewall para permitir solo las direcciones IP estáticas específicas.
  
  Para ingresar destinos adicionales, haz clic en +AGREGAR DESTINO.
2. Haga clic en SIGUIENTE.
En la sección Autenticación, ingresa los detalles de autenticación.
1. Selecciona un Tipo de autenticación y, luego, ingresa los detalles relevantes.
  La conexión de Jira Server (Data Center) admite los siguientes tipos de autenticación:
  - Contraseña de usuario
  - Token de API
  - Token de acceso personal
  - Código de autorización de OAuth 2.0
2. Haga clic en SIGUIENTE.
Revisa: Revisa tus detalles de conexión y autenticación.
Haz clic en Crear.

Detalles de la suscripción al evento

En la sección Detalles de la suscripción a eventos, proporciona detalles de la cuenta de Jira Server (Data Center) en la que se crearán las suscripciones a eventos.

Tipo de destino: Selecciona Dirección de host.
Host: Ingresa la URL de registro de tu cuenta de Jira Server (Data Center). Se crearán suscripciones a eventos para esta URL.
Token de API: Selecciona el secreto de Secret Manager que contiene el token de API asociado con el nombre de usuario.
Versión del secreto: Selecciona una versión del secreto.
Habilitar el enriquecimiento de datos: Selecciona esta casilla de verificación si deseas que el activador de Jira Server (Data Center) recupere la carga útil completa del evento de la instancia de Jira Server (Data Center). Consulta Salida del activador para ver ejemplos.
Selecciona Habilitar conectividad privada para establecer una conectividad segura entre tu aplicación de backend y tu conexión. Si seleccionas esta opción, debes realizar pasos de configuración adicionales después de crear la conexión. Para obtener más información, consulta Conectividad privada para la suscripción a eventos.
Ingresa la configuración de mensajes no entregados. Si configuras mensajes no entregados, la conexión escribe los eventos sin procesar en el tema de Pub/Sub especificado. Ingresa los siguientes detalles:
1. ID del proyecto de mensajes no entregados: Es el ID del proyecto de Google Cloud en el que configuraste el tema de Pub/Sub de mensajes no entregados.
2. Tema de mensajes no entregados: Es el tema de Pub/Sub en el que deseas escribir los detalles del evento no procesado.

Configura la autenticación

Ingresa los detalles según la autenticación que desees usar.

Contraseña del usuario
- Nombre de usuario: Ingresa la cuenta de usuario de Jira Server (Data Center) que se usa para la autenticación.
- Contraseña: Ingresa la contraseña asociada con la cuenta.
Token de API
- Nombre de usuario: Ingresa el nombre de usuario de Jira Server (Data Center) que se usó para crear el token de API.
- Token de API: Selecciona el Secret de Secret Manager que contiene el token de API.
Token de acceso personal
- Token de acceso personal: Proporciona el Secret de Secret Manager que contiene el token de acceso personal.
- Versión del secreto: Selecciona la versión del secreto seleccionado.
Código de autorización de OAuth 2.0
- ID de cliente: Proporciona el ID de cliente que te proporcionó tu aplicación externa.
- Alcances: Especifica los alcances de permisos necesarios.
- Secreto del cliente : Selecciona el secreto de Secret Manager. Debes crear el secreto de Secret Manager antes de configurar esta autorización.
- Versión del secreto: Selecciona la versión del secreto de Secret Manager para el secreto del cliente.
- URL de autorización: Proporciona la URL que se generó durante la creación del cliente.

Configuración de Jira Server (Data Center)

Para obtener información sobre cómo configurar una cuenta de Atlassian y acceder a Jira Cloud, consulta la página principal de Atlassian.

Configura una dirección de host y detalles de autenticación

Accede a tu instancia de Jira Cloud.
Ingresa la dirección del host, que son los detalles de la instancia.
Ingresa tu nombre de usuario, que es tu ID de la cuenta de Atlassian.
Ve a Configuración para generar el token de API.
Selecciona Configuración de la cuenta de Atlassian en la configuración personal.
Haz clic en la pestaña Seguridad, busca los tokens de API y haz clic en Crear y administrar tokens de API.
Haz clic en Crear token de API.
Ingresa una etiqueta memorable y concisa para tu token en el diálogo que aparece y haz clic en Crear.
Haz clic en Copiar en el portapapeles, pega el token en tu secuencia de comandos y guárdalo para usarlo más adelante.

Pasos adicionales después de la creación de la conexión

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

En la página Connections, busca la conexión recién creada.
Observa que el Estado del conector nuevo será Se requiere autorización.
Haz clic en Se requiere autorización.
Se mostrará el panel Editar autorización.
Copia el valor del URI de redireccionamiento en tu aplicación externa.
Verifica los detalles de la autorización.
Haz clic en Autorizar.
Si la autorización se realiza correctamente, el estado de la conexión se establecerá como Activa en la página Conexiones.

Cómo volver a autorizar el código de autorización

Si usas el tipo de autenticación Authorization code y realizaste cambios de configuración en tu aplicación de Jira Server (Data Center), debes volver a autorizar tu conexión de Jira Server (Data Center). Para volver a autorizar una conexión, sigue estos pasos:

Haz clic en la conexión requerida en la página Conexiones.
Se abrirá la página de detalles de la conexión.
Haz clic en Editar para editar los detalles de la conexión.
Verifica los detalles de OAuth 2.0 - Código de autorización en la sección Autenticación.
Si es necesario, realiza los cambios necesarios.
Haz clic en Guardar. Esto te llevará a la página de detalles de la conexión.
Haz clic en Editar autorización en la sección Autenticación. Se mostrará el panel Autorizar.
Haz clic en Autorizar.
Si la autorización se realiza correctamente, el estado de la conexión se establecerá en Activa en la página Conexiones.

Muestras de configuración de conexión

En esta sección, se enumeran los valores de muestra para los distintos campos que configuras cuando creas la conexión del servidor de Jira.

Tipo de conexión web de Jira

Nombre del campo	Detalles
Ubicación	us-east1
Conector	Jira Server (Data Center)
Versión del conector	1
Nombre de la conexión	google-cloud-jira-rest-conn
Cuenta de servicio	my-service-account@my-project.iam.gserviceaccount.com
Cantidad mínima de nodos	2
Cantidad máxima de nodos	50
Tipo de destino	Dirección del host
host	192.0.2.0
Nombre de usuario	NOMBRE DE USUARIO
Token de API	API_TOKEN
Versión del Secret	1

Limitaciones del sistema

El conector de Jira Server (Data Center) puede procesar un máximo de 15 transacciones por segundo, por nodo, y limita las transacciones que superen este límite. De forma predeterminada, Integration Connectors asigna 2 nodos (para una mejor disponibilidad) a una conexión.

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

Nota: La cantidad de nodos de Integration Connectors se ajustará automáticamente según tu uso. Sin embargo, si deseas reservar capacidad para grandes volúmenes sin esperar el ajuste de escala automático, puedes ajustar el valor mínimo de nodos para una conexión. Se requieren más nodos para procesar más transacciones para una conexión. Por el contrario, se requieren menos nodos si una conexión procesa menos transacciones. Para configurar los valores del nodo, haz lo siguiente:

Si eres cliente de pago por uso, configura el valor mínimo y máximo del nodo en la página de edición de la conexión.
Si eres cliente de un plan de suscripción, comunícate con el equipo de asistencia.

La cantidad máxima de transacciones que puede controlar un nodo depende de varios factores. Por lo tanto, antes de ajustar la cantidad mínima de nodos para mejorar el rendimiento, te recomendamos que verifiques si tus sistemas de backend están configurados de manera óptima para controlar el tráfico requerido.

Usa la conexión de Jira Server (Data Center) en una integración

Después de crear la conexión, estará disponible en la integración de Apigee y en Application Integration. Puedes usar la conexión en una integración a través de la tarea Connectors.

Para comprender cómo crear y usar la tarea Connectors en Apigee Integration, consulta Tarea Connectors.
Para comprender cómo crear y usar la tarea Connectors en Application Integration, consulta Tarea Connectors.

Ejemplos de operaciones de entidades

En esta sección, se proporcionan ejemplos de cómo realizar las operaciones de entidades en este conector.

Ejemplo: Problemas con la lista

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Problemas en la lista Entity.
Selecciona la operación LIST y haz clic en Listo.
En la sección Entrada de tarea de la tarea Connectors, puedes establecer la filterClause según los requisitos del cliente.

Debes usar comillas simples ("'") para incluir el valor de una cláusula de filtro. Puedes usar la cláusula de filtro para filtrar registros según las columnas.

Puedes usar la cláusula de filtro para filtrar registros según las columnas. Por ejemplo, para filtrar registros, usa la siguiente filterClause: Location='US' y region='us-east1'.

filterClause

Ejemplo: Obtener problemas

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Problemas en la lista Entity.
Selecciona la operación GET y haz clic en Listo.
Configura el ID de la entidad en 10000, que es el ID de la clave que se pasará para los problemas. Para establecer el ID de la entidad, en la sección Task Input de la tarea Connectors, haz clic en EntityId y, luego, ingresa 10000 en el campo Valor predeterminado.
El valor del ID de la entidad debe pasarse directamente. Por ejemplo, 10000. Aquí, 10000 es el valor de clave primaria único que se pasa.

Para usar la operación Get, la entidad debe tener una clave primaria única; de lo contrario, no se podrá realizar la operación Get.

Ejemplo: Borrar problemas

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Problemas en la lista Entity.
Selecciona la operación DELETE y haz clic en Listo.
Establece el ID de la entidad en 10000, que es la clave que se pasará. Para establecer el ID de la entidad, en la sección Task Input de la tarea Connectors, haz clic en EntityId y, luego, ingresa 10000 en el campo Valor predeterminado.

Ejemplo: Crea IssueTypes

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona IssueTypes en la lista Entity.
Selecciona la operación Create y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
  "Name": "task123456",
  "Description": "New description is added."
}
```
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
  "Id": "10041"
}  
```

Ejemplo: Crea problemas

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Problemas en la lista Entity.
Selecciona la operación Create y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
    "IssueTypeName": "Subtask", 
    "ProjectName": "kanban4", 
    "Summary": "Summary Added", 
    "ParentKey": "KN-6" 
}
```
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
  "Id": 10071.0
}
```

Ejemplo: Crea sprints

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Sprints en la lista Entity.
Selecciona la operación Create y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
  "Name": "PROJ Sprint Googlecloud",
  "State": "future",
  "Goal": null,
  "OriginBoardId": 2.0,
  "StartDate": "2023-06-27 07:06:08",
  "EndDate": "2023-07-27 07:06:08"
}
```
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
  "Id": 23.0
}   
```

Ejemplo: Crea comentarios

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Comentarios en la lista Entity.
Selecciona la operación Create y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
  "IssueId": 10001.0,
  "Body": "Adding comments to above ID by editing it"
}
```
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
  "Id": 10023.0,
  "IssueId": null
}
```

Ejemplo: Crear usuarios

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Usuarios en la lista Entity.
Selecciona la operación Create y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
  "GroupName": null,
  "DisplayName": "Sample",
  "EmailAddress": "sample@gmail.com",
  "Active": true,
  "TimeZone": null,
  "Locale": "en_US",
  "AccountType": "atlassian"
}
```
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
  "AccountId": "557058:0a04612c-746d-4d47-a909-71ba797fe228"
}
```

Ejemplo: Crea registros de trabajo

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Registros de trabajo en la lista Entity.
Selecciona la operación Create y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
  "IssueKey": "GJCT-1",
  "Started": "2023-06-10 08:08:08",
  "TimeSpent": "2000"
}
```
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
  "Id": "41718",
  "IssueId": 10000.0
}
```

Ejemplo: Actualiza IssueTypes

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona IssueTypes en la lista Entity.
Selecciona la operación Update y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
  "Name": "NEW_TASK",
  "Description": "New Description"
} 
```
Configura el ID de la entidad en la entidad de IssueTypes . Para establecer el ID de la entidad, haz clic en entityId y, luego, ingresa 10038 en el campo Valor predeterminado.
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
  "Id": "10038"
}
```

Ejemplo: Problemas con la actualización

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Problemas en la lista Entity.
Selecciona la operación Update y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
  "AssigneeAccountId": "61d572aa7c6f9800705289a1",
  "AssigneeName": "Charlie b"
}
```
Establece el ID de la entidad en la entidad de los problemas . Para establecer el ID de la entidad, haz clic en entityId y, luego, ingresa 10024 en el campo Valor predeterminado.
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
  "AssigneeDisplayName": "Charlie b"
}
```

Ejemplo: Actualización de sprints

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Sprints en la lista Entity.
Selecciona la operación Update y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
  "Name": "PROJ Sprint Googlecloud_Updated",
  "State": "future",
  "StartDate": "2023-06-27 07:06:08",
  "EndDate": "2023-07-27 07:06:08"
}
```
Establece el ID de la entidad en la entidad de los sprints . Para establecer el ID de la entidad, haz clic en entityId y, luego, ingresa 2 en el campo Valor predeterminado.
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
}
```

Ejemplo: Actualizar comentarios

En el cuadro de diálogo Configure connector task, haz clic en Entities.
Selecciona Comentarios en la lista Entity.
Selecciona la operación Update y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:
```
{
  "Name": "PROJ Sprint Googlecloud_Updated",
  "State": "future",
  "StartDate": "2023-06-27 07:06:08",
  "EndDate": "2023-07-27 07:06:08"
}
```
Establece el ID de la entidad en la entidad de los comentarios . Para establecer el ID de la entidad, haz clic en entityId y, luego, ingresa 2 en el campo Valor predeterminado.
Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
{
}
```

Obtén ayuda de la Comunidad de Google Cloud

Puedes publicar tus preguntas y debatir sobre este conector en la comunidad de Google Cloud en Cloud Forums.

¿Qué sigue?

Obtén información para suspender y reanudar una conexión.
Obtén información para supervisar el uso del conector.
Comprende cómo ver los registros del conector.