Werken met AEM Forms Repository

Snel starten (SOAP-modus): Een map maken met de Java API

Mappen maken met de 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

Maak een ResourceRepositoryClient-object door de constructor ervan te gebruiken en een ServiceClientFactory-object door te geven dat verbindingseigenschappen bevat.
De map maken

Als u een bronverzameling wilt maken, moet u eerst een com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean-object maken.

Roep de methode repositoryInfomodelFactoryBean van het object newResourceCollection aan en geef de volgende parameters door:
- A com.adobe.repository.infomodel.Id UUID identifier to be assigned to the resource.
- A com.adobe.repository.infomodel.Lid UUID identifier to be assigned to the resource.
- A java.lang.String bevattende de naam van de middelinzameling. Bijvoorbeeld, FormsFolder.
De methode retourneert een com.adobe.repository.infomodel.bean.ResourceCollection-object dat de nieuwe map vertegenwoordigt.

Stel de beschrijving van de map in met de methode setDescription en geef de volgende parameter door:
- A String die de middelinzameling beschrijft. In dit voorbeeld wordt "test Folder" gebruikt .
De map naar de opslagplaats schrijven

Roep de methode ResourceRepositoryClient van het object writeResource aan en geef de URI van de map en het object ResourceCollection door. De URI naar de map kan bijvoorbeeld de volgende waarde /Applications/FormsApplication/1.0/ zijn.

De methode retourneert een instantie van het nieuwe com.adobe.repository.infomodel.bean.Resource-object. U kunt bijvoorbeeld de id-waarde van de nieuwe bron ophalen door de methode com.adobe.repository.infomodel.bean.Resource van het object getId aan te roepen.

Zie ook

Mappen maken

Mappen maken met de webservice-API

Een map maken met de Repository Service API (webservice):

Projectbestanden opnemen
- Creeer een de cliëntassemblage van Microsoft .NET die Repository WSDL gebruikend base64 gebruikt.
- Verwijs naar de cliëntassemblage van Microsoft .NET.
De serviceclient maken

Gebruikend de de cliëntassemblage van Microsoft .NET, creeer een RepositoryServiceService voorwerp door zijn standaardaannemer aan te halen. Plaats zijn Credentials bezit gebruikend een System.Net.NetworkCredential voorwerp dat de gebruikersnaam en het wachtwoord bevat.
De map maken

Maak de map met de standaardconstructor voor de klasse ResourceCollection en geef de volgende parameters door:
- Een Id-object, dat wordt gemaakt door de standaardconstructor voor de klasse Id aan te roepen en toegewezen aan het veld Resource van het object id.
- Een Lid-object, dat wordt gemaakt door de standaardconstructor voor de klasse Lid aan te roepen en toegewezen aan het veld Resource van het object lid.
- Een tekenreeks met de naam van de bronverzameling, die wordt toegewezen aan het veld name van het object. Resource De naam die in dit voorbeeld wordt gebruikt, is "testfolder".
- Een tekenreeks met de beschrijving van de bronverzameling, die wordt toegewezen aan het veld Resource van het object description. De beschrijving die in dit voorbeeld wordt gebruikt is "test folder".
De map naar de opslagplaats schrijven

Roep de methode RepositoryServiceService van het object writeResource aan en geef de volgende parameters door:
- Het pad waar de map moet worden gemaakt.
- Het ResourceCollection-object dat de map vertegenwoordigt.
- Geef null door voor de andere twee parameters.

Zie ook

Mappen maken

Bronnen schrijven met de Java API

wegschrijven van bronnen

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.

OPMERKING

Voor meer informatie over de dienst van de Bewaarplaats, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van stappen

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: "/path/folder".

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 webservice-API

Snel starten (SOAP-modus): Een bron schrijven met de Java API

Bronnen schrijven met de 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

Maak een ResourceRepositoryClient-object door de constructor ervan te gebruiken en een ServiceClientFactory-object door te geven 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 is de URI van de map testResource, omdat de bron "/testFolder" wordt opgeslagen in de map met de naam testFolder. De URI wordt opgeslagen als een java.lang.String-object.
De bron maken

