[AEM Assets]{class="badge positive" title="Gilt für AEM Assets)."}

Häufig gestellte Fragen zu Dynamic Media mit OpenAPI-Funktionen new-dynaminc-media-apis-frequently-asked-questions

Dynamic Media mit OpenAPI (Open Application Programming Interface) Funktionen stellen Rich-Media-Assets - Bilder, Videos und andere visuelle Inhalte - über standardisierte, entwicklerfreundliche API-Endpunkte bereit, transformieren und verwalten sie. Dieses Handbuch mit häufig gestellten Fragen beantwortet die häufigsten Fragen dazu, wie diese Funktionen funktionieren, was sie ermöglichen und wie sie übernommen werden können.

Was sind Dynamic Media-Funktionen mit OpenAPI? what-are-dynamic-media-openapi-capabilities

Dynamic Media ist eine Reihe von Services zur Bereitstellung und Umwandlung von Medien, die Assets automatisch für alle Geräte, Kanäle oder Bildschirme optimieren, ihre Größe ändern und rendern. Die OpenAPI-Funktionen stellen diese Services über offene, gut dokumentierte API-Spezifikationen bereit, sodass Entwickler die Medienbereitstellung direkt in ihre eigenen Programme, Storefronts und Inhaltserlebnisse integrieren können.

Da die Schnittstellen dem OpenAPI-Standard folgen, sind sie selbstbeschreibend und vorhersehbar. Daher können Integrations-Teams verfügbare Endpunkte ermitteln, Anfrage- und Antwortformate verstehen und Client-Code schneller generieren als mit proprietären, nicht dokumentierten Schnittstellen.

Wichtigste Vorteile key-benefits

Zu den wichtigsten Vorteilen von Dynamic Media mit OpenAPI-Funktionen gehören:

Was kann ich mit den OpenAPI-Funktionen von Dynamic Media tun? what-can-i-do

Sie können Medien-Assets bei Bedarf anfordern, Echtzeit-Transformationen wie Zuschneiden, Größenanpassung und Formatkonvertierung anwenden und optimierte Inhalte für Web-, Mobil- und vernetzte Erlebnisse bereitstellen - alles über standardisierte API-Aufrufe.

Wie unterscheiden sich die OpenAPI-Funktionen von der herkömmlichen Dynamic Media-Bereitstellung? openapi-vs-traditional

Der herkömmliche Versand beruht auf voreingestellten URL-Mustern und Vorlagen. OpenAPI-Funktionen fügen eine standardisierte, programmgesteuerte Schnittstelle hinzu, die die Implementierung von Automatisierung, benutzerdefinierter Integration und Headless-Architekturen (entkoppelte Frontend-Architekturen) erleichtert.

Sind diese Funktionen für Headless- und zusammensetzbare Architekturen geeignet? headless-composable

Ja. Da Medien über APIs und nicht über feste Seitenvorlagen abgerufen und transformiert werden, fügen sich die OpenAPI-Funktionen von Dynamic Media nahtlos in Headless-Content-Management- und zusammensetzbare Commerce-Setups ein, bei denen die Präsentationsebene von Inhalten und Services getrennt ist.

Benötige ich Entwicklerressourcen, um diese Funktionen nutzen zu können? developer-resources

Die API-basierte Integration umfasst in der Regel Entwickler, die Endpunkte mit einer Anwendung verbinden. Die OpenAPI-Spezifikation reduziert diesen Aufwand jedoch, indem sie konsistente, maschinenlesbare Definitionen bereitstellt, die die automatisierte Client-Generierung und -Tests unterstützen.

Sind alle Assets im Experience Manager Assets as a Cloud Service-Repository für die Suche und Bereitstellung unter Verwendung von Dynamic Media mit OpenAPI-Funktionen verfügbar? assets-available-for-search

