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 elTitlecampo.

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 estadodraftopublishedestado. 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:

[
  {
    "type": "user",
    "role": "writer",
    "email_address": "user@example.com"
  },
  {
    "type": "user",
    "role": "owner",
    "transferOwnership": true,
    "email_address": "user@example.com"
  },
  {
    "type": "domain",
    "role": "writer",
    "domain": "example.com"
  }
]

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 Templatecampo 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 Templatecampo yRetrospective Templatecampo 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:

[
  {
    "type": "user",
    "role": "writer",
    "email_address": "user@example.com"
  },
  {
    "type": "user",
    "role": "owner",
    "transferOwnership": true,
    "email_address": "user@example.com"
  },
  {
    "type": "domain",
    "role": "writer",
    "domain": "example.com"
  }
]

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 Notificationcasilla 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:

  1. Type: Puede serUser,GroupoDomain.
  2. Role: Puede serOwner,Viewer,Editor,Writer,Commenter, oNone.
  3. 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 rolWritertendrán sus permisos revocados Ejemplo 2:

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.