Arbeiten mit AEM Forms Repository

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:

ww_ww_formrepository

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.

HINWEIS

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:

  • Applications/AppraisalReport/1.0/Forms/FullForm.xdp
  • Applications/AnotherApp/1.1/Assets/picture.jpg
  • Applications/SomeApp/2.0/Resources/Data/XSDs/MyData.xsd
HINWEIS

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://[Servername]:[Serveranschluss]/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.

HINWEIS

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:

HINWEIS

Mithilfe der Repository-API können Sie die Ressourcenverwaltung nicht verwalten, nach Ressourcen suchen oder Ressourcenbeziehungen mithilfe eines ECM-Repositorys festlegen.

HINWEIS

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.

HINWEIS

Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.

Erstellen von Ordnern

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.

HINWEIS

Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.

Zusammenfassung der Schritte

Gehen Sie wie folgt vor, um einen Ordner zu erstellen:

  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie den Dienstclient.
  3. Erstellen Sie den Ordner.
  4. Schreiben Sie den Ordner in das Repository.

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 von Ordnern mit der Java-API

Erstellen Sie einen Ordner mithilfe der Repository Service API (Java):

  1. Projektdateien einschließen

    Schließen Sie Projektdateien in den Klassenpfad Ihres Java-Projekts ein.

  2. Dienstclient erstellen

    Erstellen Sie ein ResourceRepositoryClient-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory-Objekt übergeben, das Verbindungseigenschaften enthält.

  3. 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

    • Eine com.adobe.repository.infomodel.Id UUID-ID, die der Ressource zugewiesen wird.
    • Eine com.adobe.repository.infomodel.Lid UUID-ID, die der Ressource zugewiesen wird.
    • Ein 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:

    • Ein String, das die Ressourcensammlung beschreibt. In diesem Beispiel wird "test Folder" verwendet..
  4. 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

Erstellen von Ordnern

Quick Beginn (SOAP-Modus): Erstellen eines Ordners mit der Java-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Erstellen von Ordnern mit der Webdienst-API

Erstellen Sie einen Ordner mithilfe der Repository Service API (Webdienst):

  1. Projektdateien einschließen

    • Erstellen Sie eine Microsoft .NET-Client-Assembly, die die Repository-WSDL mit base64 verwendet.
    • Verweisen Sie auf die Microsoft .NET-Clientassembly.
  2. 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.

  3. Erstellen Sie den Ordner

    Erstellen Sie den Ordner mit dem Standardkonstruktor für die ResourceCollection-Klasse und übergeben Sie die folgenden Parameter:

    • Ein Id-Objekt, das durch Aufrufen des Standardkonstruktors für die Id-Klasse erstellt und dem Resource-Objektfeld id zugewiesen wird.
    • Ein Lid-Objekt, das durch Aufrufen des Standardkonstruktors für die Lid-Klasse erstellt und dem Resource-Objektfeld lid zugewiesen wird.
    • Eine Zeichenfolge, die den Namen der Ressourcensammlung enthält, die dem Feld Resource des Objekts name zugewiesen ist. Der in diesem Beispiel verwendete Name ist "testfolder".
    • Eine Zeichenfolge, die die Beschreibung der Ressourcensammlung enthält, die dem Feld Resource des Objekts description zugewiesen ist. Die in diesem Beispiel verwendete Beschreibung ist "test folder".
  4. Den Ordner in das Repository schreiben

    Rufen Sie die writeResource-Methode des Objekts auf und übergeben Sie die folgenden Parameter:RepositoryServiceService

    • Der Pfad, in dem der Ordner erstellt werden soll.
    • Das ResourceCollection-Objekt, das den Ordner darstellt.
    • Übergeben Sie null für die anderen beiden Parameter.

Siehe auch

Erstellen von Ordnern

Aufrufen von AEM Forms mit Base64-Kodierung

Schreiben von Ressourcen

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.

HINWEIS

Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.

Zusammenfassung der Schritte

Gehen Sie wie folgt vor, um eine Ressource zu schreiben:

  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie einen Client des Repository-Dienstes.
  3. Geben Sie den URI der zu lesenden Ressource an.
  4. Lesen Sie die Ressource.

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