Nein. Nur die genehmigte und neueste Version der Assets sind für die Suche und Bereitstellung mit verfügbar Dynamic Media mit OpenAPI-Funktionen. Assets, die nicht genehmigt wurden oder nur als frühere Revisionen vorhanden sind, sind von diesem Such- und Bereitstellungsumfang ausgeschlossen.

Zwei Bedingungen bestimmen, ob ein Asset im Experience Manager Assets as a Cloud Service-Repository angezeigt wird:

Dieser Umfang ist beabsichtigt. Da nur genehmigte aktuelle Assets infrage kommen, ist die Bereitstellung auf Inhalte beschränkt, die die Governance-Überprüfung bestanden haben, die die Markenkonsistenz über alle Kanäle und Programme hinweg sicherstellt. Daher verweisen nachgelagerte Erlebnisse, die Assets über Dynamic Media mit OpenAPI-Funktionen nutzen, zuverlässig auf überprüfte, aktuelle Inhalte und nicht auf nicht genehmigte oder veraltete Revisionen.

Wie können Admins neue und vorhandene Assets, die einem Ordner hinzugefügt wurden, als genehmigt markieren? add-assets-to-folder-as-approved

Administratoren markieren neue und vorhandene Assets in einem Ordner als genehmigt, indem sie den Ordner für die Massenvalidierung konfigurieren und dann alle bereits vorhandenen Assets erneut verarbeiten. In Adobe Experience Manager (AEM) Assets wird der Status eines Assets durch die jcr:content/metadata/dam:status Eigenschaft gesteuert. Diese Eigenschaft steuert, ob ein Asset in der gesamten Asset-Bibliothek als verwendbar, blockiert oder mit ausstehender Revision behandelt wird.

Die Werte dieser Eigenschaft sind:

AEM Assets unterscheidet den Status Genehmigt anhand eines Symbols Genehmigt auf der Asset-Karte, wie in den folgenden Abbildungen für Admin- und Asset-Ansichten dargestellt:

Admin-Ansicht

Assets-Ansicht

Informationen zum Genehmigen aller Assets in einem Ordner finden Sie in den Anweisungen zum Genehmigen mehrerer Assets in einem Ordner. Es gibt auch ein Video, in dem der gesamte Prozess dargestellt ist.

Nachdem Sie einen Ordner für die Massengenehmigung eingerichtet haben, werden alle neuen Assets, die zum Ordner hinzugefügt werden, automatisch genehmigt. Dadurch wird ein konsistenter Validierungsstatus über den gesamten Ordner hinweg sichergestellt, ohne dass jeder neue Upload manuell überprüft werden muss. Alle vorhandenen Assets werden erst genehmigt, nachdem sie erneut verarbeitet wurden, da durch die erneute Verarbeitung die dam:status-Eigenschaft mit der Massenvalidierungskonfiguration des Ordners neu bewertet wird. Anweisungen zur erneuten Verarbeitung von Assets finden Sie unter Erneutes Verarbeiten digitaler Assets. Wenn Admins nicht genehmigte Assets aus einem anderen Ordner kopieren oder verschieben, müssen sie die Assets erneut verarbeiten sodass die verschobenen Assets den Status „Genehmigt“ übernehmen.

AEM Assets kennzeichnet das Asset als Rejected, wenn der Administrator die Rejected- oder Changes requested-Werte angibt, da beide Werte einen nicht genehmigten Status darstellen. AEM Assets unterscheidet den Status „Abgelehnt“ durch der auf der Asset-Karte in der Admin-Ansicht verfügbar ist.

Auf ähnliche Weise unterscheidet AEM Assets den Status Abgelehnt in der Ansicht Assets durch den folgenden Status Abgelehnt auf der Asset-Karte:

Wie können Sie dafür sorgen, dass die Rollen für Assets in der Admin-Ansicht in Experience Manager mithilfe der Benutzer- oder Gruppen-ID von Adobe IMS (Adobe Identity Management Services) festgelegt werden, um das Bereitstellungs- und Sucherlebnis sicher zu gestalten? set-roles-secure-delivery-search

