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 in inserimento
commento descrizione del task SI in inserimento
idIssue isIssue jira/td> SI in inserimento
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 in inserimento
gruppi gruppi di COMETA a cui associare la risorsa
sede sede della risorsa SI in inserimento
retribuzioneAnnualeLorda retribuzione annuale lorda della risorsa
rimborsoKmMensile rimborso Km mensile della risorsa
indennitaTrasfertaMensile indennità di trasferta mensile della risorsa
altroMensile altro mensile lorda della risorsa
rimborsoFissoAnnuale rimborso fisso annuale lorda della risorsa
codiceFiscale codice fiscale della risorsa
indirizzo indirizzo della risorsa
indirizzo indirizzo della risorsa
civico civico della risorsa
comune comune della risorsa
provincia provincia della risorsa
cap cap della risorsa
luogoDiNascita luogo di nascita della risorsa
dataAssunzione data assunzione della risorsa
dataLicenziamento data licenziamento della risorsa
dataDiNascita data di nascita della risorsa
buoniPasto buoni pasto spettanti
cellulareAziendale cellulare aziendale della risorsa
cellularePersonale cellulare personale della risorsa
mailPec PEC della risorsa
mailPersonale mail personale della risorsa
codiceUnitaOrganizzativa codice dell'Unità Organizzativa
unitaOrganizzativa nome dell'Unità Organizzativa
inviaMailCredenziali Indica se inviare le credenziali all'utente in fase di inserimento false

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"
}