Ressourcen mit der Java-API schreiben

Erstellen Sie eine Ressource mithilfe der Repository Service API (Java):

  1. Projektdateien einschließen

    Schließen Sie JAR-Clientdateien in den Klassenpfad Ihres Java-Projekts ein.

  2. Dienstclient erstellen

    Erstellen Sie ein ResourceRepositoryClient-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory-Objekt übergeben, das Verbindungseigenschaften enthält.

  3. 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.

  4. 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:

    • Ein com.adobe.repository.infomodel.Id-Objekt, das durch Aufrufen des Standardkonstruktors für die Id-Klasse erstellt wird.
    • Ein com.adobe.repository.infomodel.Lid-Objekt, das durch Aufrufen des Standardkonstruktors für die Lid-Klasse erstellt wird.
    • Ein 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".

  5. 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:

    • Aufrufen der setDataDocument-Methode des ResourceContent-Objekts und Übergeben eines com.adobe.idp.Document-Objekts
    • Aufrufen der setSize-Methode des ResourceContent-Objekts und Übergeben der Größe in Byte des Document-Objekts

    hinzufü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.

  6. 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

Ressourcen schreiben

Quick Beginn (SOAP-Modus): Schreiben einer Ressource mit der Java-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Ressourcen mit der Webdienst-API schreiben

Erstellen Sie eine Ressource mithilfe der Repository Service API (Webdienst):

  1. Projektdateien einschließen

    • Erstellen Sie eine Microsoft .NET-Client-Assembly, die die Repository-WSDL mit base64 verwendet.
    • Verweisen Sie auf die Microsoft .NET-Clientassembly.
  2. 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.

  3. 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.

  4. 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:

    • Ein com.adobe.repository.infomodel.Id-Objekt, das durch Aufrufen des Standardkonstruktors für die Id-Klasse erstellt und dem Resource-Objektfeld id zugewiesen wird.
    • Ein com.adobe.repository.infomodel.Lid-Objekt, das durch Aufrufen des Standardkonstruktors für die Lid-Klasse erstellt und dem Resource-Objektfeld lid zugewiesen wird.
    • Eine Zeichenfolge, die den Dateinamen der Ressource enthält, der dem Feld Resource des Objekts name zugewiesen ist. Der in diesem Beispiel verwendete Name ist "testResource".
    • Eine Zeichenfolge, die die Beschreibung der Ressource enthält, die dem Feld Resource des Objekts description zugewiesen ist. Die in diesem Beispiel verwendete Beschreibung ist "test resource".
  5. 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:

    • Zuweisen eines BLOB-Objekts, das ein Dokument enthält, zum ResourceContent-Objektfeld dataDocument
    • Zuweisen der Größe in Byte des Objekts BLOB zum Feld ResourceContent des Objekts size

    hinzufügen Sie den Inhalt der Ressource, indem Sie das ResourceContent-Objekt dem Resource-Objektfeld content zuweisen.

  6. 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

Ressourcen schreiben

Aufrufen von AEM Forms mit Base64-Kodierung

Auflisten von Ressourcen

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.

HINWEIS

Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.

Zusammenfassung der Schritte

Gehen Sie zur Liste von Ressourcen wie folgt vor:

  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie den Dienstclient.
  3. Geben Sie den Ordnerpfad an.
  4. Rufen Sie die Liste der Ressourcen ab.

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

Listen mit der Java-API

Liste von Ressourcen mit der Webdienst-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Beginn zur Repository Service API

Liste von Ressourcen mit der Java-API

Listen mithilfe der Repository Service API (Java):

  1. Projektdateien einschließen

    Schließen Sie JAR-Clientdateien in den Klassenpfad Ihres Java-Projekts ein.

  2. Dienstclient erstellen

    Erstellen Sie ein ResourceRepositoryClient-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory-Objekt übergeben, das Verbindungseigenschaften enthält.

  3. 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.

  4. 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

Auflisten von Ressourcen.

Quick Beginn (SOAP-Modus): Auflisten von Ressourcen mit der Java-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Liste von Ressourcen mit der Webdienst-API

