Jira Geo

IMPORTANTE: Sempre buscar as transicoes disponiveis com getTransitionsForJiraIssue antes de transicionar, pois os IDs podem variar conforme o status atual da tarefa.

Campos Custom Fields Importantes

Valores de Resolution

Valores de "Necessario atualizar" (repositorios)

Formato ADF (Atlassian Document Format)

A API v3 do Jira exige ADF para campos textarea. Strings puras retornam Bad Request.

Estrutura Basica

{
  "type": "doc",
  "version": 1,
  "content": [
    {
      "type": "paragraph",
      "content": [
        { "type": "text", "text": "Texto simples" }
      ]
    }
  ]
}

Elementos ADF Uteis

Heading

{ "type": "heading", "attrs": { "level": 2 }, "content": [{ "type": "text", "text": "Titulo" }] }

Bullet List

{
  "type": "bulletList",
  "content": [
    { "type": "listItem", "content": [{ "type": "paragraph", "content": [{ "type": "text", "text": "Item" }] }] }
  ]
}

Ordered List

{
  "type": "orderedList",
  "content": [
    { "type": "listItem", "content": [{ "type": "paragraph", "content": [{ "type": "text", "text": "Passo 1" }] }] }
  ]
}

Bold

{ "type": "text", "text": "negrito", "marks": [{ "type": "strong" }] }

Link

{ "type": "text", "text": "texto do link", "marks": [{ "type": "link", "attrs": { "href": "https://url" } }] }

Code Inline

{ "type": "text", "text": "codigo", "marks": [{ "type": "code" }] }

IMPORTANTE: Campos textfield (como customfield_10896 Base de dados) aceitam string pura, NAO precisam de ADF.

Procedimentos

1. Enviar para Ready to Review (transicao mais comum)

Esta transicao exige campos obrigatorios na tela de transicao:

Campos obrigatorios:
- resolution (obrigatorio): usar { "name": "Done" } na maioria dos casos
- customfield_10165 (Pull requests): links das PRs em ADF
- customfield_10132 (Alteracoes de escopo): descrever se houve ou nao mudancas
- customfield_10896 (Base de dados): alteracoes de schema como string

Exemplo Completo de Transicao

# 1. Buscar transicoes disponiveis
getTransitionsForJiraIssue(cloudId="geovendas.atlassian.net", issueIdOrKey="GEO-XXXX", expand="transitions.fields")

# 2. Preencher Procedure Description ANTES da transicao (via editJiraIssue)
editJiraIssue(
  cloudId="geovendas.atlassian.net",
  issueIdOrKey="GEO-XXXX",
  fields={
    "customfield_10066": {  # Procedure Description - ADF
      "type": "doc", "version": 1,
      "content": [
        { "type": "heading", "attrs": { "level": 2 }, "content": [{ "type": "text", "text": "Procedimento de Teste" }] },
        { "type": "orderedList", "content": [
          { "type": "listItem", "content": [{ "type": "paragraph", "content": [{ "type": "text", "text": "Passo 1..." }] }] },
          { "type": "listItem", "content": [{ "type": "paragraph", "content": [{ "type": "text", "text": "Passo 2..." }] }] }
        ]}
      ]
    }
  }
)

# 3. Executar transicao com campos da tela
transitionJiraIssue(
  cloudId="geovendas.atlassian.net",
  issueIdOrKey="GEO-XXXX",
  transition={ "id": "71" },  # Send to Revision
  fields={
    "resolution": { "name": "Done" },
    "customfield_10165": {  # Pull requests - ADF
      "type": "doc", "version": 1,
      "content": [{
        "type": "bulletList",
        "content": [
          { "type": "listItem", "content": [{ "type": "paragraph", "content": [
            { "type": "text", "text": "Backend: " },
            { "type": "text", "text": "#XXXX", "marks": [{ "type": "link", "attrs": { "href": "https://github.com/tecnologia-ibtech/REPO/pull/XXXX" } }] }
          ]}]}
        ]
      }]
    },
    "customfield_10132": {  # Alteracoes de escopo - ADF
      "type": "doc", "version": 1,
      "content": [{ "type": "paragraph", "content": [{ "type": "text", "text": "Sem alteracoes de escopo." }] }]
    },
    "customfield_10896": "Descricao das alteracoes de banco"  # String pura
  }
)

2. Atualizar Procedure Description

Sempre usar ADF. Estrutura recomendada para procedure:

1. Pre-requisitos — configuracoes necessarias, flags, servicos
2. Passos numerados por area — frontend, backend, integracao
3. Endpoints REST — listar com metodo, path, parametros
4. Validacoes — o que verificar, comportamentos esperados
5. PRs Relacionadas — links com referencia cruzada entre repos

3. Consultar Tarefa

getJiraIssue(cloudId="geovendas.atlassian.net", issueIdOrKey="GEO-XXXX")

Para ver todos os campos (incluindo custom fields):

getJiraIssue(cloudId="geovendas.atlassian.net", issueIdOrKey="GEO-XXXX", expand="names")

4. Buscar Tarefas com JQL

# Minhas tarefas em desenvolvimento
searchJiraIssuesUsingJql(
  cloudId="geovendas.atlassian.net",
  jql="project = GEO AND assignee = currentUser() AND status = 'In development'"
)

# Tarefas ready to review
searchJiraIssuesUsingJql(
  cloudId="geovendas.atlassian.net",
  jql="project = GEO AND status = 'Ready to Review' ORDER BY updated DESC"
)

5. Adicionar Comentario

addCommentToJiraIssue(
  cloudId="geovendas.atlassian.net",
  issueIdOrKey="GEO-XXXX",
  commentBody="Texto do comentario em Markdown"
)

Erros Comuns

Repositorios GitHub da Geovendas