Connectors > GitHub

Introducción

El conector de GitHub de Bizagi está disponible en el Connectors Xchange de Bizagi.

A través de este conector, podrá conectar sus procesos de Bizagi a una cuenta de GitHub y usar sus servicios.

Para más información de las capacidades de este conector, visite nuestro Connectors Xchange.

Este Conector se desarrolló según el contenido de la API y la información proporcionada por GitHub. Bizagi y sus subsidiarias no ofrecen garantía alguna sobre el contenido ni los errores causados por las llamadas a los servicios de la API. Bizagi y sus subsidiarias no se responsabilizan de ninguna pérdida, costo o daño derivado de las llamadas a la API de GitHub.

Antes de iniciar

Para probar y usar este conector, necesita:

1.Bizagi Studio previamente instalado.

2.Este conector previamente instalado a traves de Connectors Xchange, tal como se describe en el artículo de Connector Xchange, o a través de el manual de instalación descrito en la documentación de Instalar y administrar conectores.

3.Una cuenta en https://github.com/.

4.Un token de acceso.

Obtener su token de acceso

Siga estos pasos para obtener su token de acceso

1.Diríjase a https://github.com/settings/developers e inicie sección con su cuenta de GitHub.

GitHub001

2.Vaya a la pestaña de nombre Personal access tokens.

GitHub002

3.Haga clic en Generate new token.

GitHub003

4.Dele un nombre a su token.

GitHub005

5.Active por lo menos los siguientes permisos para su token y haga clic en Generate token.

GitHub004

6.Copie este token de acceso y guárdelo en un lugar seguro.

GitHub006

Configurar el conector

Para configurar el conector siga los pasos descritos en el capítulo de configuración en el artículo Instalar y administrar conectores.

Tenga en cuenta los siguientes parámetros de autenticación:

•Authentication method: Custom

•TOKEN: Token que se obtuvo en el paso anterior.

•OWNER: Opcional - Nombre de usuario del dueño usado por defecto. Este será usado por todas las actividades que requieran un dueño (owner) a menos que se especifique lo contrario.

•REPO: Opcional - Nombre del repositorio usado por defecto. Este será usado por todas las actividades que requieran un repositorio (repo) a menos que se especifique lo contrario.

•ORG: Opcional - Nombre de la organización usada por defecto. Este será usado por todas las actividades que requieran una organización (org) a menos que se especifique lo contrario.

GitHub007

Usar el conector

Éste conector permite el uso desde Bizagi de varios métodos disponibles para el uso de los servicios de GitHub.

Para configurar el conector, por favor visite el artículo Utilizar conectores.

Al usar el conector, asegúrese de tener en cuenta, para los métodos disponibles, los siguientes detalles:

Add assignees to an issue (Añadir asignados a una incidencia)

Esta acción permite agregar asignados a una incidencia.

Para configurar las entradas de esta acción tenga en cuenta:

•owner (Requerido): dueño del repositorio (nombre de usuario en GitHub). Si no se especifica este campo, se usa la variable global OWNER. Este parámetro debe ser de tipo String en su modelo de Bizagi.

•repo (Requerido): nombre del repositorio. Si no se especifica este campo, se usa la variable global REPO. Este parámetro debe ser de tipo String en su modelo de Bizagi.

•issue_number (Requerido): número de ID de la incidencia. Este parámetro debe ser un número en su modelo de Bizagi.

•assignees (Requerido): nombres de los usuarios que se desean asignar a la incidencia. Los usuarios que ya están asignados no se reemplazan. Si alguno de los nombres en la lista no existe, no se genera ningún error; simplemente se ignora. Este parámetro debe ser un arreglo de cadenas (strings) en el modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/issues/assignees/#add-assignees-to-an-issue.

Check assignee (Verificar asignado)

Esta acción permite verificar si se puede asignar un usuario a una incidencia.

Para configurar las entradas de esta acción tenga en cuenta:

•repo (Requerido): nombre del repositorio. Si no se especifica este campo, se usa la variable global REPO. Este parámetro debe ser de tipo String en su modelo de Bizagi.