Liste von Ressourcen mithilfe der Repository Service API (Webdienst):

  1. Projektdateien einschließen

    • Erstellen Sie eine Microsoft .NET-Client-Assembly, die die Repository-WSDL verwendet.
    • Verweisen Sie auf die Microsoft .NET-Clientassembly.
  2. 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.

  3. 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.

  4. 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

Auflisten von Ressourcen.

Aufrufen von AEM Forms mit Base64-Kodierung

Reading Resources

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:

  • traverse: ermöglicht die Liste von Ressourcen; zum Lesen von Ressourcenmetadaten, jedoch nicht von Ressourceninhalten
  • lautet: ermöglicht Ihnen das Lesen von Ressourceninhalten
  • schreiben: ermöglicht Ihnen das Schreiben von Ressourceninhalten
  • Verwaltung von Listen der Zugriffskontrolle (ACL): ermöglicht Ihnen die Bearbeitung von ACLs für Ressourcen

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.

HINWEIS

Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.

Zusammenfassung der Schritte

Gehen Sie wie folgt vor, um eine Ressource zu lesen:

  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie einen Client des Repository-Dienstes.
  3. Geben Sie den URI der zu lesenden Ressource an.
  4. Lesen Sie die Ressource.

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

Ressourcen mithilfe der Java-API lesen

Lesen Sie eine Ressource mithilfe der Repository-Dienst-API (Java):

  1. Projektdateien einschließen

    Schließen Sie JAR-Clientdateien in den Klassenpfad Ihres Java-Projekts ein.

  2. Dienstclient erstellen

    Erstellen Sie ein ResourceRepositoryClient-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory-Objekt übergeben, das Verbindungseigenschaften enthält.

  3. 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.

  4. 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

Ressourcen lesen

Quick Beginn (SOAP-Modus): Lesen einer Ressource mit der Java-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Lesen von Ressourcen mit der Webdienst-API

Lesen Sie eine Ressource mithilfe der Repository-Dienst-API (Webdienst):

  1. Projektdateien einschließen

  2. 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.

  3. 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.

  4. 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

Ressourcen lesen

Aufrufen von AEM Forms mit Base64-Kodierung

Ressourcen aktualisieren

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.

HINWEIS

Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.

Zusammenfassung der Schritte

Gehen Sie wie folgt vor, um eine Ressource zu aktualisieren:

  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie einen Client des Repository-Dienstes.
  3. Rufen Sie die zu aktualisierende Ressource ab.
  4. Aktualisieren Sie die Ressource.

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

Ressourcen mithilfe der Java-API aktualisieren

Aktualisieren Sie eine Ressource mithilfe der Repository Service API (Java):

  1. Projektdateien einschließen

    Schließen Sie JAR-Clientdateien in den Klassenpfad Ihres Java-Projekts ein.

  2. Dienstclient erstellen

    Erstellen Sie ein ResourceRepositoryClient-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory-Objekt übergeben, das Verbindungseigenschaften enthält.

  3. 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".

  4. 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

    • Ein java.lang.String-Objekt, das den URI der Ressource enthält.
    • Das Resource-Objekt, das die aktualisierten Ressourceninformationen enthält.
    • Ein 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

Ressourcen aktualisieren

Quick Beginn (SOAP-Modus): Aktualisieren einer Ressource mit der Java-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Aktualisieren von Ressourcen mithilfe der Webdienst-API

Aktualisieren Sie eine Ressource mithilfe der Repository API (Webdienst):

  1. Projektdateien einschließen

    • Erstellen Sie eine Microsoft .NET-Client-Assembly, die die Repository-WSDL verwendet.
    • Verweisen Sie auf die Microsoft .NET-Clientassembly.
  2. 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.

  3. 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.

  4. 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.

  5. Rufen Sie die updateResource-Methode des Objekts auf und übergeben Sie die folgenden Parameter:RepositoryServiceService

    • Ein System.String-Objekt, das den URI der Ressource enthält.
    • Das Resource-Objekt, das die aktualisierten Ressourceninformationen enthält.
    • Ein 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.
    • Übergeben Sie null für die verbleibenden beiden Parameter.

Siehe auch

Ressourcen aktualisieren

Aufrufen von AEM Forms mit Base64-Kodierung

