Come esportare gli item in PhotoRobot Controls App
In PhotoRobot Controls App (di seguito «CAPP») gli utenti possono esportare gli item su un disco locale oppure su PhotoRobot Cloud.

Questo Manuale di supporto utente PhotoRobot descrive come utilizzare e risolvere i problemi dell'esportazione degli item in CAPP e tratta i seguenti argomenti:
- Opzioni di esportazione degli item
- Formati di output
- Formattazione dei file
- Modelli di nome file
- Salvataggio e caricamento delle configurazioni
- Esportazione degli item su disco locale
- Esportazione degli item sul cloud
Esportazione degli item (locale)
Selezione degli item da esportare
Per selezionare gli item da esportare da CAPP verso un'unità locale, aprire prima il Project in cui sono archiviati.
All'interno di un Project vengono visualizzati 25 item per impostazione predefinita. È possibile selezionare singoli item da esportare oppure tutte le 25 voci presenti in una pagina.
Per selezionare tutti gli item di un progetto, fare clic sul comando Select all entries, visualizzato accanto al numero di voci selezionate:

Dopo aver selezionato gli item da esportare, il numero totale di item viene visualizzato nella parte in alto a destra della pagina. Verificare che il numero totale sia corretto e fare clic su Export per aprire la finestra di esportazione:

Configurazione delle opzioni di esportazione
Nel menu Export items, nella parte superiore della finestra sono visualizzati tutti gli item da esportare. Le impostazioni di esportazione sono poi organizzate in passaggi, a partire dalla scelta della cartella locale in cui salvare i file esportati.

Selezione della destinazione di esportazione
Il primo passaggio del menu Export è Destination. Nel campo Output folder* è possibile scegliere la cartella locale in cui verranno salvati i file esportati.

Modifica dello stato degli item
Il passaggio Item status consente di contrassegnare facoltativamente gli item esportati come Exported al termine del processo. È inoltre possibile attivare o disattivare l'opzione che evita di modificare lo stato degli item che non contengono foto.

Assegnazione dei metadati delle immagini
L'opzione Image metadata consente di incorporare autore, copyright, titolo, descrizione e parole chiave nei file immagine esportati. Selezionare la casella accanto a Embed metadata in exported images per attivarla o disattivarla. L'attivazione consente di configurare i valori predefiniti in Settings e fornisce un'anteprima dei metadati dell'immagine da allegare.

Aggiunta delle opzioni della galleria
Il passaggio Galleria , quando esporti gli elementi, serve ad aggiungere anteprima HTML, file dati SpinViewer e miniature insieme alle immagini esportate. Spunta le caselle accanto a ogni opzione per abilitarle o disabilitarle. È anche possibile abilitare Aggiungi dati OCR estratti nella configurazione data.json.

- Add HTML preview – Selezionare questa casella per generare un'anteprima HTML accanto agli elementi esportati, su cui gli utenti possono fare clic per ispezionarli.
- Add data.json config for PhotoRobot SpinViewer – Selezionare questa casella per configurare il file di configurazione JSON principale.
- Nota: dopo la configurazione, verificare che la sintassi JSON sia valida.
- Export thumbnail images – Esportare le immagini con le miniature.
- Add extracted OCR data into data.json config – Includere il riconoscimento ottico dei caratteri (OCR) negli elementi esportati.
Definire i formati di output
Infine, per ogni esportazione è necessario selezionare gli Output formats. Questo passaggio definisce gli output still, spin, anteprima e ritocco per l'esportazione.

Fare clic sull'opzione (+) Add output format per scegliere il formato da esportare: Spin (immagini 360 / 3D), Still images e Images for export.

- Spin (360 / 3D) images – Esportare gli elementi come spin del prodotto.
- Still images – Esportare immagini statiche, ad esempio una galleria di 5 o 6 foto.
- Images for retouch – Contrassegnare le immagini per il ritocco esterno prima dell'esportazione finale.
Nota: quando si aggiungono più output, è possibile configurare opzioni di menu distinte per le immagini Spin (360 / 3D), per le immagini Still o per altri formati di output.
Il campo Folder filter consente quindi di lasciare vuote le cartelle per includere tutte le cartelle di un determinato tipo. Inserire i nomi per individuare le cartelle corrispondenti in tutti gli elementi esportati.
Scegliere il formato file da esportare
Per ogni output, selezionare il formato file in cui scaricare le immagini: JPG, PNG, WebP o TIFF. Sono disponibili ulteriori opzioni per regolare i DPI, scegliere il colore di sfondo (Background color), modificare la qualità (Change quality) e scaricare i file originali o ridimensionati. Il campo Filename* mostra il nome del file esportato.