Benutzer- und Gruppen-IDs von Adobe IMS (Adobe Identity Management Services) werden aus dem Admin Console von Adobe abgerufen und in der Experience Manager Assets Admin view angewendet, um Rollen festzulegen, die die Bereitstellung und Suche sichern. Durch die Zuweisung von Rollen, die auf diesen IMS-Benutzer- oder Gruppen-IDs basieren, wird sichergestellt, dass nur autorisierte Identitäten auf bestimmte Assets zugreifen, sie bereitstellen oder suchen können. Da der Zugriff auf Asset-Ebene durch diese Identitäten gesteuert wird, ist die Verwendung der richtigen IMS-ID der grundlegende Schritt für die rollenbasierte Sicherheit in Experience Manager.

Benutzende, die Zugriff auf die Experience Manager Author-Umgebung benötigen, werden als Adobe IMS-Benutzende in der Admin Console von Adobe. Informationen darüber, was Adobe IMS-Benutzende sind und wie sie in der Admin Console aufgerufen und verwaltet werden, finden Sie unter Adobe IMS-Benutzende.

Zuordnung von IMS-Identitäten zu Asset-Rollen:

Da Bereitstellungs- und Sucherlebnisse durch die Rollen gesteuert werden, die für Assets festgelegt sind, ist das Abrufen der korrekten Adobe IMS-Benutzer- oder Gruppen-ID aus der Admin Console unerlässlich. Dieser Ansatz zentralisiert das Identitätsmanagement, reduziert das Risiko des unbefugten Zugriffs auf Assets und hält die Berechtigungen an die Art und Weise angepasst, wie Identitäten bereits in der Adobe-Umgebung verwaltet werden.

Können Sie mehrere Assets gleichzeitig in einem Ordner genehmigen? approve-multiple-assets-in-folder

Ja. Mit Adobe Experience Manager (AEM) Assets können Benutzende mehrere Assets in einem Ordner gleichzeitig genehmigen, sodass jede Datei nicht einzeln genehmigt werden muss. Die Massenvalidierung optimiert die Prüfungs-Workflows und spart viel Zeit bei der Verwaltung großer Asset-Bibliotheken, da Überprüfungsstatus „Genehmigt in einer einzigen Aktion auf jedes ausgewählte Asset angewendet wird.

Je nach verwendeter Benutzeroberfläche werden zwei Methoden unterstützt: die Assets Admin- oder die Assets-.

Mehrere Assets in der Assets Admin View genehmigen

Führen Sie die folgenden Schritte aus, um mehrere Assets gleichzeitig in der Experience Manager Assets Admin view zu genehmigen:

Dadurch wird der Genehmigt Überprüfungsstatus auf jedes ausgewählte Asset gleichzeitig angewendet und die Änderungen werden in einem einzigen Schritt bestätigt und geschlossen.

Mehrere Assets in der Assets-Ansicht genehmigen

So genehmigen Sie gleichzeitig mehrere Assets in einem Ordner in der Assets-Ansicht:

Durch Klicken auf Speichern wird der Genehmigt-Status gleichzeitig für alle ausgewählten Assets übernommen, sodass im gesamten Ordner ein konsistenter Prüfungsstatus gewährleistet ist.

Wie kann ich die Asset-Bereitstellung sichern und nach Dynamic Media mit OpenAPIs suchen? secure-asset-delivery

Zentrale Asset Governance) in Adobe Experience Manager gibt DAM- und Markenmanagern direkte Kontrolle darüber, wer auf Assets zugreifen kann, die über OpenAPIs (Open Application Programming Interfaces) bereitgestellt werden. Dieses Governance-Modell sichert sowohl die Asset-Suche als auch die Asset-Bereitstellung, indem Zugriffsregeln an der Quelle durchgesetzt werden, sodass nur autorisierte Benutzer geschützte Inhalte abrufen.