•assignee (Requerido): nombre del usuario que se desea verificar. Diferencia entre mayúsculas y minúsculas. Este parámetro debe ser de tipo String en su modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/issues/assignees/#check-assignee.

Create a comment (Crear un comentario)

Esta acción permite crear un comentario.

Para configurar las entradas de esta acción tenga en cuenta:

•repo (Requerido): nombre del repositorio. Si no se especifica este campo, se usa la variable global REPO. Este parámetro debe ser de tipo String en su modelo de Bizagi.

•issue_number (Requerido): número de ID de la incidencia. Este parámetro debe ser un número en su modelo de Bizagi.

•body (Requerido): contenido del comentario. Este parámetro debe ser de tipo String en su modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/issues/comments/#create-a-comment.

Create an Issue (Crear una incidencia)

Esta acción permite crear una incidencia.

Para configurar las entradas de esta acción tenga en cuenta:

•repo (Requerido): nombre del repositorio. Si no se especifica este campo, se usa la variable global REPO. Este parámetro debe ser de tipo String en su modelo de Bizagi.

•title (Requerido): título de la incidencia. Este parámetro debe ser de tipo String en su modelo de Bizagi.

•body: descripcion del problema. Este parámetro debe ser de tipo String en su modelo de Bizagi.

•labels: Este parámetro debe ser un arreglo de strings en su modelo de Bizagi.

•assignees: Este parámetro debe ser un arreglo de strings en su modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/issues/#create-an-issue.

Delete a Comment (Borrar un comentario)

Esta acción permite borrar un comentario.

Para configurar las entradas de esta acción tenga en cuenta:

• owner (Requerido): dueño del repositorio (nombre de usuario en GitHub). Si no se especifica este campo, se usa la variable global OWNER. Este parámetro debe ser de tipo String en su modelo de Bizagi.

• repo (Requerido): nombre del repositorio. Si no se especifica este campo, se usa la variable global REPO. Este parámetro debe ser de tipo String en su modelo de Bizagi.

• comment_id (Requerido): ID del comentario que se quiere eliminar. Este parámetro debe ser un número en su modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/issues/comments/#delete-a-comment.

Edit a Comment (Editar un comentario)

Esta acción permite editar un comentario.

Para configurar las entradas de esta acción tenga en cuenta:

•repo (Requerido): nombre del repositorio. Si no se especifica este campo, se usa la variable global REPO. Este parámetro debe ser de tipo String en su modelo de Bizagi.

•comment_id (Requerido): ID del comentario que se quiere editar. Este parámetro debe ser un número en su modelo de Bizagi.

•body (Requerido): contenido del comentario. Este parámetro debe ser de tipo String en su modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/issues/comments/#edit-a-comment.

Edit an Issue (Editar una incidencia)

Esta acción permite editar una incidencia.

Para configurar las entradas de esta acción tenga en cuenta:

•repo (Requerido): nombre del repositorio. Si no se especifica este campo, se usa la variable global REPO. Este parámetro debe ser de tipo String en su modelo de Bizagi.

•issue_number (Requerido): número de ID de la incidencia. Este parámetro debe ser un número en su modelo de Bizagi.

•title (Requerido): título de la incidencia. Este parámetro debe ser de tipo String en su modelo de Bizagi.

•body: descripción de la incidencia. Este parámetro debe ser de tipo String en su modelo de Bizagi.

•state: el nuevo estado de la incidencia. Posibles valores: "open", "closed". Default: "open". Este parámetro debe ser de tipo String en su modelo de Bizagi.

•labels: etiquetas a asociar con esta incidencia. Solo los usuarios con "push access" pueden asignar etiquetas a las incidencias. Si no se tienen los permisos necesarios, las etiquetas se eliminan sin generar ningun tipo de error. Este parámetro debe ser un arreglo de strings en su modelo de Bizagi.

