Universal Web Platform · Contenuti

Contenuti: le pagine di contenuto del sito

Contenuti: le pagine di contenuto del sito. Nel web service è il tipo UWPCONTENUTO (valore 106 di DataType); gli oggetti sono della classe UWPContenuto e viaggiano nella lista ObjectListUWPContenuto della richiesta e della risposta.

Scheda tecnica

VoceValore
Tipo di datoUWPCONTENUTO = 106
ClasseUWPContenuto
Lista nella richiesta e nella rispostaObjectListUWPContenuto
Tabella letta da QUERYUWPContenuti — è il nome da usare davanti alle colonne in SQLFilter
Operazioni ammesseQUERY (3), INSERTORMODIFY (0), DELETE (1), TRUNCATETABLE (2)
Campi chiaveCodice — identificano il record: con gli stessi valori INSERTORMODIFY aggiorna, con valori nuovi crea
Chiave per cancellare con DeletingClassCodice
Chiave per le conferme di ricezioneCodice — come si usa
Controlli prima del salvataggioCodice: «Codice non specificato»
Titolo: «Titolo non specificato»

I campi

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.

CampoTipoObbligatorioPredefinitoColonnaA cosa serve
CodiceTestoChiave, sìvuotocodiceCodice univoco del record. È la chiave con cui il record viene creato o aggiornato. Se manca il server risponde «Codice non specificato».
DataData e ora—nessuna datadataData.
TitoloTestoSìvuototitoloTitolo. Se manca il server risponde «Titolo non specificato».
CategoriaTesto—vuotocategoriaCodice della categoria a cui appartiene il record.
DescrizioneBreveTesto—vuotodescrizionebreveDescrizione breve, per elenchi e anteprime.
DescrizioneLungaTesto—vuotodescrizionelungaTesto completo, anche in HTML.
VisibileVero/falso—falsevisibileVero se il contenuto è visibile sul sito.
PosizioneIntero—0posizionePosizione nell'ordinamento: i valori più bassi vengono prima.
LinkSostitutivoTesto—vuotolinksostitutivoIndirizzo a cui portare il visitatore al posto della pagina del contenuto.
ListMediaElenco di MediaEntry—elenco vuoto—Immagini e video del contenuto.

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": 106,
  "GuidPC": "gestionale-01",
  "AllInsert": false,
  "ObjectListUWPContenuto": [
    {
      "Codice": "COD001",
      "Data": "2026-03-15T00:00:00",
      "Titolo": "Esempio",
      "Categoria": "ESEMPIO",
      "DescrizioneBreve": "Descrizione di esempio",
      "DescrizioneLunga": "Descrizione di esempio"
    }
  ]
}

Lettura con filtro: fino a 100 record, ignorando le conferme di ricezione.

JSON · QUERY
{
  "DataOperation": 3,
  "TypeObject": 106,
  "GuidPC": "gestionale-01",
  "SQLFilter": "UWPContenuti.codice = 'COD001'",
  "QueryParameter": {
    "IgnoreImportRecord": true,
    "StartingRecord": 1,
    "LimitRecord": 100
  }
}

Cancellazione: bastano i campi chiave.

JSON · DELETE
{
  "DataOperation": 1,
  "TypeObject": 106,
  "GuidPC": "gestionale-01",
  "ObjectListUWPContenuto": [
    {
      "Codice": "COD001"
    }
  ]
}

Le regole su formati, date, numeri e compressione sono in formato e trasporto; esempi completi in esempi di codice.