Differenze tra le versioni di "Interrogazione Commesse"

Da CometaSoftware Wiki.
Jump to navigation Jump to search
 
(Una versione intermedia di uno stesso utente non è mostrata)
Riga 4: Riga 4:
 
         <ul>
 
         <ul>
 
             <li><b>commesse</b> metodo che consente di estrarre i dati delle commesse</li>
 
             <li><b>commesse</b> metodo che consente di estrarre i dati delle commesse</li>
 +
<li><b>tipologieAttivita</b> metodo che consente di estrarre tutte le tipologie di attività</li>
 
             <li><b>tipologieCommesse</b> metodo che consente di estrarre tutte le tipologie delle commesse</li>
 
             <li><b>tipologieCommesse</b> metodo che consente di estrarre tutte le tipologie delle commesse</li>
            <li><b>tipologieAttivita</b> metodo che consente di estrarre tutte le tipologie di attività</li>
+
         
  
 
              
 
              
Riga 245: Riga 246:
 
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
 
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
  
<b>presenze</b></td>
+
<b>tipologieAttivita</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;'>POST</td>
  
 
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
 
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
 
                  <b>application/json</b>
 
                  <b>application/json</b>
 +
                 
 +
                </td>
 +
                <td style='border: 1px solid #999; padding: 3px; vertical-align: top; width:400px'>
 +
                    <p>  In caso di successo:</p>
 +
 +
                    <pre>
 +
[
 +
    {
 +
        "id": 6,
 +
        "descrizione": "Business Development",
 +
        "capitabizzabile": false,
 +
        "diProdotto": false
 +
    },
 +
    {
 +
        "id": 1,
 +
        "descrizione": "Cloud Service",
 +
        "capitabizzabile": false,
 +
        "diProdotto": false
 +
    },
 +
    {
 +
        "id": 7,
 +
        "descrizione": "Consulting",
 +
        "capitabizzabile": false,
 +
        "diProdotto": false
 +
    },
 +
...
 +
]
 +
 +
 +
</pre>
 +
                    <p>In caso di errore:</p>
 +
 
                     <pre>
 
                     <pre>
 
{
 
{
   "anno":2020,
+
   "successo": false,
   "mese":"1",
+
   "messaggio": "Descrizione dell'errore"
  "applicativoEsterno":"TeamSystem",
 
  "tipoRisorsa":"dipendente"
 
 
}
 
}
 +
</pre>
 +
 +
                </td>
  
</pre>
+
            </tr>
                    <p><b>descrizione dei parametri</b></p>
 
                    <table border="0" style="border:1px solid #999; border-collapse:collapse">
 
                        <tr>
 
                            <th style=' border: 1px solid #999; padding: 3px; font-size: 10pt; background-color: #DDD; text-transform: uppercase; white-space:owrap;'>parametro</th>
 
                            <th style=' border: 1px solid #999; padding: 3px; font-size: 10pt; background-color: #DDD; text-transform: uppercase; white-space:owrap;'>descrizione</th>
 
                            <th style=' border: 1px solid #999; padding: 3px; font-size: 10pt; background-color: #DDD; text-transform: uppercase; white-space:owrap;'>default</th>
 
                            <th style=' border: 1px solid #999; padding: 3px; font-size: 10pt; background-color: #DDD; text-transform: uppercase; white-space:owrap;'>obbligatorio</th>
 
                        </tr>
 
                        <tr>
 
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>anno</b></td>
 
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>Anno di estrazione</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>
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>mese</b></td>
+
                <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>Mese di estrazione</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>applicativoEsterno</b></td>
 
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>nome applicativo Esterno di si cui è configurata la transcodifica in Cometa</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>
 
                        </tr>
 
                        <tr>
 
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>tipoRisorsa</b></td>
 
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>valori possibili: dipendente, collaboratore, esterno</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>
 
                        </tr>
 
                    </table>
 
  
 +
<b>tipologieCommesse</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;'>
+
                  <b>application/json</b>