Als u een bron wilt maken, moet u eerst een com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean-object maken.

Roep de methode RepositoryInfomodelFactoryBean van het object newResource aan, die een object com.adobe.repository.infomodel.bean.Resource maakt. In dit voorbeeld worden de volgende parameters opgegeven:
- Een object com.adobe.repository.infomodel.Id, dat wordt gemaakt door de standaardconstructor voor de klasse Id aan te roepen.
- Een object com.adobe.repository.infomodel.Lid, dat wordt gemaakt door de standaardconstructor voor de klasse Lid aan te roepen.
- Een java.lang.String met de bestandsnaam van de bron.
Als u de beschrijving van de bron wilt opgeven, roept u de methode setDescription van het object Resource aan en geeft u een tekenreeks met de beschrijving door. In dit voorbeeld is de beschrijving "test resource".
De inhoud van de bron opgeven

Als u inhoud voor de bron wilt maken, roept u de methode newResourceContent van het object RepositoryInfomodelFactoryBean aan, die een object com.adobe.repository.infomodel.bean.ResourceContent retourneert. Voeg inhoud toe aan het ResourceContent-object. In dit voorbeeld worden de volgende taken uitgevoerd:
- De methode setDataDocument van het object ResourceContent aanroepen en een object com.adobe.idp.Document doorgeven
- De methode setSize van het object ResourceContent aanroepen en de grootte van het object Document in bytes doorgeven
Voeg de inhoud aan de bron toe door de methode Resource van het object setContent aan te roepen en het object ResourceContent door te geven. Zie AEM Forms API Reference voor meer informatie.
De bron naar de doelmap schrijven

Roep de methode ResourceRepositoryClient van het object writeResource aan en geef de URI van de map en het object Resource door.

Zie ook

Bronnen schrijven

Bronnen schrijven met de webservice-API

Schrijf een bron met behulp van de Repository Service API (webservice):

Projectbestanden opnemen
- Creeer een de cliëntassemblage van Microsoft .NET die Repository WSDL gebruikend base64 gebruikt.
- Verwijs naar de cliëntassemblage van Microsoft .NET.
De serviceclient maken

Gebruikend de de cliëntassemblage van Microsoft .NET, creeer een RepositoryServiceService voorwerp door zijn standaardaannemer aan te halen. Plaats zijn Credentials bezit gebruikend een System.Net.NetworkCredential voorwerp dat de gebruikersnaam en het wachtwoord bevat.
De URI van de doelmap voor de bron opgeven

