Werken met AEM Forms Repository working-with-aem-forms-repository
Over de Repository Service
De Repository-service biedt AEM Forms opslagservices en beheerservices voor resources. Wanneer ontwikkelaars een AEM Forms kunnen ze de middelen in de opslagplaats implementeren in plaats van in het bestandssysteem. De elementen kunnen elk type onderpand bevatten, zoals XML-formulieren, PDF forms (inclusief Acrobat-formulieren), formulierfragmenten, afbeeldingen, profielen, beleid, SWF-bestanden, DDX-bestanden, XML-schema's, WSDL-bestanden en testgegevens.
Neem bijvoorbeeld de volgende Forms-toepassing met de naam Applications/FormsApplication:
Er bevindt zich een bestand met de naam Loan.xdp in de FormsFolder. Als u dit formulierontwerp wilt openen, geeft u het volledige pad op (inclusief versie): Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
.
Het pad naar een bron in de AEM Forms-opslagplaats is:
Applications/Application-name/Application-version/Folder.../Filename
De volgende waarden tonen enkele voorbeelden van URI-waarden:
- Applications/AppraisalReport/1.0/Forms/FullForm.xdp
- Applications/AnotherApp/1.1/Assets/picture.jpg
- Applications/SomeApp/2.0/Resources/Data/XSDs/MyData.xsd
De API van de dataopslag biedt een aantal bewerkingen die u kunt gebruiken om gegevens op te slaan en op te halen uit de dataopslag. Bijvoorbeeld, kunt u een lijst van middelen verkrijgen of specifieke middelen terugwinnen die in de bewaarplaats worden opgeslagen wanneer een middel als deel van de verwerking van een toepassing nodig is.
Met de Repository-service-API kunt u de volgende taken uitvoeren:
- Maak mappen. Zie Mappen maken.
- Bronnen en hun eigenschappen schrijven. Zie Bronnen schrijven.
- De middelen van de lijst in een bepaalde inzameling of verwant met andere middelen. Zie Aanbiedingsbronnen.
- Bronnen en hun eigenschappen lezen. Zie Bronnen lezen.
- Bronnen en hun eigenschappen bijwerken. Zie Bronnen bijwerken.
- Zoeken naar bronnen, waaronder hun geschiedenis, gerelateerde bronnen en eigenschappen. Zie Zoeken naar bronnen.
- Geef relaties tussen bronnen op. Zie Resourcerelaties maken.
- Beheer middeltoegangsbeheer, met inbegrip van het sluiten en het ontgrendelen van middelen, en het lezen en het schrijven toegangsbeheerlijsten (ACLs). Zie Bronnen vergrendelen.
- Bronnen en hun eigenschappen verwijderen. Zie Bronnen verwijderen.
Mappen maken creating-folders
De omslagen (middelinzamelingen) worden gebruikt om voorwerpen (dossiers of middelen) in georganiseerde groepen op te slaan. Mappen kunnen bronnen en andere mappen bevatten, ook wel submappen genoemd. Bronnen kunnen slechts in één map tegelijk worden opgeslagen.
De dossiers erven toegangsbeheerlijsten (ACLs) van omslagen, en subfolders erven ACLs van hun ouderomslagen. Daarom moeten de bovenliggende mappen bestaan voordat u onderliggende mappen kunt maken. IDE laat u slechts op een omslag-door-omslag basis, niet op een dossier-door-dossier basis communiceren. U kunt geen mappen versieren en dit hoeft niet te gebeuren; een map bevat geen gegevens zelf. In plaats daarvan is het alleen een container voor bronnen die gegevens bevatten. Standaard ACL is systeem-vlakke toestemming, zo betekent het dat de gebruikers systeemvlakke toestemmingen (lees, schrijf, traverse, het leiden ACLs) moeten hebben tot iemand hen toestemmingen voor een bepaalde omslag geeft. ACLs werkt slechts in winde.
Overzicht van de stappen summary-of-steps
Ga als volgt te werk om een map te maken:
- Inclusief projectbestanden.
- Maak de serviceclient.
- Maak de map.
- Schrijf de map naar de opslagplaats.
Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, neemt u de proxybestanden op.
De serviceclient maken
Alvorens u een middelinzameling programmatically kunt tot stand brengen, moet u een verbinding vestigen en geloofsbrieven verstrekken. Dit wordt verwezenlijkt door een de dienstcliënt te creëren.
De map maken
Roep de servicemethode voor opslagplaats aan om de bronverzameling te maken en de bronverzameling te vullen met identificerende informatie, zoals de UUID, mapnaam en beschrijving van de verzameling.
De map naar de opslagplaats schrijven
Roep de servicemethode Repository aan om de bronverzameling te schrijven en de URI van de doelmap op te geven.
Zie ook
Mappen maken met de webservice-API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Mappen maken met de Java API create-folders-using-the-java-api
Een map maken met de API voor opslagplaats (Java):
-
Projectbestanden opnemen
Neem projectbestanden op in het klassenpad van uw Java-project.
-
De serviceclient maken
Een
ResourceRepositoryClient
object door de constructor ervan te gebruiken en een object door te gevenServiceClientFactory
object dat verbindingseigenschappen bevat. -
De map maken
Als u een bronverzameling wilt maken, moet u eerst een
com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean
object.De
repositoryInfomodelFactoryBean
objectnewResourceCollection
en geeft de volgende parameters door:- A
com.adobe.repository.infomodel.Id
UUID-id die aan de bron moet worden toegewezen. - A
com.adobe.repository.infomodel.Lid
UUID-id die aan de bron moet worden toegewezen. - A
java.lang.String
met de naam van de bronverzameling. Bijvoorbeeld,FormsFolder
.
De methode retourneert een
com.adobe.repository.infomodel.bean.ResourceCollection
object dat de nieuwe map vertegenwoordigt.De beschrijving van de map instellen met de opdracht
setDescription
methode en geef de volgende parameter door:- A
String
dat de middelinzameling beschrijft. In dit voorbeeld:"test Folder"
wordt gebruikt.
- A
-
De map naar de opslagplaats schrijven
De
ResourceRepositoryClient
objectwriteResource
en geeft u de URI van de map en deResourceCollection
object. De URI naar de map kan bijvoorbeeld de volgende waarde zijn/Applications/FormsApplication/1.0/
.De methode retourneert een instantie van het zojuist gemaakte
com.adobe.repository.infomodel.bean.Resource
object. U kunt, bijvoorbeeld, de herkenningstekenwaarde van de nieuwe bron terugwinnen door hetcom.adobe.repository.infomodel.bean.Resource
objectgetId
methode.
Zie ook
Snel starten (SOAP-modus): Een map maken met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Mappen maken met de webservice-API create-folders-using-the-web-service-api
Een map maken met de Repository Service API (webservice):
-
Projectbestanden opnemen
- Creeer een Microsoft .NET cliëntassemblage die de Bewaarplaats WSDL gebruikend base64 verbruikt.
- Verwijs naar de Microsoft .NET cliëntassemblage.
-
De serviceclient maken
Gebruikend de de cliëntassemblage van Microsoft .NET, creeer een
RepositoryServiceService
object door de standaardconstructor aan te roepen. Stel zijnCredentials
eigenschap met eenSystem.Net.NetworkCredential
-object dat de gebruikersnaam en het wachtwoord bevat. -
De map maken
Maak de map met de standaardconstructor voor de
ResourceCollection
klasse en geef de volgende parameters door:- An
Id
object, dat wordt gemaakt door de standaardconstructor voor hetId
klasse en toegewezen aan deResource
objectid
veld. - An
Lid
object, dat wordt gemaakt door de standaardconstructor voor hetLid
klasse en toegewezen aan deResource
objectlid
veld. - Een tekenreeks met de naam van de bronverzameling die is toegewezen aan de
Resource
objectname
veld. De in dit voorbeeld gebruikte naam is"testfolder"
. - Een tekenreeks die de beschrijving bevat van de bronverzameling die is toegewezen aan de
Resource
objectdescription
veld. In dit voorbeeld wordt de volgende beschrijving gebruikt:"test folder"
.
- An
-
De map naar de opslagplaats schrijven
De
RepositoryServiceService
objectwriteResource
methode en geef de volgende parameters door:- Het pad waar de map moet worden gemaakt.
- De
ResourceCollection
object dat de map vertegenwoordigt. - Voldoende
null
voor de andere twee parameters.
Zie ook
AEM Forms aanroepen met Base64-codering
Bronnen schrijven writing-resources
U kunt bronnen maken op een bepaalde locatie in de opslagplaats. De natuurlijke dossiergrootte is onderworpen aan gegevensbestandbeperkingen en zittingsonderbreking. Voor de standaardconfiguratie, zijn de dossiers beperkt tot 25 MB. Als u de maximale bestandsgrootte wilt verhogen of verlagen, moet u de databaseconfiguratie wijzigen.
Het schrijven van bronnen is gelijk aan het opslaan van gegevens in de opslagplaats. Zodra u een middel aan de bewaarplaats schrijft, wordt het toegankelijk voor alle cliënten in het bewaarplaats ecosysteem. Wanneer u bronnen naar de opslagplaats schrijft, zoals XML-schema's, XDP-bestanden en XSD-bestanden, wordt de inhoud geparseerd op basis van het MIME-type. Als het MIME-type wordt ondersteund, bepaalt de parser of er een impliciete relatie met andere inhoud is. Als een CSS (Cascading Style Sheet) bijvoorbeeld een relatieve URL heeft die verwijst naar een gemeenschappelijke CSS, wordt verwacht dat u de gemeenschappelijke CSS ook in de opslagplaats zult verzenden. De relatie tussen de twee bronnen wordt gedurende een niet-aanpasbare periode van 30 dagen opgeslagen als een hangende relatie. Wanneer u de algemene CSS binnen de periode van 30 dagen naar de opslagplaats verzendt, wordt de relatie gevormd.
Wanneer u een middel creeert, wordt de toegangsbeheerlijst (ACL) geërft van de ouderomslag. De wortelomslag heeft systeem-vlakke toestemmingen tot een eerste middel of een omslag wordt gecreeerd, waarbij het middel of de omslag standaardACL toestemmingen wordt gegeven.
U kunt bronnen programmatisch schrijven met de Java API of webservice van de Repository-service.
Overzicht van de stappen summary_of_steps-1
Voer de volgende stappen uit om een resource te schrijven:
- Inclusief projectbestanden.
- Maak een Repository Service-client.
- Geef de URI op van de bron die moet worden gelezen.
- Lees de bron.
Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, neemt u de proxybestanden op.
De serviceclient maken
Voordat u een bron via programmacode kunt lezen, moet u een verbinding tot stand brengen en referenties opgeven. Dit wordt verwezenlijkt door een de dienstcliënt te creëren.
De URI van de doelmap voor de bron opgeven
Maak een tekenreeks met de URI van de bron die moet worden gelezen. De syntaxis bevat slashes, zoals in dit voorbeeld: "/pad/map".
De bron maken
Roep de servicemethode voor opslagplaats aan om de bron te maken en de bron te vullen met identificerende informatie, waaronder de UUID, de naam van de bron en een beschrijving.
De inhoud van de bron opgeven
Roep de de dienstmethode van de Bewaarplaats aan om middelinhoud tot stand te brengen, en die inhoud in het middel op te slaan.
De bron naar de doelmap schrijven
Roep de servicemethode Repository aan om de bron te schrijven en de URI van de doelmap op te geven.
Zie ook
Bronnen schrijven met de Java API
Bronnen schrijven met de webservice-API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Bronnen schrijven met de Java API write-resources-using-the-java-api
Schrijf een bron met behulp van de Repository Service API (Java):
-
Projectbestanden opnemen
Neem client-JAR-bestanden op in het klassenpad van uw Java-project.
-
De serviceclient maken
Een
ResourceRepositoryClient
object door de constructor ervan te gebruiken en een object door te gevenServiceClientFactory
object dat verbindingseigenschappen bevat. -
De URI van de doelmap voor de bron opgeven
Geef de URI van de doelmap voor de bron op. In dit geval omdat de resource
testResource
wordt opgeslagen in de map met de naamtestFolder
, de URI van de map is"/testFolder"
. De URI wordt opgeslagen als eenjava.lang.String
object. -
De bron maken
Als u een bron wilt maken, moet u eerst een
com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean
object.De
RepositoryInfomodelFactoryBean
objectnewResource
methode, die eencom.adobe.repository.infomodel.bean.Resource
object. In dit voorbeeld worden de volgende parameters opgegeven:- A
com.adobe.repository.infomodel.Id
object, dat wordt gemaakt door de standaardconstructor voor hetId
klasse. - A
com.adobe.repository.infomodel.Lid
object, dat wordt gemaakt door de standaardconstructor voor hetLid
klasse. - A
java.lang.String
met de bestandsnaam van de bron.
Als u de beschrijving van de bron wilt opgeven, roept u de
Resource
objectsetDescription
en geeft u een tekenreeks met de beschrijving door. In dit voorbeeld is de beschrijving"test resource"
. - A
-
De inhoud van de bron opgeven
Als u inhoud voor de bron wilt maken, roept u de
RepositoryInfomodelFactoryBean
objectnewResourceContent
methode, die eencom.adobe.repository.infomodel.bean.ResourceContent
object. Inhoud toevoegen aan deResourceContent
object. In dit voorbeeld worden de volgende taken uitgevoerd:- De
ResourceContent
objectsetDataDocument
methode en doorgeven alscom.adobe.idp.Document
object - De
ResourceContent
objectsetSize
en het doorgeven van de grootte in bytes van deDocument
object
Voeg de inhoud aan de bron toe door de
Resource
objectsetContent
en geeft deResourceContent
object. Zie voor meer informatie AEM Forms API-naslag. - De
-
De bron naar de doelmap schrijven
De
ResourceRepositoryClient
objectwriteResource
en geeft de URI van de map en deResource
object.
Zie ook
Snel starten (SOAP-modus): Een bron schrijven met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Bronnen schrijven met de webservice-API write-resources-using-the-web-service-api
Schrijf een bron met behulp van de Repository Service API (webservice):
-
Projectbestanden opnemen
- Creeer een Microsoft .NET cliëntassemblage die de Bewaarplaats WSDL gebruikend base64 verbruikt.
- Verwijs naar de Microsoft .NET cliëntassemblage.
-
De serviceclient maken
Gebruikend de de cliëntassemblage van Microsoft .NET, creeer een
RepositoryServiceService
object door de standaardconstructor aan te roepen. Stel zijnCredentials
eigenschap met eenSystem.Net.NetworkCredential
object met de gebruikersnaam en het wachtwoord. -
De URI van de doelmap voor de bron opgeven
Geef de URI van de doelmap voor de bron op. In dit geval omdat de resource
testResource
wordt opgeslagen in de map met de naamtestFolder
, de URI van de map is"/testFolder"
. Wanneer het gebruiken van een taal volgzaam met het Kader van Microsoft .NET (bijvoorbeeld, C#), sla URI in a opSystem.String
object. -
De bron maken
Als u een bron wilt maken, roept u de standaardconstructor voor de
Resource
klasse. In dit voorbeeld wordt de volgende informatie opgeslagen in deResource
object:- A
com.adobe.repository.infomodel.Id
object, dat wordt gemaakt door de standaardconstructor voor hetId
klasse en toegewezen aan deResource
objectid
veld. - A
com.adobe.repository.infomodel.Lid
object, dat wordt gemaakt door de standaardconstructor voor hetLid
klasse en toegewezen aan deResource
objectlid
veld. - Een tekenreeks met de bestandsnaam van de bron die is toegewezen aan de
Resource
objectname
veld. De in dit voorbeeld gebruikte naam is"testResource"
. - Een tekenreeks met de beschrijving van de bron die is toegewezen aan de
Resource
objectdescription
veld. In dit voorbeeld wordt de volgende beschrijving gebruikt:"test resource"
.
- A
-
De inhoud van de bron opgeven
Als u inhoud voor de bron wilt maken, roept u de standaardconstructor voor de
ResourceContent
klasse. Voeg vervolgens inhoud toe aan deResourceContent
object. In dit voorbeeld worden de volgende taken uitgevoerd:- Een
BLOB
object met een document naar hetResourceContent
objectdataDocument
veld. - Wijs de grootte in bytes van de
BLOB
aanResourceContent
objectsize
veld.
Voeg de inhoud aan de bron toe door de
ResourceContent
aanResource
objectcontent
veld. - Een
-
De bron naar de doelmap schrijven
De
RepositoryServiceService
objectwriteResource
en geeft de URI van de map en deResource
object. Voldoendenull
voor de andere twee parameters.
Zie ook
AEM Forms aanroepen met Base64-codering
Aanbiedingsbronnen listing-resources
Je kunt bronnen vinden door bronnen aan te bieden. Een vraag wordt uitgevoerd tegen de bewaarplaats om alle middelen te vinden die met een bepaalde middelinzameling verwant zijn.
Zodra u uw middelen organiseert, kunt u de structuur inspecteren u door een bepaalde tak van de structuur te zien creeerde, veel als u in een werkend systeem zou doen.
Bronnen voor lijsten werken op basis van relatie: bronnen zijn leden van mappen. Lidmaatschap wordt vertegenwoordigd door een relatie van het type "lid van". Wanneer u bronnen in een bepaalde map opsomt, zoekt u naar bronnen die verwant zijn aan een bepaalde map door de relatie "lid van". Relaties zijn gericht: een lid van een verhouding heeft een bron die een lid van het doel is. De bron is de bron; het doel is de bovenliggende map.
Overzicht van de stappen summary_of_steps-2
Voer de volgende stappen uit om bronnen weer te geven:
- Inclusief projectbestanden.
- Maak de serviceclient.
- Geef het mappad op.
- Haal de lijst met bronnen op.
Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, neemt u de proxybestanden op.
De serviceclient maken
Alvorens u een middelinzameling programmatically kunt tot stand brengen, moet u een verbinding vestigen en geloofsbrieven verstrekken. Dit wordt verwezenlijkt door een de dienstcliënt te creëren.
Het mappad opgeven
Maak een tekenreeks met het pad van de map met de bronnen. De syntaxis bevat slashes, zoals in dit voorbeeld: "/pad/map".
De lijst met bronnen ophalen
Roep de servicemethode voor gegevensopslagruimte aan om de lijst met bronnen op te halen en geef het pad van de doelmap op.
Zie ook
Bronnen weergeven met de Java API
Bronnen weergeven met de webservice-API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Bronnen weergeven met de Java API list-resources-using-the-java-api
Bronnen weergeven met behulp van de Repository Service API (Java):
-
Projectbestanden opnemen
Neem client-JAR-bestanden op in het klassenpad van uw Java-project.
-
De serviceclient maken
Een
ResourceRepositoryClient
object door de constructor ervan te gebruiken en een object door te gevenServiceClientFactory
object dat verbindingseigenschappen bevat. -
Het mappad opgeven
Geef de URI op van de bronverzameling die moet worden opgevraagd. In dit geval is de URI
"/testFolder"
. De URI wordt opgeslagen als eenjava.lang.String
object. -
De lijst met bronnen ophalen
De
ResourceRepositoryClient
objectlistMembers
en geeft u de URI van de map door.De methode retourneert een
java.util.List
vancom.adobe.repository.infomodel.bean.Resource
objecten die de bron zijn van eencom.adobe.repository.infomodel.bean.Relation
van het typeRelation.TYPE_MEMBER_OF
en hebben de broninzamelings URI als doel. U kunt dit doorlopenList
om elk van de middelen terug te winnen. In dit voorbeeld worden de naam en beschrijving van elke bron weergegeven.
Zie ook
Snel starten (SOAP-modus): Bronnen weergeven met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Bronnen weergeven met de webservice-API list-resources-using-the-web-service-api
Bronnen weergeven met de Repository Service API (webservice):
-
Projectbestanden opnemen
- Creeer een Microsoft .NET cliëntassemblage die de Bewaarplaats WSDL verbruikt.
- Verwijs naar de Microsoft .NET cliëntassemblage.
-
De serviceclient maken
Gebruikend de de cliëntassemblage van Microsoft .NET, creeer een
RepositoryServiceService
object door de standaardconstructor aan te roepen. Stel zijnCredentials
eigenschap met eenSystem.Net.NetworkCredential
object met de gebruikersnaam en het wachtwoord. -
Het mappad opgeven
Geef een tekenreeks op die de URI bevat van de map waarnaar wordt gevraagd. In dit geval is de URI
"/testFolder"
. Wanneer het gebruiken van een taal die met het Kader van Microsoft .NET (bijvoorbeeld, C#) volgzaam is, sla URI in a opSystem.String
object. -
De lijst met bronnen ophalen
De
RepositoryServiceService
objectlistMembers
en geeft de URI van de map door als de eerste parameter. Voldoendenull
voor de andere twee parameters.De methode retourneert een array met objecten waarnaar gecast kan worden
Resource
objecten. U kunt de objectarray doorlopen om elk van de gerelateerde bronnen op te halen. In dit voorbeeld worden de naam en beschrijving van elke bron weergegeven.
Zie ook
AEM Forms aanroepen met Base64-codering
Bronnen lezen reading-resources
U kunt bronnen ophalen van een bepaalde locatie in de opslagplaats om de inhoud en metagegevens te lezen. De workflow wordt voorafgegaan door een initialisatieformulier. Het proces heeft alle machtigingen die het nodig heeft om het formulier te lezen. Het systeem haalt het gegevensformulier op en leest de inhoud uit de gegevensopslagruimte. De opslagplaats verleent toegang tot de inhoud en de meta-gegevens (de capaciteit zelfs om het middel te weten bestaat).
De repository heeft de volgende vier machtigingstypen:
- doorlopen: staat u toe om van middelen een lijst te maken; dat wil zeggen, bronmetagegevens lezen, maar geen broninhoud
- lezen: staat u toe om middelinhoud te lezen
- schrijven: staat u toe om middelinhoud te schrijven
- het beheren van toegangsbeheerlijsten (ACLs): staat u toe om ACLs op middelen te manipuleren
Gebruikers kunnen alleen processen uitvoeren als zij gemachtigd zijn het proces uit te voeren. IDE-gebruikers hebben verplaatsings- en leesmachtigingen nodig om te synchroniseren met de repository. ACLs is slechts in ontwerptijd van toepassing omdat runtime binnen de systeemcontext voorkomt.
U kunt bronnen programmatisch lezen met de Java API of webservice van de Repository-service.
Overzicht van de stappen summary_of_steps-3
Voer de volgende stappen uit om een bron te lezen:
- Inclusief projectbestanden.
- Maak een Repository Service-client.
- Geef de URI op van de bron die moet worden gelezen.
- Lees de bron.
Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, neemt u de proxybestanden op.
De serviceclient maken
Voordat u een bron via programmacode kunt lezen, moet u een verbinding tot stand brengen en referenties opgeven. Dit wordt verwezenlijkt door een de dienstcliënt te creëren.
De URI opgeven van de bron die moet worden gelezen
Maak een tekenreeks met de URI van de bron die moet worden gelezen. De syntaxis bevat slashes, zoals in dit voorbeeld: "/pad/resource".
De bron lezen
Roep de servicemethode Repository aan om de bron te lezen en de URI op te geven.
Zie ook
Bronnen lezen met de webservice-API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Bronnen lezen met de Java API read-resources-using-the-java-api
Een bron lezen met de API voor opslagplaats (Java):
-
Projectbestanden opnemen
Neem client-JAR-bestanden op in het klassenpad van uw Java-project.
-
De serviceclient maken
Een
ResourceRepositoryClient
object door de constructor ervan te gebruiken en een object door te gevenServiceClientFactory
object dat verbindingseigenschappen bevat. -
De URI opgeven van de bron die moet worden gelezen
Geef een tekenreekswaarde op die de URI vertegenwoordigt van de bron die moet worden opgehaald. Bijvoorbeeld, veronderstellend wordt het middel genoemd testResource die zich in een map met de naam testFolder, specificeren
/testFolder/testResource
. -
De bron lezen
De
ResourceRepositoryClient
objectreadResource
en geeft de URI van de bron door als een parameter. Deze methode retourneert eenResource
instantie die de bron vertegenwoordigt.
Zie ook
Snel starten (SOAP-modus): Een bron lezen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Bronnen lezen met de webservice-API reading-resources-using-the-web-service-api
Een bron lezen met de Repository Service API (webservice):
-
Projectbestanden opnemen
- Creeer een Microsoft .NET cliëntassemblage die de Bewaarplaats WSDL verbruikt. (Zie Creërend een .NET cliëntassemblage die het coderen Base64 gebruikt.)
- Verwijs naar de Microsoft .NET cliëntassemblage. (Zie Creërend een .NET cliëntassemblage die het coderen Base64 gebruikt.)
-
De serviceclient maken
Gebruikend de de cliëntassemblage van Microsoft .NET, creeer een
RepositoryServiceService
object door de standaardconstructor aan te roepen. Stel zijnCredentials
eigenschap met eenSystem.Net.NetworkCredential
object met de gebruikersnaam en het wachtwoord. -
De URI opgeven van de bron die moet worden gelezen
Geef een tekenreeks op met de URI van de bron die moet worden opgehaald. In dit geval omdat de resource
testResource
bevindt zich in de map met de naamtestFolder
, de URI ervan is"/testFolder/testResource"
. Wanneer het gebruiken van een taal volgzaam met het Kader van Microsoft .NET (bijvoorbeeld, C#), sla URI in a opSystem.String
object. -
De bron lezen
De
RepositoryServiceService
objectreadResource
en geeft de URI van de bron door als de eerste parameter. Voldoendenull
voor de andere twee parameters.
Zie ook
AEM Forms aanroepen met Base64-codering
Bronnen bijwerken updating-resources
U kunt de inhoud van bronnen in de opslagplaats ophalen en bijwerken. Wanneer u middelen bijwerkt, blijft het toegangsbeheer tot die middelen onveranderd tussen versies. Wanneer u een update uitvoert, kunt u de hoofdversie verhogen. Als u er niet voor kiest de hoofdversie te verhogen, wordt de kleine versie automatisch bijgewerkt.
Wanneer u een bron bijwerkt, wordt de nieuwe versie gemaakt op basis van de opgegeven bronkenmerken. Wanneer u een bron bijwerkt, geeft u twee belangrijke parameters op: de doel-URI en een resource-instantie die alle bijgewerkte metagegevens bevatten. Het is belangrijk om op te merken dat als u een bepaald attribuut (bijvoorbeeld, de naam) niet verandert, het attribuut nog wordt vereist in de instantie u binnen overgaat. De relaties die worden gemaakt bij het parseren van de inhoud, worden toegevoegd aan de specifieke versie en worden alleen naar voren gebracht als dat is opgegeven.
Als u bijvoorbeeld een XDP-bestand bijwerkt dat verwijzingen naar andere bronnen bevat, worden deze aanvullende verwijzingen ook opgenomen. Veronderstel dat form.xdp versie 1.0 twee externe verwijzingen heeft: een logo en een stijlpagina, en u werkt vervolgens form.xdp bij zodat het nu drie verwijzingen heeft: een logo, een stijlpagina en een schemabestand. Tijdens de update voegt de dataopslag de derde relatie (aan het schemabestand) toe aan de relatietabel die in behandeling is. Zodra het schemadossier in de bewaarplaats aanwezig is, zal de verhouding automatisch worden gevormd. Als form.xdp versie 2.0 het logo echter niet meer gebruikt, heeft form.xdp versie 2.0 geen relatie met het logo.
Alle updatebewerkingen zijn atomisch en transactioneel. Als twee gebruikers bijvoorbeeld dezelfde bron lezen en beide besluiten versie 1.0 bij te werken naar versie 2.0, zal één van hen slagen en één van hen zal ontbreken, zal de integriteit van de repository worden gehandhaafd, en beide zullen een bericht krijgen dat succes of mislukking bevestigt. Als de transactie niet begaan, zal het in het geval van gegevensbestandmislukking terugdraaien en uit tijd of terugloop afhankelijk van de toepassingsserver.
U kunt bronnen programmatisch bijwerken met de Java API of webservice van de Repository-service.
Overzicht van de stappen summary_of_steps-4
Voer de volgende stappen uit om een bron bij te werken:
- Inclusief projectbestanden.
- Maak een Repository Service-client.
- Haal de bron op die u wilt bijwerken.
- Werk de bron bij.
Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, neemt u de proxybestanden op.
De serviceclient maken
Voordat u een bron via programmacode kunt lezen, moet u een verbinding tot stand brengen en referenties opgeven. Dit wordt verwezenlijkt door een de dienstcliënt te creëren.
De bron ophalen die moet worden bijgewerkt
Lees de bron. Zie voor meer informatie Bronnen lezen.
De bron bijwerken
Plaats de nieuwe informatie in het middel en haal de de dienstmethode van de Bewaarplaats aan om het middel bij te werken, specificerend URI, het bijgewerkte middel, en hoe de versieinformatie zou moeten worden bijgewerkt.
Zie ook
Bronnen bijwerken met de Java API
Bronnen bijwerken met de webservice-API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Bronnen bijwerken met de Java API update-resources-using-the-java-api
Werk een bron bij met behulp van de Repository Service API (Java):
-
Projectbestanden opnemen
Neem client-JAR-bestanden op in het klassenpad van uw Java-project.
-
De serviceclient maken
Een
ResourceRepositoryClient
object door de constructor ervan te gebruiken en een object door te gevenServiceClientFactory
object dat verbindingseigenschappen bevat. -
De bron ophalen die moet worden bijgewerkt
Geef de URI op van de bron die u wilt ophalen en lezen. In dit voorbeeld is de URI van de bron
"/testFolder/testResource"
. -
De bron bijwerken
Werk de
Resource
objectgegevens. Als u in dit voorbeeld de beschrijving wilt bijwerken, roept u deResource
objectsetDescription
en geeft u de nieuwe beschrijvingstekenreeks door als een parameter.Roep vervolgens het
ServiceClientFactory
objectupdateResource
en geeft de volgende parameters door:- A
java.lang.String
object met de URI van de bron. - De
Resource
object met de bijgewerkte broninformatie. - A
boolean
waarde die aangeeft of de hoofdversie of de secundaire versie moet worden bijgewerkt. In dit voorbeeld is een waarde vantrue
wordt doorgegeven om aan te geven dat de hoofdversie moet worden verhoogd.
- A
Zie ook
Snel starten (SOAP-modus): Een bron bijwerken met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Bronnen bijwerken met de webservice-API update-resources-using-the-web-service-api
Een bron bijwerken met de Repository API (webservice):
-
Projectbestanden opnemen
- Creeer een Microsoft .NET cliëntassemblage die de Bewaarplaats WSDL verbruikt.
- Verwijs naar de Microsoft .NET cliëntassemblage.
-
De serviceclient maken
Gebruikend de de cliëntassemblage van Microsoft .NET, creeer een
RepositoryServiceService
object door de standaardconstructor aan te roepen. Stel zijnCredentials
eigenschap met eenSystem.Net.NetworkCredential
object met de gebruikersnaam en het wachtwoord. -
De bron ophalen die moet worden bijgewerkt
Geef de URI op van de bron die moet worden opgehaald en lees de bron. In dit voorbeeld is de URI van de bron
"/testFolder/testResource"
. Zie voor meer informatie Bronnen lezen. -
De bron bijwerken
Werk de
Resource
objectgegevens. Als u in dit voorbeeld de beschrijving wilt bijwerken, wijst u een nieuwe waarde toe aan deResource
objectdescription
veld. -
De
RepositoryServiceService
objectupdateResource
en geeft de volgende parameters door:- A
System.String
object met de URI van de bron. - De
Resource
object met de bijgewerkte broninformatie. - A
boolean
waarde die aangeeft of de hoofdversie of de secundaire versie moet worden bijgewerkt. In dit voorbeeld is een waarde vantrue
wordt doorgegeven om aan te geven dat de hoofdversie moet worden verhoogd. - Voldoende
null
voor de overige twee parameters.
- A
Zie ook
AEM Forms aanroepen met Base64-codering
Zoeken naar bronnen searching-for-resources
U kunt vragen construeren die worden gebruikt om naar middelen in de bewaarplaats, met inbegrip van geschiedenis, verwante middelen, en eigenschappen te zoeken.
U kunt gerelateerde bronnen ophalen om de afhankelijkheden tussen een formulier en de bijbehorende fragmenten te bepalen. Als u bijvoorbeeld een formulier hebt, kunt u bepalen welke fragmenten of externe bronnen het gebruikt. Als u een afbeelding hebt, kunt u ook nagaan in welke formulieren de afbeelding wordt gebruikt. U kunt ook naar gerelateerde bronnen zoeken door filteren op basis van eigenschappen. U kunt bijvoorbeeld zoeken naar alle formulieren die een afbeelding met een opgegeven naam gebruiken, of naar afbeeldingen die worden gebruikt door een formulier met een opgegeven naam. U kunt ook zoeken met eigenschappen van bronnen. U kunt bijvoorbeeld een query uitvoeren om alle formulieren of bronnen te zoeken waarvan de naam begint met een bepaalde tekenreeks die jokertekens '%' en '_' kan bevatten. Vergeet niet dat zoekopdrachten op basis van eigenschappen niet op relaties zijn gebaseerd. dergelijke onderzoeken zijn gebaseerd op de veronderstelling dat u specifieke kennis over een bepaalde middel hebt.
Query-instructies
A query bevat een of meer instructies die logisch worden gekoppeld aan voorwaarden. A statement bestaat uit een linkeroperand, een operator en een rechteroperand. Bovendien kunt u de sorteervolgorde opgeven die voor de zoekresultaten moet worden gebruikt. De sorteervolgorde bevat informatie die gelijk is aan een SQL ORDER BY
component en bestaat uit elementen die de kenmerken bevatten waarop de zoekopdracht is gebaseerd en een waarde die aangeeft of oplopende of aflopende volgorde moet worden gebruikt.
U kunt programmatically naar middelen zoeken door de dienstJava API van de Bewaarplaats te gebruiken. Op dit moment is het niet mogelijk om met de webservice-API naar bronnen te zoeken.
Sorteergedrag
De orde van de soort wordt niet gerespecteerd wanneer het aanhalen van ResourceRepositoryClient
object searchProperties
en geeft u een sorteervolgorde op. Stel dat u een bron maakt met drie aangepaste eigenschappen, waarbij kenmerknamen name
, secondName
, en asecondName
. Vervolgens maakt u een sorteervolgordelement op de kenmerknaam en stelt u de optie ascending
waarde aan true
.
Vervolgens roept u de ResourceRepositoryClient
object searchProperties
en geeft u de sorteervolgorde door. De zoekopdracht retourneert de juiste bron, met de drie eigenschappen. De eigenschappen worden echter niet gesorteerd op kenmerknaam. Ze worden geretourneerd in de volgorde waarin ze zijn toegevoegd: name
, secondName
, en asecondName
.
Overzicht van de stappen summary_of_steps-5
Ga als volgt te werk om naar bronnen te zoeken:
- Inclusief projectbestanden.
- Maak een Repository Service-client.
- Geef de doelmap voor de zoekopdracht op.
- Geef de kenmerken op die in de zoekopdracht worden gebruikt.
- Maak de query die wordt gebruikt in de zoekopdracht.
- Maak de sorteervolgorde voor de zoekresultaten.
- Zoek de bronnen.
- Haal de bronnen op uit het zoekresultaat.
Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, neemt u de proxybestanden op.
De serviceclient maken
Voordat u een bron via programmacode kunt lezen, moet u een verbinding tot stand brengen en referenties opgeven. Dit wordt verwezenlijkt door een de dienstcliënt te creëren.
De doelmap voor de zoekopdracht opgeven
Maak een tekenreeks met het basispad waaruit de zoekopdracht moet worden uitgevoerd. De syntaxis bevat slashes, zoals in dit voorbeeld: "/pad/map".
De kenmerken opgeven die in de zoekopdracht worden gebruikt
U kunt uw zoekopdracht baseren op de kenmerken in de bronnen. Geef de waarden op van de kenmerken waarop de zoekopdracht moet worden uitgevoerd.
De query maken die wordt gebruikt in de zoekopdracht
Construeer een vraag door verklaringen en voorwaarden te gebruiken. Elke instructie geeft het kenmerk op waarop de zoekopdracht moet worden gebaseerd, de voorwaarde die moet worden gebruikt en de kenmerkwaarde die in de zoekopdracht moet worden gebruikt.
De sorteervolgorde voor de zoekresultaten maken
De sorteervolgorde bestaat uit elementen, die elk een van de kenmerken bevatten die in de zoekopdracht worden gebruikt en een waarde die aangeeft of oplopende of aflopende volgorde moet worden gebruikt.
Zoeken naar de bronnen
Zoek naar de middelen gebruikend de omslag, de vraag, en de soortorde. Geef bovendien de diepte van de zoekopdracht en een bovengrens op voor het aantal resultaten dat moet worden geretourneerd.
De bronnen ophalen uit het zoekresultaat
Doorloop de geretourneerde lijst met bronnen en extraheer de informatie voor verdere verwerking.
Zie ook
Zoeken naar bronnen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Zoeken naar bronnen met de Java API search-for-resources-using-the-java-api
Zoek naar een bron met behulp van de Repository Service API (Java):
-
Projectbestanden opnemen
Neem client-JAR-bestanden op in het klassenpad van uw Java-project.
-
De serviceclient maken
Een
ResourceRepositoryClient
object door de constructor ervan te gebruiken en een object door te gevenServiceClientFactory
object dat verbindingseigenschappen bevat. -
De doelmap voor de zoekopdracht opgeven
Geef de URI op van het basispad waaruit de zoekopdracht moet worden uitgevoerd. In dit voorbeeld is de URI van de bron
/testFolder
. -
De kenmerken opgeven die in de zoekopdracht worden gebruikt
Geef de waarden op voor de kenmerken waarop de zoekopdracht moet worden uitgevoerd. De kenmerken bestaan binnen een
com.adobe.repository.infomodel.bean.Resource
object. In dit voorbeeld wordt de zoekopdracht uitgevoerd op het kenmerk name. derhalvejava.lang.String
met deResource
de naam van het object wordt gebruikt, namelijktestResource
in dit geval. -
De query maken die wordt gebruikt in de zoekopdracht
Als u een query wilt maken, maakt u een
com.adobe.repository.query.Query
object door de standaardconstructor voor hetQuery
en voegt instructies toe aan de query.Als u een instructie wilt maken, roept u de constructor voor de
com.adobe.repository.query.Query.Statement
klasse en geef de volgende parameters door:- Een linkeroperand die de constante van het middelattribuut bevat. In dit voorbeeld, omdat de naam van het middel als basis voor het onderzoek wordt gebruikt, de statische waarde
Resource.ATTRIBUTE_NAME
wordt gebruikt. - Een operator die de voorwaarde bevat die wordt gebruikt in de zoekopdracht naar het kenmerk. De operator moet een van de statische constanten in het dialoogvenster
Query.Statement
klasse. In dit voorbeeld wordt de statische waardeQuery.Statement.OPERATOR_BEGINS_WITH
wordt gebruikt. - Een rechteroperand die de kenmerkwaarde bevat waarop de zoekopdracht moet worden uitgevoerd. In dit voorbeeld wordt het kenmerk name, a
String
met de waarde"testResource"
, wordt gebruikt.
Geef de naamruimte van de linkeroperand op door de
Query.Statement
objectsetNamespace
en geeft u een van de statische waarden in decom.adobe.repository.infomodel.bean.ResourceProperty
klasse. In dit voorbeeld:ResourceProperty.RESERVED_NAMESPACE_REPOSITORY
wordt gebruikt.Voeg elke verklaring aan de vraag toe door aan te halen
Query
objectaddStatement
en geeft deQuery.Statement
object. - Een linkeroperand die de constante van het middelattribuut bevat. In dit voorbeeld, omdat de naam van het middel als basis voor het onderzoek wordt gebruikt, de statische waarde
-
De sorteervolgorde voor de zoekresultaten maken
Als u de sorteervolgorde wilt opgeven die in de zoekresultaten wordt gebruikt, maakt u een
com.adobe.repository.query.sort.SortOrder
object door de standaardconstructor voor hetSortOrder
en voegt elementen toe aan de sorteervolgorde.Als u een element voor de sorteervolgorde wilt maken, roept u een van de constructors voor de opdracht
com.adobe.repository.query.sort.SortOrder.Element
klasse. In dit voorbeeld, omdat de naam van het middel als basis voor het onderzoek wordt gebruikt, de statische waardeResource.ATTRIBUTE_NAME
wordt gebruikt als de eerste parameter en oplopende volgorde (aboolean
waarde vantrue
) wordt opgegeven als de tweede parameter.Voeg elk element aan de soortorde toe door aan te halen
SortOrder
objectaddSortElement
en geeft deSortOrder.Element
object. -
Zoeken naar de bronnen
Als u wilt zoeken naar
resources
op basis van kenmerkeigenschappen, activeert u deResourceRepositoryClient
objectsearchProperties
methode en geef de volgende parameters door:- A
String
met het basispad waaruit de zoekopdracht moet worden uitgevoerd. In dit geval:"/testFolder"
wordt gebruikt. - De query die wordt gebruikt in de zoekopdracht.
- De diepte van de zoekopdracht. In dit geval:
com.adobe.repository.infomodel.bean.ResourceCollection.DEPTH_INFINITE
wordt gebruikt om aan te geven dat het basispad en alle bijbehorende mappen moeten worden gebruikt. - An
int
waarde die de eerste rij aangeeft waaruit de niet-gepagineerde resultatenset moet worden geselecteerd. In dit voorbeeld:0
wordt opgegeven. - An
int
waarde die het maximumaantal resultaten aangeeft dat moet worden geretourneerd. In dit voorbeeld:10
wordt opgegeven. - De sorteervolgorde die in de zoekopdracht wordt gebruikt.
De methode retourneert een
java.util.List
vanResource
objecten in de opgegeven sorteervolgorde. - A
-
De bronnen ophalen uit het zoekresultaat
Doorloop de
List
en elk object naar eenResource
om haar informatie op te vragen. In dit voorbeeld wordt de naam van elke bron weergegeven.
Zie ook
Snel starten (SOAP-modus): Zoeken naar bronnen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Resourcerelaties maken creating-resource-relationships
U kunt relaties tussen bronnen in de opslagplaats opgeven. Er zijn drie soorten relaties:
- Afhankelijkheid: een relatie waarin een middel van andere middelen afhangt, betekenend dat alle verwante middelen in de bewaarplaats nodig zijn.
- Lidmaatschap (bestandssysteem): een relatie waarin een bron zich in een bepaalde map bevindt.
- Aangepast: een relatie die u opgeeft tussen bronnen. Bijvoorbeeld, als één middel is afgekeurd en een andere middel in de bewaarplaats is geïntroduceerd, kon u uw eigen vervangingsverhouding specificeren.
U kunt uw eigen aangepaste relaties maken. Als u bijvoorbeeld een HTML-bestand opslaat in de opslagplaats en een afbeelding gebruikt, kunt u een aangepaste relatie opgeven om het HTML-bestand te koppelen aan de afbeelding (aangezien doorgaans alleen XML-bestanden worden gekoppeld aan afbeeldingen die een door de opslagplaats gedefinieerde afhankelijkheidsrelatie gebruiken). Een ander voorbeeld van een aangepaste relatie is als u een andere weergave van de opslagplaats wilt maken met een cyclische grafiekstructuur in plaats van een boomstructuur. U kunt een cirkelvormige grafiek samen met een kijker definiëren om die relaties te doorlopen. Tot slot kon u erop wijzen dat een middel een andere middel vervangt alhoewel de twee middelen volledig verschillend zijn. In dat geval zou u een relatietype buiten de gereserveerde waaier kunnen bepalen en een verhouding tussen die twee middelen tot stand brengen. Uw toepassing zou de enige cliënt zijn die de verhouding kon ontdekken en verwerken, en het zou kunnen worden gebruikt om onderzoeken op die verhouding te voeren.
U kunt via programmacode relaties tussen bronnen opgeven met de Java API of webservice van de Repository-service.
Overzicht van de stappen summary_of_steps-6
Voer de volgende stappen uit om een relatie tussen twee bronnen op te geven:
- Inclusief projectbestanden.
- Maak een Repository Service-client.
- Geef de URI's op van de bronnen die moeten worden gerelateerd.
- Maak de relatie.
Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, neemt u de proxybestanden op.
De serviceclient maken
Voordat u een bron via programmacode kunt lezen, moet u een verbinding tot stand brengen en referenties opgeven. Dit wordt verwezenlijkt door een de dienstcliënt te creëren.
De URI's opgeven van de bronnen die moeten worden gekoppeld
Maak tekenreeksen die de URI's bevatten van de bron die moet worden gerelateerd. De syntaxis bevat slashes, zoals in dit voorbeeld: "/pad/resource".
De relatie maken
Roep de servicemethode voor gegevensopslagruimte aan om het type relatie te maken en op te geven.
Zie ook
Relatiebronnen maken met de Java API
Relatiebronnen maken met de webservice-API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Relatiebronnen maken met de Java API create-relationship-resources-using-the-java-api
Relatiebronnen maken met de Java API van Repository-service en de volgende taken uitvoeren:
-
Projectbestanden opnemen
Neem client-JAR-bestanden op in het klassenpad van uw Java-project.
-
De serviceclient maken
Een
ResourceRepositoryClient
object door de constructor ervan te gebruiken en een object door te gevenServiceClientFactory
object dat verbindingseigenschappen bevat. -
De URI's opgeven van de bronnen die moeten worden gekoppeld
Geef de URI's op van de bronnen die moeten worden gerelateerd. In dit geval, omdat de bronnen een naam hebben
testResource1
entestResource2
en bevinden zich in de map met de naamtestFolder
, hun URI's zijn"/testFolder/testResource1"
en"/testFolder/testResource2"
. De URI's worden opgeslagen als eenjava.lang.String
objecten. In dit voorbeeld worden de bronnen eerst naar de opslagplaats geschreven en worden hun URI's opgehaald. Voor meer informatie over het schrijven van een middel, zie Bronnen schrijven. -
De relatie maken
De
ResourceRepositoryClient
objectcreateRelationship
methode en geef de volgende parameters door:- De URI van de bronbron.
- De URI van de doelbron.
- Het type relatie, dat een van de statische constanten is in de
com.adobe.repository.infomodel.bean.Relation
klasse. In dit voorbeeld wordt een afhankelijkheidsrelatie tot stand gebracht door de waarde op te gevenRelation.TYPE_DEPENDANT_OF
. - A
boolean
waarde die aangeeft of de doelbron automatisch wordt bijgewerkt naar decom.adobe.repository.infomodel.Id
-based identifier van de nieuwe hoofdbron. In dit voorbeeld, wegens de afhankelijkheidsrelatie, de waardetrue
wordt opgegeven.
U kunt ook een lijst met verwante bronnen voor een bepaalde bron ophalen door het
ResourceRepositoryClient
objectgetRelated
en geeft de volgende parameters door:- De URI van de bron waarvoor gerelateerde bronnen moeten worden opgehaald. In dit voorbeeld wordt de bronbron (
"/testFolder/testResource1"
) is opgegeven. - A
boolean
waarde die aangeeft of de opgegeven bron de bronbron in de relatie is. In dit voorbeeld wordt de waardetrue
is opgegeven, omdat dit het geval is. - Het relatietype, dat een van de statische constanten is in het dialoogvenster
Relation
klasse. In dit voorbeeld wordt een afhankelijkheidsrelatie opgegeven door dezelfde waarde te gebruiken die eerder is gebruikt:Relation.TYPE_DEPENDANT_OF
.
De
getRelated
methode retourneert eenjava.util.List
vanResource
objecten waardoor u kunt herhalen om elk van de gerelateerde bronnen op te halen, waarbij de objecten in deList
totResource
zoals u doet. In dit voorbeeld:testResource2
naar verwachting in de lijst met geretourneerde bronnen staan.
Zie ook
Snel starten (SOAP-modus): Relaties maken tussen bronnen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Relatiebronnen maken met de webservice-API create-relationship-resources-using-the-web-service-api
Relatiebronnen maken met de Repository API (webservice):
-
Projectbestanden opnemen
- Creeer een Microsoft .NET cliëntassemblage die de Bewaarplaats WSDL verbruikt.
- Verwijs naar de Microsoft .NET cliëntassemblage.
-
De serviceclient maken
Gebruikend de de cliëntassemblage van Microsoft .NET, creeer een
RepositoryServiceService
object door de standaardconstructor aan te roepen. Stel zijnCredentials
eigenschap met eenSystem.Net.NetworkCredential
object met de gebruikersnaam en het wachtwoord. -
De URI's opgeven van de bronnen die moeten worden gekoppeld
Geef de URI's op van de bronnen die moeten worden gerelateerd. In dit geval, omdat de bronnen een naam hebben
testResource1
entestResource2
en bevinden zich in de map met de naamtestFolder
, hun URI's zijn"/testFolder/testResource1"
en"/testFolder/testResource2"
. Wanneer het gebruiken van een taal volgzaam met het Kader van Microsoft .NET (bijvoorbeeld, C#), worden URIs opgeslagen als aSystem.String
objecten. In dit voorbeeld worden de bronnen eerst naar de opslagplaats geschreven en worden hun URI's opgehaald. Voor meer informatie over het schrijven van een middel, zie Bronnen schrijven. -
De relatie maken
De
RepositoryServiceService
objectcreateRelationship
methode en geef de volgende parameters door:- De URI van de bronbron.
- De URI van de doelbron.
- Het type relatie. In dit voorbeeld wordt een afhankelijkheidsrelatie tot stand gebracht door de waarde op te geven
3
. - A
boolean
waarde die aangeeft of het relatietype is opgegeven. In dit voorbeeld wordt de waardetrue
wordt opgegeven. - A
boolean
waarde die aangeeft of de doelbron automatisch wordt bijgewerkt naar deId
-based identifier van de nieuwe hoofdbron. In dit voorbeeld, wegens de afhankelijkheidsrelatie, de waardetrue
wordt opgegeven. - A
boolean
waarde die aangeeft of de doelkop is opgegeven. In dit voorbeeld wordt de waardetrue
wordt opgegeven. - Voldoende
null
voor de laatste parameter.
U kunt ook een lijst met verwante bronnen voor een bepaalde bron ophalen door het
RepositoryServiceService
objectgetRelated
en geeft de volgende parameters door:- De URI van de bron waarvoor gerelateerde bronnen moeten worden opgehaald. In dit voorbeeld wordt de bronbron (
"/testFolder/testResource1"
) is opgegeven. - A
boolean
waarde die aangeeft of de opgegeven bron de bronbron in de relatie is. In dit voorbeeld wordt de waardetrue
is opgegeven, omdat dit het geval is. - A
boolean
waarde die aangeeft of de bronbron is opgegeven. In dit voorbeeld wordt de waardetrue
wordt opgegeven. - Een array van gehele getallen die de relatietypen bevatten. In dit voorbeeld wordt een afhankelijkheidsrelatie opgegeven door dezelfde waarde in de array te gebruiken als eerder werd gebruikt:
3
. - Voldoende
null
voor de overige twee parameters.
De
getRelated
methode retourneert een array met objecten waarop kan worden gecastResource
objecten waarmee u kunt herhalen om elk van de gerelateerde bronnen op te halen. In dit voorbeeld:testResource2
naar verwachting in de lijst met geretourneerde bronnen staan.
Zie ook
AEM Forms aanroepen met Base64-codering
Bronnen vergrendelen locking-resources
U kunt een bron of reeks bronnen vergrendelen voor exclusief gebruik door een bepaalde gebruiker of voor gedeeld gebruik door meerdere gebruikers. Een gedeelde vergrendeling is een indicatie dat er iets met de bron zal gebeuren, maar het belet niemand anders om acties met die bron te ondernemen. Een gedeeld slot zou als signalerend mechanisme moeten worden beschouwd. Een exclusief slot betekent dat de gebruiker die het middel sloot de middel zal veranderen, en het slot zorgt ervoor dat niemand anders dit kan doen tot de gebruiker niet meer toegang tot het middel nodig heeft en het slot heeft vrijgegeven. Als een bewaarnemerbeheerder een middel ontgrendelt, zullen alle exclusieve en gedeelde sloten op dat middel automatisch worden verwijderd. Dit type actie is bedoeld voor situaties waarin een gebruiker niet meer beschikbaar is en de bron niet heeft ontgrendeld.
Wanneer een bron is vergrendeld, wordt een vergrendelingspictogram weergegeven wanneer u het tabblad Bronnen in Workbench bekijkt, zoals in de volgende afbeelding wordt getoond.
U kunt de toegang tot bronnen programmatisch beheren met de Java API of webservice van de Repository-service.
Overzicht van de stappen summary_of_steps-7
Voer de volgende stappen uit om bronnen te vergrendelen en te ontgrendelen:
- Inclusief projectbestanden.
- Maak een Repository Service-client.
- Geef de URI op van de bron die moet worden vergrendeld.
- Vergrendel de resource.
- Haal de sloten voor de bron op.
- De bron ontgrendelen
Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, neemt u de proxybestanden op.
De serviceclient maken
Voordat u een bron via programmacode kunt lezen, moet u een verbinding tot stand brengen en referenties opgeven. Dit wordt verwezenlijkt door een de dienstcliënt te creëren.
De URI opgeven van de bron die moet worden vergrendeld
Maak een tekenreeks met de URI van de bron die moet worden vergrendeld. De syntaxis bevat slashes, zoals in dit voorbeeld: "/pad/resource".
De bron vergrendelen
Roep de servicemethode Repository aan om de bron te vergrendelen, waarbij de URI, het type vergrendeling en de vergrendelingsdiepte worden opgegeven.
Haalt de vergrendelingen voor de bron op
Roep de de dienstmethode van de Bewaarplaats aan om de sloten voor het middel terug te winnen, die URI specificeren.
De bron ontgrendelen
Roep de servicemethode Repository aan om de bron te ontgrendelen en de URI op te geven.
Zie ook
Bronnen vergrendelen met de Java API
Bronnen vergrendelen met de webservice-API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Bronnen vergrendelen met de Java API lock-resources-using-the-java-api
Bronnen vergrendelen met de API voor opslagplaats (Java):
-
Projectbestanden opnemen
Neem client-JAR-bestanden op in het klassenpad van uw Java-project.
-
De serviceclient maken
Een
ResourceRepositoryClient
object door de constructor ervan te gebruiken en een object door te gevenServiceClientFactory
object dat verbindingseigenschappen bevat. -
De URI opgeven van de bron die moet worden vergrendeld
Geef de URI op van de bron die moet worden vergrendeld. In dit geval omdat de resource
testResource
bevindt zich in de map met de naamtestFolder
, de URI ervan is"/testFolder/testResource"
. De URI wordt opgeslagen als eenjava.lang.String
object. -
De bron vergrendelen
De
ResourceRepositoryClient
objectlockResource
methode en geef de volgende parameters door:- De URI van de resource.
- Het vergrendelingsbereik. In dit voorbeeld wordt het vergrendelingsbereik opgegeven zoals in
com.adobe.repository.infomodel.bean.Lock.SCOPE_EXCLUSIVE
. - De vergrendelingsdiepte. In dit voorbeeld wordt de vergrendelingsdiepte opgegeven als: omdat de vergrendeling alleen van toepassing is op de specifieke bron en geen van de leden of onderliggende elementen ervan
Lock.DEPTH_ZERO
.
note note NOTE De overbelaste versie van de lockResource
methode die vier parameters vereist werpt een uitzondering. Zorg ervoor dat u delockResource
methode die drie parameters zoals aangetoond in deze analyse vereist. -
Haalt de vergrendelingen voor de bron op
De
ResourceRepositoryClient
objectgetLocks
en geeft de URI van de bron door als een parameter. De methode retourneert een lijst met vergrendelingsobjecten waarmee u kunt herhalen. In dit voorbeeld worden de eigenaar van de vergrendeling, de diepte en het bereik voor elk object afgedrukt door het aanroepen van het object LockgetOwnerUserId
,getDepth
, engetType
methoden, respectievelijk. -
De bron ontgrendelen
De
ResourceRepositoryClient
objectunlockResource
en geeft de URI van de bron door als een parameter. Zie voor meer informatie de AEM Forms API-naslag.
Zie ook
Snel starten (SOAP-modus): Een bron vergrendelen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Bronnen vergrendelen met de webservice-API lock-resources-using-the-web-service-api
Bronnen vergrendelen met behulp van de Repository Service API (webservice):
-
Projectbestanden opnemen
- Creeer een Microsoft .NET cliëntassemblage die de Bewaarplaats WSDL gebruikend Base64 gebruikt.
- Verwijs naar de Microsoft .NET cliëntassemblage.
-
De serviceclient maken
Gebruikend de de cliëntassemblage van Microsoft .NET, creeer een
RepositoryServiceService
object door de standaardconstructor aan te roepen. Stel zijnCredentials
eigenschap met eenSystem.Net.NetworkCredential
object met de gebruikersnaam en het wachtwoord. -
De URI opgeven van de bron die moet worden vergrendeld
Geef een tekenreeks op die de URI bevat van de bron die moet worden vergrendeld. In dit geval omdat de resource
testResource
bevindt zich in de maptestFolder
, de URI ervan is"/testFolder/testResource"
. Wanneer het gebruiken van een taal volgzaam met het Kader van Microsoft .NET (bijvoorbeeld, C#), sla URI in a opSystem.String
object. -
De bron vergrendelen
De
RepositoryServiceService
objectlockResource
methode en geef de volgende parameters door:- De URI van de resource.
- Het vergrendelingsbereik. In dit voorbeeld wordt het vergrendelingsbereik opgegeven zoals in
11
. - De vergrendelingsdiepte. In dit voorbeeld wordt de vergrendelingsdiepte opgegeven als: omdat de vergrendeling alleen van toepassing is op de specifieke bron en geen van de leden of onderliggende elementen ervan
2
. - An
int
waarde die op het aantal seconden wijst tot het slot verloopt. In dit voorbeeld wordt de waarde van1000
wordt gebruikt. - Voldoende
null
voor de laatste parameter.
-
Haalt de vergrendelingen voor de bron op
De
RepositoryServiceService
objectgetLocks
en geeft de URI van de bron door als de eerste parameter ennull
voor de tweede parameter. De methode retourneert eenobject
array metLock
objecten waarmee u kunt herhalen. In dit voorbeeld worden de eigenaar, diepte en bereik van de vergrendeling voor elk object afgedrukt door toegang te krijgen tot elk objectLock
objectownerUserId
,depth
, entype
respectievelijk velden. -
De bron ontgrendelen
De
RepositoryServiceService
objectunlockResource
en geeft de URI van de bron door als de eerste parameter ennull
voor de tweede parameter.
Zie ook
AEM Forms aanroepen met Base64-codering
Bronnen verwijderen deleting-resources
U kunt bronnen programmatisch verwijderen van een bepaalde locatie in de opslagplaats met behulp van de Java API (SOAP) van de Repository-service.
Wanneer u een middel schrapt, is de schrapping normaal permanent, hoewel in sommige gevallen ECM bewaart bewaarplaatsen de versies van het middel volgens hun geschiedenismechanismen. Daarom wanneer het schrappen van een middel, is het belangrijk om zeker te zijn dat u nooit die middel opnieuw zult nodig hebben. De gemeenschappelijke redenen om een middel te schrappen omvatten de behoefte om de beschikbare ruimte in het gegevensbestand te verhogen. U kunt een versie van een bron verwijderen, maar als u dat doet, moet u de resource-id opgeven en niet de logische id (LID) of het pad. Als u een map verwijdert, worden alle gegevens in die map, inclusief de submappen en bronnen, automatisch verwijderd.
Gerelateerde bronnen worden niet verwijderd. Als u bijvoorbeeld een formulier hebt waarin het bestand logo.gif wordt gebruikt en u logo.gif verwijdert, wordt een relatie opgeslagen in de relatietabel die in behandeling is. Als alternatief kunt u voor versiedrukking de objectstatus van de meest recente versie instellen op afgekeurd.
Een schrappingsverrichting is niet transactie-veilig in systemen ECM. Als u bijvoorbeeld probeert 100 bronnen te verwijderen en de bewerking op de 50e bron mislukt, worden de eerste 49 instanties verwijderd, maar de rest niet. Anders, is het standaardgedrag terugschroeven (niet-verplichting).
com.adobe.repository.bindings.dsc.client.ResourceRepositoryClient.deleteResources()
methode met ECM-opslagplaats (EMC Documentum Content Server en IBM FileNet P8 Content Manager), wordt de transactie niet teruggedraaid als de verwijdering mislukt voor een van de opgegeven bronnen, wat betekent dat bestanden die zijn verwijderd, niet kunnen worden verwijderd.Overzicht van de stappen summary_of_steps-8
Ga als volgt te werk om een bron te verwijderen:
- Inclusief projectbestanden.
- Maak een Repository Service-client.
- Geef de URI op van de bron die moet worden verwijderd.
- Verwijder de bron.
Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, neemt u de proxybestanden op.
De serviceclient maken
Voordat u een bron via programmacode kunt lezen, moet u een verbinding tot stand brengen en referenties opgeven. Dit wordt verwezenlijkt door een de dienstcliënt te creëren.
De URI opgeven van de bron die moet worden verwijderd
Maak een tekenreeks met de URI van de bron die moet worden verwijderd. De syntaxis bevat slashes, zoals in dit voorbeeld: "/pad/resource". Als de te schrappen bron een omslag is, zal de schrapping recursief zijn.
De bron verwijderen
Roep de servicemethode Repository aan om de bron te verwijderen en de URI op te geven.
Zie ook
Bronnen verwijderen met de Java API
Bronnen verwijderen met de webservice-API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Bronnen verwijderen met de Java API (SOAP) delete-resources-using-the-java-api-soap
Verwijder een bron met de Repository API (Java):
-
Projectbestanden opnemen
Neem client-JAR-bestanden op in het klassenpad van uw Java-project.
-
De serviceclient maken
Een
ResourceRepositoryClient
object door de constructor ervan te gebruiken en een object door te gevenServiceClientFactory
object dat verbindingseigenschappen bevat. -
De URI opgeven van de bron die moet worden verwijderd
Geef de URI op van de bron die moet worden opgehaald. In dit geval, omdat de bron met de naam testResourceToBeDelette zich in de map met de naam testFolder bevindt, is zijn URI
/testFolder/testResourceToBeDeleted
. De URI wordt opgeslagen als eenjava.lang.String
object. In dit voorbeeld wordt de bron eerst naar de opslagplaats geschreven en wordt de URI ervan opgehaald. Voor meer informatie over het schrijven van een middel, zie Bronnen schrijven. -
De bron verwijderen
De
ResourceRepositoryClient
objectdeleteResource
en geeft de URI van de bron door als een parameter.
Zie ook
Snel starten (SOAP-modus): Zoeken naar bronnen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Bronnen verwijderen met de webservice-API delete-resources-using-the-web-service-api
Verwijder een bron met de Repository API (webservice):
-
Projectbestanden opnemen
- Creeer een Microsoft .NET cliëntassemblage die de Bewaarplaats WSDL gebruikend Base64 gebruikt.
- Verwijs naar de Microsoft .NET cliëntassemblage.
-
De serviceclient maken
Gebruikend de de cliëntassemblage van Microsoft .NET, creeer een
RepositoryServiceService
object door de standaardconstructor aan te roepen. Stel zijnCredentials
eigenschap met eenSystem.Net.NetworkCredential
object met de gebruikersnaam en het wachtwoord. -
De URI opgeven van de bron die moet worden verwijderd
Geef de URI op van de bron die moet worden opgehaald. In dit geval omdat de resource
testResourceToBeDeleted
bevindt zich in de map met de naamtestFolder
, de URI ervan is"/testFolder/testResourceToBeDeleted"
. In dit voorbeeld wordt de bron eerst naar de opslagplaats geschreven en wordt de URI ervan opgehaald. Voor meer informatie over het schrijven van een middel, zie Bronnen schrijven. -
De bron verwijderen
De
RepositoryServiceService
objectdeleteResources
methode en eenSystem.String
array met de URI van de resource als eerste parameter. Voldoendenull
voor de tweede parameter.
Zie ook
AEM Forms aanroepen met Base64-codering