Der Artikel enthält Empfehlungen, Referenzmaterialien und Ressourcen für Entwickler von Assets as a Cloud Service. Er enthält ein neues Modul für den Asset-Upload, eine API-Referenz und Informationen über die Unterstützung, die in Nachbearbeitungs-Workflows bereitgestellt wird.
Assets as a Cloud Service bietet mehrere APIs für die programmgesteuerte Interaktion mit digitalen Assets. Jede API unterstützt spezifische Anwendungsfälle, wie in der folgenden Tabelle beschrieben. Die Assets-Benutzeroberfläche, das Experience Manager-Desktop-Programm und Adobe Asset Link unterstützen alle oder einige der Vorgänge.
Einige APIs bestehen weiterhin, werden jedoch nicht aktiv unterstützt (mit einem × gekennzeichnet). Verwenden Sie diese APIs nach Möglichkeit nicht.
Unterstützungsebene | Beschreibung |
---|---|
✓ | Unterstützt |
× | Nicht unterstützt. Nicht verwenden. |
- | Nicht verfügbar |
Anwendungsfall | aem-upload | AEM / Sling / JCR Java-APIs | Asset Compute Service | Assets HTTP-API | Sling GET/POST Servlets | GraphQL (Vorschau) |
---|---|---|---|---|---|---|
Ursprüngliche Binärdatei | ||||||
Original erstellen | they | × | - | × | × | - |
Original lesen | - | × | they | they | they | - |
Original aktualisieren | they | × | they | × | × | - |
Original löschen | - | they | - | they | they | - |
Original kopieren | - | they | - | they | they | - |
Original verschieben | - | they | - | they | they | - |
Metadaten | ||||||
Metadaten erstellen | - | they | they | they | they | - |
Metadaten lesen | - | they | - | they | they | - |
Metadaten aktualisieren | - | they | they | they | they | - |
Metadaten löschen | - | they | they | they | they | - |
Metadaten kopieren | - | they | - | they | they | - |
Metadaten verschieben | - | they | - | they | they | - |
Inhaltsfragmente | ||||||
Inhaltsfragmente erstellen | - | they | - | they | - | - |
Inhaltsfragmente lesen | - | they | - | they | - | they |
Inhaltsfragmente aktualisieren | - | they | - | they | - | - |
Inhaltsfragmente löschen | - | they | - | they | - | - |
Inhaltsfragmente kopieren | - | they | - | they | - | - |
Inhaltsfragmente verschieben | - | they | - | they | - | - |
Versionen | ||||||
Version erstellen | they | they | - | - | - | - |
Version lesen | - | they | - | - | - | - |
Version löschen | - | they | - | - | - | - |
Ordner | ||||||
Ordner erstellen | they | they | - | they | - | - |
Ordner lesen | - | they | - | they | - | - |
Ordner löschen | they | they | - | they | - | - |
Ordner kopieren | they | they | - | they | - | - |
Ordner verschieben | they | they | - | they | - | - |
Unter Experience Manager als Cloud Service können Sie die Assets mit der HTTP-API direkt in die Cloud-Datenspeicherung hochladen. Die Schritte zum Hochladen einer Binärdatei sind:
Der Ansatz bietet eine skalierbare und leistungsfähigere Handhabung von Asset-Uploads. Die Unterschiede im Vergleich zu Experience Manager 6.5 sind:
Informationen zum Implementieren dieses Ansatzes finden Sie im Client-Code in der Open-Source-Bibliothek aem-upload.
Senden Sie eine HTTP-POST-Anfrage an den gewünschten Ordner. Assets werden in diesem Ordner erstellt oder aktualisiert. Schließen Sie den Selektor .initiateUpload.json
ein, um anzugeben, dass die Anfrage darin besteht, den Upload einer Binärdatei zu starten. Der Pfad zum Ordner, in dem das Asset erstellt werden soll, lautet beispielsweise /assets/folder
. Die POST-Anfrage ist POST https://[aem_server]:[port]/content/dam/assets/folder.initiateUpload.json
.
Der Content-Typ des Anfragetexts sollte application/x-www-form-urlencoded
-Formulardaten sein, die die folgenden Felder enthalten:
(string) fileName
: Erforderlich. Der Name des Assets, wie er in Experience Manager angezeigt wird.(number) fileSize
: Erforderlich. Die Dateigröße des hochgeladenen Assets in Byte.Eine einzige Anfrage kann dazu verwendet werden, Uploads für mehrere Binärdateien zu initiieren, solange jede Binärdatei die erforderlichen Felder enthält. Bei Erfolg wird die Anfrage mit einem 201
-Status-Code und einem Text mit JSON-Daten im folgenden Format beantwortet:
{
"completeURI": "(string)",
"folderPath": (string)",
"files": [
{
"fileName": "(string)",
"mimeType": "(string)",
"uploadToken": "(string)",
"uploadURIs": [
"(string)"
]
}
]
}
completeURI
(Zeichenfolge): Diese URI aufrufen, wenn das Hochladen der Binärdatei abgeschlossen ist. Die URI kann eine absolute oder relative URI sein. Clients sollten in der Lage sein, beide Fälle zu handhaben. Das heißt, dass der Wert "https://author.acme.com/content/dam.completeUpload.json"
oder "/content/dam.completeUpload.json"
sein kann. Siehe Abschließen des Hochladens .folderPath
(Zeichenfolge): Vollständiger Pfad zum Ordner, in den die Binärdatei hochgeladen wird.(files)
(Array): Eine Liste der Elemente, deren Länge und Reihenfolge mit der Länge und Reihenfolge der Liste der binären Informationen übereinstimmen, die in der Anfrage zum Initiieren bereitgestellt werden.fileName
(Zeichenfolge): Der Name der entsprechenden Binärdatei, wie in der Anfrage zum Initiieren angegeben. Dieser Wert sollte in der vollständigen Anfrage enthalten sein.mimeType
(Zeichenfolge): Der Mime-Typ der entsprechenden Binärdatei, wie der Initiierungsanfrage angegeben. Dieser Wert sollte in der vollständigen Anfrage enthalten sein.uploadToken
(Zeichenfolge): Ein Upload-Token für die entsprechende Binärdatei. Dieser Wert sollte in der vollständigen Anfrage enthalten sein.uploadURIs
(Array): Eine Liste der Zeichenfolgen, deren Werte vollständige URIs sind, in die der binäre Inhalt hochgeladen werden soll (siehe Hochladen der Binärdatei).minPartSize
(Nummer): Die Mindestlänge (in Byte) der Daten, die einem der uploadURIs
bei mehr als einem URI bereitgestellt werden können.maxPartSize
(Nummer): Die maximale Länge (in Byte) von Daten, die für einen der URI bereitgestellt werden können, uploadURIs
wenn mehrere URI vorhanden sind.Die Ausgabe beim Initiieren eines Uploads umfasst einen oder mehrere Upload-URI-Werte. Wenn mehr als eine URI angegeben wird, teilt der Client die Binärdatei in Teile und sendet die POST-Anfrage jeden Teils in der richtigen Reihenfolge an jede URI. Verwenden Sie alle URIs. Stellen Sie sicher, dass die Größe der einzelnen Teile innerhalb der minimalen und maximalen Größe liegt, wie in der Initiierungsantwort angegeben. CDN-Edge-Knoten beschleunigen das angeforderte Hochladen von Binärdateien.
Eine Möglichkeit, dies zu erreichen, besteht darin, die Teilegröße basierend auf der Anzahl der von der API bereitgestellten Upload-URIs zu berechnen. Angenommen, die Gesamtgröße der Binärdatei beträgt 20.000 Bytes und die Anzahl der Upload-URIs beträgt 2. Führen Sie dann die folgenden Schritte aus:
Bei erfolgreicher Ausführung des Uploads antwortet der Server auf jede Anfrage mit Status-Code 201
.
Nachdem alle Teile einer Binärdatei hochgeladen wurden, senden Sie eine HTTP-POST-Anfrage an den vollständigen URI, der von den Initiierungsdaten bereitgestellt wird. Der Content-Typ des Anfragetexts sollte application/x-www-form-urlencoded
-Formulardaten sein, die die folgenden Felder enthalten.
Felder | Typ | Erforderlich | Beschreibung |
---|---|---|---|
fileName |
Zeichenfolge | Erforderlich | Der Name des Assets, wie in den Initiierungsdaten angegeben. |
mimeType |
Zeichenfolge | Erforderlich | Der HTTP-Content-Typ der Binärdatei, wie in den Initiierungsdaten angegeben. |
uploadToken |
Zeichenfolge | Erforderlich | Upload-Token für die Binärdatei, wie in den Initiierungsdaten angegeben. |
createVersion |
Boolesch | Optional | Wenn True und ein Asset mit dem angegebenen Namen existiert, erstellt Experience Manager eine neue Version des Assets. |
versionLabel |
Zeichenfolge | optional | Wenn eine neue Version erstellt wird, die Bezeichnung, die der neuen Version eines Assets zugeordnet ist. |
versionComment |
Zeichenfolge | optional | Wenn eine neue Version erstellt wird, die Kommentare, die der Version zugeordnet sind. |
replace |
Boolesch | optional | Wenn True und ein Asset mit dem angegebenen Namen existiert, löscht Experience Manager das Asset und erstellt es dann erneut. |
Wenn das Asset existiert und weder createVersion
noch replace
angegeben ist, aktualisiert Experience Manager die aktuelle Version des Assets mit der neuen Binärdatei.
Wie beim Initiierungsprozess können die vollständigen Anfragedaten Informationen zu mehr als einer Datei enthalten.
Das Hochladen einer Binärdatei wird erst durchgeführt, wenn die vollständige URL für die Datei aufgerufen wurde. Ein Asset wird verarbeitet, nachdem der Upload-Vorgang abgeschlossen ist. Die Verarbeitung wird nicht gestartet, auch wenn die Binärdatei des Assets vollständig hochgeladen wurde, der Upload-Vorgang jedoch nicht abgeschlossen ist.
Bei erfolgreicher Ausführung antwortet der Server mit Status-Code 200
.
Um mehr über die Upload-Algorithmen zu erfahren oder eigene Upload-Skripte und -Tools zu erstellen, stellt Adobe Open-Source-Bibliotheken und -Tools bereit:
Die neue Upload-Methode wird nur für Adobe Experience Manager as a Cloud Service unterstützt. Die APIs aus Adobe Experience Manager 6.5 werden nicht mehr unterstützt. Die Methoden im Zusammenhang mit dem Hochladen oder Aktualisieren von Assets oder Ausgabedarstellungen (alle binären Uploads) werden in den folgenden APIs nicht mehr unterstützt:
AssetManager
Java-API, z. B. AssetManager.createAsset(..)
In Experience Manager basiert die Asset-Verarbeitung auf der Konfiguration von Verarbeitungsprofilen, die Asset-Microservices verwendet. Für die Verarbeitung sind keine Entwicklererweiterungen erforderlich.
Verwenden Sie die standardmäßigen Workflows mit Erweiterungen mit benutzerdefinierten Schritten für die Konfiguration des Nachbearbeitungs-Workflows.
Kunden, die ein Upgrade von früheren Versionen von Experience Manager durchführen, können Asset-Microservices zur Verarbeitung von Assets verwenden. Die Cloud-nativen Asset-Microservices sind bedeutend einfacher zu konfigurieren und zu verwenden. Einige Workflow-Schritte, die im DAM-Update-Asset-Workflow in der vorherigen Version verwendet wurden, werden nicht unterstützt.
Experience Manager as a Cloud Service unterstützt die folgenden Workflow-Schritte:
com.day.cq.dam.similaritysearch.internal.workflow.process.AutoTagAssetProcess
com.day.cq.dam.core.impl.process.CreateAssetLanguageCopyProcess
com.day.cq.wcm.workflow.process.CreateVersionProcess
com.day.cq.dam.similaritysearch.internal.workflow.smarttags.StartTrainingProcess
com.day.cq.dam.similaritysearch.internal.workflow.smarttags.TransferTrainingDataProcess
com.day.cq.dam.core.impl.process.TranslateAssetLanguageCopyProcess
com.day.cq.dam.core.impl.process.UpdateAssetLanguageCopyProcess
com.adobe.cq.workflow.replication.impl.ReplicationWorkflowProcess
com.day.cq.dam.core.impl.process.DamUpdateAssetWorkflowCompletedProcess
Die folgenden technischen Workflow-Modelle werden entweder durch Asset-Microservices ersetzt oder es ist kein Support verfügbar:
com.day.cq.dam.core.impl.process.DamMetadataWritebackWorkflowCompletedProcess
com.day.cq.dam.core.process.DeleteImagePreviewProcess
com.day.cq.dam.s7dam.common.process.DMEncodeVideoWorkflowCompletedProcess
com.day.cq.dam.core.process.GateKeeperProcess
com.day.cq.dam.core.process.AssetOffloadingProcess
com.day.cq.dam.core.process.MetadataProcessorProcess
com.day.cq.dam.core.process.XMPWritebackProcess
com.adobe.cq.dam.dm.process.workflow.DMImageProcess
com.day.cq.dam.s7dam.common.process.S7VideoThumbnailProcess
com.day.cq.dam.scene7.impl.process.Scene7UploadProcess
com.day.cq.dam.s7dam.common.process.VideoProxyServiceProcess
com.day.cq.dam.s7dam.common.process.VideoThumbnailDownloadProcess
com.day.cq.dam.s7dam.common.process.VideoUserUploadedThumbnailProcess
com.day.cq.dam.core.process.CreatePdfPreviewProcess
com.day.cq.dam.core.process.CreateWebEnabledImageProcess
com.day.cq.dam.video.FFMpegThumbnailProcess
com.day.cq.dam.core.process.ThumbnailProcess
com.day.cq.dam.cameraraw.process.CameraRawHandlingProcess
com.day.cq.dam.core.process.CommandLineProcess
com.day.cq.dam.pdfrasterizer.process.PdfRasterizerHandlingProcess
com.day.cq.dam.core.process.AddPropertyWorkflowProcess
com.day.cq.dam.core.process.CreateSubAssetsProcess
com.day.cq.dam.core.process.DownloadAssetProcess
com.day.cq.dam.word.process.ExtractImagesProcess
com.day.cq.dam.word.process.ExtractPlainProcess
com.day.cq.dam.video.FFMpegTranscodeProcess
com.day.cq.dam.ids.impl.process.IDSJobProcess
com.day.cq.dam.indd.process.INDDMediaExtractProcess
com.day.cq.dam.indd.process.INDDPageExtractProcess
com.day.cq.dam.core.impl.lightbox.LightboxUpdateAssetProcess
com.day.cq.dam.pim.impl.sourcing.upload.process.ProductAssetsUploadProcess
com.day.cq.dam.core.process.ScheduledPublishBPProcess
com.day.cq.dam.core.process.ScheduledUnPublishBPProcess
com.day.cq.dam.core.process.SendDownloadAssetEmailProcess
com.day.cq.dam.core.impl.process.SendTransientWorkflowCompletedEmailProcess