- JPG – Il formato JPG è apprezzato per compatibilità e dimensioni ridotte, ma durante il trasferimento alcuni dati possono andare persi. Ciò dipende dalla compressione con perdita di JPG, che non sempre restituisce una rappresentazione 1:1 dell'immagine originale.
- PNG – Il formato PNG utilizza una compressione senza perdita per scaricare le immagini in una rappresentazione 1:1 del file originale. I file PNG possono inoltre essere forniti con sfondo trasparente, ma hanno dimensioni molto maggiori rispetto ai JPG e sul web vengono usati molto raramente.
- WebP – Il formato WebP di Google è in genere compatibile ovunque e riunisce in un unico formato le caratteristiche di JPG e PNG. WebP offre una compressione superiore, sia con perdita sia senza perdita; i file possono avere trasparenza e le immagini possono essere compresse a dimensioni estremamente ridotte.
- TIFF – Il formato TIFF è estremamente raro e viene utilizzato solo in casi molto particolari, per garantire la compatibilità con sistemi legacy. Per questo motivo TIFF è supportato in modo limitato in CAPP e non è consigliato per l'esportazione degli elementi.
Nota: i formati file consigliati sono WebP e JPG. Inoltre, WebP è preferibile a JPG, poiché a parità di indice SSIM richiede costantemente meno bit per pixel. Al contrario, le dimensioni dei file PNG sono spesso eccessive per il web e il formato viene utilizzato solo in casi particolari. Si tenga inoltre presente che i DPI sono impostati su 72 per impostazione predefinita. La modifica dei DPI non influisce sulla risoluzione dell'immagine, per cui nella maggior parte dei casi si consiglia di mantenere l'impostazione predefinita.
Impostare il colore di sfondo (solo file JPG trasparenti)
Se si configura per l'esportazione un file JPG trasparente, è possibile selezionare un colore di sfondo facendo clic su Background color:

- Nota: le opzioni del colore di sfondo sono disponibili solo per i file JPG trasparenti.
- Le opzioni Change quality funzionano sia per i file JPG sia per i file WebP.
Modificare la qualità (JPG, WebP)
Per regolare la qualità delle immagini nei file JPG o WebP, selezionare la casella Change quality sotto la selezione del formato file:

La qualità (Change quality) si misura su una scala da 1 a 100 (dal livello più basso al più alto) e incide contemporaneamente sulle dimensioni del file e sulla qualità dell'immagine.
Nota: per i file JPG e WebP, i livelli di qualità ideali rientrano in intervalli diversi. Sarà quindi necessario regolare questo valore in base al formato file e al rapporto desiderato tra dimensioni e qualità.
- Change quality (JPG) - La compressione JPG si misura in genere come percentuale del livello di qualità. Ad esempio, un'immagine con qualità 100 non presenta quasi alcuna perdita, ma ha un peso file maggiore. Al contrario, un'immagine con qualità 1 è di qualità estremamente bassa. In generale, i file JPG con qualità pari o superiore a 90 sono considerati di «alta qualità», quelli tra 80 e 90 di «qualità media» e quelli tra 70 e 80 di «bassa qualità».
- Change quality (WebP) - Nella maggior parte dei casi, i livelli di qualità ideali per WebP si collocano nell'intervallo tra 50 e 80. Con un valore di qualità pari o superiore a 80, spesso non si nota alcuna differenza apprezzabile nella qualità dell'immagine, mentre il peso dei file aumenta. Con valori pari o inferiori a 50, il peso dei file si riduce solo di poco, mentre la qualità dell'immagine risulta gravemente compromessa.
Esportare l'immagine originale o ridimensionata
Per tutti i tipi di file, è possibile scegliere se esportare gli item nelle dimensioni originali o in una risoluzione ridimensionata a piacere:

- Original - È l'impostazione predefinita, che mantiene la risoluzione originale dell'immagine.
- Resized - Consente di specificare la dimensione massima in pixel dell'immagine da esportare (esempio: risoluzione 1200).
Denominazione dei file nell'esportazione degli item
L'ultimo passaggio prima dell'esportazione degli item consiste nella scelta di un Filename*. In questa fase è possibile selezionare o modificare le variabili del modello dell'immagine:

Per accedere alla finestra di aiuto, fare clic su Show template variables tramite l'icona con il punto interrogativo a destra del nome file inserito:

Le variabili standard comprendono:
- ${nomeprogetto}
- ${itemName}
- ${codice a barre}
- ${trackingCode}
- ${folderName}
Le variabili che richiedono ulteriori spiegazioni sono:
- ${rowAngle} - Indica l'angolazione verticale da cui è stata scattata l'immagine.
- ${turnAngle} - Indica l'angolazione orizzontale da cui è stata scattata l'immagine.
- ${rowIndex} - È simile all'angolo di riga, ma utilizza un indice all'interno della riga (esempio: se le righe sono 3, l'indice di riga va da 001 a 003).
- ${turnIndex} - È simile all'angolo di rotazione, ma utilizza un indice all'interno della rotazione (esempio: se uno spin ha 24 frame, l'indice di rotazione va da 001 a 024).
I modelli possono essere ulteriormente personalizzati tramite variabili:
- ${label} - Consente di creare un'etichetta di base per un item da esportare (esempio: front, back, side).
- ${gs1} - Consente di configurare etichette avanzate per gli item secondo gli standard GS1 per le immagini.
- ${order} - Indica l'indice dell'immagine all'interno della cartella. È simile all'indice di rotazione, ma anziché una posizione all'interno di una riga indica una posizione all'interno di una cartella (esempio: con 2 righe da 24 frame, la prima riga ha indici da 1 a 24, la seconda da 25 a 48.
- ${stopId}
- ${tag:key} - Consente di personalizzare i *tag di un item.
I tag all'interno di un nome file possono fungere, ad esempio, da etichetta per distinguere «Product A» da «Product B». In questo caso, il nome file per Product A potrebbe essere: ${projectName}/${itemName}(${tag:productid}/${folderName}/${rowAngle}_a${turnAngle}.jpg
Sono inoltre disponibili opzioni di formattazione personalizzata per personalizzare ulteriormente alcune variabili, tra cui: ${rowIndex}, ${turnIndex} e ${order}. Per personalizzarle, far seguire alla variabile il simbolo dei due punti e un valore, ad esempio:
- ${turnIndex:2} - Formatta i nomi file dell'indice di rotazione con due cifre anziché con l'indice numerico predefinito a tre cifre (ad es. 01, 02, 03 e così via).
- ${rowIndex:2:0} - Formatta i nomi file dell'indice di riga con una lunghezza di due cifre, a partire da zero (ad es. 00, 01, 02 e così via).
- ${order:4:20} - Formatta l'indice d'ordine con una lunghezza di quattro cifre, a partire dal numero 20 (ad es. 0020, 0021, 0022 e così via).
( ! ) - Duplicate path error: se in un modello si utilizza r${rowAngle}_a${turnAngle} e si esportano anche immagini statiche che condividono righe con gli stessi angoli, è necessario specificare ${order} nel modello. In questo modo si evita il «Duplicate path error»; la sintassi corretta è la seguente: ${order}_r${rowAngle}_a${turnAngle}.
Salvare o caricare le configurazioni
È quindi possibile salvare un template di esportazione con le relative configurazioni oppure caricarne uno dal proprio archivio.
Per salvare o caricare un template di esportazione, acceda alle opzioni del template tramite l'icona del menu accanto a Export items, nella parte superiore del menu di esportazione:

Per salvare, faccia clic su Save per creare un nuovo template, assegni un nome e aggiunga tag o note per l'indicizzazione o la consultazione future:

Esportazione degli item sul disco locale
Dopo aver configurato il template di esportazione con tutti gli output richiesti, la formattazione dei file e le variabili del nome file, faccia clic su Export in basso a destra nell'interfaccia:

Al termine dell'esportazione, tutti gli item vengono trasferiti da CAPP al percorso specificato sul disco locale.
Esportazione degli item (nel cloud)
L'esportazione degli item nel cloud segue la stessa procedura dell'esportazione su disco locale e offre le stesse funzionalità.
- Configuri le opzioni di esportazione, gli output, i formati dei file e le variabili del nome file:

L'unica differenza è che, con l'esportazione degli item nel cloud, CAPP genera un link con un indirizzo URL per accedere all'item esportato.
- Nella scheda Exports, faccia clic su Get link accanto all'item da esportare:

- Faccia clic su Copy link per salvare l'indirizzo URL dell'item da esportare:

- Incolli il link dagli appunti nella barra degli indirizzi del browser per accedere all'item da scaricare. I link generati vengono conservati e restano disponibili per il download per 7 giorni.

- Per scaricare le immagini è necessario installare l'app PhotoRobot File Manager. Faccia clic su Download Mac installer (disponibile anche per Windows) se non utilizza già l'app sul Suo dispositivo.

- Faccia clic su Download now per selezionare una cartella di destinazione per il download dell'item, quindi faccia clic sul pulsante Download finale sotto il percorso dell'item:

Al termine del download, PhotoRobot File Manager mostra sia i download sia gli upload:

- Faccia clic su Show in finder per aprire la cartella contenente le immagini esportate.