+
                 
 
                 </td>
 
                 </td>
 
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top; width:400px'>
 
                 <td style='border: 1px solid #999; padding: 3px; vertical-align: top; width:400px'>
Riga 303: Riga 308:
  
 
                     <pre>
 
                     <pre>
{
+
[
  "risorse": [
+
    {
  {
+
        "id": 21,
  "id": 84,
+
        "descrizione": "Fabrick"
  "codice": "99",
+
    },
  "matricola": "XXX",
+
    {
  "nome": "Paolo",
+
        "id": 26,
  "cognome": "Rossi",
+
        "descrizione": "FBK_AM_PRD"
  "codiceFiscale": "XXX",
+
    },
  "email": "xxx@gmail.com",
 
  "nominativo": "Rossi Paolo",
 
  "giorni": [
 
 
     {
 
     {
    "data": "2020-01-01T00:00:00",
+
        "id": 29,
    "giustificativi": [
+
        "descrizione": "FBK_AM_PRJ"
      {
 
      "id": 3,
 
      "codice": "MAL",
 
      "descrizione": "Malattia",
 
      "minuti": 480
 
      }
 
    ],
 
    "timbrature": [
 
      {
 
      "ingresso": "2020-01-01T09:00:00",
 
      "uscita": "2020-01-01T12:45:00",
 
      "approvata": true,
 
      "minuti": 225
 
      },
 
      {
 
      "ingresso": "2020-01-01T14:00:00",
 
      "uscita": "2020-01-01T18:00:00",
 
      "approvata": false,
 
      "minuti": 240
 
      }
 
    ],
 
    "minutiOrdinari": 300,
 
    "minutiStraordinari": 20,
 
    "minutiStraordinariNotturni": 0,
 
    "minutiStraordinariFestivi": 0,
 
    "minutiStraordinariFestiviNotturni": 0,
 
    "minutiStraordinariFestiviDiurni": 0,
 
    "minutiReperibilita": 0,
 
    "minutiReperibilitaFestiva": 0
 
 
     },
 
     },
    ...
+
...
  ]
+
]
  },
 
...
 
]
 
}
 
  
Il valore del campo codice della risorsa e della timbratura è il codice di transcodifica dell'applicativo impostato nei parametri e configurato in Cometa.
 
  
Le timbrature si popolano se la rirosa effettua le timbrature.
 
 
I campi dei minuti si popolano se la Risorsa compila il timesheet.
 
 
I giustificativi di popolano se si utilizza la funzionalità di gestione dei giustificativi in cometa.
 
 
</pre>
 
</pre>
 
                     <p>In caso di errore:</p>
 
                     <p>In caso di errore:</p>
Riga 375: Riga 338:
  
 
             </tr>
 
             </tr>
 
+
   
         
 
 
         </table>
 
         </table>

Versione attuale delle 12:11, 9 mag 2024

Per eseguire i servizi presenti in questa sezione è necessario utilizzare un utente che abbia il permesso Accesso API

Metodi presenti un questa sezione:

  • commesse metodo che consente di estrarre i dati delle commesse
  • tipologieAttivita metodo che consente di estrarre tutte le tipologie di attività
  • tipologieCommesse metodo che consente di estrarre tutte le tipologie delle commesse


METODO HTTP Verb PARAMETRI RISULTATO
commesse POST

application/json

{
    "filtri":
    {
        "ID":"1368",
        "dataInizioDa":"2024-01-01",
        "dataInizioA":"2024-12-31",
        "dataFineDa":"2024-01-01",
        "dataFineA":"2024-12-31",
        "stato":"A",
        "idTipoAttivita":"13",
        "idTipologia":"29",
        "descrizione":"manute"
    }, 
    "pagina":1,
    "recordPerPagina":200
}

descrizione dei parametri

