Hochladen von Bild-Assets oder Vektor-Assets

Bevor Sie ein Bild-Asset hochladen können, fordern Sie zunächst einen gemeinsamen geheimen Schlüssel an. Mit diesem gemeinsamen geheimen Schlüssel können Sie ein Upload-Token abrufen. Mit dem Upload-Token können Sie anschließend Bild- oder Vektor-Assets hochladen.

Anfordern eines gemeinsamen geheimen Schlüssels

Fordern Sie einen gemeinsamen geheimen Schlüssel von mithilfe der Admin Console an, um einen Unterstützungsfall zu erstellen. Fordern Sie in Ihrem Support-Fall einen gemeinsamen geheimen Schlüssel an.

Geben Sie in der E-Mail-Nachricht den Unternehmensnamen an, den Sie verwenden möchten, um Bild-Assets hochzuladen. Nachdem Sie den Schlüssel von Dynamic Media Classic erhalten haben, speichern Sie ihn lokal für die zukünftige Verwendung.

Abrufen des Upload-Tokens

Das Upload-Token stellt sicher, dass niemand denselben gemeinsamen geheimen Schlüssel zum Hochladen von Assets verwenden kann. Außerdem stellt es sicher, dass der Upload zulässig ist und von einer vertrauenswürdigen Quelle stammt.

Das Upload-Token besteht aus einer alphanumerischen Zeichenfolge, die nur für eine begrenzte Zeitspanne gültig ist. Verwenden Sie die folgenden URLs und ersetzen Sie Ihren gemeinsamen geheimen Schlüssel, um das Upload-Token abzurufen.

• Bild
  https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602In diesem Beispiel lautet der gemeinsame geheime Schlüssel fece4b21-87ee-47fc-9b99-2e29b78b602

• Vektor
  https://s7ugc1.scene7.com/ugc/vector?op=get_uploadtoken&shared_secret=2d19f60e-890a-4e79-a1a5-9ac2875429b9In diesem Beispiel lautet der gemeinsame geheime Schlüssel 2d19f60e-890a-4e79-a1a5-9ac2875429b9

Standardmäßig läuft das Upload-Token 5 Minuten (300 Sekunden) nach dem Abrufen ab. Wenn Sie mehr Zeit benötigen, schließen Sie den Parameter expires und die gewünschte Zeit in Sekunden in die URL ein. So wird bei der folgenden URL für ein Beispielbild ein Upload-Token abgerufen, das 1800 Sekunden gültig ist:

https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=1800

Die erfolgreiche Antwort für Bilder sieht folgendermaßen aus:

<?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>get_uploadtoken</operationName> 
        <serviceStatus>SUCCESS</serviceStatus> 
        <title>Upload Token for fece4b21-87ee-47fc-9b99-2e29b78b602</title> 
        <message> 
            <uploadtoken>aa2a378a-cd25-4c80-994d-312094e0ef20_1800</uploadtoken> 
            <expiration_in_seconds>1800</expiration_in_seconds> 
        </message> 
        </response> 
    </user_generated_content> 
</scene7>

Speichern Sie das Upload-Token für zukünftige Anfragen lokal.

Folgende Felder können Sie in der URL-Anfragezeichenfolge zum Abrufen eines Upload-Tokens verwenden:

URL-Parameter	Erforderlich oder optional	Wert
op	Erforderlich	get_uploadtoken
shared_secret	Erforderlich	Der gemeinsame geheime Schlüssel für das Unternehmen, das den Upload ausführt.
expires	Optional	Anzahl der Sekunden, die das Upload-Token gültig ist. Der Standardwert ist 300 Sekunden, wenn nicht spezifiziert.

Beispielbild-URL:

https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=600

Beispiel-Vektor-URL:

https://s7ugc1.scene7.com/ugc/vector?op=get_uploadtoken&shared_secret=2d19f60e-890a-4e79-a1a5-9ac2875429b9&expires=5000

Zulässige HTTP-Methoden: GET und POST

Sie können nun ein Bild-Asset hochladen.

Siehe Hochladen von Bild-Assets.

