Beispiele und Beispiele in diesem Dokument gelten nur für die Umgebung AEM Forms on JEE.
Informationen zum Repository-Dienst
Der Repository-Dienst stellt Ressourcen- und Verwaltungsdienste für AEM Forms bereit. Wenn Entwickler eine AEM Forms-Anwendung erstellen, können sie die Elemente im Repository anstatt im Dateisystem bereitstellen. Die Elemente können alle Typen von Zusätzen umfassen, darunter XML-Formulare, PDF-Formulare (einschließlich Acrobat-Formularen), Formularfragmente, Bilder, Profile, Richtlinien, SWF-Dateien, DDX-Dateien, XML-Schemas, WSDL-Dateien und Testdaten.
Nehmen Sie beispielsweise die folgende Forms-Anwendung mit dem Namen Applications/FormsApplication:
Beachten Sie, dass sich im FormsFolder eine Datei mit dem Namen "Loan.xdp"befindet. Um auf diesen Formularentwurf zuzugreifen, geben Sie den vollständigen Pfad an (einschließlich Version): Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
.
Informationen zum Erstellen einer Forms-Anwendung mit Workbench finden Sie unter Workbench Help.
Der Pfad zu einer Ressource im AEM Forms-Repository lautet:
Applications/Application-name/Application-version/Folder.../Filename
Die folgenden Werte zeigen einige Beispiele für URI-Werte:
Sie können das AEM Forms-Repository über einen Webbrowser durchsuchen. Um das Repository zu durchsuchen, geben Sie die folgende URL in einen Webbrowser ein https://[server name]:[server port]/repository
. Mithilfe eines Webbrowsers können Sie die Beginn überprüfen, die mit dem Abschnitt Arbeiten mit AEM Forms-Repository verknüpft sind. Wenn Sie beispielsweise Inhalte zum AEM Forms-Repository hinzufügen, können Sie den Inhalt in einem Webbrowser anzeigen. (Siehe Quick Beginn (SOAP-Modus): Schreiben einer Ressource mit der Java-API.)
Die Repository-API bietet eine Reihe von Vorgängen, mit denen Sie Informationen aus dem Repository speichern und abrufen können. Sie können beispielsweise eine Liste von Ressourcen abrufen oder spezifische Ressourcen abrufen, die im Repository gespeichert werden, wenn eine Ressource im Rahmen der Verarbeitung einer Anwendung benötigt wird.
Die Repository-API kann nicht für die Interaktion mit Content Services (nicht mehr unterstützt) verwendet werden. Für die Interaktion mit Content Services (nicht mehr unterstützt) verwenden Sie die Dokument-Management-API.
Mithilfe der Repository-Dienst-API können Sie die folgenden Aufgaben ausführen:
Mithilfe der Repository-API können Sie die Ressourcenverwaltung nicht verwalten, nach Ressourcen suchen oder Ressourcenbeziehungen mithilfe eines ECM-Repositorys festlegen.
Wenn eine verschlüsselte PDF-Datei in das Repository geschrieben wird, kann die Funktion zur Extraktion automatisierter Beziehungen nicht verwendet werden. Andernfalls kann eine verschlüsselte PDF im Repository gespeichert und später abgerufen werden. Der Abruf kann die PDF entschlüsseln, nachdem sie aus dem Repository abgerufen wurde.
Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.
Ordner (Ressourcensammlungen) werden zum Speichern von Objekten (Dateien oder Ressourcen) in organisierten Gruppierungen verwendet. Ordner können Ressourcen und andere Ordner enthalten, die auch als Unterordner bezeichnet werden. Ressourcen können jeweils nur in einem Ordner gespeichert werden.
Dateien übernehmen Listen der Zugriffskontrolle (ACLs) aus Ordnern und Unterordner übernehmen ACLs aus ihren übergeordneten Ordnern. Daher müssen die übergeordneten Ordner vorhanden sein, bevor Sie untergeordnete Ordner erstellen können. Die IDE ermöglicht die Interaktion nur auf Ordner-für-Ordner-Basis, nicht auf Datei-für-Datei-Basis. Sie können keine Versionsordner erstellen, und dies ist nicht erforderlich. ein Ordner selbst keine Daten enthält. Vielmehr ist es nur ein Container für Ressourcen, die Daten enthalten. Die standardmäßige Zugriffsberechtigung für ACL ist auf Systemebene. Das bedeutet, dass Benutzer über Berechtigungen auf Systemebene verfügen müssen (Lese-, Schreib-, Durchlauf- und Verwaltungsberechtigungen für ACLs), bis ihnen jemand Berechtigungen für einen bestimmten Ordner erteilt. ACLs funktionieren nur in der IDE.
Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.
Gehen Sie wie folgt vor, um einen Ordner zu erstellen:
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, schließen Sie die Proxydateien ein.
Dienstclient erstellen
Bevor Sie eine Ressourcensammlung programmgesteuert erstellen können, müssen Sie eine Verbindung herstellen und Anmeldeinformationen angeben. Dies wird durch Erstellen eines Dienstclients erreicht.
Erstellen Sie den Ordner
Rufen Sie die Methode des Repository-Dienstes auf, um die Ressourcensammlung zu erstellen und die Ressourcensammlung mit Identifizierungsinformationen wie UUID, Ordnername und Beschreibung zu füllen.
Den Ordner in das Repository schreiben
Rufen Sie die Methode des Repository-Dienstes auf, um die Ressourcensammlung zu schreiben, und geben Sie den URI des Ordners "Zielgruppe"an.
Siehe auch
Erstellen von Ordnern mit der Java-API
Erstellen von Ordnern mit der Webdienst-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Beginn zur Repository Service API
Erstellen Sie einen Ordner mithilfe der Repository Service API (Java):
Projektdateien einschließen
Schließen Sie Projektdateien in den Klassenpfad Ihres Java-Projekts ein.
Dienstclient erstellen
Erstellen Sie ein ResourceRepositoryClient
-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory
-Objekt übergeben, das Verbindungseigenschaften enthält.
Erstellen Sie den Ordner
Um eine Ressourcensammlung zu erstellen, müssen Sie zunächst ein com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean
-Objekt erstellen.
Rufen Sie die newResourceCollection
-Methode des Objekts auf und übergeben Sie die folgenden Parameter:repositoryInfomodelFactoryBean
com.adobe.repository.infomodel.Id
UUID-ID, die der Ressource zugewiesen wird.com.adobe.repository.infomodel.Lid
UUID-ID, die der Ressource zugewiesen wird.java.lang.String
, der den Namen der Ressourcensammlung enthält. Beispiel: FormsFolder
.Die Methode gibt ein com.adobe.repository.infomodel.bean.ResourceCollection
-Objekt zurück, das den neuen Ordner darstellt.
Legen Sie die Beschreibung des Ordners mit der setDescription
-Methode fest und übergeben Sie den folgenden Parameter:
String
, das die Ressourcensammlung beschreibt. In diesem Beispiel wird "test Folder"
verwendet..
Den Ordner in das Repository schreiben
Rufen Sie die writeResource
-Methode des Objekts auf und übergeben Sie den URI des Ordners und das ResourceCollection
-Objekt. ResourceRepositoryClient
Beispielsweise kann der URI für den Ordner der folgende Wert sein: /Applications/FormsApplication/1.0/
.
Die Methode gibt eine Instanz des neu erstellten com.adobe.repository.infomodel.bean.Resource
-Objekts zurück. Sie können beispielsweise den Bezeichnerwert der neuen Ressource abrufen, indem Sie die getId
-Methode des Objekts aufrufen.com.adobe.repository.infomodel.bean.Resource
Siehe auch
Quick Beginn (SOAP-Modus): Erstellen eines Ordners mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Erstellen Sie einen Ordner mithilfe der Repository Service API (Webdienst):
Projektdateien einschließen
Dienstclient erstellen
Erstellen Sie mit der Microsoft .NET-Clientassembly ein RepositoryServiceService
-Objekt, indem Sie dessen Standardkonstruktor aufrufen. Legen Sie die Eigenschaft Credentials
mit einem System.Net.NetworkCredential
-Objekt fest, das den Benutzernamen und das Kennwort enthält.
Erstellen Sie den Ordner
Erstellen Sie den Ordner mit dem Standardkonstruktor für die ResourceCollection
-Klasse und übergeben Sie die folgenden Parameter:
Id
-Objekt, das durch Aufrufen des Standardkonstruktors für die Id
-Klasse erstellt und dem Resource
-Objektfeld id
zugewiesen wird.Lid
-Objekt, das durch Aufrufen des Standardkonstruktors für die Lid
-Klasse erstellt und dem Resource
-Objektfeld lid
zugewiesen wird.Resource
des Objekts name
zugewiesen ist. Der in diesem Beispiel verwendete Name ist "testfolder"
.Resource
des Objekts description
zugewiesen ist. Die in diesem Beispiel verwendete Beschreibung ist "test folder"
.Den Ordner in das Repository schreiben
Rufen Sie die writeResource
-Methode des Objekts auf und übergeben Sie die folgenden Parameter:RepositoryServiceService
ResourceCollection
-Objekt, das den Ordner darstellt.null
für die anderen beiden Parameter.Siehe auch
Aufrufen von AEM Forms mit Base64-Kodierung
Sie können Ressourcen an einem bestimmten Speicherort im Repository erstellen. Die natürliche Dateigröße unterliegt Datenbankbeschränkungen und Sitzungszeitlimit. Bei der Standardkonfiguration sind die Dateien auf 25 MB beschränkt. Um die maximale Dateigröße zu erhöhen oder zu verringern, müssen Sie die Datenbankkonfiguration ändern.
Das Schreiben von Ressourcen entspricht dem Speichern von Daten im Repository. Sobald Sie eine Ressource in das Repository schreiben, wird sie für alle Clients im Repository-Ökosystem verfügbar. Wenn Sie Ressourcen wie XML-Schemas, XDP-Dateien und XSD-Dateien in das Repository schreiben, werden die Inhalte basierend auf dem MIME-Typ analysiert. Wenn der MIME-Typ unterstützt wird, bestimmt der Parser, ob eine implizite Beziehung zu anderen Inhalten besteht. Wenn beispielsweise ein CSS (Cascading Stylesheet) über eine relative URL verfügt, die auf eine gängige CSS verweist, wird erwartet, dass Sie auch die allgemeine CSS in das Repository senden. Die Beziehung zwischen den beiden Ressourcen wird als ausstehende Beziehung für einen nicht anpassbaren Zeitraum von 30 Tagen gespeichert. Wenn Sie die allgemeine CSS innerhalb des Zeitraums von 30 Tagen an das Repository senden, wird die Beziehung aufgebaut.
Wenn Sie eine Ressource erstellen, wird die Zugriffskontrolle-Liste (ACL) vom übergeordneten Ordner übernommen. Der Stammordner verfügt über Berechtigungen auf Systemebene, bis eine ursprüngliche Ressource oder ein anfänglicher Ordner erstellt wurde. An diesem Punkt erhält die Ressource oder der Ordner die standardmäßigen Zugriffsrechte für ACL.
Sie können Ressourcen programmgesteuert mit der Java-API des Repository-Dienstes oder der Webdienst-API schreiben.
Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.
Gehen Sie wie folgt vor, um eine Ressource zu schreiben:
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, schließen Sie die Proxydateien ein.
Dienstclient erstellen
Bevor Sie eine Ressource programmgesteuert lesen können, müssen Sie eine Verbindung herstellen und Anmeldeinformationen angeben. Dies wird durch Erstellen eines Dienstclients erreicht.
Geben Sie den URI des Ordners "Zielgruppe"für die Ressource an
Erstellen Sie eine Zeichenfolge, die den URI der zu lesenden Ressource enthält. Die Syntax enthält Schrägstriche, wie im folgenden Beispiel: "/path/folder".
Ressource erstellen
Rufen Sie die Methode des Repository-Dienstes auf, um die Ressource zu erstellen, und füllen Sie die Ressource mit Identifizierungsinformationen wie UUID, Ressourcenname und Beschreibung.
Ressourceninhalt angeben
Rufen Sie die Methode des Repository-Dienstes auf, um Ressourceninhalte zu erstellen und diesen Inhalt in der Ressource zu speichern.
Ressource in den Ordner "Zielgruppe"schreiben
Rufen Sie die Methode des Repository-Dienstes auf, um die Ressource zu schreiben, und geben Sie den URI des Ordners "Zielgruppe"an.
Siehe auch
Ressourcen mit der Java-API schreiben
Schreiben von Ressourcen mit der Webdienst-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Beginn zur Repository Service API
Erstellen Sie eine Ressource mithilfe der Repository Service API (Java):
Projektdateien einschließen
Schließen Sie JAR-Clientdateien in den Klassenpfad Ihres Java-Projekts ein.
Dienstclient erstellen
Erstellen Sie ein ResourceRepositoryClient
-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory
-Objekt übergeben, das Verbindungseigenschaften enthält.
Geben Sie den URI des Ordners "Zielgruppe"für die Ressource an
Geben Sie den URI des Ressourcenordners für die Zielgruppe an. In diesem Fall ist der URI des Ordners "/testFolder"
, da die Ressource testResource
im Ordner testFolder
gespeichert wird. Der URI wird als java.lang.String
-Objekt gespeichert.
Ressource erstellen
Um eine Ressource zu erstellen, müssen Sie zunächst ein com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean
-Objekt erstellen.
Rufen Sie die newResource
-Methode des Objekts auf, mit der ein com.adobe.repository.infomodel.bean.Resource
-Objekt erstellt wird. RepositoryInfomodelFactoryBean
In diesem Beispiel werden die folgenden Parameter bereitgestellt:
com.adobe.repository.infomodel.Id
-Objekt, das durch Aufrufen des Standardkonstruktors für die Id
-Klasse erstellt wird.com.adobe.repository.infomodel.Lid
-Objekt, das durch Aufrufen des Standardkonstruktors für die Lid
-Klasse erstellt wird.java.lang.String
, der den Dateinamen der Ressource enthält.Um die Beschreibung der Ressource anzugeben, rufen Sie die Resource
-Methode des Objekts setDescription
auf und übergeben Sie eine Zeichenfolge, die die Beschreibung enthält. In diesem Beispiel lautet die Beschreibung "test resource"
.
Ressourceninhalt angeben
Um Inhalte für die Ressource zu erstellen, rufen Sie die RepositoryInfomodelFactoryBean
-Objektmethode newResourceContent
auf, die ein com.adobe.repository.infomodel.bean.ResourceContent
-Objekt zurückgibt. hinzufügen Inhalt in das ResourceContent
-Objekt. In diesem Beispiel wird dies durch folgende Aufgaben erreicht:
setDataDocument
-Methode des ResourceContent
-Objekts und Übergeben eines com.adobe.idp.Document
-ObjektssetSize
-Methode des ResourceContent
-Objekts und Übergeben der Größe in Byte des Document
-Objektshinzufügen Sie den Inhalt an die Ressource, indem Sie die Resource
-Objektmethode setContent
aufrufen und das ResourceContent
-Objekt übergeben. Weitere Informationen finden Sie unter AEM Forms API Reference.
Ressource in den Ordner "Zielgruppe"schreiben
Rufen Sie die writeResource
-Methode des Objekts auf und übergeben Sie den URI des Ordners sowie das Resource
-Objekt.ResourceRepositoryClient
Siehe auch
Quick Beginn (SOAP-Modus): Schreiben einer Ressource mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Erstellen Sie eine Ressource mithilfe der Repository Service API (Webdienst):
Projektdateien einschließen
Dienstclient erstellen
Erstellen Sie mit der Microsoft .NET-Clientassembly ein RepositoryServiceService
-Objekt, indem Sie dessen Standardkonstruktor aufrufen. Legen Sie die Eigenschaft Credentials
mit einem System.Net.NetworkCredential
-Objekt fest, das den Benutzernamen und das Kennwort enthält.
Geben Sie den URI des Ordners "Zielgruppe"für die Ressource an
Geben Sie den URI des Ressourcenordners für die Zielgruppe an. In diesem Fall ist der URI des Ordners "/testFolder"
, da die Ressource testResource
im Ordner testFolder
gespeichert wird. Wenn Sie eine mit Microsoft .NET Framework kompatible Sprache verwenden (z. B. C#), speichern Sie den URI in einem System.String
-Objekt.
Ressource erstellen
Um eine Ressource zu erstellen, rufen Sie den Standardkonstruktor für die Klasse Resource
auf. In diesem Beispiel werden die folgenden Informationen im Resource
-Objekt gespeichert:
com.adobe.repository.infomodel.Id
-Objekt, das durch Aufrufen des Standardkonstruktors für die Id
-Klasse erstellt und dem Resource
-Objektfeld id
zugewiesen wird.com.adobe.repository.infomodel.Lid
-Objekt, das durch Aufrufen des Standardkonstruktors für die Lid
-Klasse erstellt und dem Resource
-Objektfeld lid
zugewiesen wird.Resource
des Objekts name
zugewiesen ist. Der in diesem Beispiel verwendete Name ist "testResource"
.Resource
des Objekts description
zugewiesen ist. Die in diesem Beispiel verwendete Beschreibung ist "test resource"
.Ressourceninhalt angeben
Um Inhalte für die Ressource zu erstellen, rufen Sie den Standardkonstruktor für die Klasse ResourceContent
auf. Fügen Sie dann dem ResourceContent
-Objekt Inhalt hinzu. In diesem Beispiel wird dies durch folgende Aufgaben erreicht:
BLOB
-Objekts, das ein Dokument enthält, zum ResourceContent
-Objektfeld dataDocument
BLOB
zum Feld ResourceContent
des Objekts size
hinzufügen Sie den Inhalt der Ressource, indem Sie das ResourceContent
-Objekt dem Resource
-Objektfeld content
zuweisen.
Ressource in den Ordner "Zielgruppe"schreiben
Rufen Sie die writeResource
-Methode des Objekts auf und übergeben Sie den URI des Ordners sowie das Resource
-Objekt. RepositoryServiceService
Übergeben Sie null
für die anderen beiden Parameter.
Siehe auch
Aufrufen von AEM Forms mit Base64-Kodierung
Sie können Ressourcen entdecken, indem Sie Ressourcen auflisten. Für das Repository wird eine Abfrage ausgeführt, um alle Ressourcen zu finden, die mit einer bestimmten Ressourcensammlung zusammenhängen.
Nachdem Sie Ihre Ressourcen organisiert haben, können Sie die von Ihnen erstellte Struktur überprüfen, indem Sie einen bestimmten Zweig der Struktur sehen, ähnlich wie bei einem Betriebssystem.
Auflisten von Ressourcen funktioniert nach Beziehung: Ressourcen sind Mitglieder von Ordnern. Die Mitgliedschaft wird durch eine Beziehung des Typs "Mitglied von"repräsentiert. Wenn Sie Ressourcen in einem bestimmten Ordner Liste haben, suchen Sie nach Ressourcen, die mit einem bestimmten Ordner durch die Beziehung "Mitglied von"in Verbindung stehen. Beziehungen sind in Richtung: Ein Mitglied einer Beziehung hat eine Quelle, die Mitglied der Zielgruppe ist. Die Quelle ist die Ressource; die Zielgruppe ist der übergeordnete Ordner.
Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.
Gehen Sie zur Liste von Ressourcen wie folgt vor:
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, schließen Sie die Proxydateien ein.
Dienstclient erstellen
Bevor Sie eine Ressourcensammlung programmgesteuert erstellen können, müssen Sie eine Verbindung herstellen und Anmeldeinformationen angeben. Dies wird durch Erstellen eines Dienstclients erreicht.
Ordnerpfad angeben
Erstellen Sie eine Zeichenfolge, die den Pfad des Ordners enthält, der die Ressourcen enthält. Die Syntax enthält Schrägstriche, wie im folgenden Beispiel: "/path/folder".
Abrufen der Liste von Ressourcen
Rufen Sie die Methode des Repository-Dienstes auf, um die Liste der Zielgruppen abzurufen, und geben Sie den Pfad des Ordners an.
Siehe auch
Liste von Ressourcen mit der Webdienst-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Beginn zur Repository Service API
Listen mithilfe der Repository Service API (Java):
Projektdateien einschließen
Schließen Sie JAR-Clientdateien in den Klassenpfad Ihres Java-Projekts ein.
Dienstclient erstellen
Erstellen Sie ein ResourceRepositoryClient
-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory
-Objekt übergeben, das Verbindungseigenschaften enthält.
Ordnerpfad angeben
Geben Sie den URI der zu abfragenden Ressourcensammlung an. In diesem Fall lautet der URI "/testFolder"
. Der URI wird als java.lang.String
-Objekt gespeichert.
Abrufen der Liste von Ressourcen
Rufen Sie die ResourceRepositoryClient
-Methode des Objekts listMembers
auf und übergeben Sie den URI des Ordners.
Die Methode gibt ein java.util.List
von com.adobe.repository.infomodel.bean.Resource
Objekten zurück, die die Quelle eines com.adobe.repository.infomodel.bean.Relation
vom Typ Relation.TYPE_MEMBER_OF
sind und die den URI für die Ressourcensammlung als Zielgruppe haben. Sie können diese List
durchlaufen, um die einzelnen Ressourcen abzurufen. In diesem Beispiel werden der Name und die Beschreibung der einzelnen Ressourcen angezeigt.
Siehe auch
Quick Beginn (SOAP-Modus): Auflisten von Ressourcen mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Liste von Ressourcen mithilfe der Repository Service API (Webdienst):
Projektdateien einschließen
Dienstclient erstellen
Erstellen Sie mit der Microsoft .NET-Clientassembly ein RepositoryServiceService
-Objekt, indem Sie dessen Standardkonstruktor aufrufen. Legen Sie die Eigenschaft Credentials
mit einem System.Net.NetworkCredential
-Objekt fest, das den Benutzernamen und das Kennwort enthält.
Ordnerpfad angeben
Geben Sie eine Zeichenfolge an, die den URI des abzufragenden Ordners enthält. In diesem Fall lautet der URI "/testFolder"
. Wenn Sie eine mit Microsoft .NET Framework kompatible Sprache verwenden (z. B. C#), speichern Sie den URI in einem System.String
-Objekt.
Abrufen der Liste von Ressourcen
Rufen Sie die RepositoryServiceService
-Methode des Objekts listMembers
auf und übergeben Sie den URI des Ordners als ersten Parameter. Übergeben Sie null
für die anderen beiden Parameter.
Die Methode gibt ein Array von Objekten zurück, die in Resource
-Objekte umgewandelt werden können. Sie können das Objektarray durchlaufen, um jede der zugehörigen Ressourcen abzurufen. In diesem Beispiel werden der Name und die Beschreibung der einzelnen Ressourcen angezeigt.
Siehe auch
Aufrufen von AEM Forms mit Base64-Kodierung
Sie können Ressourcen von einem bestimmten Speicherort im Repository abrufen, um deren Inhalt und Metadaten zu lesen. Der Workflow wird durch ein Initialisierungsformular vorn beendet. Der Prozess verfügt über alle Berechtigungen, die zum Lesen des Formulars erforderlich sind. Das System ruft das Datenformular ab und liest den Inhalt aus dem Repository. Das Repository gewährt Zugriff auf den Inhalt und die Metadaten (die Möglichkeit, die Ressource zu erkennen).
Das Repository verfügt über die folgenden vier Berechtigungstypen:
Benutzer können nur Prozesse ausführen, wenn sie über die Berechtigung zum Ausführen des Prozesses verfügen. IDE-Benutzer benötigen für die Synchronisierung mit dem Repository die Berechtigung zum Durchlaufen und Lesen. ACLs gelten nur zur Entwurfszeit, da die Laufzeit im Systemkontext erfolgt.
Sie können Ressourcen programmgesteuert mit der Java-API des Repository-Dienstes oder der Webdienst-API lesen.
Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.
Gehen Sie wie folgt vor, um eine Ressource zu lesen:
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, schließen Sie die Proxydateien ein.
Dienstclient erstellen
Bevor Sie eine Ressource programmgesteuert lesen können, müssen Sie eine Verbindung herstellen und Anmeldeinformationen angeben. Dies wird durch Erstellen eines Dienstclients erreicht.
Geben Sie den URI der zu lesenden Ressource an
Erstellen Sie eine Zeichenfolge, die den URI der zu lesenden Ressource enthält. Die Syntax enthält Schrägstriche, wie im folgenden Beispiel: "/path/resource".
Ressource lesen
Rufen Sie die Methode des Repository-Dienstes auf, um die Ressource zu lesen, und geben Sie den URI an.
Siehe auch
Ressourcen mithilfe der Java-API lesen
Lesen von Ressourcen mit der Webdienst-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Beginn zur Repository Service API
Lesen Sie eine Ressource mithilfe der Repository-Dienst-API (Java):
Projektdateien einschließen
Schließen Sie JAR-Clientdateien in den Klassenpfad Ihres Java-Projekts ein.
Dienstclient erstellen
Erstellen Sie ein ResourceRepositoryClient
-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory
-Objekt übergeben, das Verbindungseigenschaften enthält.
Geben Sie den URI der zu lesenden Ressource an
Geben Sie einen Zeichenfolgenwert an, der den URI der abzurufenden Ressource darstellt. Wenn die Ressource beispielsweise testResource heißt, die sich in einem Ordner mit dem Namen testFolder befindet, geben Sie /testFolder/testResource
an.
Ressource lesen
Rufen Sie die readResource
-Methode des Objekts auf und übergeben Sie den URI der Ressource als Parameter. ResourceRepositoryClient
Diese Methode gibt eine Resource
-Instanz zurück, die die Ressource darstellt.
Siehe auch
Quick Beginn (SOAP-Modus): Lesen einer Ressource mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Lesen Sie eine Ressource mithilfe der Repository-Dienst-API (Webdienst):
Projektdateien einschließen
Dienstclient erstellen
Erstellen Sie mit der Microsoft .NET-Clientassembly ein RepositoryServiceService
-Objekt, indem Sie dessen Standardkonstruktor aufrufen. Legen Sie die Eigenschaft Credentials
mit einem System.Net.NetworkCredential
-Objekt fest, das den Benutzernamen und das Kennwort enthält.
Geben Sie den URI der zu lesenden Ressource an
Geben Sie eine Zeichenfolge an, die den URI der abzurufenden Ressource enthält. In diesem Fall lautet der URI "/testFolder/testResource"
, da sich die Ressource testResource
im Ordner testFolder
befindet. Wenn Sie eine mit Microsoft .NET Framework kompatible Sprache verwenden (z. B. C#), speichern Sie den URI in einem System.String
-Objekt.
Ressource lesen
Rufen Sie die readResource
-Methode des Objekts auf und übergeben Sie den URI der Ressource als ersten Parameter. RepositoryServiceService
Übergeben Sie null
für die anderen beiden Parameter.
Siehe auch
Aufrufen von AEM Forms mit Base64-Kodierung
Sie können den Inhalt der Ressourcen im Repository abrufen und aktualisieren. Wenn Sie Ressourcen aktualisieren, bleibt die Zugriffskontrolle auf diese Ressourcen zwischen den verschiedenen Versionen unverändert. Bei der Ausführung einer Aktualisierung haben Sie die Möglichkeit, die Hauptversion zu erhöhen. Wenn Sie die Hauptversion nicht inkrementieren, wird die Nebenversion automatisch aktualisiert.
Wenn Sie eine Ressource aktualisieren, wird die neue Version basierend auf den angegebenen Ressourcenattributen erstellt. Wenn Sie eine Ressource aktualisieren, geben Sie zwei wichtige Parameter an: der Zielgruppen-URI und eine Ressourceninstanz, die alle aktualisierten Metadaten enthält. Beachten Sie, dass das Attribut bei keiner Änderung eines bestimmten Attributs (z. B. des Namens) in der von Ihnen übergebenen Instanz weiterhin erforderlich ist. Die Beziehungen, die beim Analysieren des Inhalts erstellt werden, werden der jeweiligen Version hinzugefügt und nur nach Angabe weitergeleitet.
Wenn Sie beispielsweise eine XDP-Datei aktualisieren und sie Verweise auf andere Ressourcen enthält, werden diese zusätzlichen Verweise ebenfalls aufgezeichnet. Angenommen, form.xdp Version 1.0 hat zwei externe Verweise: ein Logo und ein Stylesheet und Sie aktualisieren dann form.xdp, sodass es jetzt drei Verweise hat: ein Logo, ein Stylesheet und eine Schema-Datei. Während der Aktualisierung fügt das Repository der ausstehenden Beziehungstabelle die dritte Beziehung (zur Schema-Datei) hinzu. Sobald die Schema-Datei im Repository vorhanden ist, wird die Beziehung automatisch aufgebaut. Wenn form.xdp Version 2.0 das Logo jedoch nicht mehr verwendet, hat form.xdp Version 2.0 keine Beziehung zum Logo.
Alle Aktualisierungsvorgänge sind atomar und transaktional. Wenn zum Beispiel zwei Benutzer dieselbe Ressource lesen und beide entscheiden, Version 1.0 auf Version 2.0 zu aktualisieren, wird einer von ihnen erfolgreich sein und einer von ihnen schlägt fehl, die Integrität des Repositorys wird gewahrt und beide erhalten eine Meldung, die den Erfolg oder Fehler bestätigt. Wenn die Transaktion nicht übernommen wird, wird sie bei einem Datenbankfehler zurückgesetzt und abhängig vom Anwendungsserver ein Timeout oder eine Rollback durchgeführt.
Sie können Ressourcen programmgesteuert mit der Java-API des Repository-Dienstes oder der Webdienst-API aktualisieren.
Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.
Gehen Sie wie folgt vor, um eine Ressource zu aktualisieren:
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, schließen Sie die Proxydateien ein.
Dienstclient erstellen
Bevor Sie eine Ressource programmgesteuert lesen können, müssen Sie eine Verbindung herstellen und Anmeldeinformationen angeben. Dies wird durch Erstellen eines Dienstclients erreicht.
Abrufen der zu aktualisierenden Ressource
Lesen Sie die Ressource. Weitere Informationen finden Sie unter Reading Resources.
Ressource aktualisieren
Legen Sie die neuen Informationen in der Ressource fest und rufen Sie die Methode des Repository-Dienstes auf, um die Ressource zu aktualisieren, geben Sie den URI, die aktualisierte Ressource und die Art und Weise an, wie die Versionsinformationen aktualisiert werden sollen.
Siehe auch
Aktualisieren von Ressourcen mit der Java-API
Aktualisieren von Ressourcen mithilfe der Webdienst-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Beginn zur Repository Service API
Aktualisieren Sie eine Ressource mithilfe der Repository Service API (Java):
Projektdateien einschließen
Schließen Sie JAR-Clientdateien in den Klassenpfad Ihres Java-Projekts ein.
Dienstclient erstellen
Erstellen Sie ein ResourceRepositoryClient
-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory
-Objekt übergeben, das Verbindungseigenschaften enthält.
Abrufen der zu aktualisierenden Ressource
Geben Sie den URI der Ressource an, die abgerufen und gelesen werden soll. In diesem Beispiel lautet der URI der Ressource "/testFolder/testResource"
.
Ressource aktualisieren
Aktualisieren Sie die Informationen des Objekts Resource
. Um die Beschreibung in diesem Beispiel zu aktualisieren, rufen Sie die Resource
-Methode des Objekts setDescription
auf und übergeben Sie die neue Zeichenfolge als Parameter.
Rufen Sie dann die updateResource
-Methode des Objekts auf und übergeben Sie die folgenden Parameter:ServiceClientFactory
java.lang.String
-Objekt, das den URI der Ressource enthält.Resource
-Objekt, das die aktualisierten Ressourceninformationen enthält.boolean
-Wert, der angibt, ob die Haupt- oder Nebenversion aktualisiert werden soll. In diesem Beispiel wird der Wert true
übergeben, um anzugeben, dass die Hauptversion inkrementiert werden soll.Siehe auch
Quick Beginn (SOAP-Modus): Aktualisieren einer Ressource mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Aktualisieren Sie eine Ressource mithilfe der Repository API (Webdienst):
Projektdateien einschließen
Dienstclient erstellen
Erstellen Sie mit der Microsoft .NET-Clientassembly ein RepositoryServiceService
-Objekt, indem Sie dessen Standardkonstruktor aufrufen. Legen Sie die Eigenschaft Credentials
mit einem System.Net.NetworkCredential
-Objekt fest, das den Benutzernamen und das Kennwort enthält.
Abrufen der zu aktualisierenden Ressource
Geben Sie den URI der Ressource an, die abgerufen und gelesen werden soll. In diesem Beispiel lautet der URI der Ressource "/testFolder/testResource"
. Weitere Informationen finden Sie unter Reading Resources.
Ressource aktualisieren
Aktualisieren Sie die Informationen des Objekts Resource
. Um in diesem Beispiel die Beschreibung zu aktualisieren, weisen Sie dem Feld Resource
des Objekts description
einen neuen Wert zu.
Rufen Sie die updateResource
-Methode des Objekts auf und übergeben Sie die folgenden Parameter:RepositoryServiceService
System.String
-Objekt, das den URI der Ressource enthält.Resource
-Objekt, das die aktualisierten Ressourceninformationen enthält.boolean
-Wert, der angibt, ob die Haupt- oder Nebenversion aktualisiert werden soll. In diesem Beispiel wird der Wert true
übergeben, um anzugeben, dass die Hauptversion inkrementiert werden soll.null
für die verbleibenden beiden Parameter.Siehe auch
Aufrufen von AEM Forms mit Base64-Kodierung
Sie können Abfragen erstellen, mit denen im Repository nach Ressourcen gesucht wird, einschließlich Verlauf, zugehörige Ressourcen und Eigenschaften.
Sie können zugehörige Ressourcen abrufen, um Abhängigkeiten zwischen einem Formular und seinen Fragmenten zu ermitteln. Wenn Sie beispielsweise ein Formular haben, können Sie festlegen, welche Fragmente oder externen Ressourcen es verwendet. Wenn Sie ein Bild haben, können Sie auch herausfinden, welche Formulare das Bild verwenden. Sie können auch nach verwandten Ressourcen suchen, indem Sie auf der Grundlage von Eigenschaften filtern. Sie können beispielsweise nach allen Formularen suchen, die ein Bild mit einem angegebenen Namen verwenden, oder nach jedem Bild, das von einem Formular mit einem angegebenen Namen verwendet wird. Sie können auch mithilfe der Ressourceneigenschaften suchen. Sie können beispielsweise eine Abfrage durchführen, um alle Formulare oder Ressourcen zu finden, deren Beginn mit einer angegebenen Zeichenfolge mit "%"und "_"gekennzeichnet sind. Denken Sie daran, dass Suchvorgänge, die auf Eigenschaften basieren, nicht auf Beziehungen basieren; Diese Suchvorgänge basieren auf der Annahme, dass Sie über spezifische Kenntnisse zu einer bestimmten Ressource verfügen.
Anweisungen zur Abfrage
Eine Abfrage enthält eine oder mehrere Anweisungen, die logisch mit Bedingungen verbunden sind. Eine Anweisung besteht aus einem linken Operanden, einem Operator und einem rechten Operanden. Darüber hinaus können Sie die Sortierreihenfolge festlegen, die für die Suchergebnisse verwendet werden soll. Die Sortierreihenfolge enthält Informationen, die einer SQL ORDER BY
-Klausel entsprechen, und besteht aus Elementen, die die Attribute enthalten, auf denen die Suche basiert, sowie einem Wert, der angibt, ob eine aufsteigende oder absteigende Reihenfolge verwendet werden soll.
Sie können mithilfe der Java-API des Repository-Dienstes programmgesteuert nach Ressourcen suchen. Derzeit ist es nicht möglich, die Web-Service-API für die Suche nach Ressourcen zu verwenden.
Sortierverhalten
Die Sortierreihenfolge wird nicht berücksichtigt, wenn die ResourceRepositoryClient
-Methode des Objekts searchProperties
aufgerufen und eine Sortierreihenfolge angegeben wird. Angenommen, Sie erstellen eine Ressource mit drei benutzerdefinierten Eigenschaften, wobei die Attributnamen name
, secondName
und asecondName
lauten. Als Nächstes erstellen Sie ein Element für die Sortierreihenfolge auf dem Attributnamen und setzen den Wert ascending
auf true
.
Anschließend rufen Sie die ResourceRepositoryClient
-Methode des Objekts auf und übergeben die Sortierreihenfolge. searchProperties
Die Suche gibt die richtige Ressource mit den drei Eigenschaften zurück. Die Eigenschaften werden jedoch nicht nach Attributnamen sortiert. Sie werden in der Reihenfolge zurückgegeben, in der sie hinzugefügt wurden: name
, secondName
und asecondName
.
Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.
Gehen Sie wie folgt vor, um nach Ressourcen zu suchen:
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, schließen Sie die Proxydateien ein.
Dienstclient erstellen
Bevor Sie eine Ressource programmgesteuert lesen können, müssen Sie eine Verbindung herstellen und Anmeldeinformationen angeben. Dies wird durch Erstellen eines Dienstclients erreicht.
Geben Sie den Ordner "Zielgruppe"für die Suche an
Erstellen Sie eine Zeichenfolge, die den Basispfad enthält, von dem aus die Suche durchgeführt werden soll. Die Syntax enthält Schrägstriche, wie im folgenden Beispiel: "/path/folder".
Geben Sie die Attribute an, die bei der Suche verwendet werden
Sie können Ihre Suche auf den Attributen in den Ressourcen aufbauen. Geben Sie die Werte der Attribute an, auf denen die Suche durchgeführt werden soll.
Erstellen der bei der Suche verwendeten Abfrage
Erstellen Sie eine Abfrage mithilfe von Anweisungen und Bedingungen. Jede Anweisung gibt das Attribut an, auf dem die Suche basieren soll, die zu verwendende Bedingung und den bei der Suche zu verwendenden Attributwert.
Erstellen der Sortierreihenfolge für die Suchergebnisse
Die Sortierreihenfolge besteht aus Elementen, von denen jedes eines der Attribute enthält, die bei der Suche verwendet werden, sowie einem Wert, der angibt, ob die Reihenfolge aufsteigend oder absteigend sein soll.
Ressourcen suchen
Suchen Sie mithilfe des Ordners, der Abfrage und der Sortierreihenfolge nach Ressourcen. Geben Sie außerdem die Suchtiefe und eine Obergrenze für die Anzahl der zurückzugebenden Ergebnisse an.
Ressourcen aus dem Suchergebnis abrufen
Durchlaufen Sie die zurückgegebene Liste der Ressourcen und extrahieren Sie die Informationen zur weiteren Verarbeitung.
Siehe auch
Ressourcen mit der Java-API suchen
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Beginn zur Repository Service API
Suchen Sie eine Ressource mithilfe der Repository Service API (Java):
Projektdateien einschließen
Schließen Sie JAR-Clientdateien in den Klassenpfad Ihres Java-Projekts ein.
Dienstclient erstellen
Erstellen Sie ein ResourceRepositoryClient
-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory
-Objekt übergeben, das Verbindungseigenschaften enthält.
Geben Sie den Ordner "Zielgruppe"für die Suche an
Geben Sie den URI des Basispfades an, aus dem die Suche ausgeführt werden soll. In diesem Beispiel lautet der URI der Ressource /testFolder
.
Geben Sie die Attribute an, die bei der Suche verwendet werden
Geben Sie die Werte für die Attribute an, auf denen die Suche durchgeführt werden soll. Die Attribute befinden sich in einem com.adobe.repository.infomodel.bean.Resource
-Objekt. In diesem Beispiel wird die Suche mit dem Attribut name durchgeführt. Daher wird ein java.lang.String
-Objekt verwendet, das den Namen des Resource
-Objekts enthält, in diesem Fall testResource
.
Erstellen der bei der Suche verwendeten Abfrage
Um eine Abfrage zu erstellen, erstellen Sie ein com.adobe.repository.query.Query
-Objekt, indem Sie den Standardkonstruktor für die Query
-Klasse aufrufen und der Abfrage Anweisungen hinzufügen.
Um eine Anweisung zu erstellen, rufen Sie den Konstruktor für die com.adobe.repository.query.Query.Statement
-Klasse auf und übergeben Sie die folgenden Parameter:
Resource.ATTRIBUTE_NAME
verwendet, da der Name der Ressource als Grundlage für die Suche verwendet wird.Query.Statement
sein. In diesem Beispiel wird der statische Wert Query.Statement.OPERATOR_BEGINS_WITH
verwendet.String
, das den Wert "testResource"
enthält, verwendet.Geben Sie den Namensraum des linken Operanden an, indem Sie die Query.Statement
-Objektmethode setNamespace
aufrufen und einen der in der com.adobe.repository.infomodel.bean.ResourceProperty
-Klasse enthaltenen statischen Werte übergeben. In diesem Beispiel wird ResourceProperty.RESERVED_NAMESPACE_REPOSITORY
verwendet.
hinzufügen Sie jede Anweisung an die Abfrage, indem Sie die Query
-Objektmethode addStatement
aufrufen und das Query.Statement
-Objekt übergeben.
Erstellen der Sortierreihenfolge für die Suchergebnisse
Um die in den Suchergebnissen verwendete Sortierreihenfolge festzulegen, erstellen Sie ein com.adobe.repository.query.sort.SortOrder
-Objekt, indem Sie den Standardkonstruktor für die SortOrder
-Klasse aufrufen und Elemente zur Sortierreihenfolge hinzufügen.
Um ein Element für die Sortierreihenfolge zu erstellen, rufen Sie einen der Konstruktoren für die Klasse com.adobe.repository.query.sort.SortOrder.Element
auf. In diesem Beispiel wird der statische Wert Resource.ATTRIBUTE_NAME
als erster Parameter verwendet und die aufsteigende Reihenfolge (ein boolean
-Wert von true
) als zweiter Parameter angegeben, da der Name der Ressource als Grundlage für die Suche verwendet wird.
hinzufügen jedes Element in die Sortierreihenfolge, indem die SortOrder
-Objektmethode addSortElement
aufgerufen und das SortOrder.Element
-Objekt übergeben wird.
Ressourcen suchen
Um anhand der Attributeigenschaften nach resources
zu suchen, rufen Sie die ResourceRepositoryClient
-Methode des Objekts searchProperties
auf und geben Sie die folgenden Parameter ein:
String
, der den Basispfad enthält, aus dem die Suche ausgeführt werden soll. In diesem Fall wird "/testFolder"
verwendet.com.adobe.repository.infomodel.bean.ResourceCollection.DEPTH_INFINITE
verwendet, um anzugeben, dass der Basispfad und alle zugehörigen Ordner verwendet werden sollen.int
-Wert, der die erste Zeile angibt, aus der die nicht paginierte Ergebnismenge ausgewählt werden soll. In diesem Beispiel wird 0
angegeben.int
-Wert, der die maximale Anzahl der zurückzugebenden Ergebnisse angibt. In diesem Beispiel wird 10
angegeben.Die Methode gibt ein java.util.List
von Resource
-Objekten in der angegebenen Sortierreihenfolge zurück.
Ressourcen aus dem Suchergebnis abrufen
Um die im Suchergebnis enthaltenen Ressourcen abzurufen, müssen Sie die List
durchlaufen und jedes Objekt in ein Resource
konvertieren, um die zugehörigen Informationen zu extrahieren. In diesem Beispiel wird der Name der einzelnen Ressourcen angezeigt.
Siehe auch
Quick Beginn (SOAP-Modus): Suchen nach Ressourcen mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Sie können Beziehungen zwischen Ressourcen im Repository angeben. Es gibt drei Arten von Beziehungen:
Sie können eigene benutzerspezifische Beziehungen erstellen. Wenn Sie beispielsweise eine HTML-Datei im Repository speichern und sie ein Bild verwendet, können Sie eine benutzerspezifische Beziehung angeben, um die HTML-Datei mit dem Bild zu verknüpfen (da normalerweise nur XML-Dateien mit Bildern verknüpft werden, die eine durch das Repository definierte Abhängigkeitsbeziehung verwenden). Ein weiteres Beispiel für eine benutzerspezifische Beziehung wäre, wenn Sie eine andere Ansicht des Repositorys mit einer zyklischen Diagrammstruktur anstelle einer Baumstruktur erstellen möchten. Sie können ein Kreisdiagramm zusammen mit einem Viewer definieren, um diese Beziehungen zu durchlaufen. Schließlich könnten Sie angeben, dass eine Ressource eine andere Ressource ersetzt, auch wenn die beiden Ressourcen völlig unterschiedlich sind. In diesem Fall können Sie einen Beziehungstyp außerhalb des reservierten Bereichs definieren und eine Beziehung zwischen diesen beiden Ressourcen herstellen. Ihre Anwendung wäre der einzige Client, der die Beziehung erkennen und verarbeiten könnte, und könnte zur Durchführung von Suchvorgängen zu dieser Beziehung verwendet werden.
Sie können Beziehungen zwischen Ressourcen programmgesteuert angeben, indem Sie die Java-API des Repository-Dienstes oder die Webdienst-API verwenden.
Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.
Gehen Sie wie folgt vor, um eine Beziehung zwischen zwei Ressourcen festzulegen:
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, schließen Sie die Proxydateien ein.
Dienstclient erstellen
Bevor Sie eine Ressource programmgesteuert lesen können, müssen Sie eine Verbindung herstellen und Anmeldeinformationen angeben. Dies wird durch Erstellen eines Dienstclients erreicht.
Geben Sie die URIs der Ressourcen an, die verknüpft werden sollen
Erstellen Sie Zeichenfolgen, die die URIs der Ressource enthalten, die zugeordnet werden soll. Die Syntax enthält Schrägstriche, wie im folgenden Beispiel: "/path/resource".
Beziehung erstellen
Rufen Sie die Methode des Repository-Dienstes auf, um den Beziehungstyp zu erstellen und anzugeben.
Siehe auch
Erstellen von Beziehungsressourcen mit der Java-API
Erstellen von Beziehungsressourcen mit der Webdienst-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Beginn zur Repository Service API
Erstellen Sie Beziehungsressourcen mithilfe der Java-API des Repository-Dienstes:
Projektdateien einschließen
Schließen Sie JAR-Clientdateien in den Klassenpfad Ihres Java-Projekts ein.
Dienstclient erstellen
Erstellen Sie ein ResourceRepositoryClient
-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory
-Objekt übergeben, das Verbindungseigenschaften enthält.
Geben Sie die URIs der Ressourcen an, die verknüpft werden sollen
Geben Sie die URIs der Ressourcen an, die verknüpft werden sollen. In diesem Fall sind die URIs testResource1
und testResource2
und im Ordner testFolder
enthalten, da sich die Ressourcen im Ordner "/testFolder/testResource1"
befinden. "/testFolder/testResource2"
Die URIs werden als java.lang.String
-Objekte gespeichert. In diesem Beispiel werden die Ressourcen zuerst in das Repository geschrieben und ihre URIs abgerufen. Weitere Informationen zum Schreiben einer Ressource finden Sie unter Schreibressourcen.
Beziehung erstellen
Rufen Sie die createRelationship
-Methode des Objekts auf und übergeben Sie die folgenden Parameter:ResourceRepositoryClient
com.adobe.repository.infomodel.bean.Relation
-Klasse ist. In diesem Beispiel wird eine Abhängigkeitsbeziehung durch Angabe des Werts Relation.TYPE_DEPENDANT_OF
hergestellt.boolean
-Wert, der angibt, ob die Zielgruppe-Ressource automatisch auf den com.adobe.repository.infomodel.Id
-basierten Bezeichner der neuen Kopfressource aktualisiert wird. In diesem Beispiel wird aufgrund der Abhängigkeitsbeziehung der Wert true
angegeben.Sie können auch eine Liste der zugehörigen Ressourcen für eine bestimmte Ressource abrufen, indem Sie die getRelated
-Methode des Objekts ResourceRepositoryClient
aufrufen und die folgenden Parameter übergeben:
"/testFolder/testResource1"
) angegeben.boolean
-Wert, der angibt, ob die angegebene Ressource die Quellressource in der Beziehung ist. In diesem Beispiel wird der Wert true
angegeben, da dies der Fall ist.Relation
-Klasse ist. In diesem Beispiel wird eine Abhängigkeit angegeben, indem der gleiche Wert wie zuvor verwendet wird: Relation.TYPE_DEPENDANT_OF
.Die getRelated
-Methode gibt ein java.util.List
von Resource
-Objekten zurück, über die Sie die zugehörigen Ressourcen aufrufen können, wobei die in List
enthaltenen Objekte wie gewünscht auf Resource
umgeleitet werden. In diesem Beispiel wird erwartet, dass testResource2
sich in der Liste der zurückgegebenen Ressourcen befindet.
Siehe auch
Erstellen von Ressourcenbeziehungen
Quick Beginn (SOAP-Modus): Beziehungen zwischen Ressourcen mithilfe der Java-API erstellen
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Erstellen Sie Beziehungsressourcen mithilfe der Repository API (Webdienst):
Projektdateien einschließen
Dienstclient erstellen
Erstellen Sie mit der Microsoft .NET-Clientassembly ein RepositoryServiceService
-Objekt, indem Sie dessen Standardkonstruktor aufrufen. Legen Sie die Eigenschaft Credentials
mit einem System.Net.NetworkCredential
-Objekt fest, das den Benutzernamen und das Kennwort enthält.
Geben Sie die URIs der Ressourcen an, die verknüpft werden sollen
Geben Sie die URIs der Ressourcen an, die verknüpft werden sollen. In diesem Fall sind die URIs testResource1
und testResource2
und im Ordner testFolder
enthalten, da sich die Ressourcen im Ordner "/testFolder/testResource1"
befinden. "/testFolder/testResource2"
Bei Verwendung einer Sprache, die mit Microsoft .NET Framework kompatibel ist (z. B. C#), werden die URIs als System.String
-Objekte gespeichert. In diesem Beispiel werden die Ressourcen zuerst in das Repository geschrieben und ihre URIs abgerufen. Weitere Informationen zum Schreiben einer Ressource finden Sie unter Schreibressourcen.
Beziehung erstellen
Rufen Sie die createRelationship
-Methode des Objekts auf und übergeben Sie die folgenden Parameter:RepositoryServiceService
3
hergestellt.boolean
-Wert, der angibt, ob der Beziehungstyp angegeben wurde. In diesem Beispiel wird der Wert true
angegeben.boolean
-Wert, der angibt, ob die Zielgruppe-Ressource automatisch auf den Id
-basierten Bezeichner der neuen Kopfressource aktualisiert wird. In diesem Beispiel wird aufgrund der Abhängigkeitsbeziehung der Wert true
angegeben.boolean
-Wert, der angibt, ob die Kopfzeile der Zielgruppe angegeben wurde. In diesem Beispiel wird der Wert true
angegeben.null
.Sie können auch eine Liste der zugehörigen Ressourcen für eine bestimmte Ressource abrufen, indem Sie die getRelated
-Methode des Objekts RepositoryServiceService
aufrufen und die folgenden Parameter übergeben:
"/testFolder/testResource1"
) angegeben.boolean
-Wert, der angibt, ob die angegebene Ressource die Quellressource in der Beziehung ist. In diesem Beispiel wird der Wert true
angegeben, da dies der Fall ist.boolean
-Wert, der angibt, ob die Quellressource angegeben wurde. In diesem Beispiel wird der Wert true
angegeben.3
.null
für die verbleibenden beiden Parameter.Die getRelated
-Methode gibt ein Array von Objekten zurück, die in Resource
-Objekte umgewandelt werden können, durch die Sie die zugehörigen Ressourcen abrufen können. In diesem Beispiel wird erwartet, dass testResource2
sich in der Liste der zurückgegebenen Ressourcen befindet.
Siehe auch
Erstellen von Ressourcenbeziehungen
Aufrufen von AEM Forms mit Base64-Kodierung
Sie können eine Ressource oder einen Satz von Ressourcen sperren, um sie exklusiv von einem bestimmten Benutzer oder für mehrere Benutzer freizugeben. Ein freigegebenes Schloss ist ein Hinweis darauf, dass mit der Ressource etwas passieren wird, aber es hindert niemanden daran, mit dieser Ressource zu handeln. Eine freigegebene Sperre sollte als Signalmechanismus betrachtet werden. Ein exklusives Sperren bedeutet, dass der Benutzer, der die Ressource gesperrt hat, die Ressource ändern wird, und das Schloss stellt sicher, dass niemand anders dies tun kann, bis der Benutzer keinen Zugriff mehr auf die Ressource benötigt und die Sperre aufgehoben hat. Wenn ein Repository-Administrator eine Ressource entsperrt, werden alle exklusiven und freigegebenen Sperren für diese Ressource automatisch entfernt. Diese Aktion ist für Situationen gedacht, in denen ein Benutzer nicht mehr verfügbar ist und die Ressource nicht entsperrt hat.
Wenn eine Ressource gesperrt ist, wird bei der Ansicht der Registerkarte "Ressourcen"in Workbench ein Sperrsymbol angezeigt, wie in der folgenden Abbildung dargestellt.
Sie können den Zugriff auf Ressourcen programmgesteuert über die Java-API oder die Webdienst-API des Repository-Dienstes steuern.
Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.
Gehen Sie wie folgt vor, um Ressourcen zu sperren und zu entsperren:
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, schließen Sie die Proxydateien ein.
Dienstclient erstellen
Bevor Sie eine Ressource programmgesteuert lesen können, müssen Sie eine Verbindung herstellen und Anmeldeinformationen angeben. Dies wird durch Erstellen eines Dienstclients erreicht.
Geben Sie den URI der zu sperrenden Ressource an
Erstellen Sie eine Zeichenfolge, die den URI der zu sperrenden Ressource enthält. Die Syntax enthält Schrägstriche, wie im folgenden Beispiel: "/path/resource".
Ressource sperren
Rufen Sie die Methode des Repository-Dienstes auf, um die Ressource zu sperren, und geben Sie den URI, den Sperrtyp und die Sperrtiefe an.
Sperren der Ressource abrufen
Rufen Sie die Methode des Repository-Dienstes auf, um die Sperren für die Ressource abzurufen, und geben Sie den URI an.
Ressource entsperren
Rufen Sie die Methode des Repository-Dienstes auf, um die Ressource zu entsperren, und geben Sie den URI an.
Siehe auch
Sperren von Ressourcen mithilfe der Java-API
Sperren von Ressourcen mithilfe der Webdienst-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Beginn zur Repository Service API
Sperren Sie Ressourcen mithilfe der Repository Service API (Java):
Projektdateien einschließen
Schließen Sie JAR-Clientdateien in den Klassenpfad Ihres Java-Projekts ein.
Dienstclient erstellen
Erstellen Sie ein ResourceRepositoryClient
-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory
-Objekt übergeben, das Verbindungseigenschaften enthält.
Geben Sie den URI der zu sperrenden Ressource an
Geben Sie den URI der Ressource an, die gesperrt werden soll. In diesem Fall lautet der URI "/testFolder/testResource"
, da sich die Ressource testResource
im Ordner testFolder
befindet. Der URI wird als java.lang.String
-Objekt gespeichert.
Ressource sperren
Rufen Sie die lockResource
-Methode des Objekts auf und übergeben Sie die folgenden Parameter:ResourceRepositoryClient
com.adobe.repository.infomodel.bean.Lock.SCOPE_EXCLUSIVE
angegeben, da die Ressource für die ausschließliche Verwendung gesperrt wird.Lock.DEPTH_ZERO
angegeben, da die Sperrung nur für die jeweilige Ressource und nicht für deren Mitglieder oder untergeordnete Elemente gilt.Die überladene Version der lockResource
-Methode, die vier Parameter erfordert, gibt eine Ausnahme aus. Stellen Sie sicher, dass Sie die lockResource
-Methode verwenden, für die drei Parameter erforderlich sind, wie in dieser exemplarischen Vorgehensweise gezeigt.
Sperren der Ressource abrufen
Rufen Sie die getLocks
-Methode des Objekts auf und übergeben Sie den URI der Ressource als Parameter. ResourceRepositoryClient
Die Methode gibt eine Liste von Lock-Objekten zurück, durch die Sie iterieren können. In diesem Beispiel werden der Sperreneigentümer, die Sperrtiefe und der Umfang für jedes Objekt gedruckt, indem die Methoden getOwnerUserId
, getDepth
und getType
aufgerufen werden.
Ressource entsperren
Rufen Sie die unlockResource
-Methode des Objekts auf und übergeben Sie den URI der Ressource als Parameter. ResourceRepositoryClient
Weitere Informationen finden Sie unter AEM Forms API Reference.
Siehe auch
Quick Beginn (SOAP-Modus): Sperren einer Ressource mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Sperren Sie Ressourcen mithilfe der Repository Service API (Webdienst):
Projektdateien einschließen
Dienstclient erstellen
Erstellen Sie mit der Microsoft .NET-Clientassembly ein RepositoryServiceService
-Objekt, indem Sie dessen Standardkonstruktor aufrufen. Legen Sie die Eigenschaft Credentials
mit einem System.Net.NetworkCredential
-Objekt fest, das den Benutzernamen und das Kennwort enthält.
Geben Sie den URI der zu sperrenden Ressource an
Geben Sie eine Zeichenfolge an, die den URI der zu sperrenden Ressource enthält. In diesem Fall lautet der URI testResource
, da sich die Ressource testFolder
im Ordner "/testFolder/testResource"
befindet. Wenn Sie eine mit Microsoft .NET Framework kompatible Sprache verwenden (z. B. C#), speichern Sie den URI in einem System.String
-Objekt.
Ressource sperren
Rufen Sie die lockResource
-Methode des Objekts auf und übergeben Sie die folgenden Parameter:RepositoryServiceService
11
angegeben, da die Ressource für die ausschließliche Verwendung gesperrt wird.2
angegeben, da die Sperrung nur für die jeweilige Ressource und nicht für deren Mitglieder oder untergeordnete Elemente gilt.int
-Wert, der die Anzahl der Sekunden angibt, bis die Sperre abläuft. In diesem Beispiel wird der Wert von 1000
verwendet.null
.Sperren der Ressource abrufen
Rufen Sie die getLocks
-Methode des Objekts auf und übergeben Sie den URI der Ressource als ersten Parameter und null
als zweiten Parameter. RepositoryServiceService
Die Methode gibt ein object
-Array zurück, das Lock
-Objekte enthält, durch die Sie iterieren können. In diesem Beispiel werden der Inhaber der Sperre, die Tiefe und der Umfang für jedes Objekt gedruckt, indem auf die Felder Lock
, ownerUserId
, depth
und type
des Objekts zugegriffen wird.
Ressource entsperren
Rufen Sie die unlockResource
-Methode des Objekts auf und übergeben Sie den URI der Ressource als ersten Parameter und null
als zweiten Parameter.RepositoryServiceService
Siehe auch
Aufrufen von AEM Forms mit Base64-Kodierung
Sie können Ressourcen programmgesteuert von einem bestimmten Speicherort im Repository löschen, indem Sie die Java-API (SOAP) des Repository-Dienstes verwenden.
Wenn Sie eine Ressource löschen, ist der Löschvorgang normalerweise dauerhaft, in einigen Fällen können jedoch ECM-Repositorys die Versionen der Ressource gemäß ihren Verlaufsmechanismen speichern. Daher ist es beim Löschen einer Ressource wichtig sicherzustellen, dass Sie diese Ressource nie mehr benötigen. Häufige Gründe für das Löschen einer Ressource sind u. a. die Notwendigkeit, den verfügbaren Speicherplatz in der Datenbank zu erhöhen. Sie können eine Version einer Ressource löschen. Wenn Sie dies tun, müssen Sie jedoch die Ressourcenkennung und nicht deren logische ID (LID) oder Pfad angeben. Wenn Sie einen Ordner löschen, werden alle darin enthaltenen Ordner, einschließlich Unterordner und Ressourcen, automatisch gelöscht.
Zugehörige Ressourcen werden nicht gelöscht. Wenn Sie beispielsweise ein Formular mit der Datei "logo.gif"haben und "logo.gif"löschen, wird eine Beziehung in der Tabelle für die ausstehende Beziehung gespeichert. Alternativ können Sie bei veralteter Version den Objektstatus der neuesten Version auf veraltet setzen.
Ein Löschvorgang ist in ECM-Systemen nicht transaktionssicher. Wenn Sie beispielsweise versuchen, 100 Ressourcen zu löschen und der Vorgang bei der 50. Ressource fehlschlägt, werden die ersten 49 Instanzen gelöscht, der Rest jedoch nicht. Andernfalls lautet das Standardverhalten "Rollback"(Nicht-Verpflichtung).
Bei Verwendung der com.adobe.repository.bindings.dsc.client.ResourceRepositoryClient.deleteResources()
-Methode mit dem ECM-Repository (EMC Documentum Content Server und IBM FileNet P8 Content Manager) wird die Transaktion nicht rückgängig gemacht, wenn der Löschvorgang für eine der angegebenen Ressourcen fehlschlägt. Dies bedeutet, dass die gelöschten Dateien nicht gelöscht werden können.
Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.
Gehen Sie wie folgt vor, um eine Ressource zu löschen:
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, schließen Sie die Proxydateien ein.
Dienstclient erstellen
Bevor Sie eine Ressource programmgesteuert lesen können, müssen Sie eine Verbindung herstellen und Anmeldeinformationen angeben. Dies wird durch Erstellen eines Dienstclients erreicht.
Geben Sie den URI der zu löschenden Ressource an
Erstellen Sie eine Zeichenfolge, die den URI der zu löschenden Ressource enthält. Die Syntax enthält Schrägstriche, wie im folgenden Beispiel: "/path/resource". Wenn die zu löschende Ressource ein Ordner ist, wird der Löschvorgang rekursiv ausgeführt.
Ressource löschen
Rufen Sie die Methode des Repository-Dienstes auf, um die Ressource zu löschen, und geben Sie den URI an.
Siehe auch
Ressourcen mithilfe der Java-API löschen
Löschen von Ressourcen mithilfe der Webdienst-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Beginn zur Repository Service API
Löschen Sie eine Ressource mithilfe der Repository API (Java):
Projektdateien einschließen
Schließen Sie JAR-Clientdateien in den Klassenpfad Ihres Java-Projekts ein.
Dienstclient erstellen
Erstellen Sie ein ResourceRepositoryClient
-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory
-Objekt übergeben, das Verbindungseigenschaften enthält.
Geben Sie den URI der zu löschenden Ressource an
Geben Sie den URI der abzurufenden Ressource an. In diesem Fall ist der URI der Ressource mit dem Namen testResourceToBeDeleted im Ordner testFolder /testFolder/testResourceToBeDeleted
. Der URI wird als java.lang.String
-Objekt gespeichert. In diesem Beispiel wird die Ressource zuerst in das Repository geschrieben und der zugehörige URI abgerufen. Weitere Informationen zum Schreiben einer Ressource finden Sie unter Schreibressourcen.
Ressource löschen
Rufen Sie die deleteResource
-Methode des Objekts auf und übergeben Sie den URI der Ressource als Parameter.ResourceRepositoryClient
Siehe auch
Quick Beginn (SOAP-Modus): Suchen nach Ressourcen mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Löschen Sie eine Ressource mithilfe der Repository API (Webdienst):
Projektdateien einschließen
Dienstclient erstellen
Erstellen Sie mit der Microsoft .NET-Clientassembly ein RepositoryServiceService
-Objekt, indem Sie dessen Standardkonstruktor aufrufen. Legen Sie die Eigenschaft Credentials
mit einem System.Net.NetworkCredential
-Objekt fest, das den Benutzernamen und das Kennwort enthält.
Geben Sie den URI der zu löschenden Ressource an
Geben Sie den URI der abzurufenden Ressource an. In diesem Fall lautet der URI "/testFolder/testResourceToBeDeleted"
, da sich die Ressource testResourceToBeDeleted
im Ordner testFolder
befindet. In diesem Beispiel wird die Ressource zuerst in das Repository geschrieben und der zugehörige URI abgerufen. Weitere Informationen zum Schreiben einer Ressource finden Sie unter Schreibressourcen.
Ressource löschen
Rufen Sie die RepositoryServiceService
-Methode des Objekts auf und übergeben Sie ein System.String
-Array, das den URI der Ressource als ersten Parameter enthält. deleteResources
Übergeben Sie null
für den zweiten Parameter.
Siehe auch
Aufrufen von AEM Forms mit Base64-Kodierung