Integrazione JIRA

Da CometaSoftware Wiki.
Jump to navigation Jump to search

Per eseguire i servizi presenti in questa sezione è necessario utilizzare un utente che abbia il permesso Accesso API

Metodi presenti un questa sezione:

  • jira/commesse Consente di recuperare la lista delle commesse da indicare nella creazione del task
  • jira/task consenti di inserire/modificare i task


METODO HTTP Verb PARAMETRI RISULTATO
jira/commesse POST

Ricerca commesse

application/json

{
    "filtri":
    {
        "stato":"A",
        "descrizione":"XXX",
        "id":"234"
    },
    "pagina":"1",
    "recordPerPagina":"100"

    
}

descrizione dei parametri

parametro descrizione default obbligatorio
stato stato della commessa. Può assumere i seguneti valori: A (Aperta), C (Chiusa), S (StandBy)
descrizione descrizione della commessa
id id della commessa


In caso di successo:

{
    "parametriDiRicerca": {
        "filtri": {
            "stato": "A",
            "id": 0,
            "descrizione": null
        },
        "pagina": 1,
        "recordPerPagina": 2
    },
    "totaleRecordRicerca": 56,
    "totaleRecord": 2,
    "commesse": [
        {
            "id": 548,
            "descrizione": "AM COMETA RQI",
            "numeroRisorseAssegnate": 0,
            "stato": "A",
            "dataInizio": "2020-11-15T00:00:00",
            "dataFineEffettiva": "0001-01-01T00:00:00",
            "dataFinePrevista": "2021-11-30T00:00:00",
            "giorniStimati": 0.0,
            "giorniLavorati": 0.0,
            "tipologia": "Canone di manutenzione",
            "capoProgetto": "Vespignani Giacomo",
            "responsabileDiStruttura": "Vespignani Giacomo",
            "unitaOrganizzativa": "",
            "cliente": "FOR DATA",
            "clienteFinale": "RQI",
            "offerta": "2020_00110_VG_FOR DATA - rivendita cometa RQI",
            "tags": "",
            "settore": "Vendita e manutenzione ns. prodotti e soluzioni"
        },
        {
            "id": 569,
            "descrizione": "Attività di supporto per applicativo VUMAS",
            "numeroRisorseAssegnate": 2,
            "stato": "A",
            "dataInizio": "2021-01-01T00:00:00",
            "dataFineEffettiva": "0001-01-01T00:00:00",
            "dataFinePrevista": "2021-12-31T00:00:00",
            "giorniStimati": 30.0,
            "giorniLavorati": 0.625,
            "tipologia": "Canone di manutenzione",
            "capoProgetto": "Genova Bruno",
            "responsabileDiStruttura": "Vespignani Giacomo",
            "unitaOrganizzativa": "",
            "cliente": "CODD & DATE SRL",
            "clienteFinale": "",
            "offerta": "2021_00012_AE_CODD & DATE SRL - Manutenzione evolutiva VUMAS",
            "tags": "",
            "settore": "Vendita e manutenzione ns. prodotti e soluzioni"
        }
    ]
}

In caso di errore:

{
  "successo": false,
  "messaggio": "Descrizione dell'errore"
}
jira/task POST

Inserimento commesse

application/json

{
    "IDCommessa":"726",
    "titolo":"Task di prova Jira 1",
    "descrizione":"C'è una grave errore 1",
    "idIssue":"100",
    "idSubTask":"201",
    "issueKey":"PRJ-200",
    "codiceStato":"100",
    "codiceAmbiente":"200",
    "codicePriorita":"100",
    "codiceTipologia":"100",
    "idsTags":[1,2],
    "fix":true,
    "workaround":false,
    "DataFinePrevista":"2021-04-20T17:30:00",
    "allegati":[
        {
        "nomeFile":"test.txt",
        "descrizione":"file di prova",
        "base64FileData":"RmlsZSBkaSBwcm92YSBmaWxlIGRpIHByb3ZhIHF1ZXN0byDDqCB1biBmaWxlIGRpIHByb3Zh"
        }
    ]
}

descrizione dei parametri

parametro descrizione default obbligatorio
idCommessa id della commessa recuperato con il servizio jira/commesse SI
titolo titolo del task SI
descrizione descrizione del task SI
idIssue isIssue jira SI
idSubTask tisSubTask jira SI
idSubTask tisSubTask jira SI
issueKey codice identificativo del Task su Jira
codiceAmbiente codice identificativo dell'ambiente di riferimento: da definire con il cliente SI
codicePriorita codice identificativo della priorità del task: da definire con il cliente SI
codiceTipologia codice identificativo della tipologia del task: da definire con il cliente SI
dataFinePrevista Data fine per la risoluzione del task prevista SI
fix identifica un task di fix è obbligatorio indicare un o tra i due valori fix o workaround
idsTags array di ID dei tag ta associare al Task
allegati allegati al task

La data è nel fomato ISO yyyy-mm-ddTHH:mm:ss
Date valide possono essere:

  • 2017-12-5
  • 2020-01-25
  • 2021-04-20T16:20:00



In caso di successo:

{
    "idTask": 900,
    "successo": true
}


In caso di errore:

{
  "successo": false,
  "messaggio": "Descrizione dell'errore",
}
PUT

application/json

{
    "idTask":"902",
    "idIssue":"101",
    "idSubTask":"203",
    "issueKey":"PRJ-210",
    "codiceStato":"130",
    "codicePriorita":"100",
    "descrizione":"C'è una grave errore w",
    "DataFinePrevista":"2021-04-20T17:30:00",
    "allegati":[
        {
        "nomeFile":"test.txt",
        "descrizione":"file di prova",
        "base64FileData":"RmlsZSBkaSBwcm92YSBmaWxlIGRpIHByb3ZhIHF1ZXN0byDDqCB1biBmaWxlIGRpIHByb3Zh"
        }
    ]
}

descrizione dei parametri

parametro descrizione default obbligatorio
idTask id del task di cometa SI
descrizione descrizione del task
idIssue idIssue jira SI
idSubTask idSubTask jira SI
issueKey codice identificativo del Task in Jira
codiceStato codice identificativo dello stato del task: valori da concordare con il cliente
codicePriorita codice identificativo della priorità del task: valori da concordare con il cliente
DataFinePrevista Data fine per il task prevista
allegati allegati al task

La data è nel fomato ISO yyyy-mm-ddTHH:mm:ss
Date valide possono essere:

  • 2017-12-5
  • 2020-01-25
  • 2021-04-20T16:20:00


In caso di successo:

{
  "successo": true,
  "messaggio": null
}


In caso di errore:

{
  "successo": false,
  "messaggio": "Descrizione dell'errore"
}