Differenze tra le versioni di "Integrazione JIRA"

Da CometaSoftware Wiki.
Jump to navigation Jump to search
 
(13 versioni intermedie di uno stesso utente non sono mostrate)
Riga 66: Riga 66:
 
                         <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>id</b></td>
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>id della commessa/span></td>
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>id della commessa</span></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>
Riga 161: Riga 161:
 
     "idIssue":"100",
 
     "idIssue":"100",
 
     "idSubTask":"201",
 
     "idSubTask":"201",
 +
    "issueKey":"PRJ-200",
 
     "codiceStato":"100",
 
     "codiceStato":"100",
 
     "codiceAmbiente":"200",
 
     "codiceAmbiente":"200",
 
     "codicePriorita":"100",
 
     "codicePriorita":"100",
 
     "codiceTipologia":"100",
 
     "codiceTipologia":"100",
 +
    "idsTags":[1,2],
 
     "fix":true,
 
     "fix":true,
 
     "workaround":false,
 
     "workaround":false,
Riga 206: Riga 208:
 
<tr>
 
<tr>
 
                             <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;'><b>idIssue</b></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;'>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>idSubTask</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>tisSubTask 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;'>SI</td>
 +
                        </tr>
 +
<tr>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>idSubTask</b></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>idSubTask</b></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>tisSubTask jira</td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>tisSubTask jira</td>
Riga 217: Riga 225:
 
                         </tr>
 
                         </tr>
 
<tr>
 
<tr>
                             <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;'><b>issueKey</b></td>
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>codice identificativo dello stato del task: da definire con il cliente
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>codice identificativo del Task su Jira
 +
                            <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>
  
Riga 241: Riga 249:
 
                             <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>dataFinePrevista</b></td>
 
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>dataFinePrevista</b></td>
Riga 254: Riga 263:
 
                         </tr>
 
                         </tr>
 
<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;'><b>idsTags</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;'>array di ID dei tag ta associare 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;'>è obbligatorio indicare un o tra i due valori fix o workaround</td>
 
 
                         </tr>
 
                         </tr>
 
 
Riga 320: Riga 329:
 
                     <pre>
 
                     <pre>
 
{
 
{
     "commento":{
+
     "idTask":"902",
        "id":"23222",
+
    "idIssue":"101",
        "testo":"task modificato di prova"
+
    "idSubTask":"203",
    },
+
     "issueKey":"PRJ-210",
     "idTask":"2259",
+
     "codiceStato":"130",
     "idIssue":"AAXXVV",
+
     "codicePriorita":"100",
     "stato":"110",
+
     "descrizione":"C'è una grave errore w",
     "dataFineWorkaround":"2021-03-20T15:12:00",
+
     "DataFinePrevista":"2021-04-20T17:30:00",
     "dataFineFix":"2021-04-20T16:20:00",
 
 
     "allegati":[
 
     "allegati":[
 
         {
 
         {
Riga 355: Riga 363:
 
 
 
<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 362: Riga 370:
 
<tr>
 
<tr>
 
                             <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;'><b>idIssue</b></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;'>idIssue 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>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>idSubTask</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>idSubTask 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;'>SI</td>
 +
                        </tr>
 +
<tr>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>issueKey</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>codice identificativo del Task in 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>
 
                         </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: valori da concordare con il cliente
                          <ul>
+
</td>
                                <li>100 (to do per workaround)
+
                             <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
                                </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>
 
 
                         </tr>
 
                         </tr>
<tr>
+
<tr>
                             <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;'><b>codicePriorita</b></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;'>codice identificativo della priorità del task: valori da concordare con il cliente
 +
</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>
 
                         </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 il 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;'></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>
 
                         </tr>
 
                         </tr>
 +
 +
 +
 
<tr>
 
<tr>
 
                             <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;'><b>allegati</b></td>
Riga 410: Riga 423:
  
 
<p>
 
<p>
                     La data è nel fomato ISO yyyy-mm-dd
+
                     La data è nel fomato ISO yyyy-mm-ddTHH:mm:ss
 
                     <br />
 
                     <br />
 
                     Date valide possono essere:
 
                     Date valide possono essere:
                     <ul><li>2017-12-5</li><li>2020-01-25</li></ul>
+
                     <ul><li>2017-12-5</li><li>2020-01-25</li>
 
+
<li>2021-04-20T16:20:00</li>
                   
+
</ul>
 
   
 
   
 
   
 
   

Versione attuale delle 11:27, 10 gen 2022

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


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",
    "issueKey":"PRJ-200",
    "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
idSubTask tisSubTask jira SI
issueKey codice identificativo del Task su Jira
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",
    "issueKey":"PRJ-210",
    "codiceStato":"130",
    "codicePriorita":"100",
    "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 SI
idSubTask idSubTask jira SI
issueKey codice identificativo del Task in Jira
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"
}