Dopo aver recuperato un token di caricamento valido per un periodo di tempo specificato, potete caricare una risorsa immagine. Potete caricare la risorsa come POST multiparte o modulo e inviare gli altri valori come una stringa di richiesta URL, come nell’esempio di seguito:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
I campi
upload_token
e
company_name
sono obbligatori.
Consultate
Ottenimento del token di caricamento
.
Consultate
Richiesta di una chiave segreta condivisa
.
Potete anche inviare altri valori facoltativi come stringhe di richiesta URL, come nell’esempio di seguito:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company&file_limit=2000000&file_exts=jpg,gif
Il parametro
file_limit
specifica il limite di dimensione del file, in byte. Il parametro
file_exts
specifica le estensioni del nome file consentite per il caricamento. Entrambi questi valori sono facoltativi.
Nell’applicazione è possibile impostare un limite globale per la dimensione dei nomi file e le estensioni di file consentite. Se l’elemento inviato nella richiesta è un sottoinsieme dei limiti globali, viene rispettato. I limiti globali sono indicati di seguito:
Limite globale
|
Valore
|
Dimensione file per tutti i client
|
20 MB
|
Formati file immagine supportati per il caricamento
|
BMP, GIF, JPG, PNG, PSD
|
Il seguente modulo HTML consente a un utente di caricare una risorsa. Il modulo richiede l’inserimento delle informazioni di seguito:
Il codice HTML di seguito viene visualizzato quando fate clic con il pulsante destro del mouse nella finestra del browser e fate clic su
Visualizza sorgente
per il modulo illustrato nella figura. Nel codice viene mostrata la stringa di richiesta URL corrispondente e il metodo POST che vengono eseguiti quando l’utente fa clic su Invia.
<html>
<body>
<script language="javascript">
function uploadImage()
{
var preserve_colorprofile = "false";
if(document.image_upload.preserve_colorprofile[0].checked == true){
preserve_colorprofile = "true";
}
var preserve_filename = "false";
if(document.image_upload.preserve_filename[0].checked == true){
preserve_filename = "true";
}
document.image_upload.action="https://s7ugc1.scene7.com/ugc/image?op=upload&company_name="+document.image_upload.company_name.value+"&upload_token="+document.image_upload.upload_token.value+"&file_limit="+document.image_upload.file_limit.value+"&file_exts="+document.image_upload.file_exts.value+"&preserve_colorprofile="+preserve_colorprofile+"&preserve_filename="+preserve_filename;
return true;
}
</script>
<form method="POST" enctype="multipart/form-data" name="image_upload" id="image_upload" onSubmit="return uploadImage();">
<table>
<tr><td colspan="2"><strong> UGC Image Upload Test Page: </strong></td></tr>
<tr><td colspan="2"></td></tr>
<tr><td><strong> Company Name</strong></td><td><input type="text" size="40" name="company_name"></td></tr>
<tr><td><strong> Upload Token </strong></td><td><input type="text" size="40" name="upload_token"></td></tr>
<tr><td><strong> File Size Limit (in bytes) </strong></td><td><input type="text" size="40" name="file_limit"> bytes</td></tr>
<tr><td><strong> File Extensions allowed </strong></td><td><input type="text" size="40" name="file_exts"></td></tr>
<tr><td><strong> Preserve Color Profile</strong></td><td><input type="radio" name="preserve_colorprofile" value="true">Yes <input type="radio" name="preserve_colorprofile" value="false" checked>No</td></tr>
<tr><td><strong> Preserve File Name</strong></td><td><input type="radio" name="preserve_filename" value="true">Yes <input type="radio" name="preserve_filename" value="false" checked>No</td></tr>
<tr><td colspan="2"></td></tr>
<tr>
<td><strong>File to upload: : </strong></td>
<td><input name="filename" type="file" id="filename" size="58" maxlength="1024" /></td>
</tr>
<tr><td colspan="2"></td></tr>
<tr>
<td><strong>Click Submit to upload your image: </strong></td>
<td><input type="submit" value="Submit"></td>
</tr>
</table>
</form>
</body>
</html>
Per visualizzare la risposta XML in Internet Explorer, fate clic su
Visualizza
>
Sorgente
. Per visualizzare la risposta XML in Firefox, fate clic su
Visualizza
>
Sorgente pagina
. Per la visualizzazione delle risposte XML si consiglia Firefox.
Segue un esempio di risposta a seguito di un caricamento riuscito:
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
<user_generated_content>
<response>
<serviceName>User Generated Content - Images</serviceName>
<version>1.0.0</version>
<operationName>upload</operationName>
<serviceStatus>SUCCESS</serviceStatus>
<title>Your file has been uploaded Successfully.</title>
<message>
<url>http://s7w2p1.scene7.com/is/image/ </url>
<path>000Company/ugc/1442564.tif</path>
<fullurl>http://s7w2p1.scene7.com/is/image/000Company/ugc/1442564.tif </fullurl>
</message>
</response>
</user_generated_content>
</scene7>
Nota:
la risorsa caricata (JPG, GIF è così via) viene convertita in formato PTIFF e la risposta invia un collegamento diretto a tale risorsa PTIFF.
La risorsa è come qualsiasi altra risorsa Image Server ed è possibile applicarvi delle query di elaborazione. Ad esempio, con l’URL seguente viene richiesto di ingrandire la risorsa in base alla larghezza e all’altezza specificate.
http://s7w2p1.scene7.com/is/image/S7WebUGC/ugc/9536356.tif?&wid=800&hei=100&fit=stretch
Inviate la risorsa come POST multiparte o modulo mentre inviate gli altri valori come una stringa query URL. Nella stringa query URL potete usare i seguenti campi per caricare una risorsa:
Parametro URL
|
Richiesto o facoltativo
|
Valore
|
op
|
Obbligatorio
|
upload
|
upload_token
|
Obbligatorio
|
Token di caricamento per la chiave segreta condivisa associata alla società.
|
company_name
|
Obbligatorio
|
Nome della società che esegue il caricamento.
|
file_limit
|
Facoltativo
|
Limite dimensione file in byte per la risorsa.
|
file_exts
|
Facoltativo
|
Elenco di estensioni consentite per il file della risorsa immagine.
|
preserve_colorprofile
|
Facoltativo
|
Mantiene eventuale profilo colore incorporato durante la conversione in formato PTIFF del file caricato. I valori consentiti sono true o false. Il valore predefinito è false..
|
preserve_filename
|
Facoltativo
|
Mantiene il nome file della risorsa caricata. I valori consentiti sono true o false. Il valore predefinito è false..
|
Nota:
dovete inviare la risorsa da caricare come unico campo in una richiesta POST multiparte.
URL campione:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
Metodo HTTP consentito:
POST