Hochladen von Bild-Assets

Wenn Sie ein Upload-Token abgerufen haben, das für eine bestimmte Zeitspanne gültig ist, können Sie ein Bild-Asset hochladen. Sie laden das Asset mit der POST-Methode als mehrteilige Formulardaten hoch, während Sie die übrigen Werte als URL-Anfragezeichenfolge senden, wie im nachfolgenden Beispiel gezeigt:

https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company

Die Felder upload_token und company_name sind erforderlich.

Siehe Abrufen des Upload-Tokens.

Siehe Anfordern eines gemeinsamen geheimen Schlüssels.

Sie können auch andere optionale Werte als URL-Anfragezeichenfolgen senden, wie das nachfolgende Beispiel zeigt:

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

Der Parameter file_limit gibt die maximale Dateigröße in Byte an. Der Parameter file_exts gibt die für das Hochladen zulässigen Erweiterungen des Dateinamens an. Diese beiden Werte sind optional.

In der Anwendung sind globale Beschränkungen für die maximale Dateigröße und zulässigen Dateierweiterungen festgelegt. Wenn es sich bei der von Ihnen gesendeten Anforderung um eine Untergruppe der globalen Beschränkungen handelt, wird diese berücksichtigt. Die globalen Beschränkungen lauten wie folgt:

Globale Beschränkung	Wert
Dateigröße für alle Clients	20 MB
Unterstützte Bilddateiformate zum Hochladen	BMP, GIF, JPG, PNG, PSD

Mit dem folgenden HTML-Formular können Benutzer Assets hochladen. In dem Formular wird der Benutzer aufgefordert, die folgenden Informationen einzugeben:

• Einen Unternehmensnamen.
• Ein Upload-Token.
• Eine Beschränkung für die Dateigröße.
• Eine Liste mit den Erweiterungen für Dateinamen.
• Gibt an, ob das Profil und der Dateiname des Assets beibehalten werden sollen.
• Gibt an, ob der Hintergrund "Aussparen"verwendet werden soll. Wenn Sie "Hintergrund aussparen"aktivieren, legen Sie die Methode "Ecke", "Toleranz"und "Füllmethode"fest. Siehe Hintergrund aussparen unter Bildbearbeitungsoptionen beim Hochladen.
• Den Namen der hochzuladenden Datei

![] ()

Sie können den HTML-Quellcode, der mit dem oben stehenden Formular verknüpft ist, durch Klicken auf den folgenden Link Ansicht haben:

https://s7ugc1.scene7.com/ugc/upload.html

Klicken Sie in Firefox mit der rechten Maustaste in das Browserfenster und klicken Sie dann auf Seitenquelle der Ansicht. Der Code enthält die URL-Anfragezeichenfolge und die POST-Methode, die ausgeführt werden, wenn der Benutzer auf „Absenden“ klickt.

Um die XML-Antwort im Internet Explorer anzuzeigen, klicken Sie auf „Ansicht“ > „Quelltext“. Um die XML-Antwort in Firefox Ansicht, klicken Sie auf Tools > Web Developer > Page Source. Zur Anzeige von XML-Antworten wird Firefox empfohlen.

Hier eine Beispielantwort für einen erfolgreiche Upload:

<?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>https://s7w2p1.scene7.com/is/image/ </url> 
            <path>000Company/ugc/1442564.tif</path> 
            <fullurl>https://s7w2p1.scene7.com/is/image/000Company/ugc/1442564.tif </fullurl> 
            </message> 
        </response> 
    </user_generated_content> 
</scene7>

Das Asset kann wie jede andere Image-Server-Ressource gehandhabt werden; Sie können auch Verarbeitungsanfragen darauf anwenden. Mit der folgenden URL wird beispielsweise ein Asset in der angegebenen Breite und Höhe angefordert.

https://s7w2p1.scene7.com/is/image/S7WebUGC/ugc/9536356.tif?&wid=800&hei=100&fit=stretch

Senden Sie das hochzuladende Asset mit der POST-Methode als mehrteilige Formulardaten, während Sie die übrigen Werte als URL-Anfragezeichenfolge senden. Folgende Felder können Sie in der URL-Anfragezeichenfolge zum Hochladen eines Assets verwenden:

URL-Parameter	Erforderlich oder optional	Wert
op	Erforderlich	Hochladen
upload_token	Erforderlich	Upload-Token für den gemeinsamen geheimen Schlüssel für das Unternehmen.
company_name	Erforderlich	Name des hochladenden Unternehmens.
file_limit	optional	Maximale Dateigröße (in Byte) für das Asset.
file_exts	optional	Liste der zulässigen Erweiterungen für die Bild-Asset-Datei.
preserve_colorprofile	optional	Behält eingebettete Farbprofile bei der Konvertierung der hochgeladenen Datei in das PTIFF-Format bei. Mögliche Werte sind „true“ oder „false“. Der Standardwert ist „false“…
preserve_filename	optional	Behält den Dateinamen des hochgeladenen Assets bei. Mögliche Werte sind „true“ oder „false“. Der Standardwert ist „false“…

Beispiel-URL:

https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company

Zulässige HTTP-Methode:

POST

Abrufen von Asset-Metadaten für Bilder

Mit image_info können Sie Metadaten für ein hochgeladenes Asset abrufen, wie im nachfolgenden Beispiel gezeigt:

https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif

Hier ein Beispiel für eine erfolgreiche Antwort:

<?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>image_info</operationName> 
            <serviceStatus>SUCCESS</serviceStatus> 
            <title>More information on 1442564.tif</title> 
            <message> 
            File created on Tue Sep 08 19:02:04 CDT 2009, File Size = 243494 bytes 
            <imageFormat>Tiff</imageFormat> 
            <colorSpace>Rgb</colorSpace> 
            <width>686</width> 
            <height>457</height> 
            </message> 
        </response> 
    </user_generated_content> 
</scene7>

Folgende Felder können Sie in der URL-Anfragezeichenfolge zum Abrufen von Informationen für ein Asset verwenden:

URL-Parameter	Erforderlich oder optional	Wert
op	Erforderlich	image_info
shared_secret	Erforderlich	Der gemeinsame geheime Schlüssel für das Unternehmen.
image_name	Erforderlich	Name des Bildes.

Beispiel-URL:

https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif

Zulässige HTTP-Methode:

GET und POST

Hochladen von Vektor-Assets

Wenn Sie ein Upload-Token abgerufen haben, das für eine bestimmte Zeitspanne gültig ist, können Sie ein Vektor-Asset hochladen. Sie laden das Asset mit der POST-Methode als mehrteilige Formulardaten hoch, während Sie die übrigen Werte als URL-Anfragezeichenfolge senden, wie im nachfolgenden Beispiel gezeigt:

https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d- 312094e0ef20_18000&company_name=000Company

Die Felder upload_token und company_name sind erforderlich.

Siehe Abrufen des Upload-Tokens.

Siehe Anfordern eines gemeinsamen geheimen Schlüssels.

Sie können auch andere optionale Werte als URL-Anfragezeichenfolgen senden, wie das nachfolgende Beispiel zeigt:

https://s7ugc1.scene7.com/ugc/vector?op=upload&upload_token=aa2a378a-cd25-4c80-994d- 312094e0ef20_18000&company_name=000Company&file_limit=2000000&file_exts=ai,pdf

Der Parameter file_limit gibt die maximale Dateigröße in Byte an. Der Parameter file_exts gibt die für das Hochladen zulässigen Erweiterungen des Dateinamens an. Diese beiden Werte sind optional.

In der Anwendung sind globale Beschränkungen für die maximale Dateigröße und zulässigen Dateierweiterungen festgelegt. Wenn es sich bei der von Ihnen gesendeten Anforderung um eine Untergruppe der globalen Beschränkungen handelt, wird diese berücksichtigt. Die globalen Beschränkungen lauten wie folgt:

Globale Beschränkung	Wert
Dateigröße für alle Clients	20 MB
Unterstützte Vektordateiformate zum Hochladen	AI, EPS, PDF (nur, wenn das PDF-Dokument zuvor in Adobe Illustrator CS6 geöffnet und gespeichert wurde)