Diese Admins beschränken den Zugriff auf der Autorenseite - speziell auf die AEM as a Cloud Service- - mithilfe von zwei primären Steuerelementen:

Da diese Steuerelemente auf der Authoring-Ebene angewendet werden, steuern sie jede nachgelagerte Anfrage. Endbenutzer, die nach Assets suchen oder Versand-URLs verwenden, erhalten eingeschränkte Assets erst nach erfolgreichem Abschluss des Autorisierungsprozesses. Anfragen, bei denen die Autorisierung fehlschlägt, werden blockiert, wodurch ein nicht autorisierter Abruf auch dann verhindert wird, wenn eine Versand-URL bekannt ist. Dadurch wird sichergestellt, dass Governance-Entscheidungen von DAM-Administratoren und Marken-Managern über Suchergebnisse und direkte Versand-Links hinweg konsistent durchgesetzt werden.

Weitere Informationen finden Sie unter Beschränken des Zugriffs auf Assets in Experience Manager.

Wie erhalten Sie Berechtigungen zum Bearbeiten des Genehmigungsstatus eines Assets? permissions-edit-approval-status

Um Berechtigungen zum Bearbeiten des Genehmigungsstatus eines Assets zu erhalten, muss ein Administrator Bearbeitungszugriff auf das Feld Prüfungsstatus innerhalb des Metadatenschemas gewähren, das auf den Asset-Ordner angewendet wurde. Als DAM-Benutzer (Digital Asset Management) haben Sie möglicherweise nicht standardmäßig die Berechtigung Assets genehmigen, da die Bearbeitung von Genehmigungen und Überprüfungsstatus auf Metadatenschema-Ebene und nicht über den allgemeinen Ordnerzugriff gesteuert wird.

Administratoren können diesen Zugriff aktivieren, indem sie die folgenden Schritte ausführen:

Durch die Gewährung von Bearbeitungsberechtigungen für Feld Prüfungsstatus“ wird sichergestellt, dass die DAM-Benutzer den Genehmigungsstatus eines Assets direkt ändern können, was den Prüfungs-Workflow optimiert. Weitere Informationen finden Sie unter Deaktivieren der Bearbeitung für das Feld „Überprüfungsstatus“.

Welche Dateigröße wird für Videos unterstützt? supported-file-formats-videos

Dynamic Media mit OpenAPI-Funktionen unterstützt Videos in langer Form mit einer maximalen Dateigröße von 50 GB und einer maximalen Dauer von 2 Stunden pro Video. Diese Beschränkungen definieren die Obergrenzen für einen einzelnen Video-Upload, sodass Inhalte in voller Länge wie aufgezeichnete Webinare, Schulungssitzungen, Produktdemonstrationen und erweiterte Präsentationen bereitgestellt werden können, ohne das Filmmaterial in kürzere Segmente zu unterteilen.

Da Dynamic Media bis zu 50 GB große Dateien unterstützt, können hochauflösende und hochbitrate Aufnahmen hochgeladen und gestreamt werden, ohne dass die Qualität beeinträchtigt wird. Die 2-Stunden-Obergrenze stellt sicher, dass langformatige Assets in eine einzige kontinuierliche Datei passen, was die Inhaltsverwaltung und -wiedergabe für Betrachter vereinfacht.

Inwiefern unterscheidet sich Dynamic Media mit OpenAPI-Funktionen von der Dynamic Media-Lösung? dynamic-media-and-dynamic-media-with-openapi-differences

Dynamic Media mit OpenAPI-Funktionen und Dynamic Media sind unterschiedliche Lösungen, die jeweils ihre eigenen speziellen Bereitstellungsfunktionen bieten. Überprüfen Sie sorgfältig Ihre spezifischen Anforderungen, um die Lösung zu ermitteln, die Ihren Anforderungen am besten entspricht.