Suchen nach Ressourcen

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.

HINWEIS

Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.

Zusammenfassung der Schritte

Gehen Sie wie folgt vor, um nach Ressourcen zu suchen:

  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie einen Client des Repository-Dienstes.
  3. Geben Sie den Ordner "Zielgruppe"für die Suche an.
  4. Geben Sie die Attribute an, die bei der Suche verwendet werden.
  5. Erstellen Sie die bei der Suche verwendete Abfrage.
  6. Erstellen Sie die Sortierreihenfolge für die Suchergebnisse.
  7. Suchen Sie nach den Ressourcen.
  8. Rufen Sie die Ressourcen aus dem Suchergebnis ab.

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

Ressourcen mithilfe der Java-API suchen

Suchen Sie eine Ressource mithilfe der Repository Service API (Java):

  1. Projektdateien einschließen

    Schließen Sie JAR-Clientdateien in den Klassenpfad Ihres Java-Projekts ein.

  2. Dienstclient erstellen

    Erstellen Sie ein ResourceRepositoryClient-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory-Objekt übergeben, das Verbindungseigenschaften enthält.

  3. 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.

  4. 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.

  5. 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:

    • Ein linker Operand, der die Konstante für das Ressourcenattribut enthält. In diesem Beispiel wird der statische Wert Resource.ATTRIBUTE_NAME verwendet, da der Name der Ressource als Grundlage für die Suche verwendet wird.
    • Ein Operator, der die bei der Suche nach dem Attribut verwendete Bedingung enthält. Der Operator muss eine der statischen Konstanten in der Klasse Query.Statement sein. In diesem Beispiel wird der statische Wert Query.Statement.OPERATOR_BEGINS_WITH verwendet.
    • Ein rechter Operand mit dem Attributwert, auf dem die Suche durchgeführt werden soll. In diesem Beispiel wird das Attribut name, ein 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.

  6. 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.

  7. 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:

    • Ein String, der den Basispfad enthält, aus dem die Suche ausgeführt werden soll. In diesem Fall wird "/testFolder" verwendet.
    • Die bei der Suche verwendete Abfrage.
    • Die Suchtiefe. In diesem Fall wird com.adobe.repository.infomodel.bean.ResourceCollection.DEPTH_INFINITE verwendet, um anzugeben, dass der Basispfad und alle zugehörigen Ordner verwendet werden sollen.
    • Ein int-Wert, der die erste Zeile angibt, aus der die nicht paginierte Ergebnismenge ausgewählt werden soll. In diesem Beispiel wird 0 angegeben.
    • Ein int-Wert, der die maximale Anzahl der zurückzugebenden Ergebnisse angibt. In diesem Beispiel wird 10 angegeben.
    • Die bei der Suche verwendete Sortierreihenfolge.

    Die Methode gibt ein java.util.List von Resource-Objekten in der angegebenen Sortierreihenfolge zurück.

  8. 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

Suchen nach Ressourcen

Quick Beginn (SOAP-Modus): Suchen nach Ressourcen mit der Java-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Erstellen von Ressourcenbeziehungen

Sie können Beziehungen zwischen Ressourcen im Repository angeben. Es gibt drei Arten von Beziehungen:

  • Abhängigkeit: eine Beziehung, in der eine Ressource von anderen Ressourcen abhängt, d. h. alle zugehörigen Ressourcen werden im Repository benötigt.
  • Mitgliedschaft (Dateisystem): eine Beziehung, in der sich eine Ressource innerhalb eines angegebenen Ordners befindet.
  • Benutzerdefiniert: eine Beziehung, die Sie zwischen Ressourcen angeben. Wenn beispielsweise eine Ressource nicht mehr unterstützt und eine andere in das Repository eingefügt wurde, können Sie Ihre eigene Ersatzbeziehung angeben.

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.

HINWEIS

Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.

Zusammenfassung der Schritte

Gehen Sie wie folgt vor, um eine Beziehung zwischen zwei Ressourcen festzulegen:

  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie einen Client des Repository-Dienstes.
  3. Geben Sie die URIs der Ressourcen an, die verknüpft werden sollen.
  4. Erstellen Sie die Beziehung.

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 von Beziehungsressourcen mit der Java-API