•assignees: usuarios asignados a esta incidencia. Solo los usuarios con "push access" pueden asignar usuarios a incidencias. Si no se tienen los permisos necesarios, los asignados se eliminan sin generar ningun tipo de error. Este parámetro debe ser un arreglo de strings en su modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/issues/#edit-an-issue.

Get a Single Comment (Obtener un comentario)

Esta acción permite obtener un comentario específico.

Para configurar las entradas de esta acción tenga en cuenta:

•repo (Requerido): nombre del repositorio. Si no se especifica este campo, se usa la variable global REPO. Este parámetro debe ser de tipo String en su modelo de Bizagi.

•comment_id (Requerido): ID del comentario que se quiere consultar. Este parámetro debe ser un número en su modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/issues/comments/#get-a-single-comment.

Get a Single Issue (Obtener una incidencia)

Esta acción permite obtener una incidencia específica.

Para configurar las entradas de esta acción tenga en cuenta:

• owner (Requerido): dueño del repositorio (nombre de usuario en GitHub). Si no se especifica este campo, se usa la variable global OWNER. Este parámetro debe ser de tipo String en su modelo de Bizagi.

• repo (Requerido): nombre del repositorio. Si no se especifica este campo, se usa la variable global REPO. Este parámetro debe ser de tipo String en su modelo de Bizagi.

• issue_number (Requerido): número de ID del problema. Este parámetro debe ser un número en su modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/issues/#get-a-single-issue.

List All Issues (Listar todas las incidencias)

Esta acción permite get obtener multiples incidencias.

Para configurar las entradas de esta acción tenga en cuenta:

•org: se puede especificar este parámetro de manera opcional, para solo listar incidencias dentro de una organización específica. Ej: la organización "Bizagi". De esta manera, se le hace más fácil al usuario ver solo las incidencias de una organización, sin mezclarlos con sus repositorios privados u otras organizaciones a las que pertenece. Si no se especifica este parámetro en la entrada de la acción, se usa la variable global ORG, y si no existe en la variable global ORG, se ignora y se muestran los problemas que el usuario autenticado puede ver según los filtros que haya puesto en el parámetro "filter". Este parámetro debe ser de tipo String en su modelo de Bizagi.

•filter: filtra la incidencias a retornar. Posibles valores: "assigned" (solo incidencias asignadas al usuario autenticado), "created" (incidencias creadas por el usuario autenticado), "mentioned" (incidencias donde se menciona el usuario autenticado), "subscribed" (incidencias a las que el usuario autenticado está inscrito para recibir actualizaciones), "all" (todas las incidencias que el usuario autenticado puede ver, sin importar su participación o creación). Default: "assigned". Este parámetro debe ser de tipo String en su modelo de Bizagi.

•state: indica el estado de las incidencias a retornar. Posibles valores: "open", "closed", "all". Default: "open". Este parámetro debe ser de tipo String en su modelo de Bizagi.

•labels: etiquetas utilizados para filtrar las incidencias. Este parámetro debe ser un arreglo de strings en su modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/issues/#list-issues.

List All Labels in a Repository (Listar todas las etiquetas en un repositorio)

Esta acción permite obtener todas las etiquetas de un repositorio.

Para configurar las entradas de esta acción tenga en cuenta:

•repo (Requerido): nombre del repositorio. Si no se especifica este campo, se usa la variable global REPO. Este parámetro debe ser de tipo String en su modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/issues/labels/#list-all-labels-for-this-repository.

List Assignees (Listar asignados)

Esta acción permite obtener todos los asignados.

Para configurar las entradas de esta acción tenga en cuenta:

•repo (Requerido): nombre del repositorio. Si no se especifica este campo, se usa la variable global REPO. Este parámetro debe ser de tipo String en su modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/issues/assignees/#list-assignees.

List Comments in a Repository (Listar los comentarios en un repositorio)

Esta acción permite obtener todos los comentarios de un repositorio.

Para configurar las entradas de esta acción tenga en cuenta:

• owner (Requerido): dueño del repositorio (nombre de usuario en GitHub). Si no se especifica este campo, se usa la variable global OWNER. Este parámetro debe ser de tipo String en su modelo de Bizagi.

