Differenze tra le versioni di "Integrazione JIRA"

Da CometaSoftware Wiki.
Jump to navigation Jump to search
Riga 156: Riga 156:
 
                     <pre>
 
                     <pre>
 
{
 
{
     "idCommessa":"548",
+
     "IDCommessa":"726",
     "titolo":"Prova api",
+
     "titolo":"Task di prova Jira 1",
     "commento":{
+
     "descrizione":"C'è una grave errore 1",
        "id":"232",
+
    "idIssue":"100",
        "testo":"task creato di prova"
+
    "idSubTask":"201",
     },
+
     "codiceStato":"100",
     "idIssue":"AAXXVV",
+
     "codiceAmbiente":"200",
     "idSubTask":"123",
+
     "codicePriorita":"100",
     "stato":"100",
+
     "codiceTipologia":"100",
     "dataFineWorkaround":"2021-03-20T15:12:00",
+
     "fix":true,
     "dataFineFix":"2021-04-20T16:20:00",
+
    "workaround":false,
 +
     "DataFinePrevista":"2021-04-20T17:30:00",
 
     "allegati":[
 
     "allegati":[
 
         {
 
         {
Riga 198: Riga 199:
 
                         </tr>
 
                         </tr>
 
<tr>
 
<tr>
                             <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;'><b>descrizione</b></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;'>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>
Riga 216: Riga 217:
 
                         </tr>
 
                         </tr>
 
<tr>
 
<tr>
                             <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;'><b>codiceStato</b></td>
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>codice identificativo dello stato del task:  
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>codice identificativo dello stato del task: da definire con il cliente
                          <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>
+
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>dataFineWorkaround</b></td>
+
<tr>
                             <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;'><b>codiceAmbiente</b></td>
 +
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>codice identificativo dell'ambiente di riferimento: da definire con il cliente
 +
                            <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>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>codicePriorita</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>codice identificativo della priorità del task: da definire con il cliente
 
                             <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>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>codiceTipologia</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>codice identificativo della tipologia del task: da definire con il cliente
 
                             <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>dataFineFix</b></td>
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>dataFinePrevista</b></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;'>Data fine per la risoluzione del task prevista</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>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>fix</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>identifica un task di 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;'>è obbligatorio indicare un o tra i due valori fix o workaround</td>
 +
                        </tr>
 +
<tr>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>workaround</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>identifica un task di 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;'>è obbligatorio indicare un o tra i due valori fix o workaround</td>
 +
                        </tr>
 +
 +
 
                         </tr>
 
                         </tr>
 
<tr>
 
<tr>
Riga 274: Riga 291:
 
                     <pre>
 
                     <pre>
 
{
 
{
     "idTask": 2259
+
     "idTask": 900,
 +
    "successo": true
 
}
 
}
 
</pre>
 
</pre>

Versione delle 17:58, 17 apr 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":"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",
    "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/td> 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
workaround identifica un task di workaround è obbligatorio indicare un o tra i due valori fix o workaround
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

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