Erstellen Sie Beziehungsressourcen mithilfe der Java-API des Repository-Dienstes:

  1. Projektdateien einschließen

    Schließen Sie JAR-Clientdateien in den Klassenpfad Ihres Java-Projekts ein.

  2. Dienstclient erstellen

    Erstellen Sie ein ResourceRepositoryClient-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory-Objekt übergeben, das Verbindungseigenschaften enthält.

  3. 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.

  4. Beziehung erstellen

    Rufen Sie die createRelationship-Methode des Objekts auf und übergeben Sie die folgenden Parameter:ResourceRepositoryClient

    • Der URI der Quellressource.
    • Der URI der Zielgruppe-Ressource.
    • Der Beziehungstyp, der eine der statischen Konstanten in der com.adobe.repository.infomodel.bean.Relation-Klasse ist. In diesem Beispiel wird eine Abhängigkeitsbeziehung durch Angabe des Werts Relation.TYPE_DEPENDANT_OF hergestellt.
    • Ein 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:

    • Der URI der Ressource, für die zugehörige Ressourcen abgerufen werden sollen. In diesem Beispiel wird die Quellressource ( "/testFolder/testResource1") angegeben.
    • Ein 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.
    • Der Beziehungstyp, der eine der statischen Konstanten in der 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 von Beziehungsressourcen mithilfe der Webdienst-API

Erstellen Sie Beziehungsressourcen mithilfe der Repository API (Webdienst):

  1. Projektdateien einschließen

    • Erstellen Sie eine Microsoft .NET-Client-Assembly, die die Repository-WSDL verwendet.
    • Verweisen Sie auf die Microsoft .NET-Clientassembly.
  2. 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.

  3. 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.

  4. Beziehung erstellen

    Rufen Sie die createRelationship-Methode des Objekts auf und übergeben Sie die folgenden Parameter:RepositoryServiceService

    • Der URI der Quellressource.
    • Der URI der Zielgruppe-Ressource.
    • Die Art der Beziehung. In diesem Beispiel wird eine Abhängigkeitsbeziehung durch Angabe des Werts 3 hergestellt.
    • Ein boolean-Wert, der angibt, ob der Beziehungstyp angegeben wurde. In diesem Beispiel wird der Wert true angegeben.
    • Ein 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.
    • Ein boolean-Wert, der angibt, ob die Kopfzeile der Zielgruppe angegeben wurde. In diesem Beispiel wird der Wert true angegeben.
    • Für den letzten Parameter übergeben Sie 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:

    • Der URI der Ressource, für die zugehörige Ressourcen abgerufen werden sollen. In diesem Beispiel wird die Quellressource ( "/testFolder/testResource1") angegeben.
    • Ein 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.
    • Ein boolean-Wert, der angibt, ob die Quellressource angegeben wurde. In diesem Beispiel wird der Wert true angegeben.
    • Ein Array von Ganzzahlen, das die Beziehungstypen enthält. In diesem Beispiel wird eine Abhängigkeitsbeziehung angegeben, indem der gleiche Wert im Array wie zuvor verwendet wird: 3.
    • Übergeben Sie 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

Sperren von Ressourcen

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.

lr_lr_lockrepository

Sie können den Zugriff auf Ressourcen programmgesteuert über die Java-API oder die Webdienst-API des Repository-Dienstes steuern.

HINWEIS

Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.

Zusammenfassung der Schritte

Gehen Sie wie folgt vor, um Ressourcen zu sperren und zu entsperren:

  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie einen Client des Repository-Dienstes.
  3. Geben Sie den URI der Ressource an, die gesperrt werden soll.
  4. Sperren Sie die Ressource.
  5. Rufen Sie die Sperren für die Ressource ab.
  6. Ressource 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 von Ressourcen mit der Java-API

