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":"548",
    "titolo":"Prova api",
    "commento":{
        "id":"232",
        "testo":"task creato di prova"
    },
    "idIssue":"AAXXVV",
    "idSubTask":"123",
    "stato":"100",
    "dataFineWorkaround":"2021-03-20T15:12:00",
    "dataFineFix":"2021-04-20T16:20: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
commento descrizione del task SI
idIssue isIssue jira/td> SI
idSubTask tisSubTask jira SI
stato codice identificativo dello stato del task:
  • 100 (to do per workaround)
  • 110 (to do per fix)
  • 120 (solved)
  • 130 (closed)
SI
dataFineWorkaround Data fine per workaround
dataFineFix data di fine per fix
allegati allegati al task

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

  • 2017-12-5
  • 2020-01-25

In seguito all'inserimento di una nuova risorsa viene inviata automaticamente all'utente una mail con le credenziali e il link per l'accesso al sistema.


In caso di successo:

{
  "successo": true,
  "messaggio": null,
  "operazioneEseguita": "INSERIMENTO",
  "username": null,
  "mailCredenzialiInviata": false
}

Il campo operazioneEseguita può avere i seguenti valori: "INSERIMENTO", "AGGIORNAMENTO".
Nel caso l'operazione eseguita sia "INSERIMENTO" il campo mailCredenzialiInviata a false indica che c'è stato un problema nell'invio della mail.

In caso di errore:

{
  "successo": false,
  "messaggio": "Descrizione dell'errore",
  "operazioneEseguita": null,
  "username": null,
  "mailCredenzialiInviata": false
}
notespesa POST

application/json

{
	"matricola":"AAA",
	"data":"2020-01-04",
	"id":"XXXX",
	"causale":"Pranzo",
	"importoUnitario":12.5,
	"quantita": 1,
	"aziendale":false
}

descrizione dei parametri

parametro descrizione default obbligatorio
matricola matricola della risorsa SI
data data della spesa SI
id identificativo della spesa SI
causale causale della spesa SI
importoUnitario importo unitario della spesa SI
quantita quantità oggetto della spesa SI
aziendale spesa già sostenuta dall'azienda

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

  • 2017-12-5
  • 2020-01-25



In caso di successo:

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


In caso di errore:

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