Flujos de trabajo
Visión general
La integración de Google Docs de Rootly utiliza flujos de trabajo para generar y actualizar automáticamente documentos de Google y sus permisos. Si no estás familiarizado con cómo funcionan los Flujos de trabajo, por favor visita primero nuestra documentación deFlujos de trabajo.
Acciones de Flujo de Trabajo Disponibles
Crear un Documento de Google
Esta acción te permite crear una retrospectiva de incidente en un documento de Google.
Nombre
Este campo se configura automáticamente para usted. Puede renombrar este campo a lo que mejor describa su acción. El valor en este campo no afecta cómo se comporta la acción del flujo de trabajo.
Carpeta Principal
Este campo le permite seleccionar una carpeta en su Google Drive en la que se creará su documento de Google. Si no especifica una carpeta, usaremos la ruta de carpeta especificada en elTitle
campo.
Título
Este campo le permite definir el título del documento de retrospectiva. La sintaxis Liquid es compatible en este campo.
Si desea crear carpetas dinámicamente para anidar su documento, puede hacerlo separando cada carpeta con un/
. Por ejemplo, si ingresa el siguiente texto como título:
{{ incident.created_at | date: '%Y' }}/{{ incident.created_at | date: '%B' }}/{{ incident.title }}
La ruta de almacenamiento será:
[Carpeta] año de creación del incidente > [Carpeta] mes de creación del incidente > [Doc] Título del Incidente
Plantilla de Retrospectiva Personalizada
Este campo le permite definir el contenido del cuerpo de la retrospectiva. La sintaxis Liquid es compatible en este campo.
No se recomienda usar este campo para crear una plantilla de su retrospectiva.
Plantilla de Retrospectiva
Este campo le permite usar una plantilla de retrospectiva predefinida para crear el contenido del cuerpo de la retrospectiva. La lista de plantillas seleccionables se puede definir en lapágina de Plantillas de Retrospectiva.
Se recomienda que use esto para crear una plantilla de su retrospectiva.
Si se selecciona una plantilla en este campo, el contenido definido en el campo Plantilla de Retrospectiva Personalizada será anulado.
Marcar Post Mortem como Publicado
Este campo le permite definir el estado de la retrospectiva. Una retrospectiva puede estar en estadodraft
opublished
estado. Esto se usa típicamente si tiene flujos de trabajo de notificación automatizados que solo se activan cuando el estado de la retrospectiva espublished
.
ID de Plantilla de Google Doc
Este campo le permite seleccionar una plantilla predefinida de su Google Drive. Por favor, veaConfiguración de Plantillas de Retro en Google Docpara aprender cómo configurar una plantilla de retrospectiva en Google Doc.
Use este método de creación de plantillas para una retrospectiva completamente personalizada.
Si se selecciona una plantilla en este campo, el contenido definido en el campo Plantilla de Retrospectiva Personalizada y el campo Plantilla de Retrospectiva será anulado.
Definir Permisos de Compartir
Puede personalizar los permisos como se muestra a continuación:
Actualizar un Google Doc
Esta acción le permite actualizar un Google Doc existente.
Tenga en cuenta que esta acción de flujo de trabajosobrescribiráel documento de retrospectiva existente. Si ya ha realizado ediciones manuales directamente a través de Google Docs, esas edicionesse perderán.
Nombre
Este campo se configura automáticamente para usted. Puede renombrar este campo a lo que mejor describa su acción. El valor en este campo no afecta cómo se comporta la acción del flujo de trabajo.
Archivo
Este campo le permite especificar el id del documento en su Google Drive que desea actualizar. El valor predeterminado está configurado como{{ incident.google\_drive\_id }}
. La sintaxis Liquid es compatible en este campo.
Título
Este campo le permite actualizar el título del Google Doc. La sintaxis Liquid es compatible en este campo.
Plantilla de Retrospectiva Personalizada
Este campo le permite actualizar el contenido del cuerpo del Google Doc. La sintaxis Liquid es compatible en este campo.
Plantilla de Retrospectiva
Este campo le permite usar una plantilla de retrospectiva predefinida para actualizar el contenido del cuerpo del Google Doc.
Si se selecciona una plantilla en este campo, el contenido definido en elCustom Retrospective Template
campo será anulado.
ID de Plantilla de Google Doc
Este campo le permite seleccionar una plantilla predefinida de su Google Drive para actualizar el contenido del cuerpo de su Google Doc.
Si se selecciona una plantilla en este campo, el contenido definido en elCustom Retrospective Template
campo yRetrospective Template
campo será anulado.
Crear Permisos de Google Doc
Esta acción le permite otorgar a los usuarios los permisos necesarios para el documento de retrospectiva.
Nombre
Este campo se configura automáticamente para usted. Puede renombrar este campo a lo que mejor describa su acción. El valor en este campo no afecta cómo se comporta la acción del flujo de trabajo.
Archivo
Este campo le permite especificar el id del archivo en su Google Drive para el que desea crear permisos. El valor predeterminado está configurado como{{ incident.google_drive_id }}
. La sintaxis Liquid es compatible en este campo.
Definir Permisos de Compartir
Puede personalizar los permisos como se muestra a continuación:
Enviar notificación por correo electrónico
Opcionalmente, puede notificar por correo electrónico a los usuarios a quienes se les otorga permiso.
Mensaje de correo electrónico
Opcionalmente, puede proporcionar un mensaje para enviar con la notificación por correo electrónico. El mensaje se enviará solo si laSend Email Notification
casilla está marcada.
Eliminar permisos de Google Doc
Esta acción le permite revocar los permisos de usuario existentes para un documento de retrospectiva.
Nombre
Este campo se establece automáticamente para usted. Puede renombrar este campo a lo que mejor describa su acción. El valor en este campo no afecta cómo se comporta la acción del flujo de trabajo.
Archivo
Este campo le permite especificar el id del archivo en su Google Drive del que desea revocar permisos. El valor predeterminado se establece en{{ incident.google_drive_id }}
. La sintaxis Liquid es compatible en este campo.
Atributo para consultar
Este campo le permite seleccionar un atributo por el cual desea revocar permisos. Hay tres opciones:
Type
: Puede serUser
,Group
oDomain
.Role
: Puede serOwner
,Viewer
,Editor
,Writer
,Commenter
, oNone
.Email Address
(predeterminado): La dirección de correo electrónico del usuario al que desea revocar los permisos.
Valor
Este campo le permite especificar el valor del atributo que se seleccionó en el campo anterior,Attribute to Query By
. La sintaxis Liquid es compatible en este campo.
Ejemplo 1:
- Si,
Attribute to Query By
=Role
Value
=Writer
- Entonces,
- Todos los usuarios con el rol
Writer
tendrán sus permisos revocados Ejemplo 2:
- Todos los usuarios con el rol
Este es el caso de uso más común para revocar permisos.
- Si,
Attribute to Query By
=Email Address
Value
={{ trigger.subscriber.email }}
- Entonces,
- Todos los usuarios que se han dado de baja del incidente tendrán sus permisos revocados
Soporte
Si necesita ayuda o más información sobre esta integración, por favor contacte asupport@rootly.como inicie un chat navegando aAyuda > Chatear con nosotros.