Sperren Sie Ressourcen mithilfe der Repository Service API (Java):

  1. Projektdateien einschließen

    Schließen Sie JAR-Clientdateien in den Klassenpfad Ihres Java-Projekts ein.

  2. Dienstclient erstellen

    Erstellen Sie ein ResourceRepositoryClient-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory-Objekt übergeben, das Verbindungseigenschaften enthält.

  3. 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.

  4. Ressource sperren

    Rufen Sie die lockResource-Methode des Objekts auf und übergeben Sie die folgenden Parameter:ResourceRepositoryClient

    • Der URI der Ressource.
    • Der Sperrbereich. In diesem Beispiel wird der Sperrbereich als com.adobe.repository.infomodel.bean.Lock.SCOPE_EXCLUSIVE angegeben, da die Ressource für die ausschließliche Verwendung gesperrt wird.
    • Die Sperrtiefe. In diesem Beispiel wird die Sperrtiefe als Lock.DEPTH_ZERO angegeben, da die Sperrung nur für die jeweilige Ressource und nicht für deren Mitglieder oder untergeordnete Elemente gilt.
    HINWEIS

    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.

  5. 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.

  6. 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

Ressourcen sperren

Quick Beginn (SOAP-Modus): Sperren einer Ressource mit der Java-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Sperren von Ressourcen mithilfe der Webdienst-API

Sperren Sie Ressourcen mithilfe der Repository Service API (Webdienst):

  1. Projektdateien einschließen

    • Erstellen Sie eine Microsoft .NET-Client-Assembly, die die Repository-WSDL mit Base64 verwendet.
    • Verweisen Sie auf die Microsoft .NET-Clientassembly.
  2. 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.

  3. 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.

  4. Ressource sperren

    Rufen Sie die lockResource-Methode des Objekts auf und übergeben Sie die folgenden Parameter:RepositoryServiceService

    • Der URI der Ressource.
    • Der Sperrbereich. In diesem Beispiel wird der Sperrbereich als 11 angegeben, da die Ressource für die ausschließliche Verwendung gesperrt wird.
    • Die Sperrtiefe. In diesem Beispiel wird die Sperrtiefe als 2 angegeben, da die Sperrung nur für die jeweilige Ressource und nicht für deren Mitglieder oder untergeordnete Elemente gilt.
    • Ein int-Wert, der die Anzahl der Sekunden angibt, bis die Sperre abläuft. In diesem Beispiel wird der Wert von 1000 verwendet.
    • Für den letzten Parameter übergeben Sie null.
  5. 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.

  6. 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

Ressourcen sperren

Aufrufen von AEM Forms mit Base64-Kodierung

Löschen von Ressourcen

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).

HINWEIS

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.

HINWEIS

Weitere Informationen zum Repository-Dienst finden Sie unter Dienste-Referenz für AEM Forms.

Zusammenfassung der Schritte

Gehen Sie wie folgt vor, um eine Ressource zu löschen:

  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie einen Client des Repository-Dienstes.
  3. Geben Sie den URI der zu löschenden Ressource an.
  4. Löschen Sie die Ressource.

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

Ressourcen mithilfe der Java-API(SOAP) löschen

Löschen Sie eine Ressource mithilfe der Repository API (Java):

  1. Projektdateien einschließen

    Schließen Sie JAR-Clientdateien in den Klassenpfad Ihres Java-Projekts ein.

  2. Dienstclient erstellen

    Erstellen Sie ein ResourceRepositoryClient-Objekt, indem Sie den Konstruktor verwenden und ein ServiceClientFactory-Objekt übergeben, das Verbindungseigenschaften enthält.

  3. 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.

  4. Ressource löschen

    Rufen Sie die deleteResource-Methode des Objekts auf und übergeben Sie den URI der Ressource als Parameter.ResourceRepositoryClient

Siehe auch

Löschen von Ressourcen

Quick Beginn (SOAP-Modus): Suchen nach Ressourcen mit der Java-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Ressourcen mithilfe der Webdienst-API löschen

Löschen Sie eine Ressource mithilfe der Repository API (Webdienst):

  1. Projektdateien einschließen

    • Erstellen Sie eine Microsoft .NET-Client-Assembly, die die Repository-WSDL mit Base64 verwendet.
    • Verweisen Sie auf die Microsoft .NET-Clientassembly.
  2. 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.

  3. 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.

  4. 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

Löschen von Ressourcen

Aufrufen von AEM Forms mit Base64-Kodierung

Auf dieser Seite

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now