Differenze tra le versioni di "Integrazione JIRA"

Da CometaSoftware Wiki.
Jump to navigation Jump to search
Riga 295: Riga 295:
 
               <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
 
               <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
  
<b>notespesa</b></td>
+
<b></b></td>
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>POST</td>
+
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>PUT</td>
  
 
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
 
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
Riga 302: Riga 302:
 
                     <pre>
 
                     <pre>
 
{
 
{
"matricola":"AAA",
+
    "commento":{
"data":"2020-01-04",
+
        "id":"23222",
"id":"XXXX",
+
        "testo":"task modificato di prova"
"causale":"Pranzo",
+
    },
"importoUnitario":12.5,
+
    "idTask":"2259",
"quantita": 1,
+
    "idIssue":"AAXXVV",
"aziendale":false
+
    "stato":"110",
 +
    "dataFineWorkaround":"2021-03-20T15:12:00",
 +
    "dataFineFix":"2021-04-20T16:20:00",
 +
    "allegati":[
 +
        {
 +
        "nomeFile":"test.txt",
 +
        "descrizione":"file di prova",
 +
        "base64FileData":"RmlsZSBkaSBwcm92YSBmaWxlIGRpIHByb3ZhIHF1ZXN0byDDqCB1biBmaWxlIGRpIHByb3Zh"
 +
        }
 +
    ]
 
}
 
}
  
 
</pre>
 
</pre>
                    <p><b>descrizione dei parametri</b></p>
+
                    <p><b>descrizione dei parametri</b></p>
 
                     <table border="0" style="border:1px solid #999; border-collapse:collapse">
 
                     <table border="0" style="border:1px solid #999; border-collapse:collapse">
 
                         <tr>
 
                         <tr>
Riga 321: Riga 330:
 
                         </tr>
 
                         </tr>
 
                         <tr>
 
                         <tr>
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>matricola</b></td>
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>idTask</b></td>
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>matricola della risorsa</td>
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>id del task di cometa</td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>SI</td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>SI</td>
 
                         </tr>
 
                         </tr>
 +
 
<tr>
 
<tr>
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>data</b></td>
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>commento</b></td>
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>data della spesa</td>
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>descrizione del task</td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>SI</td>
 
 
                         </tr>
 
                         </tr>
 
<tr>
 
<tr>
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>id</b></td>
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>idIssue</b></td>
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>identificativo della spesa</td>
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>isIssue jira/td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>SI</td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>SI</td>
 
                         </tr>
 
                         </tr>
 +
 
<tr>
 
<tr>
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>causale</b></td>
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>stato</b></td>
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>causale della spesa</td>
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>codice identificativo dello stato del task:
 +
                          <ul>
 +
                                <li>100 (to do per workaround)
 +
                                </li>
 +
<li>110 (to do per fix)
 +
                                </li>
 +
<li>120 (solved)
 +
                                </li>
 +
<li>130 (closed)
 +
                                </li>
 +
                            </ul></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>SI</td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>SI</td>
 
                         </tr>
 
                         </tr>
 
<tr>
 
<tr>
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>importoUnitario</b></td>
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>dataFineWorkaround</b></td>
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>importo unitario della spesa</td>
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>Data fine per workaround</td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>SI</td>
 
 
                         </tr>
 
                         </tr>
 +
 +
 
<tr>
 
<tr>
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>quantita</b></td>
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>dataFineFix</b></td>
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>quantità oggetto della spesa</td>
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>data di fine per fix</td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>SI</td>
 
 
                         </tr>
 
                         </tr>
 
<tr>
 
<tr>
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>aziendale</b></td>
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>allegati</b></td>
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>spesa già sostenuta dall'azienda</td>
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>allegati al task</td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>

Versione delle 21:01, 16 mar 2021

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-ddTHH:mm:ss
Date valide possono essere:

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



In caso di successo:

{
    "idTask": 2259
}


In caso di errore:

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

application/json

{
    "commento":{
        "id":"23222",
        "testo":"task modificato di prova"
    },
    "idTask":"2259",
    "idIssue":"AAXXVV",
    "stato":"110",
    "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
idTask id del task di cometa SI
commento descrizione del task
idIssue isIssue jira/td> 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 caso di successo:

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


In caso di errore:

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