Tipi di esame: gli esami che si eseguono sugli animali. Nel web service è il tipo DHMESAME (valore 83 di DataType); gli oggetti sono della classe DHMEsame e viaggiano nella lista ObjectListDHMEsame della richiesta e della risposta.
Scheda tecnica
| Voce | Valore |
|---|
| Tipo di dato | DHMESAME = 83 |
| Classe | DHMEsame |
| Lista nella richiesta e nella risposta | ObjectListDHMEsame |
| Tabella letta da QUERY | DHMTipiEsame — è il nome da usare davanti alle colonne in SQLFilter |
| Operazioni ammesse | QUERY (3), INSERTORMODIFY (0), DELETE (1), TRUNCATETABLE (2) |
| Campi chiave | Codice — identificano il record: con gli stessi valori INSERTORMODIFY aggiorna, con valori nuovi crea |
| Chiave per cancellare con DeletingClass | Codice |
| Chiave per le conferme di ricezione | Codice — come si usa |
| Controlli prima del salvataggio | Codice: «Codice non specificato»
Descrizione: «Descrizione non specificato» |
I campi di DHMEsame
La colonna Obbligatorio riporta i campi chiave e quelli controllati dal server prima di salvare; Predefinito è il valore che il campo assume se non lo invii; Colonna è il nome del campo nel database, da usare nei filtri di lettura.
| Campo | Tipo | Obbligatorio | Predefinito | Colonna | A cosa serve |
|---|
Codice | Testo | Chiave, sì | vuoto | codice | Codice univoco del record. È la chiave con cui il record viene creato o aggiornato. Se manca il server risponde «Codice non specificato». |
Descrizione | Testo | Sì | vuoto | descrizione | Descrizione del record, mostrata nel gestionale e sul sito. Se manca il server risponde «Descrizione non specificato». |
RipetiEsame | Vero/falso | — | false | ripesame | Ripeti esame. |
RipetiEsameNumeroMesi | Intero | — | 0 | nummesi | Ripeti esame numero mesi. |
RipetiEsameNumeroRipetizioni | Intero | — | 0 | ripvolte | Ripeti esame numero ripetizioni. |
ArticoloAssociato | Testo | — | vuoto | articolo | Articolo associato. |
ListaPrezziListino | Elenco di DHMEsamiPrezziListino | — | elenco vuoto | — | Prezzi listino: elenco di oggetti DHMEsamiPrezziListino. |
ListaDettaglioValori | Elenco di DHMEsamiDettaglio | — | elenco vuoto | — | Dettaglio valori: elenco di oggetti DHMEsamiDettaglio. |
Classe annidata DHMEsamiPrezziListino
Elemento usato dentro DHMEsame. I suoi campi si inviano e si ricevono insieme al record principale.
| Campo | Tipo | Obbligatorio | Predefinito | A cosa serve |
|---|
Listino | Testo | — | vuoto | Codice del listino. Codice dell'archivio Listini. |
ListinoDescrizione | Testo | — | vuoto | Descrizione di Listino, riportata per comodità di chi legge. |
Importo | Decimale | — | 0 | Importo. |
Classe annidata DHMEsamiDettaglio
Elemento usato dentro DHMEsame. I suoi campi si inviano e si ricevono insieme al record principale.
| Campo | Tipo | Obbligatorio | Predefinito | A cosa serve |
|---|
Codice | Testo | — | vuoto | Codice univoco del record. È la chiave con cui il record viene creato o aggiornato. |
Descrizione | Testo | — | vuoto | Descrizione del record, mostrata nel gestionale e sul sito. |
Posizione | Intero | — | 0 | Posizione nell'ordinamento: i valori più bassi vengono prima. |
TipoRisultato | Testo | — | vuoto | Tipo risultato. |
TipoRisultatoNumericoIntervalloValoriMinimo | Intero | — | 0 | Tipo risultato numerico intervallo valori minimo. |
TipoRisultatoNumericoIntervalloValoriMassimo | Intero | — | 0 | Tipo risultato numerico intervallo valori massimo. |
TipoRisultatoNumericoIntervalloValoriSuffisso | Testo | — | vuoto | Tipo risultato numerico intervallo valori suffisso. |
TipoRisultatoElencoValori | Elenco di Testo | — | elenco vuoto | Tipo risultato elenco valori. |
SpecieIncluse | Elenco di Testo | — | elenco vuoto | Specie incluse. |
Esempi
Inserimento o aggiornamento di un record (valori di esempio). Ricorda che INSERTORMODIFY riscrive tutti i campi: quelli che non invii tornano al valore predefinito, quindi per modificare un record esistente invia il record completo.
JSON · INSERTORMODIFY{
"DataOperation": 0,
"TypeObject": 83,
"GuidPC": "gestionale-01",
"AllInsert": false,
"ObjectListDHMEsame": [
{
"Codice": "COD001",
"Descrizione": "Descrizione di esempio",
"RipetiEsame": false,
"RipetiEsameNumeroMesi": 1,
"RipetiEsameNumeroRipetizioni": 1,
"ArticoloAssociato": "ESEMPIO"
}
]
}
Lettura con filtro: fino a 100 record, ignorando le conferme di ricezione.
JSON · QUERY{
"DataOperation": 3,
"TypeObject": 83,
"GuidPC": "gestionale-01",
"SQLFilter": "DHMTipiEsame.codice = 'COD001'",
"QueryParameter": {
"IgnoreImportRecord": true,
"StartingRecord": 1,
"LimitRecord": 100
}
}
Cancellazione: bastano i campi chiave.
JSON · DELETE{
"DataOperation": 1,
"TypeObject": 83,
"GuidPC": "gestionale-01",
"ObjectListDHMEsame": [
{
"Codice": "COD001"
}
]
}
Le regole su formati, date, numeri e compressione sono in formato e trasporto; esempi completi in esempi di codice.