• repo (Requerido): nombre del repositorio. Si no se especifica este campo, se usa la variable global REPO. Este parámetro debe ser de tipo String en su modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/issues/comments/#list-comments-in-a-repository.

List Comments on an Issue (Listar comentarios en una incidencia)

Esta acción enumera todos los comentarios que se han añadido a una incidencia específica en GitHub.

Para configurar las entradas de esta acción tenga en cuenta:

•repo (Requerido): nombre del repositorio. Si no se especifica este campo, se usa la variable global REPO. Este parámetro debe ser de tipo String en su modelo de Bizagi.

•issue_number (Requerido): número de ID del problema. Este parámetro debe ser un número en su modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/issues/comments/#list-comments-on-an-issue.

List Issues for a Repository (Listar incidencias de un repositorio)

Esta acción permite obtener multiples problemas de un repositorio.

Para configurar las entradas de esta acción tenga en cuenta:

•repo (Requerido): nombre del repositorio. Si no se especifica este campo, se usa la variable global REPO. Este parámetro debe ser de tipo String en su modelo de Bizagi.

•state: indica el estado de los problemas a retornar. Posibles valores: "open", "closed", "all". Por defecto: "open". Este parámetro debe ser de tipo String en su modelo de Bizagi.

•labels: etiquetas utilizados para filtrar los problemas. Este parámetro debe ser un arreglo de strings en su modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/issues/#list-issues-for-a-repository.

List releases for a repository (Listar versiones de un repositorio)

Esta acción permite obtener todas las versiones de un repositorio.

Para configurar las entradas de esta acción tenga en cuenta:

•repo (Requerido): nombre del repositorio. Si no se especifica este campo, se usa la variable global REPO. Este parámetro debe ser de tipo String en su modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/repos/releases/#list-releases-for-a-repository.

Lock an Issue (Bloquear una incidencia)

Esta acción permite bloquear una incidencia.

Para configurar las entradas de esta acción tenga en cuenta:

•repo (Requerido): nombre del repositorio. Si no se especifica este campo, se usa la variable global REPO. Este parámetro debe ser de tipo String en su modelo de Bizagi.

•issue_number (Requerido): número de ID de la incidencia. Este parámetro debe ser un número en su modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/issues/#lock-an-issue.

Remove Assignees From an Issue (Quitar asignados de una incidencia)

Esta acción permite eliminar todos los asignados de una incidencia.

Para configurar las entradas de esta acción tenga en cuenta:

•repo (Requerido): nombre del repositorio. Si no se especifica este campo, se usa la variable global REPO. Este parámetro debe ser de tipo String en su modelo de Bizagi.

•issue_number (Requerido): número de ID de la incidencia. Este parámetro debe ser un número en su modelo de Bizagi.

•assignees (Requerido): nombres de los usuarios que se quieren eliminar de la incidencia. Si se ingresan usuarios que no existen o que no están asignados al problema, no genera ningún tipo de error, sino que simplemente se ignoran. Este parámetro debe ser un arreglo de strings en su modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/issues/assignees/#remove-assignees-from-an-issue.

Unlock an Issue (Desbloquear una incidencia)

Esta acción permite desbloquear una incidencia.

Para configurar las entradas de esta acción tenga en cuenta:

• owner (Requerido): dueño del repositorio (nombre de usuario en GitHub). Si no se especifica este campo, se usa la variable global OWNER. Este parámetro debe ser de tipo String en su modelo de Bizagi.

• repo (Requerido): nombre del repositorio. Si no se especifica este campo, se usa la variable global REPO. Este parámetro debe ser de tipo String en su modelo de Bizagi.

• issue_number (Requerido): número de ID de la incidencia. Este parámetro debe ser un número en su modelo de Bizagi.

Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.

Para más información de este método diríjase a la documentación oficial de GitHub - https://developer.github.com/v3/issues/#unlock-an-issue.

Last Updated 12/12/2025 8:42:31 AM