Visión general

La integración de Notion de Rootly utiliza workflows para generar y actualizar automáticamente documentos de Notion - y sus permisos - Si no está familiarizado con cómo funcionan los Workflows, por favor visite primero nuestra documentación de Workflows.

Acciones de Workflow disponibles

Crear un documento de Notion

Esta acción le permite crear una retrospectiva de incidente en un documento de Notion.

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

Unidad

Este campo le permite seleccionar en qué unidad de Google Drive crear la retrospectiva. Déjelo vacío si desea crearla en su My Drive. Si va a crearla en una unidad compartida, asegúrese de que la cuenta que utilizó para integrar Google Docs tenga acceso a esta unidad.

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 el campo Title.

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 la página 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 Custom Retrospective Template será anulado.

Marcar post mortem como publicado

Este campo le permite definir el estado de la retrospectiva. Una retrospectiva puede estar en estado draft o published. Esto se usa típicamente si tiene flujos de trabajo de notificación automatizados que solo se activan cuando el estado de la retrospectiva es published.

ID de plantilla de Google Doc

Este campo le permite seleccionar una plantilla predefinida de su Google Drive. Por favor, consulte Configuración de plantillas de retrospectiva en Google Doc para 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 Custom Retrospective Template y el campo Retrospective Template 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 documento de Google

Esta acción le permite actualizar un documento de Google existente.

Tenga en cuenta que esta acción de workflow sobrescribirá el documento de retrospectiva existente. Si ya ha realizado ediciones manuales directamente a través de Google Docs, esas ediciones se 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 workflow.

Archivo

Este campo le permite especificar el id del documento en su Google Drive que desea actualizar. El valor predeterminado está establecido en {{ incident.google_drive_id }}. La sintaxis Liquid es compatible en este campo.

Título

Este campo te permite actualizar el título del documento de Google. La sintaxis Liquid es compatible en este campo.

Plantilla de Retrospectiva Personalizada

Este campo te permite actualizar el contenido del cuerpo del documento de Google. La sintaxis Liquid es compatible en este campo.

Plantilla de Retrospectiva

Este campo te permite usar una plantilla de retrospectiva predefinida para actualizar el contenido del cuerpo del documento de Google.

Si se selecciona una plantilla en este campo, el contenido definido en elCustom Retrospective Templatecampo será anulado.

ID de la Plantilla de Google Doc

Este campo te permite seleccionar una plantilla predefinida de tu Google Drive para actualizar el contenido del cuerpo de tu documento de Google.

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 te permite otorgar a los usuarios los permisos necesarios para el documento de retrospectiva.

Nombre

Este campo se configura automáticamente para ti. Puedes renombrar este campo a lo que mejor describa tu acción. El valor en este campo no afecta cómo se comporta la acción del flujo de trabajo.

Archivo

Este campo te permite especificar el id del archivo en tu Google Drive para el que quieres crear permisos. El valor predeterminado está configurado como{{ incident.google_drive_id }}. La sintaxis Liquid es compatible en este campo.

Definir Permisos de Compartir

Puedes 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, puedes notificar por correo electrónico a los usuarios a quienes se les otorgan permisos.

Mensaje de Correo Electrónico

Opcionalmente, puedes proporcionar un mensaje para enviar con la notificación por correo electrónico. El mensaje se enviará solo si la casillaSend Email Notificationestá marcada.

Eliminar Permisos de Google Doc

Esta acción te permite revocar los permisos de usuario existentes para un documento de retrospectiva.

Nombre

Este campo se configura automáticamente para ti. Puedes renombrar este campo a lo que mejor describa tu acción. El valor en este campo no afecta cómo se comporta la acción del flujo de trabajo.

Archivo

Este campo te permite especificar el id del archivo en tu Google Drive del que quieres revocar permisos. El valor predeterminado está configurado como{{ incident.google_drive_id }}. La sintaxis Liquid es compatible en este campo.

Atributo para Consultar

Este campo te permite seleccionar un atributo por el cual quieres 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 del que quieres revocar los permisos.

Valor

Este campo te permite especificar el valor del atributo que se seleccionó en el campo anterior, Atributo para Consultar. 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 necesitas ayuda o más información sobre esta integración, por favor contacta asupport@rootly.como inicia un chat navegando aAyuda > Chatear con Nosotros.