Jira
Resumo
- Crie e modifique tarefas em uma instância Jira.
Parâmetros
Parâmetro | Tipo | Escolhas | Valor Padrão | Comentários |
|---|---|---|---|
assignee | string | | Define o administrador da tarefa nas operações de criação ou transição. Observe que nem todas as transições permitirão isso. |
comment | string | | O texto do comentário a ser adicionado. |
description | string | | A descrição da tarefa, quando apropriado. |
fields | dictionary | | Esta é uma estrutura de dados de formato livre que pode conter dados arbitrários. Isso é passado diretamente para a API REST do JIRA (possivelmente após a fusão com outros dados necessários, como quando passado para criar). Veja exemplos para obter mais informações e a API REST do JIRA para obter a estrutura necessária para vários campos. |
inwardissue | string | | Defina a tarefa a partir da qual o link será criado. |
issue | string | | Uma chave da tarefa existente para operar. aliases: ticket |
issuetype | string | | O tipo de tarefa, para criação da mesma. |
linktype | string | | Defina o tipo de link, quando a ação 'link' for selecionada. |
operation - required aliases: command | string | Escolhas: - comment - create - edit - fetch - link - transition | A operação a ser executada.
|
outwardissue | string | | Defina a segunda tarefa para a qual o link será criado. |
password - required | string | | A senha para fazer login. |
project | string | | O projeto para esta operação. Obrigatório para a criação da tarefa. |
status | string | | O status desejado; relevante apenas para a operação de transição. |
summary | string | | O resumo da tarefa, quando apropriado. |
timeout | float | - 10 (default) | Defina o tempo limite, em segundos, em solicitações para a API JIRA. |
uri - required | string | | URI de base para a instância JIRA. |
username - required | string | | O nome de usuário para fazer login. |
validate_certs | boolean | Escolhas: - false - true (default) | Exigir certificados SSL válidos (defina como 'false' se desejar usar certificados autoassinados) |
Exemplos
# Exemplo: Criar uma nova tarefa, e comentar na mesma
- jira:
uri: '{{ server }}'
username: '{{ user }}'
password: '{{ pass }}'
project: ANS
operation: create
summary: Example Issue
description: Created using Atmosphere
issuetype: Task
register: issue
# Exemplo: Comentar em uma tarefa
- jira:
uri: '{{ server }}'
username: '{{ user }}'
password: '{{ pass }}'
issue: '{{ issue.meta.key }}'
operation: comment
comment: A comment added by Atmosphere
# Exemplo: Atribuir a tarefa utilizando a operação edit
- jira:
uri: '{{ server }}'
username: '{{ user }}'
password: '{{ pass }}'
issue: '{{ issue.meta.key}}'
operation: edit
assignee: ssmith
# Exemplo: Criar uma tarefa e atribuir alguem à mesma
- jira:
uri: '{{ server }}'
username: '{{ user }}'
password: '{{ pass }}'
project: ANS
operation: create
summary: Assigned issue
description: Created and assigned using Atmosphere
issuetype: Task
assignee: ssmith
# Exemplo: Editar uma tarefa, no caso adicionando fields
- jira:
uri: '{{ server }}'
username: '{{ user }}'
password: '{{ pass }}'
issue: '{{ issue.meta.key }}'
operation: edit
fields:
labels:
- autocreated
- atmosphere
# Exemplo: Retornar os dados de uma tarefa
- jira:
uri: '{{ server }}'
username: '{{ user }}'
password: '{{ pass }}'
project: ANS
operation: fetch
issue: ANS-63
register: issue
# Exemplo: Ligar tarefas de projetos diferentes
- jira:
uri: '{{ server }}'
username: '{{ user }}'
password: '{{ pass }}'
operation: link
linktype: Relates
inwardissue: HSP-1
outwardissue: MKY-1
# Exemplo: Fechar uma tarefa
- jira:
uri: '{{ server }}'
username: '{{ user }}'
password: '{{ pass }}'
issue: '{{ issue.meta.key }}'
operation: transition
status: "Itens concluídos"
Valores retornados
Chave | TIpo | Retornado quando | Descrição |
|---|---|---|---|
changed | boolean | Sempre | Se a operação foi efetuada ou não. |
meta | string | Sucesso | Informações com o resultado da operação. |