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/span>


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",
    "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
codiceStato codice identificativo dello stato del task: da definire con il cliente SI
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",
    "codiceStato":"130",
    "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/td> SI
idSubTask idSubTask jira/td> SI
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"
}