parametro descrizione default obbligatorio
ID Identificativo della commessa
dataInizioDa Data di inizio della commessa da
dataInizioA Data di inizio della commessa a 8
stato Data di finedella commessa da
dataFineA Data di fine della commessa a
stato Stato della commessa: A = Aperta, C=Chiusa, S=Standby, I = In chiusura
descrizione Descrizione della commessa
idTipoAttivita Tipo dell'attività della commessa recuperabile con il metodo tipologieAttivita
idTipologia Tipo della commessa recuperabile con il metodo tipologieCommesse
pagina numero di pagina richiesto 1
recordPerPagina numero record per pagina di ritorno 50



In caso di successo:

{
    "parametriDiRicerca": {
        "filtri": {
            "id": 1368,
            "descrizione": "manute",
            "idTipologia": 29,
            "idTipoAttivita": 13,
            "stato": "A",
            "dataInizioDa": "2024-01-01T00:00:00",
            "dataInizioA": "2024-12-31T00:00:00",
            "dataFineDa": null,
            "dataFineA": null
        },
        "pagina": 1,
        "recordPerPagina": 50
    },
    "totaleRecordRicerca": 1,
    "totaleRecord": 1,
    "commesse": [
        {
            "id": 1368,
            "descrizione": "Manutenzione Cash In e MyStore",
            "stato": "A",
            "dataInizio": "2024-04-01T00:00:00",
            "dataFineEffettiva": null,
            "dataFinePrevista": null,
            "tipologia": {
                "id": 29,
                "descrizione": "FBK_AM_PRJ"
            },
            "capoProgetto": {
                "id": 1158,
                "cognome": "FRANZETTI",
                "nome": "ALESSANDRO DAVIDE"
            },
            "responsabileDiStruttura": {
                "id": 1325,
                "cognome": "TENIVELLA",
                "nome": "EUGENIO"
            },
            "unitaOrganizzative": [
                {
                    "id": 183,
                    "codice": "FK0078",
                    "nome": "FK0078 - FBK IN STORE SOLUTIONS",
                    "dallaData": "2024-04-30T00:00:00"
                }
            ],
            "cliente": {
                "id": 90,
                "descrizione": "Fabrick Spa"
            },
            "tipoAttivita": {
                "id": 13,
                "descrizione": "Manutenzione Corr.ed Evo. Progetto"
            },
            "attivita": [
                {
                    "id": 8130,
                    "descrizione": "ANALISI E DOCUMENTAZIONE PRD - FBK POS",
                    "percentualeCostoCapitabizzabile": 0.0,
                    "tipoAttivita": {
                        "id": 12,
                        "descrizione": "Manutenzione  Evolutive  Prodotto"
                    }
                },
                {
                    "id": 8131,
                    "descrizione": "ANALISI E DOCUMENTAZIONE PRD - FBK Cash-In",
                    "percentualeCostoCapitabizzabile": 0.0,
                    "tipoAttivita": {
                        "id": 12,
                        "descrizione": "Manutenzione  Evolutive  Prodotto"
                    }
                },
              ...
            ],
            "prodotti": [
                {
                    "id": 145,
                    "codice": "FBK_API_ACTIVE_ENGINE_CORE",
                    "nome": "Active Engine - Core"
                },
                {
                    "id": 6068,
                    "codice": "FBK_PROD_POS",
                    "nome": "FBK POS"
                },
              ...
            ]
        }
    ]
}


In caso di errore:

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

application/json

In caso di successo:

[
    {
        "id": 6,
        "descrizione": "Business Development",
        "capitabizzabile": false,
        "diProdotto": false
    },
    {
        "id": 1,
        "descrizione": "Cloud Service",
        "capitabizzabile": false,
        "diProdotto": false
    },
    {
        "id": 7,
        "descrizione": "Consulting",
        "capitabizzabile": false,
        "diProdotto": false
    },
...
]


In caso di errore:

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

application/json

In caso di successo:

[
     {
        "id": 21,
        "descrizione": "Fabrick"
    },
    {
        "id": 26,
        "descrizione": "FBK_AM_PRD"
    },
    {
        "id": 29,
        "descrizione": "FBK_AM_PRJ"
    },
...
]


In caso di errore:

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