Affidatari: le persone e gli enti a cui sono affidati gli animali. Nel web service è il tipo DHMAFFIDATARI (valore 73 di DataType); gli oggetti sono della classe DHMAffidatari e viaggiano nella lista ObjectListDHMAffidatari della richiesta e della risposta.
Scheda tecnica
| Voce | Valore |
|---|
| Tipo di dato | DHMAFFIDATARI = 73 |
| Classe | DHMAffidatari |
| Lista nella richiesta e nella risposta | ObjectListDHMAffidatari |
| Tabella letta da QUERY | DHMAffidatari — è il nome da usare davanti alle colonne in SQLFilter |
| Operazioni ammesse | QUERY (3), INSERTORMODIFY (0), DELETE (1), TRUNCATETABLE (2) |
| Campi chiave | Codice + Tipo — identificano il record: con gli stessi valori INSERTORMODIFY aggiorna, con valori nuovi crea |
| Chiave per cancellare con DeletingClass | Codice|Tipo |
| Chiave per le conferme di ricezione | Codice|Tipo — come si usa |
| Controlli prima del salvataggio | Codice: «Codice non specificato»
Nome: «Nome non specificato»
Cognome: «Cognome non specificato»
Tipo: «Tipo non specificato» |
I campi di DHMAffidatari
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». |
Tipo | Testo | Chiave, sì | "A" | tipo | Tipo. Se manca il server risponde «Tipo non specificato». |
Nome | Testo | Sì | vuoto | nome | Nome. Se manca il server risponde «Nome non specificato». |
Cognome | Testo | Sì | vuoto | cognome | Cognome. Se manca il server risponde «Cognome non specificato». |
ComuneNascitaISTAT | Testo | — | — | natoa | Comune nascita ISTAT. |
ComuneNascita | Testo | — | vuoto | natoacitta | Comune nascita. |
NazioneNascita | Testo | — | vuoto | nazionenasc | Nazione nascita. |
DataDiNascita | Data e ora | — | nessuna data | natoil | Data di nascita. |
Sesso | Testo | — | vuoto | sesso | Sesso. |
CodiceFiscale | Testo | — | vuoto | cf | Codice fiscale. |
NumeroDocumentoDiRiconoscimento | Testo | — | vuoto | documento | Numero documento di riconoscimento. |
TipoDocumentoDiRiconoscimento | Testo | — | vuoto | tipodoc | Tipo documento di riconoscimento. |
TipoDocumentoDiRiconoscimentoDescrizione | Testo | — | vuoto | destipodoc | Descrizione di TipoDocumentoDiRiconoscimento, riportata per comodità di chi legge. |
DocumentoDiRiconoscimentoRilasciatoDa | Testo | — | vuoto | rilasciato | Documento di riconoscimento rilasciato da. |
DocumentoDiRiconoscimentoDataRilascio | Data e ora | — | nessuna data | dataril | Documento di riconoscimento data rilascio. |
DocumentoDiRiconoscimentoDataScadenza | Data e ora | — | nessuna data | datascadenza | Documento di riconoscimento data scadenza. |
Indirizzo | Testo | — | vuoto | indirizzo | Indirizzo (via e numero civico). |
CAP | Testo | — | vuoto | cap | Codice di avviamento postale. |
Citta | Testo | — | vuoto | citta | Città. |
Provincia | Testo | — | vuoto | prov | Sigla della provincia. |
Telefono | Testo | — | vuoto | telefono | Numero di telefono. |
Note | Testo | — | vuoto | note | Note libere. |
Email | Testo | — | vuoto | email | Indirizzo email. |
EmailPEC | Testo | — | vuoto | pec | Email PEC. |
CategoriaAnagrafica | Testo | — | vuoto | categoria | Categoria anagrafica. Codice dell'archivio Categorie anagrafiche. |
CategoriaAnagraficaDescrizione | Testo | — | vuoto | descataff | Descrizione di CategoriaAnagrafica, riportata per comodità di chi legge. |
AziendaRagioneSociale | Testo | — | vuoto | azragsoc | Azienda ragione sociale. |
AziendaIndirizzo | Testo | — | vuoto | azindirizzo | Azienda indirizzo. |
AziendaCAP | Testo | — | vuoto | azcap | Azienda CAP. |
AziendaCitta | Testo | — | vuoto | azcitta | Azienda città. |
AziendaProvincia | Testo | — | vuoto | azprov | Azienda provincia. |
AziendaPartitaIVA | Testo | — | vuoto | azpartitaiva | Azienda partita IVA. |
AziendaCodiceFiscale | Testo | — | vuoto | azcodfiscale | Azienda codice fiscale. |
AziendaTelefono | Testo | — | vuoto | aztelefono | Azienda telefono. |
AziendaEmail | Testo | — | vuoto | azemail | Azienda email. |
AziendaPEC | Testo | — | vuoto | azpec | Azienda PEC. |
ListaFileAllegati | Elenco di ImageTrasmission | — | elenco vuoto | — | File allegati. |
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": 73,
"GuidPC": "gestionale-01",
"AllInsert": false,
"ObjectListDHMAffidatari": [
{
"Codice": "COD001",
"Tipo": "COD002",
"Nome": "Esempio",
"Cognome": "ESEMPIO",
"ComuneNascitaISTAT": "ESEMPIO",
"ComuneNascita": "ESEMPIO",
"NazioneNascita": "ESEMPIO"
}
]
}
Lettura con filtro: fino a 100 record, ignorando le conferme di ricezione.
JSON · QUERY{
"DataOperation": 3,
"TypeObject": 73,
"GuidPC": "gestionale-01",
"SQLFilter": "DHMAffidatari.codice = 'COD001'",
"QueryParameter": {
"IgnoreImportRecord": true,
"StartingRecord": 1,
"LimitRecord": 100
}
}
Cancellazione: bastano i campi chiave.
JSON · DELETE{
"DataOperation": 1,
"TypeObject": 73,
"GuidPC": "gestionale-01",
"ObjectListDHMAffidatari": [
{
"Codice": "COD001",
"Tipo": "COD002"
}
]
}
Le regole su formati, date, numeri e compressione sono in formato e trasporto; esempi completi in esempi di codice.