Universal Web Platform · Valori delle varianti

CorpoVariante: i valori di ogni variante, generali o specifici di un articolo

Valori delle varianti: i valori di ogni variante, generali o specifici di un articolo. Nel web service è il tipo CORPOVARIANTE (valore 8 di DataType); gli oggetti sono della classe CorpoVariante e viaggiano nella lista ObjectListCorpoVariante della richiesta e della risposta.

Scheda tecnica

VoceValore
Tipo di datoCORPOVARIANTE = 8
ClasseCorpoVariante
Lista nella richiesta e nella rispostaObjectListCorpoVariante
Tabella letta da QUERYCorpoVarianti — è il nome da usare davanti alle colonne in SQLFilter
Operazioni ammesseQUERY (3), INSERTORMODIFY (0), DELETE (1), TRUNCATETABLE (2)
Campi chiaveCodiceVariante + Codice — identificano il record: con gli stessi valori INSERTORMODIFY aggiorna, con valori nuovi crea
Chiave per cancellare con DeletingClassCodiceVariante|Codice
Chiave per le conferme di ricezioneCodiceVariante|Codice|CodiceArticolo — come si usa
Controlli prima del salvataggioCodiceVariante: «Codice variante non specificato»
Codice: «Codice non specificato»
Descrizione: «Descrizione non specificato»

I campi di CorpoVariante

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
CodiceVarianteTestoChiave, sìvuotocodicevarCodice della variante a cui appartiene il valore. Codice dell'archivio Varianti. Se manca il server risponde «Codice variante non specificato».
CodiceTestoChiave, sìvuotocodiceCodice univoco del record. È la chiave con cui il record viene creato o aggiornato. Se manca il server risponde «Codice non specificato».
CodiceArticoloTesto—vuotocodartCodice dell'articolo, se il valore vale solo per quell'articolo; vuoto se vale per tutti. Codice dell'archivio Articoli.
DescrizioneTestoSìvuotodescrizioneDescrizione del record, mostrata nel gestionale e sul sito. Se manca il server risponde «Descrizione non specificato».
ProgressivoIntero—0progressivoNumero progressivo della riga all'interno del record principale.
DefaultValueVero/falso—falsedefvalueVero se è il valore proposto per primo.
NonStampareVero/falso—falsenostampaVero per non stampare il valore nei documenti.
EsportaVero/falso—falseesportaprestaVero se il record va esportato.

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": 8,
  "GuidPC": "gestionale-01",
  "AllInsert": false,
  "ObjectListCorpoVariante": [
    {
      "CodiceVariante": "COD001",
      "Codice": "COD002",
      "CodiceArticolo": "COD003",
      "Descrizione": "Descrizione di esempio",
      "Progressivo": 1,
      "DefaultValue": false
    }
  ]
}

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

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

Cancellazione: bastano i campi chiave.

JSON · DELETE
{
  "DataOperation": 1,
  "TypeObject": 8,
  "GuidPC": "gestionale-01",
  "ObjectListCorpoVariante": [
    {
      "CodiceVariante": "COD001",
      "Codice": "COD002"
    }
  ]
}

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

PrecedenteVariantiSuccessivaDepositi