Utenti dell'area riservata: gli utenti registrati sul sito della struttura. Nel web service è il tipo DHMUSER (valore 93 di DataType); gli oggetti sono della classe DHMUser e viaggiano nella lista ObjectListDHMUser della richiesta e della risposta.
Scheda tecnica
| Voce | Valore |
|---|
| Tipo di dato | DHMUSER = 93 |
| Classe | DHMUser |
| Lista nella richiesta e nella risposta | ObjectListDHMUser |
| Tabella letta da QUERY | DHMECommUtenti — è il nome da usare davanti alle colonne in SQLFilter |
| Operazioni ammesse | QUERY (3), INSERTORMODIFY (0), DELETE (1), TRUNCATETABLE (2) |
| Campi chiave | Username — identificano il record: con gli stessi valori INSERTORMODIFY aggiorna, con valori nuovi crea |
| Chiave per cancellare con DeletingClass | Username |
| Chiave per le conferme di ricezione | Username — come si usa |
| Controlli prima del salvataggio | Username: «Username non specificato» |
I campi di DHMUser
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 |
|---|
Username | Testo | Chiave, sì | vuoto | username | Nome utente. Se manca il server risponde «Username non specificato». |
Password | Testo | — | vuoto | password | Password. |
Descrizione | Testo | — | vuoto | descrizione | Descrizione del record, mostrata nel gestionale e sul sito. |
TipoUtente | Testo | — | vuoto | tipo | Tipo utente. |
Cellulare1 | Testo | — | vuoto | cellulare1 | Cellulare 1. |
Cellulare2 | Testo | — | vuoto | cellulare2 | Cellulare 2. |
Email | Testo | — | vuoto | email | Indirizzo email. |
PEC | Testo | — | vuoto | pec | Indirizzo di posta elettronica certificata. |
LimitaOperazioni | Vero/falso | — | false | abilitperdata | Limita operazioni. |
LimitaOperazioniDaData | Data e ora | — | nessuna data | abilitperdatadadata | Limita operazioni da data. |
LimitaOperazioniAData | Data e ora | — | nessuna data | abilitperdataadata | Limita operazioni a data. |
Logo | ImageTrasmission | — | oggetto vuoto | — | Logo, come file in Base64. |
StrutturaAssociata | Testo | — | vuoto | strutturaassociata | Struttura associata. |
OperatoreAssociato | Testo | — | vuoto | tecnico | Operatore associato. |
ClienteAssociato | Testo | — | vuoto | clienteass | Cliente associato. |
ClienteFatturazioneAssociato | Testo | — | vuoto | clifatt | Cliente fatturazione associato. |
AlertInserimentoRichiesta | Testo | — | vuoto | tipoavviso | Alert inserimento richiesta. |
AlertInserimentoEAutorizzazioneRichiesta | Testo | — | vuoto | tipoavviso | Alert inserimento e autorizzazione richiesta. |
AlertAutorizzazioneRichiesta | Testo | — | vuoto | tipoavviso | Alert autorizzazione richiesta. |
AlertAssegnazioneRichiesta | Testo | — | vuoto | tipoavviso | Alert assegnazione richiesta. |
AlertConclusaRichiesta | Testo | — | vuoto | tipoavviso | Alert conclusa richiesta. |
AlertInserimentoInterventoAvvisoStrutture | Testo | — | vuoto | tipoavviso | Alert inserimento intervento avviso strutture. |
AlertConfermaRicezioneStruttura | Testo | — | vuoto | tipoavviso | Alert conferma ricezione struttura. |
ComuniAbilitatiAbilitaTutti | Vero/falso | — | false | abilitatutticomuni | Comuni abilitati abilita tutti. |
RaggruppamentoStatisticoOrdini | Testo | — | — | raggrstatordini | Raggruppamento statistico ordini. |
AbilitazioniComuni | Elenco di Testo | — | elenco vuoto | comune | Abilitazioni comuni. |
ComuniAbilitatiElencoCAP | Elenco di Testo | — | elenco vuoto | comune | Comuni abilitati elenco CAP. |
TipologieInterventiAbilitati | Elenco di Testo | — | elenco vuoto | tipointervento | Tipologie interventi abilitati. |
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": 93,
"GuidPC": "gestionale-01",
"AllInsert": false,
"ObjectListDHMUser": [
{
"Username": "utente@example.com",
"Password": "ESEMPIO",
"Descrizione": "Descrizione di esempio",
"TipoUtente": "ESEMPIO",
"Cellulare1": "ESEMPIO",
"Cellulare2": "ESEMPIO"
}
]
}
Lettura con filtro: fino a 100 record, ignorando le conferme di ricezione.
JSON · QUERY{
"DataOperation": 3,
"TypeObject": 93,
"GuidPC": "gestionale-01",
"SQLFilter": "DHMECommUtenti.username = 'COD001'",
"QueryParameter": {
"IgnoreImportRecord": true,
"StartingRecord": 1,
"LimitRecord": 100
}
}
Cancellazione: bastano i campi chiave.
JSON · DELETE{
"DataOperation": 1,
"TypeObject": 93,
"GuidPC": "gestionale-01",
"ObjectListDHMUser": [
{
"Username": "utente@example.com"
}
]
}
Le regole su formati, date, numeri e compressione sono in formato e trasporto; esempi completi in esempi di codice.