Adobes allgemeine Anleitung besteht darin, den Dynamic Media-mit-OpenAPI-Stack (Open Application Programming Interface) für alle Integrationsanwendungsfälle zu nutzen, unabhängig davon, ob sie Anwendungen von Erstanbietern oder Drittanbietern betreffen. Da die beiden Stacks unterschiedliche URL-Strukturen verwenden, wählen Sie den richtigen Ansatz anhand der folgenden Entscheidungsregeln aus:

Abschließend sei gesagt, dass Dynamic Media und das Dynamic Media-mit-OpenAPI-Stack je nach Art Ihres Anwendungsfalls nebeneinander bestehen können.

Im Folgenden finden Sie einige der wichtigsten Unterschiede zwischen Dynamic Media mit OpenAPI-Funktionen und Dynamic Media:

Wie geht Dynamic Media mit OpenAPI-Funktionen mit den Einschränkungen der Funktion „Connected Assets“ um? dynamic-media-openapi-addresses-connected-assets-limitations

Mit den Funktionen von Dynamic Media mit OpenAPI werden die Kernbeschränkungen der Funktion „Connected Assets" überwunden, indem das binäre Kopieren eliminiert wird, alle AEM Assets-Formattypen (einschließlich Videos) unterstützt werden, die Beschränkung für Verbindungen mit vier Instanzen aufgehoben wird, erweiterbare benutzerdefinierte Integrationen ermöglicht werden und nahezu in Echtzeit Asset-Aktualisierungen bereitgestellt werden. In der folgenden Tabelle sind die wichtigsten Unterschiede zwischen den beiden Lösungen aufgeführt:

Einige Modifikatoren sind mit „Eingeschränkte Verfügbarkeit“ gekennzeichnet. Wie kann ich sie verwenden? use-limited-availability-modifiers

Modifikatoren für eingeschränkte Verfügbarkeit erfordern eine explizite Aktivierung in Ihrem Konto, bevor sie in der Produktion verwendet werden können. Adobe aktiviert diese Modifikatoren nicht standardmäßig, sodass Sie den Zugriff über den Adobe-Support anfordern müssen. Der Prozess besteht aus zwei Schritten: Öffnen eines Support-Falls und Angabe der Details, die Adobe benötigt, um die angeforderten Funktionen bereitzustellen.

So aktivieren Sie die Produktionsverwendung von -Modifikatoren, die mit „Eingeschränkte Verfügbarkeit“ gekennzeichnet sind, in Ihrem Konto:

Wie teste ich experimentelle Modifikatoren? modifiers-not-generally-available

Mit experimentellen APIs können Sie alle Modifikatoren testen, die noch nicht allgemein verfügbar sind. Experimentelle (oder Beta-)APIs bieten Entwicklern frühzeitigen Zugriff auf Funktionen, die noch ausgewertet werden, sodass Sie neue Modifikatoren validieren können, bevor sie in den stabilen, allgemein verfügbaren Satz hochgestuft werden. Auf diese Weise können Sie bevorstehende Funktionen ausprobieren, bestätigen, dass sie sich in Ihren Workflows wie erwartet verhalten, und Feedback vor einer allgemeinen Version geben.

Um einen Modifikator zu testen, der nicht allgemein verfügbar ist, rufen Sie ihn über den experimentellen API-Pfad auf. Beispiel:

</adobe/experimental/advancemodifiers-expires-YYYYMMDD/assets>

Das expires-YYYYMMDD Segment zeigt an, dass der experimentelle Modifikator an eine Zeitbeschränkung gebunden ist, und gibt das Datum an, zu dem die experimentelle Version geändert oder abläuft - eine Erinnerung daran, nach der Veröffentlichung zum allgemein verfügbaren Äquivalent zu migrieren.

Weitere Informationen zum Aufrufen dieser Endpunkte finden Sie in der Anleitung zur Verwendung der experimentellen APIs. Um festzustellen, welche Modifikatoren verfügbar sind, konsultieren Sie die vollständige Liste der Modifikatoren.

Siehe auch