Mit dem folgenden HTML-Formular können Benutzer Assets hochladen. In dem Formular wird der Benutzer aufgefordert, die folgenden Informationen einzugeben:

• Einen Unternehmensnamen.
• Ein Upload-Token.
• Eine Beschränkung für die Dateigröße.
• Eine Liste mit den Erweiterungen für Dateinamen.
• Gibt an, ob das Profil und der Dateiname des Assets beibehalten werden sollen.
• Gibt an, ob der Hintergrund "Aussparen"verwendet werden soll. Wenn Sie "Hintergrund aussparen"aktivieren, legen Sie die Methode "Ecke", "Toleranz"und "Füllmethode"fest. Siehe Hintergrund aussparen unter Bildbearbeitungsoptionen beim Hochladen.
• Den Namen der hochzuladenden Datei

![] ()

Der folgende HTML-Code wird angezeigt, wenn Sie im Browserfenster mit der rechten Maustaste klicken und anschließend für das in der Abbildung dargestellte Formular auf „Quelltext anzeigen“ klicken. Der Code enthält die URL-Anfragezeichenfolge und die POST-Methode, die ausgeführt werden, wenn der Benutzer auf „Absenden“ klickt.

<body> 
<script language="javascript"> 
function uploadImage() 
{ 
document.image_upload.action="vector?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; 
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 Vector 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 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 Vector: </strong></td> 
<td><input type="submit" value="Submit"></td> 
</tr> 
</table> 
</form> 
</body>

Um die XML-Antwort im Internet Explorer anzuzeigen, klicken Sie auf „Ansicht“ > „Quelltext“. Um die XML-Antwort in Firefox anzuzeigen, klicken Sie auf „Ansicht“ > „Seitenquelltext anzeigen“. Zur Anzeige von XML-Antworten wird Firefox empfohlen.

Hier eine Beispielantwort für einen erfolgreiche Upload:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?> 
    <scene7> 
    <user_generated_content> 
    <response> 
    <serviceName>User Generated Content -Vector</serviceName> 
    <version>1.0.0</version> 
    <operationName>upload</operationName> 
    <serviceStatus>SUCCESS</serviceStatus> 
    <title>Your file has been uploaded Successfully.</title> 
    <message> 
    <url>https://s7w2p1.scene7.com/is/agm</url> 
    <path>W2PTest/ugc/8875744.fxg</path> 
    <fullurl> 
        https://s7w2p1.scene7.com/is/agm/W2PTest/ugc/8875744.fxg 
    </fullurl> 
</message> 
</response> 
</user_generated_content> 
</scene7>

Das Asset kann wie jede andere Web-to-Print-Ressource gehandhabt werden; Sie können auch Verarbeitungsanfragen darauf anwenden. Beispielsweise wandelt die folgende URL eine FXG-Ressource in ein png-Bild mit 500x500 Pixeln um.

https://s7w2p1.scene7.com/is/agm/W2PTest/ugc/8875744.fxg?fmt=png&wid=500&hei=500

Senden Sie das hochzuladende Asset mit der POST-Methode als mehrteilige Formulardaten, während Sie die übrigen Werte als URL-Anfragezeichenfolge senden. Folgende Felder können Sie in der URL-Anfragezeichenfolge zum Hochladen eines Assets verwenden:

URL-Parameter	Erforderlich oder optional	Wert
op	Erforderlich	Hochladen
upload_token	Erforderlich	Upload-Token für den gemeinsamen geheimen Schlüssel für das Unternehmen.
firma_name	Erforderlich	Name des hochladenden Unternehmens.
file_limit	optional	Maximale Dateigröße (in Byte) für das Asset.
file_exts	optional	Liste der zulässigen Erweiterungen für die Asset-Datei.

Beispiel-URL:

https://s7ugc1.scene7.com/ugc/vector?op=upload&upload_to ken=aa2a378a-cd25-4c80-994d- 312094e0ef20_18000&company_name=000Company

Zulässige HTTP-Methode:

POST