Crear y Actualizar Topics

Puede crear y modificar topics dentro de sus rulebooks.

Crear un topic¶

Debe enviar al menos el título, categoría y estado inicial para su topic:

do:
   - mid = create_topic:
          category: Enhancement
          data:
            description: |
                 Solo una breve descripción
          status: New
          title: My topic title

La operación create_topic devolverá el mid (id) del nuevo topic.

Modificar un topic¶

Para modificar un topic, necesita al menos el mid del topic que desea modificar.

do:
    - update_topic:
         mid: ${mid}
         data:
            title: 'Changed it just now'

Dependiendo de su contexto, el mid puede estar disponible en el objeto de contexto. Por ejemplo, si su regla está enganchada a un evento topic_modify:

topic_modify:
    - topic =: "{{ ctx.topic() }}"
    - update_topic:
         mid: ${topic.mid}
         data:
            title: 'Changed it just now'

Cambiar el Estado del Topic¶

Puede promover/degradar un topic de un estado a otro con la operación change_status.

El estado to solo puede ser uno, y es requerido.

topic_modify:
    - topic =: "{{ ctx.topic() }}"
    - change_status:
        mid: ${topic.mid}
        to: Fixed

La operación change_status también puede cambiar múltiples topics a la vez y filtrar por varios estados from.

do:
    - change_status:
        mid: [ '123', '456' ],
        to: Fixed

También puede filtrar el estado from, para que garantice que solo los topics que realmente están en la lista from tengan sus estados cambiados al estado to.

do:
    - change_status:
        mid:
            - 123
            - 456
        from:
           - 'To Do'
           - 'In Progress'
        to: Fixed

Permisos¶

Las operaciones anteriores siempre usarán el usuario actual que ejecuta el rulebook.

Para un trabajo de pipeline, será el usuario que creó el trabajo.
Para un evento, el usuario que disparó el evento.
Para una llamada webhook, el usuario autenticado en Clarive que llamó al webhook.

Si el usuario no tiene permisos al proyecto del topic o la categoría del topic en cuestión, se mostrará un error de permisos.