Geef de URI van de doelmap voor de bron op. In dit geval is de URI van de map testResource, omdat de bron "/testFolder" wordt opgeslagen in de map met de naam testFolder. Wanneer het gebruiken van een taal volgzaam met het Kader van Microsoft .NET (bijvoorbeeld, C#), sla URI in een System.String voorwerp op.
De bron maken

Om een middel tot stand te brengen, haal de standaardaannemer voor de Resource klasse aan. In dit voorbeeld wordt de volgende informatie opgeslagen in het object Resource:
- Een object com.adobe.repository.infomodel.Id, dat wordt gemaakt door de standaardconstructor voor de klasse Id aan te roepen en toegewezen aan het veld Resource van het object id.
- Een object com.adobe.repository.infomodel.Lid, dat wordt gemaakt door de standaardconstructor voor de klasse Lid aan te roepen en toegewezen aan het veld Resource van het object lid.
- Een tekenreeks die de bestandsnaam van de bron bevat. Deze wordt toegewezen aan het veld name van het object. Resource De naam die in dit voorbeeld wordt gebruikt, is "testResource".
- Een tekenreeks met de beschrijving van de bron, die wordt toegewezen aan het veld description van het object. Resource De beschrijving die in dit voorbeeld wordt gebruikt is "test resource".
De inhoud van de bron opgeven

Als u inhoud voor de bron wilt maken, roept u de standaardconstructor voor de klasse ResourceContent aan. Voeg vervolgens inhoud toe aan het object ResourceContent. In dit voorbeeld worden de volgende taken uitgevoerd:
- Een BLOB-object dat een document bevat, toewijzen aan het veld dataDocument van het object.ResourceContent
- De grootte van het BLOB-object in bytes toewijzen aan het veld size van het ResourceContent-object.
Voeg de inhoud aan de bron toe door het object ResourceContent toe te wijzen aan het veld Resource van het object content.
De bron naar de doelmap schrijven

Roep de methode RepositoryServiceService van het object writeResource aan en geef de URI van de map en het object Resource door. Geef null door voor de andere twee parameters.

Zie ook

Bronnen schrijven

Bronnen weergeven met de Java API

Verkoopbronnen

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.

OPMERKING

Voor meer informatie over de dienst van de Bewaarplaats, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van stappen

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: "/path/folder".

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 webservice-API

Snel starten (SOAP-modus): Bronnen weergeven met de Java API

Bronnen weergeven met de 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

Maak een ResourceRepositoryClient-object door de constructor ervan te gebruiken en een ServiceClientFactory-object door te geven 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 een java.lang.String-object.
De lijst met bronnen ophalen

Roep de methode ResourceRepositoryClient van het object listMembers aan en geef de URI van de map door.

De methode retourneert een java.util.List van com.adobe.repository.infomodel.bean.Resource-objecten die de bron zijn van een com.adobe.repository.infomodel.bean.Relation van het type Relation.TYPE_MEMBER_OF en de URI van de bronverzameling als doel hebben. U kunt dit List herhalen om elk van de middelen terug te winnen. In dit voorbeeld worden de naam en beschrijving van elke bron weergegeven.

Zie ook

Aanbiedingsbronnen.

Bronnen weergeven met de webservice-API

Bronnen weergeven met de Repository Service API (webservice):

Projectbestanden opnemen
- Creeer een de cliëntassemblage van Microsoft .NET die de Bewaarplaats WSDL verbruikt.
- Verwijs naar de cliëntassemblage van Microsoft .NET.
De serviceclient maken

Gebruikend de de cliëntassemblage van Microsoft .NET, creeer een RepositoryServiceService voorwerp door zijn standaardaannemer aan te halen. Plaats zijn Credentials bezit gebruikend een System.Net.NetworkCredential voorwerp dat de gebruikersnaam en het wachtwoord bevat.
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 een System.String voorwerp op.
De lijst met bronnen ophalen

Roep de methode RepositoryServiceService van het object listMembers aan en geef de URI van de map als eerste parameter door. Geef null door voor de andere twee parameters.

De methode keert een serie van voorwerpen terug die aan Resource voorwerpen kunnen worden gegoten. 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

Aanbiedingsbronnen.

Bronnen lezen met de Java API

Bronnen lezen

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.

OPMERKING

Voor meer informatie over de dienst van de Bewaarplaats, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van stappen

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: "/path/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

Snel starten (SOAP-modus): Een bron lezen met de Java API

Bronnen lezen met de 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

Maak een ResourceRepositoryClient-object door de constructor ervan te gebruiken en een ServiceClientFactory-object door te geven 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. Als de bron bijvoorbeeld testResource heet en zich in een map met de naam testFolder bevindt, geeft u /testFolder/testResource op.
De bron lezen

Roep de methode ResourceRepositoryClient van het object readResource aan en geef de URI van de bron als parameter door. Deze methode retourneert een Resource-instantie die de bron vertegenwoordigt.

Zie ook

Bronnen lezen

Bronnen lezen met de API van de webservice

Een bron lezen met de Repository Service API (webservice):

Projectbestanden opnemen
- Creeer een de cliëntassemblage van Microsoft .NET die de Bewaarplaats WSDL verbruikt. (Zie Creërend een .NET cliëntassemblage die Base64 het coderen gebruikt.)
- Verwijs naar de cliëntassemblage van Microsoft .NET. (Zie Creërend een .NET cliëntassemblage die Base64 het coderen gebruikt.)
De serviceclient maken

Gebruikend de de cliëntassemblage van Microsoft .NET, creeer een RepositoryServiceService voorwerp door zijn standaardaannemer aan te halen. Plaats zijn Credentials bezit gebruikend een System.Net.NetworkCredential voorwerp dat de gebruikersnaam en het wachtwoord bevat.
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 is de URI testResource omdat de bron testFolder zich in de map met de naam "/testFolder/testResource" bevindt. Wanneer het gebruiken van een taal volgzaam met het Kader van Microsoft .NET (bijvoorbeeld, C#), sla URI in een System.String voorwerp op.
De bron lezen

Roep de methode RepositoryServiceService van het object readResource aan en geef de URI van de bron als eerste parameter door. Geef null door voor de andere twee parameters.

Zie ook

Bronnen lezen

Bronnen bijwerken met de Java API

Bronnen bijwerken

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.

OPMERKING

Voor meer informatie over de dienst van de Bewaarplaats, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van stappen

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 Bronnen lezen voor meer informatie.

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 webservice-API

Snel starten (SOAP-modus): Een bron bijwerken met de Java API

Bronnen bijwerken met de 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

Maak een ResourceRepositoryClient-object door de constructor ervan te gebruiken en een ServiceClientFactory-object door te geven 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 gegevens van het object Resource bij. In dit voorbeeld roept u de methode setDescription van het object Resource op en geeft u de nieuwe beschrijvende tekenreeks als een parameter door.

Roep vervolgens de methode ServiceClientFactory van het object updateResource aan en geef de volgende parameters door:
- Een java.lang.String-object dat de URI van de bron bevat.
- Het Resource-object dat de bijgewerkte broninformatie bevat.
- Een waarde boolean die aangeeft of de primaire of secundaire versie moet worden bijgewerkt. In dit voorbeeld wordt een waarde van true doorgegeven om aan te geven dat de hoofdversie moet worden verhoogd.

Zie ook

Bronnen bijwerken

Bronnen bijwerken met de webservice-API

Een bron bijwerken met de Repository API (webservice):

Projectbestanden opnemen
- Creeer een de cliëntassemblage van Microsoft .NET die de Bewaarplaats WSDL verbruikt.
- Verwijs naar de cliëntassemblage van Microsoft .NET.
De serviceclient maken

Gebruikend de de cliëntassemblage van Microsoft .NET, creeer een RepositoryServiceService voorwerp door zijn standaardaannemer aan te halen. Plaats zijn Credentials bezit gebruikend een System.Net.NetworkCredential voorwerp dat de gebruikersnaam en het wachtwoord bevat.
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 Bronnen lezen voor meer informatie.
De bron bijwerken

Werk de gegevens van het object Resource bij. In dit voorbeeld wijst u een nieuwe waarde toe aan het veld description van het object om de beschrijving bij te werken.Resource
Roep de methode RepositoryServiceService van het object updateResource aan en geef de volgende parameters door:
- Een System.String-object dat de URI van de bron bevat.
- Het Resource-object dat de bijgewerkte broninformatie bevat.
- Een waarde boolean die aangeeft of de primaire of secundaire versie moet worden bijgewerkt. In dit voorbeeld wordt een waarde van true doorgegeven om aan te geven dat de hoofdversie moet worden verhoogd.
- Geef null door voor de resterende twee parameters.

Zie ook

Bronnen bijwerken

Zoeken naar bronnen met de Java API

Zoeken naar bronnen

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

Een query bevat een of meer instructies die logisch gezien zijn gekoppeld aan voorwaarden. Een 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 equivalent 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 sorteervolgorde wordt niet gerespecteerd wanneer de methode searchProperties van het object ResourceRepositoryClient wordt aangeroepen en een sorteervolgorde wordt opgegeven. Stel bijvoorbeeld dat u een bron maakt met drie aangepaste eigenschappen, waarbij kenmerknamen name, secondName en asecondName zijn. Vervolgens maakt u een sorteervolgordelement op de kenmerknaam en stelt u de waarde ascending in op true.

Vervolgens roept u de methode ResourceRepositoryClient van het object searchProperties aan 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.

OPMERKING

Voor meer informatie over de dienst van de Bewaarplaats, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van stappen

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: "/path/folder".

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

Snel starten (SOAP-modus): Zoeken naar bronnen met de Java API

Zoeken naar bronnen met de 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

Maak een ResourceRepositoryClient-object door de constructor ervan te gebruiken en een ServiceClientFactory-object door te geven 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 attributen bestaan binnen een com.adobe.repository.infomodel.bean.Resource voorwerp. In dit voorbeeld wordt de zoekopdracht uitgevoerd op het kenmerk name. Daarom wordt een java.lang.String met de naam van het object Resource gebruikt, in dit geval testResource.
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 de klasse Query aan te roepen en instructies toe te voegen aan de query.

Als u een instructie wilt maken, roept u de constructor voor de klasse com.adobe.repository.query.Query.Statement aan en geeft u de volgende parameters door:
- Een linkeroperand die de constante van het middelattribuut bevat. In dit voorbeeld wordt de statische waarde Resource.ATTRIBUTE_NAME gebruikt, omdat de naam van de bron wordt gebruikt als basis voor de zoekopdracht.
- Een operator die de voorwaarde bevat die wordt gebruikt in de zoekopdracht naar het kenmerk. De operator moet een van de statische constanten in de klasse Query.Statement zijn. In dit voorbeeld wordt de statische waarde Query.Statement.OPERATOR_BEGINS_WITH gebruikt.
- Een rechteroperand die de kenmerkwaarde bevat waarop de zoekopdracht moet worden uitgevoerd. In dit voorbeeld wordt het kenmerk name gebruikt, een String met de waarde "testResource".
Geef de naamruimte van de linkeroperand op door de methode Query.Statement van het object setNamespace aan te roepen en een van de statische waarden in de klasse com.adobe.repository.infomodel.bean.ResourceProperty door te geven. In dit voorbeeld wordt ResourceProperty.RESERVED_NAMESPACE_REPOSITORY gebruikt.

Voeg elke verklaring aan de vraag toe door de Query methode van het voorwerp addStatement aan te halen en in het Query.Statement voorwerp over te gaan.
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 de klasse SortOrder aan te roepen en voegt u elementen toe aan de sorteervolgorde.

Als u een element voor de sorteervolgorde wilt maken, roept u een van de constructors voor de klasse com.adobe.repository.query.sort.SortOrder.Element aan. In dit voorbeeld wordt de statische waarde Resource.ATTRIBUTE_NAME gebruikt als de eerste parameter, en de oplopende volgorde (een boolean waarde true) wordt opgegeven als de tweede parameter, omdat de naam van de bron wordt gebruikt als de basis voor de zoekopdracht.

Voeg elk element aan de sorteervolgorde toe door de methode addSortElement van het SortOrder-object aan te roepen en het object SortOrder.Element door te geven.
Zoeken naar de bronnen

Als u naar resources wilt zoeken op basis van kenmerkeigenschappen, roept u de methode searchProperties van het object ResourceRepositoryClient aan en geeft u de volgende parameters door:
- Een String met het basispad waaruit de zoekopdracht moet worden uitgevoerd. In dit geval wordt "/testFolder" gebruikt.
- De query die wordt gebruikt in de zoekopdracht.
- De diepte van de zoekopdracht. In dit geval wordt com.adobe.repository.infomodel.bean.ResourceCollection.DEPTH_INFINITE gebruikt om aan te geven dat het basispad en alle bijbehorende mappen moeten worden gebruikt.
- Een waarde int die de eerste rij aangeeft waarvan de niet-gepagineerde resultatenset moet worden geselecteerd. In dit voorbeeld wordt 0 opgegeven.
- Een waarde int die het maximumaantal resultaten aangeeft dat moet worden geretourneerd. In dit voorbeeld wordt 10 opgegeven.
- De sorteervolgorde die in de zoekopdracht wordt gebruikt.
De methode retourneert een java.util.List van Resource-objecten in de opgegeven sorteervolgorde.
De bronnen ophalen uit het zoekresultaat

Om de middelen terug te winnen in het onderzoeksresultaat, doorloopt List en giet elk voorwerp aan Resource om zijn informatie te halen. In dit voorbeeld wordt de naam van elke bron weergegeven.

Zie ook

Zoeken naar bronnen

Relatiebronnen maken met de Java API

Resourcerelaties maken

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 gewoonlijk alleen XML-bestanden worden gekoppeld aan afbeeldingen met behulp van een door de opslagplaats gedefinieerde afhankelijkheidsrelatie). 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.

OPMERKING

Voor meer informatie over de dienst van de Bewaarplaats, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van stappen

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: "/path/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 webservice-API

Snel starten (SOAP-modus): Relaties maken tussen bronnen met de Java API

Relatiebronnen maken met de 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

Maak een ResourceRepositoryClient-object door de constructor ervan te gebruiken en een ServiceClientFactory-object door te geven 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 middelen testResource1 en testResource2 worden genoemd en in de omslag genoemd testFolder worden gevestigd, zijn hun URIs "/testFolder/testResource1" en "/testFolder/testResource2". De URI’s worden opgeslagen als een java.lang.String-object. 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 het Schrijven van Middelen.
De relatie maken

Roep de methode ResourceRepositoryClient van het object createRelationship aan en geef de volgende parameters door:
- De URI van de bronbron.
- De URI van de doelbron.
- Het type relatie. Dit is een van de statische constanten in de klasse com.adobe.repository.infomodel.bean.Relation. In dit voorbeeld wordt een afhankelijkheidsrelatie tot stand gebracht door de waarde Relation.TYPE_DEPENDANT_OF op te geven.
- Een waarde boolean die erop wijst of de doelmiddel automatisch aan com.adobe.repository.infomodel.Id-Gebaseerde herkenningsteken van de nieuwe hoofdmiddel wordt bijgewerkt. In dit voorbeeld wordt vanwege de afhankelijkheidsrelatie de waarde true opgegeven.
U kunt ook een lijst met verwante bronnen voor een bepaalde bron ophalen door de methode getRelated van het object ResourceRepositoryClient aan te roepen en de volgende parameters door te geven:
- De URI van de bron waarvoor gerelateerde bronnen moeten worden opgehaald. In dit voorbeeld wordt de bronbron ( "/testFolder/testResource1") opgegeven.
- Een waarde boolean die erop wijst of het gespecificeerde middel de bronmiddel in de verhouding is. In dit voorbeeld wordt de waarde true opgegeven omdat dit het geval is.
- Het relatietype, dat een van de statische constanten in de klasse Relation is. In dit voorbeeld wordt een afhankelijkheidsrelatie opgegeven door dezelfde waarde te gebruiken die eerder is gebruikt: Relation.TYPE_DEPENDANT_OF.
De getRelated methode keert java.util.List van Resource voorwerpen terug waardoor u kunt herhalen om elk van de verwante middelen terug te winnen, gietend de voorwerpen in List aan Resource aangezien u dit doet. In dit voorbeeld wordt verwacht dat testResource2 voorkomt in de lijst met geretourneerde bronnen.

Zie ook

Resourcerelaties maken

Relatiebronnen maken met de webservice-API

Relatiebronnen maken met de Repository API (webservice):

Projectbestanden opnemen
- Creeer een de cliëntassemblage van Microsoft .NET die de Bewaarplaats WSDL verbruikt.
- Verwijs naar de cliëntassemblage van Microsoft .NET.
De serviceclient maken

Gebruikend de de cliëntassemblage van Microsoft .NET, creeer een RepositoryServiceService voorwerp door zijn standaardaannemer aan te halen. Plaats zijn Credentials bezit gebruikend een System.Net.NetworkCredential voorwerp dat de gebruikersnaam en het wachtwoord 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 middelen testResource1 en testResource2 worden genoemd en in de omslag genoemd testFolder worden gevestigd, zijn hun URIs "/testFolder/testResource1" en "/testFolder/testResource2". Wanneer het gebruiken van een taal volgzaam met het Kader van Microsoft .NET (bijvoorbeeld, C#), worden URIs opgeslagen als System.String voorwerpen. 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 het Schrijven van Middelen.
De relatie maken

Roep de methode RepositoryServiceService van het object createRelationship aan 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 3 op te geven.
- Een waarde boolean die erop wijst of het relatietype werd gespecificeerd. In dit voorbeeld wordt de waarde true opgegeven.
- Een waarde boolean die erop wijst of de doelmiddel automatisch aan Id-Gebaseerde herkenningsteken van de nieuwe hoofdmiddel wordt bijgewerkt. In dit voorbeeld wordt vanwege de afhankelijkheidsrelatie de waarde true opgegeven.
- Een waarde boolean die erop wijst of het doelhoofd werd gespecificeerd. In dit voorbeeld wordt de waarde true opgegeven.
- Geef null door voor de laatste parameter.
U kunt ook een lijst met verwante bronnen voor een bepaalde bron ophalen door de methode getRelated van het object RepositoryServiceService aan te roepen en de volgende parameters door te geven:
- De URI van de bron waarvoor gerelateerde bronnen moeten worden opgehaald. In dit voorbeeld wordt de bronbron ( "/testFolder/testResource1") opgegeven.
- Een waarde boolean die erop wijst of het gespecificeerde middel de bronmiddel in de verhouding is. In dit voorbeeld wordt de waarde true opgegeven omdat dit het geval is.
- Een waarde boolean die erop wijst of de bronbron werd gespecificeerd. In dit voorbeeld wordt de waarde true 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.
- Geef null door voor de resterende twee parameters.
De getRelated methode keert een serie van voorwerpen terug die aan Resource voorwerpen kunnen worden gegoten waardoor u kunt herhalen om elk van de verwante middelen terug te winnen. In dit voorbeeld wordt verwacht dat testResource2 voorkomt in de lijst met geretourneerde bronnen.

Zie ook

Resourcerelaties maken

Bronnen vergrendelen met de Java API

Bronnen vergrendelen

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.

lr_lr_lockrepository

U kunt de toegang tot bronnen programmatisch beheren met de Java API of webservice van de Repository-service.

OPMERKING

Voor meer informatie over de dienst van de Bewaarplaats, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van stappen

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: "/path/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 webservice-API

Snel starten (SOAP-modus): Een bron vergrendelen met de Java API

Bronnen vergrendelen met de 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

Maak een ResourceRepositoryClient-object door de constructor ervan te gebruiken en een ServiceClientFactory-object door te geven 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 is de URI testResource omdat de bron testFolder zich in de map met de naam "/testFolder/testResource" bevindt. De URI wordt opgeslagen als een java.lang.String-object.
De bron vergrendelen

Roep de methode ResourceRepositoryClient van het object lockResource aan en geef de volgende parameters door:
- De URI van de resource.
- Het vergrendelingsbereik. In dit voorbeeld wordt het vergrendelingsbereik opgegeven als com.adobe.repository.infomodel.bean.Lock.SCOPE_EXCLUSIVE, omdat de bron wordt vergrendeld voor exclusief gebruik.
- De vergrendelingsdiepte. In dit voorbeeld wordt de vergrendelingsdiepte opgegeven als Lock.DEPTH_ZERO, omdat de vergrendeling alleen van toepassing is op de specifieke bron en geen van de leden of onderliggende elementen.
OPMERKING

De overbelaste versie van de methode lockResource die vier parameters vereist werpt een uitzondering. Zorg ervoor om de lockResource methode te gebruiken die drie parameters zoals aangetoond in deze analyse vereist.
Haalt de vergrendelingen voor de bron op

Roep de methode ResourceRepositoryClient van het object getLocks aan en geef de URI van de bron als parameter door. De methode retourneert een lijst met vergrendelingsobjecten waarmee u kunt herhalen. In dit voorbeeld worden de eigenaar, diepte en bereik van de vergrendeling voor elk object afgedrukt door respectievelijk de methoden getOwnerUserId, getDepth en getType van elk Lock-object aan te roepen.
De bron ontgrendelen

Roep de methode ResourceRepositoryClient van het object unlockResource aan en geef de URI van de bron als parameter door. Zie AEM Forms API Reference voor meer informatie.

Zie ook

Bronnen vergrendelen

Bronnen vergrendelen met de webservice-API

Bronnen vergrendelen met behulp van de Repository Service API (webservice):

Projectbestanden opnemen
- Creeer een de cliëntassemblage van Microsoft .NET die de Bewaarplaats WSDL gebruikend Base64 gebruikt.
- Verwijs naar de cliëntassemblage van Microsoft .NET.
De serviceclient maken

Gebruikend de de cliëntassemblage van Microsoft .NET, creeer een RepositoryServiceService voorwerp door zijn standaardaannemer aan te halen. Plaats zijn Credentials bezit gebruikend een System.Net.NetworkCredential voorwerp dat de gebruikersnaam en het wachtwoord bevat.
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 is de URI testResource in de map testFolder. "/testFolder/testResource" Wanneer het gebruiken van een taal volgzaam met het Kader van Microsoft .NET (bijvoorbeeld, C#), sla URI in een System.String voorwerp op.
De bron vergrendelen

Roep de methode RepositoryServiceService van het object lockResource aan en geef de volgende parameters door:
- De URI van de resource.
- Het vergrendelingsbereik. In dit voorbeeld wordt het vergrendelingsbereik opgegeven als 11, omdat de bron wordt vergrendeld voor exclusief gebruik.
- De vergrendelingsdiepte. In dit voorbeeld wordt de vergrendelingsdiepte opgegeven als 2, omdat de vergrendeling alleen van toepassing is op de specifieke bron en geen van de leden of onderliggende elementen.
- Een waarde int die op het aantal seconden wijst tot het slot verloopt. In dit voorbeeld wordt de waarde van 1000 gebruikt.
- Geef null door voor de laatste parameter.
Haalt de vergrendelingen voor de bron op

Roep de methode RepositoryServiceService van het object getLocks aan en geef de URI van de bron door als de eerste parameter en null voor de tweede parameter. De methode retourneert een object-array met Lock-objecten waardoor u kunt herhalen. In dit voorbeeld worden de eigenaar, diepte en bereik van de vergrendeling voor elk object afgedrukt door toegang te krijgen tot de velden ownerUserId, depth en type van elk object.Lock
De bron ontgrendelen

Roep de methode RepositoryServiceService van het object unlockResource aan en geef de URI van de bron door als de eerste parameter en null voor de tweede parameter.

Zie ook

Bronnen vergrendelen

Bronnen verwijderen met de Java API

Bronnen verwijderen

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

OPMERKING

Wanneer u de com.adobe.repository.bindings.dsc.client.ResourceRepositoryClient.deleteResources()-methode gebruikt 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.

OPMERKING

Voor meer informatie over de dienst van de Bewaarplaats, zie Verwijzing van de Diensten voor AEM Forms.

Overzicht van stappen

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: "/path/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 webservice-API

Snel starten (SOAP-modus): Zoeken naar bronnen met de Java API

Bronnen verwijderen met de 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

Maak een ResourceRepositoryClient-object door de constructor ervan te gebruiken en een ServiceClientFactory-object door te geven 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 het middel genoemd testResourceToBeDelette in de omslag genoemd testFolder is, is zijn URI /testFolder/testResourceToBeDeleted. De URI wordt opgeslagen als een java.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 het Schrijven van Middelen.
De bron verwijderen

Roep de methode ResourceRepositoryClient van het object deleteResource aan en geef de URI van de bron als parameter door.

Zie ook

Bronnen verwijderen

Bronnen verwijderen met de webservice-API

Verwijder een bron met de Repository API (webservice):

Projectbestanden opnemen
- Creeer een de cliëntassemblage van Microsoft .NET die de Bewaarplaats WSDL gebruikend Base64 gebruikt.
- Verwijs naar de cliëntassemblage van Microsoft .NET.
De serviceclient maken

Gebruikend de de cliëntassemblage van Microsoft .NET, creeer een RepositoryServiceService voorwerp door zijn standaardaannemer aan te halen. Plaats zijn Credentials bezit gebruikend een System.Net.NetworkCredential voorwerp dat de gebruikersnaam en het wachtwoord 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 is de URI testResourceToBeDeleted omdat de bron testFolder zich in de map met de naam "/testFolder/testResourceToBeDeleted" bevindt. 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 het Schrijven van Middelen.
De bron verwijderen

Roep de methode deleteResources van het object RepositoryServiceService aan en geef een System.String-array door die de URI van de bron als eerste parameter bevat. Geef null door voor de tweede parameter.

Zie ook

Bronnen verwijderen