Universal Web Platform · Immagini, file e allegati

Immagini, file e allegati: come si trasmettono i file

Immagini, documenti e allegati viaggiano dentro la richiesta, codificati in Base64, con la classe ImageTrasmission. Il server li salva nella cartella giusta del sito e registra il percorso nel record.

ImageTrasmission

CampoTipoA cosa serve
FileNameTestoNome del file con estensione, per esempio scarpa-rossa.jpg. Viene normalizzato; il server può scriverlo in minuscolo per i siti su Linux.
EncryptedFileTestoIl contenuto del file in Base64. Nonostante il nome non è cifrato: è la semplice codifica Base64 dei byte.
Un ImageTrasmission con EncryptedFile vuoto toglie il file dal record. Se aggiorni un record senza voler cambiare l'immagine devi rinviarla.

Immagini e file degli articoli

Per gli articoli immagini e file hanno i loro tipi: Immagini degli articoli e File degli articoli. Ogni record è identificato da articolo, variante e indice; con FotoDefault scegli la foto principale. Nella risposta alla scrittura trovi, per ogni record e nello stesso ordine, URLExportFoto con l'indirizzo pubblico del file salvato.

JSON · foto principale di un articolo
{
  "DataOperation": 0,
  "TypeObject": 21,
  "GuidPC": "gestionale-01",
  "ObjectListProductImage": [
    {
      "Articolo": "A0001",
      "StringaVariante": "",
      "Indice": 1,
      "FotoDefault": true,
      "Nome": "Vista frontale",
      "Image": { "FileName": "a0001-fronte.jpg", "EncryptedFile": "/9j/4AAQSkZJRgABAQ..." }
    }
  ]
}

Le immagini pesano: inviale a blocchi piccoli (da 10 a 20 per chiamata) e ridimensionale prima, alla misura che serve al sito.

MediaEntry e AttachedFile

I contenuti del sito (news, blog, eventi, servizi...) hanno elenchi di immagini e video (MediaEntry) e di allegati (AttachedFile), descritti nei tipi di supporto. Un MediaEntry è un'immagine oppure un video di YouTube, indicato solo dal codice del video.