Arbeta med AEM Forms Repository working-with-aem-forms-repository
Exempel och exempel i det här dokumentet gäller endast för AEM Forms i JEE-miljö.
Om databastjänsten
Databastjänsten tillhandahåller lagringstjänster och hanteringstjänster till AEM Forms. När utvecklare skapar ett AEM Forms -program kan de distribuera resurserna i databasen i stället för i filsystemet. Resurserna kan innehålla alla typer av material, inklusive XML-formulär, PDF forms (inklusive Acrobat-formulär), formulärfragment, bilder, profiler, profiler, SWF-filer, DDX-filer, XML-scheman, WSDL-filer och testdata.
Ta till exempel följande Forms-program med namnet Applications/FormsApplication:
Observera att det finns en fil med namnet Loan.xdp i FormsFolder. Om du vill komma åt den här formulärdesignen anger du den fullständiga sökvägen (inklusive version): Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
.
Sökvägen till en resurs i AEM Forms-databasen:
Applications/Application-name/Application-version/Folder.../Filename
Följande värden visar några exempel på URI-värden:
- Applications/AppraisalReport/1.0/Forms/FullForm.xdp
- Applications/AnotherApp/1.1/Assets/picture.jpg
- Applications/SomeApp/2.0/Resources/Data/XSDs/MyData.xsd
https://[server name]:[server port]/repository
. Du kan verifiera snabbstartsresultat som är kopplade till avsnittet Arbeta med AEM Forms-databas med en webbläsare. Om du till exempel lägger till innehåll i AEM Forms-databasen kan du se innehållet i en webbläsare. (Se Snabbstart (SOAP läge): Skriver en resurs med Java API.)Databas-API:t innehåller flera åtgärder som du kan använda för att lagra och hämta information från databasen. Du kan till exempel få en lista med resurser eller hämta särskilda resurser som lagras i databasen när en resurs behövs som en del av bearbetningen av ett program.
Med hjälp av API:t för databastjänsten kan du utföra följande uppgifter:
- Skapa mappar. Se Skapa mappar.
- Skriv resurser och deras egenskaper. Se Skriver resurser.
- Visa resurser i en viss samling eller som är relaterade till andra resurser. Se Visa resurser.
- Läs resurser och deras egenskaper. Se Läser resurser.
- Uppdatera resurser och deras egenskaper. Se Uppdaterar resurser.
- Sök efter resurser, inklusive historik, relaterade resurser och egenskaper. Se Söka efter resurser.
- Ange relationer mellan resurser. Se Skapa resursrelationer.
- Hantera resursåtkomstkontroll, inklusive låsning och upplåsning av resurser, samt läs- och skrivåtkomstkontrollistor. Se Låsa resurser.
- Ta bort resurser och deras egenskaper. Se Ta bort resurser.
Skapar mappar creating-folders
Mappar (resurssamlingar) används för att lagra objekt (filer eller resurser) i ordnade grupperingar. Mappar kan innehålla resurser och andra mappar, som också kallas undermappar. Resurser kan bara lagras i en mapp i taget.
Filerna ärver åtkomstkontrollistor (ACL:er) från mappar, och undermappar ärver åtkomstkontrollistor från sina överordnade mappar. Därför måste de överordnade mapparna finnas innan du kan skapa underordnade mappar. Med IDE kan du bara interagera mappvis, inte fil för fil. Du kan inte versionsmappar och du behöver inte göra det. En mapp innehåller inga data. I stället är det bara en behållare för resurser som innehåller data. Standard-ACL är behörighet på systemnivå, vilket innebär att användare måste ha behörighet på systemnivå (läsa, skriva, bläddra, hantera åtkomstkontrollistor) tills någon ger dem behörighet för en viss mapp. ACL-listor fungerar bara i den integrerade utvecklingsmiljön.
Sammanfattning av steg summary-of-steps
Så här skapar du en mapp:
- Inkludera projektfiler.
- Skapa tjänstklienten.
- Skapa mappen.
- Skriv mappen till databasen.
Inkludera projektfiler
Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster inkluderar du proxyfilerna.
Skapa tjänstklienten
Innan du kan skapa en resurssamling programmatiskt måste du skapa en anslutning och ange autentiseringsuppgifter. Detta uppnås genom att en tjänstklient skapas.
Skapa mappen
Anropa databastjänstmetoden för att skapa resurssamlingen och fylla i resurssamlingen med identifieringsinformation, inklusive dess UUID, mappnamn och beskrivning.
Skriv mappen i databasen
Anropa databastjänstmetoden för att skriva resurssamlingen och ange målmappens URI.
Se även
Skapa mappar med webbtjänstens API
Skapa mappar med Java API create-folders-using-the-java-api
Skapa en mapp med hjälp av Repository Service API (Java):
-
Inkludera projektfiler
Inkludera projektfiler i Java-projektets klassökväg.
-
Skapa tjänstklienten
Skapa ett
ResourceRepositoryClient
-objekt med hjälp av dess konstruktor och skicka ettServiceClientFactory
-objekt som innehåller anslutningsegenskaper. -
Skapa mappen
Om du vill skapa en resurssamling måste du först skapa ett
com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean
-objekt.Anropa
repositoryInfomodelFactoryBean
-objektetsnewResourceCollection
-metod och skicka följande parametrar:- En
com.adobe.repository.infomodel.Id
UUID-identifierare som ska tilldelas resursen. - En
com.adobe.repository.infomodel.Lid
UUID-identifierare som ska tilldelas resursen. - En
java.lang.String
som innehåller namnet på resurssamlingen. Exempel:FormsFolder
.
Metoden returnerar ett
com.adobe.repository.infomodel.bean.ResourceCollection
-objekt som representerar den nya mappen.Ange mappens beskrivning med metoden
setDescription
och skicka följande parameter:- A
String
that describes the resource collection. I detta exempel används"test Folder"
.
- En
-
Skriv mappen till databasen
Anropa
ResourceRepositoryClient
-objektetswriteResource
-metod och skicka URI:n för mappen ochResourceCollection
-objektet. URI till mappen kan till exempel vara följande värde:/Applications/FormsApplication/1.0/
.Metoden returnerar en instans av det nyskapade
com.adobe.repository.infomodel.bean.Resource
-objektet. Du kan till exempel hämta identifierarvärdet för den nya resursen genom att anropacom.adobe.repository.infomodel.bean.Resource
-objektetsgetId
-metod.
Se även
Snabbstart (SOAP): Skapa en mapp med Java API
Skapa mappar med webbtjänstens API create-folders-using-the-web-service-api
Skapa en mapp med hjälp av Repository-tjänstens API (webbtjänst):
-
Inkludera projektfiler
- Skapa en Microsoft .NET-klientsammansättning som använder databas-WSDL med base64.
- Referera till Microsoft .NET-klientsammansättningen.
-
Skapa tjänstklienten
Skapa ett
RepositoryServiceService
-objekt med Microsoft .NET-klientsammansättningen genom att anropa dess standardkonstruktor. Ange egenskapenCredentials
med ettSystem.Net.NetworkCredential
-objekt som innehåller användarnamnet och lösenordet. -
Skapa mappen
Skapa mappen med standardkonstruktorn för klassen
ResourceCollection
och skicka följande parametrar:- Ett
Id
-objekt, som skapas genom att standardkonstruktorn anropas för klassenId
och tilldelas tillResource
-objektetsid
-fält. - Ett
Lid
-objekt, som skapas genom att standardkonstruktorn anropas för klassenLid
och tilldelas tillResource
-objektetslid
-fält. - En sträng som innehåller namnet på resurssamlingen, som tilldelas till
Resource
-objektetsname
-fält. Namnet som används i det här exemplet är"testfolder"
. - En sträng som innehåller beskrivningen av resurssamlingen, som tilldelas till
Resource
-objektetsdescription
-fält. Beskrivningen i det här exemplet är"test folder"
.
- Ett
-
Skriv mappen till databasen
Anropa
RepositoryServiceService
-objektetswriteResource
-metod och skicka följande parametrar:- Sökvägen till den mapp som ska skapas.
- Objektet
ResourceCollection
som representerar mappen. - Skicka
null
för de andra två parametrarna.
Se även
Skriver resurser writing-resources
Du kan skapa resurser på en viss plats i databasen. Den naturliga filstorleken kan begränsas av databasen och tidsgränsen för sessioner kan överskridas. För standardkonfigurationen är filerna begränsade till 25 MB. Om du vill öka eller minska den maximala filstorleken måste du ändra databaskonfigurationen.
Att skriva resurser motsvarar att lagra data i databasen. När du har skrivit en resurs till databasen blir den tillgänglig för alla klienter i databasens ekosystem. När du skriver resurser, t.ex. XML-scheman, XDP-filer och XSD-filer, till databasen analyseras innehållet baserat på MIME-typen. Om MIME-typen stöds avgör parsern om det finns en underförstådd relation till annat innehåll. Om en CSS (Cascading Style Sheet) till exempel har en relativ URL som refererar till en vanlig CSS-formatmall förväntas du att du även ska skicka den vanliga CSS-koden till databasen. Relationen mellan de två resurserna lagras som en väntande relation under en icke-justerbar period på 30 dagar. När du skickar den vanliga CSS-koden till databasen inom 30 dagar skapas relationen.
När du skapar en resurs ärvs åtkomstkontrollistan (ACL) från den överordnade mappen. Rotmappen har behörighet på systemnivå tills en ursprunglig resurs eller mapp skapas. Då får resursen eller mappen standardbehörigheter för åtkomstkontrollista.
Du kan skriva resurser programmatiskt med hjälp av Java API:t för databastjänsten eller webbtjänstens API.
Sammanfattning av steg summary_of_steps-1
Så här skriver du en resurs:
- Inkludera projektfiler.
- Skapa en databastjänstklient.
- Ange URI för resursen som ska läsas.
- Läs resursen.
Inkludera projektfiler
Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster inkluderar du proxyfilerna.
Skapa tjänstklienten
Innan du kan läsa en resurs programmatiskt måste du skapa en anslutning och ange autentiseringsuppgifter. Detta uppnås genom att en tjänstklient skapas.
Ange URI för målmappen för resursen
Skapa en sträng som innehåller URI:n för resursen som ska läsas. Syntaxen innehåller snedstreck, som i det här exemplet: "/path/folder".
Skapa resursen
Anropa databastjänstmetoden för att skapa resursen och fylla resursen med identifieringsinformation, inklusive dess UUID, resursnamn och beskrivning.
Ange resursinnehållet
Anropa databastjänstmetoden för att skapa resursinnehåll och lagra innehållet i resursen.
Skriv resursen till målmappen
Anropa databastjänstmetoden för att skriva resursen och ange målmappens URI.
Se även
Skriv resurser med webbtjänstens API
Inkludera AEM Forms Java-biblioteksfiler
Snabbstart för databastjänst-API
Skriv resurser med Java API write-resources-using-the-java-api
Skriv en resurs med hjälp av Repository Service API (Java):
-
Inkludera projektfiler
Inkludera JAR-klientfiler i Java-projektets klassökväg.
-
Skapa tjänstklienten
Skapa ett
ResourceRepositoryClient
-objekt med hjälp av dess konstruktor och skicka ettServiceClientFactory
-objekt som innehåller anslutningsegenskaper. -
Ange URI för målmappen för resursen
Ange URI för målmappen för resursen. I det här fallet är mappens URI
"/testFolder"
eftersom resursen med namnettestResource
lagras i mappentestFolder
. URI:n lagras som ettjava.lang.String
-objekt. -
Skapa resursen
Om du vill skapa en resurs måste du först skapa ett
com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean
-objekt.Anropa
RepositoryInfomodelFactoryBean
-objektetsnewResource
-metod, som skapar ettcom.adobe.repository.infomodel.bean.Resource
-objekt. I det här exemplet anges följande parametrar:- Ett
com.adobe.repository.infomodel.Id
-objekt, som skapas genom att standardkonstruktorn för klassenId
anropas. - Ett
com.adobe.repository.infomodel.Lid
-objekt, som skapas genom att standardkonstruktorn för klassenLid
anropas. - En
java.lang.String
som innehåller resursens filnamn.
Om du vill ange resursens beskrivning anropar du
Resource
-objektetssetDescription
-metod och skickar en sträng som innehåller beskrivningen. I detta exempel är beskrivningen"test resource"
. - Ett
-
Ange resursinnehållet
Om du vill skapa innehåll för resursen anropar du
RepositoryInfomodelFactoryBean
-objektetsnewResourceContent
-metod, som returnerar ettcom.adobe.repository.infomodel.bean.ResourceContent
-objekt. Lägg till innehåll i objektetResourceContent
. I det här exemplet genomförs detta genom följande åtgärder:- Anropar
ResourceContent
-objektetssetDataDocument
-metod och skickar ettcom.adobe.idp.Document
-objekt - Anropar
ResourceContent
-objektetssetSize
-metod och skickar storleken i byte förDocument
-objektet
Lägg till innehållet i resursen genom att anropa
Resource
-objektetssetContent
-metod och skickaResourceContent
-objektet. Mer information finns i AEM Forms API Reference. - Anropar
-
Skriv resursen till målmappen
Anropa
ResourceRepositoryClient
-objektetswriteResource
-metod och skicka URI:n för mappen ochResource
-objektet.
Se även
Snabbstart (SOAP): Skriva en resurs med Java API
Skriv resurser med webbtjänstens API write-resources-using-the-web-service-api
Skriv en resurs med hjälp av Repository-tjänstens API (webbtjänst):
-
Inkludera projektfiler
- Skapa en Microsoft .NET-klientsammansättning som använder databas-WSDL med base64.
- Referera till Microsoft .NET-klientsammansättningen.
-
Skapa tjänstklienten
Skapa ett
RepositoryServiceService
-objekt med Microsoft .NET-klientsammansättningen genom att anropa dess standardkonstruktor. Ange egenskapenCredentials
med ettSystem.Net.NetworkCredential
-objekt som innehåller användarnamnet och lösenordet. -
Ange URI för målmappen för resursen
Ange URI för målmappen för resursen. I det här fallet är mappens URI
"/testFolder"
eftersom resursen med namnettestResource
lagras i mappentestFolder
. När du använder ett språk som är kompatibelt med Microsoft .NET Framework (till exempel C#), ska du lagra URI:n i ettSystem.String
-objekt. -
Skapa resursen
Om du vill skapa en resurs anropar du standardkonstruktorn för klassen
Resource
. I det här exemplet lagras följande information i objektetResource
:- Ett
com.adobe.repository.infomodel.Id
-objekt, som skapas genom att standardkonstruktorn anropas för klassenId
och tilldelas tillResource
-objektetsid
-fält. - Ett
com.adobe.repository.infomodel.Lid
-objekt, som skapas genom att standardkonstruktorn anropas för klassenLid
och tilldelas tillResource
-objektetslid
-fält. - En sträng som innehåller resursens filnamn, som är tilldelat
Resource
-objektetsname
-fält. Namnet som används i det här exemplet är"testResource"
. - En sträng som innehåller beskrivningen av resursen, som tilldelas till
Resource
-objektetsdescription
-fält. Beskrivningen i det här exemplet är"test resource"
.
- Ett
-
Ange resursinnehållet
Om du vill skapa innehåll för resursen anropar du standardkonstruktorn för klassen
ResourceContent
. Lägg sedan till innehåll i objektetResourceContent
. I det här exemplet genomförs detta genom följande åtgärder:- Tilldela ett
BLOB
-objekt som innehåller ett dokument tillResourceContent
-objektetsdataDocument
-fält. - Tilldela storleken i byte för objektet
BLOB
till fältetsize
för objektetResourceContent
.
Lägg till innehållet i resursen genom att tilldela objektet
ResourceContent
tillResource
-objektetscontent
-fält. - Tilldela ett
-
Skriv resursen till målmappen
Anropa
RepositoryServiceService
-objektetswriteResource
-metod och skicka URI:n för mappen ochResource
-objektet. Skickanull
för de andra två parametrarna.
Se även
Resurser listas listing-resources
Du kan identifiera resurser genom att lista resurser. En fråga utförs mot databasen för att hitta alla resurser som är relaterade till en given resurssamling.
När du har organiserat dina resurser kan du inspektera strukturen som du skapade genom att se en viss gren av strukturen, precis som i ett operativsystem.
Listresurser hanteras efter relation: resurserna är medlemmar i mappar. Medlemskapet representeras av en relation av typen"medlem av". När du listar resurser i en viss mapp frågar du efter resurser som är relaterade till en viss mapp av relationen "medlem i". Relationer är riktade: en medlem i en relation har en källa som är medlem i målet. Källan är resursen och målet är den överordnade mappen.
Sammanfattning av steg summary_of_steps-2
Följ de här stegen för att visa resurser:
- Inkludera projektfiler.
- Skapa tjänstklienten.
- Ange mappsökvägen.
- Hämta listan med resurser.
Inkludera projektfiler
Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster inkluderar du proxyfilerna.
Skapa tjänstklienten
Innan du kan skapa en resurssamling programmatiskt måste du skapa en anslutning och ange autentiseringsuppgifter. Detta uppnås genom att en tjänstklient skapas.
Ange mappsökvägen
Skapa en sträng som innehåller sökvägen till mappen som innehåller resurserna. Syntaxen innehåller snedstreck, som i det här exemplet: "/path/folder".
Hämta listan med resurser
Anropa databastjänstmetoden för att hämta listan över resurser och ange målmappens sökväg.
Se även
Visa resurser som använder webbtjänstens API
Visa resurser med Java API list-resources-using-the-java-api
Visa resurser med hjälp av Repository Service API (Java):
-
Inkludera projektfiler
Inkludera JAR-klientfiler i Java-projektets klassökväg.
-
Skapa tjänstklienten
Skapa ett
ResourceRepositoryClient
-objekt med hjälp av dess konstruktor och skicka ettServiceClientFactory
-objekt som innehåller anslutningsegenskaper. -
Ange mappsökväg
Ange URI:n för resurssamlingen som ska frågas. I det här fallet är dess URI
"/testFolder"
. URI:n lagras som ettjava.lang.String
-objekt. -
Hämta listan över resurser
Anropa
ResourceRepositoryClient
-objektetslistMembers
-metod och skicka mappens URI.Metoden returnerar
java.util.List
avcom.adobe.repository.infomodel.bean.Resource
objekt som är källan till encom.adobe.repository.infomodel.bean.Relation
av typenRelation.TYPE_MEMBER_OF
och har resurssamlings-URI som mål. Du kan iterera genom dennaList
för att hämta varje resurs. I det här exemplet visas namn och beskrivning för varje resurs.
Se även
Snabbstart (SOAP): Visa resurser med Java API
Inkludera AEM Forms Java-biblioteksfiler
Visa resurser som använder webbtjänstens API list-resources-using-the-web-service-api
Visa resurser med hjälp av Repository-tjänstens API (webbtjänst):
-
Inkludera projektfiler
- Skapa en Microsoft .NET-klientsammansättning som använder WSDL för databasen.
- Referera till Microsoft .NET-klientsammansättningen.
-
Skapa tjänstklienten
Skapa ett
RepositoryServiceService
-objekt med Microsoft .NET-klientsammansättningen genom att anropa dess standardkonstruktor. Ange egenskapenCredentials
med ettSystem.Net.NetworkCredential
-objekt som innehåller användarnamnet och lösenordet. -
Ange mappsökväg
Ange en sträng som innehåller URI:n för mappen som ska efterfrågas. I det här fallet är dess URI
"/testFolder"
. När du använder ett språk som är kompatibelt med Microsoft .NET Framework (till exempel C#), ska du lagra URI:n i ettSystem.String
-objekt. -
Hämta listan över resurser
Anropa
RepositoryServiceService
-objektetslistMembers
-metod och skicka URI:n för mappen som den första parametern. Skickanull
för de andra två parametrarna.Metoden returnerar en array med objekt som kan bytas till
Resource
-objekt. Du kan iterera genom objektarrayen för att hämta de relaterade resurserna. I det här exemplet visas namn och beskrivning för varje resurs.
Se även
Läser resurser reading-resources
Du kan hämta resurser från en viss plats i databasen för att läsa deras innehåll och metadata. Arbetsflödet avslutas av ett initieringsformulär. Processen har alla behörigheter som krävs för att läsa formuläret. Systemet hämtar dataformuläret och läser innehållet från databasen. Databasen ger åtkomst till innehållet och metadata (möjlighet att ens veta att resursen finns).
Databasen har följande fyra behörighetstyper:
- gå igenom: gör att du kan lista resurser, d.v.s. läsa resursmetadata, men inte resursinnehåll
- read: gör att du kan läsa resursinnehåll
- skriv: låter dig skriva resursinnehåll
- hantera åtkomstkontrollistor: gör att du kan ändra åtkomstkontrollistor på resurser
Användare kan bara köra processer om de har behörighet att köra processen. IDE-användare behöver gå igenom och läsa behörigheter för att synkronisera med databasen. ACL-listor används endast i designläge eftersom körning sker i systemkontexten.
Du kan läsa resurser programmatiskt med hjälp av Java API:t för databastjänsten eller webbtjänstens API.
Sammanfattning av steg summary_of_steps-3
Så här läser du en resurs:
- Inkludera projektfiler.
- Skapa en databastjänstklient.
- Ange URI för resursen som ska läsas.
- Läs resursen.
Inkludera projektfiler
Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster inkluderar du proxyfilerna.
Skapa tjänstklienten
Innan du kan läsa en resurs programmatiskt måste du skapa en anslutning och ange autentiseringsuppgifter. Detta uppnås genom att en tjänstklient skapas.
Ange URI för resursen som ska läsas
Skapa en sträng som innehåller URI:n för resursen som ska läsas. Syntaxen innehåller snedstreck, som i det här exemplet: "/path/resource".
Läs resursen
Anropa databastjänstmetoden för att läsa resursen och ange URI:n.
Se även
Läsa resurser med hjälp av webbtjänstens API
Läs resurser med Java API read-resources-using-the-java-api
Läs en resurs med hjälp av Repository Service API (Java):
-
Inkludera projektfiler
Inkludera JAR-klientfiler i Java-projektets klassökväg.
-
Skapa tjänstklienten
Skapa ett
ResourceRepositoryClient
-objekt med hjälp av dess konstruktor och skicka ettServiceClientFactory
-objekt som innehåller anslutningsegenskaper. -
Ange URI för resursen som ska läsas
Ange ett strängvärde som representerar URI:n för resursen som ska hämtas. Om resursen till exempel heter testResource som finns i en mapp med namnet testFolder anger du
/testFolder/testResource
. -
Läs resursen
Anropa
ResourceRepositoryClient
-objektetsreadResource
-metod och skicka resursens URI som en parameter. Den här metoden returnerar enResource
-instans som representerar resursen.
Se även
Snabbstart (SOAP): Läsa en resurs med Java API
Inkludera AEM Forms Java-biblioteksfiler
Läsa resurser med hjälp av webbtjänstens API reading-resources-using-the-web-service-api
Läs en resurs med hjälp av Repository Service API (webbtjänsten):
-
Inkludera projektfiler
- Skapa en Microsoft .NET-klientsammansättning som använder WSDL för databasen. (Se Skapa en .NET-klientsammansättning som använder Base64-kodning.)
- Referera till Microsoft .NET-klientsammansättningen. (Se Skapa en .NET-klientsammansättning som använder Base64-kodning.)
-
Skapa tjänstklienten
Skapa ett
RepositoryServiceService
-objekt med Microsoft .NET-klientsammansättningen genom att anropa dess standardkonstruktor. Ange egenskapenCredentials
med ettSystem.Net.NetworkCredential
-objekt som innehåller användarnamnet och lösenordet. -
Ange URI för resursen som ska läsas
Ange en sträng som innehåller URI:n för resursen som ska hämtas. I det här fallet är resursen
testResource
"/testFolder/testResource"
eftersom den finns i mappentestFolder
. När du använder ett språk som är kompatibelt med Microsoft .NET Framework (till exempel C#), ska du lagra URI:n i ettSystem.String
-objekt. -
Läs resursen
Anropa
RepositoryServiceService
-objektetsreadResource
-metod och skicka URI:n för resursen som den första parametern. Skickanull
för de andra två parametrarna.
Se även
Uppdaterar resurser updating-resources
Du kan hämta och uppdatera innehållet för resurser i databasen. När du uppdaterar resurser ändras inte åtkomstkontrollen för dessa resurser mellan versionerna. När du utför en uppdatering kan du välja att öka huvudversionen. Om du inte väljer att öka den större versionen uppdateras den mindre versionen automatiskt.
När du uppdaterar en resurs skapas den nya versionen baserat på de angivna resursattributen. När du uppdaterar en resurs anger du två viktiga parametrar: mål-URI och en resursinstans som innehåller alla uppdaterade metadata. Observera att om du inte ändrar ett visst attribut (till exempel namnet), krävs fortfarande attributet i den instans som du skickar in. De relationer som skapas när innehållet tolkas läggs till i den specifika versionen och överförs inte framåt om inte annat anges.
Om du till exempel uppdaterar en XDP-fil och den innehåller referenser till andra resurser, spelas även dessa ytterligare referenser in. Anta att form.xdp version 1.0 har två externa referenser: en logotyp och en formatmall. Därefter uppdaterar du form.xdp så att den nu har tre referenser: en logotyp, en formatmall och en schemafil. Under uppdateringen lägger databasen till den tredje relationen (till schemafilen) i den väntande relationstabellen. När schemafilen finns i databasen kommer relationen automatiskt att formas. Om form.xdp version 2.0 inte längre använder logotypen kommer form.xdp version 2.0 inte att ha något samband med logotypen.
Alla uppdateringsåtgärder är atomiska och transaktionella. Om två användare till exempel läser samma resurs och båda beslutar att uppdatera version 1.0 till version 2.0, kommer en av dem att lyckas och en av dem kommer att misslyckas, databasens integritet kommer att bevaras och båda får ett meddelande som bekräftar att åtgärden lyckades eller misslyckades. Om transaktionen inte genomförs återställs den om det uppstår ett databasfel och timeout eller återställning inträffar beroende på programservern.
Du kan uppdatera resurser programmatiskt med hjälp av Java API:t för databastjänsten eller webbtjänstens API.
Sammanfattning av steg summary_of_steps-4
Så här uppdaterar du en resurs:
- Inkludera projektfiler.
- Skapa en databastjänstklient.
- Hämta resursen som ska uppdateras.
- Uppdatera resursen.
Inkludera projektfiler
Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster inkluderar du proxyfilerna.
Skapa tjänstklienten
Innan du kan läsa en resurs programmatiskt måste du skapa en anslutning och ange autentiseringsuppgifter. Detta uppnås genom att en tjänstklient skapas.
Hämta resursen som ska uppdateras
Läs resursen. Mer information finns i Läser resurser.
Uppdatera resursen
Ange den nya informationen i resursen och anropa databastjänstmetoden för att uppdatera resursen, ange URI, den uppdaterade resursen och hur versionsinformationen ska uppdateras.
Se även
Uppdatera resurser med Java API
Uppdatera resurser med webbtjänstens API
Inkludera AEM Forms Java-biblioteksfiler
Snabbstart för databastjänst-API
Uppdatera resurser med Java API update-resources-using-the-java-api
Uppdatera en resurs med hjälp av Repository Service API (Java):
-
Inkludera projektfiler
Inkludera JAR-klientfiler i Java-projektets klassökväg.
-
Skapa tjänstklienten
Skapa ett
ResourceRepositoryClient
-objekt med hjälp av dess konstruktor och skicka ettServiceClientFactory
-objekt som innehåller anslutningsegenskaper. -
Hämta resursen som ska uppdateras
Ange URI för resursen som ska hämtas och läsas. I det här exemplet är resursens URI
"/testFolder/testResource"
. -
Uppdatera resursen
Uppdatera
Resource
-objektets information. I det här exemplet uppdaterar du beskrivningen genom att anropaResource
-objektetssetDescription
-metod och skicka den nya beskrivningssträngen som en parameter.Anropa sedan
ServiceClientFactory
-objektetsupdateResource
-metod och skicka följande parametrar:- Ett
java.lang.String
-objekt som innehåller resursens URI. - Objektet
Resource
som innehåller den uppdaterade resursinformationen. - Ett
boolean
-värde som anger om huvudversionen eller delversionen ska uppdateras. I det här exemplet skickas värdettrue
för att ange att huvudversionen ska ökas.
- Ett
Se även
Snabbstart (SOAP): Uppdatera en resurs med Java API
Uppdatera resurser med webbtjänstens API update-resources-using-the-web-service-api
Uppdatera en resurs med hjälp av Repository API (webbtjänsten):
-
Inkludera projektfiler
- Skapa en Microsoft .NET-klientsammansättning som använder WSDL för databasen.
- Referera till Microsoft .NET-klientsammansättningen.
-
Skapa tjänstklienten
Skapa ett
RepositoryServiceService
-objekt med Microsoft .NET-klientsammansättningen genom att anropa dess standardkonstruktor. Ange egenskapenCredentials
med ettSystem.Net.NetworkCredential
-objekt som innehåller användarnamnet och lösenordet. -
Hämta resursen som ska uppdateras
Ange URI för resursen som ska hämtas och läsa resursen. I det här exemplet är resursens URI
"/testFolder/testResource"
. Mer information finns i Läser resurser. -
Uppdatera resursen
Uppdatera
Resource
-objektets information. I det här exemplet uppdaterar du beskrivningen genom att tilldela ett nytt värde tillResource
-objektetsdescription
-fält. -
Anropa
RepositoryServiceService
-objektetsupdateResource
-metod och skicka följande parametrar:- Ett
System.String
-objekt som innehåller resursens URI. - Objektet
Resource
som innehåller den uppdaterade resursinformationen. - Ett
boolean
-värde som anger om huvudversionen eller delversionen ska uppdateras. I det här exemplet skickas värdettrue
för att ange att huvudversionen ska ökas. - Skicka
null
för de återstående två parametrarna.
- Ett
Se även
Söker efter resurser searching-for-resources
Du kan skapa frågor som används för att söka efter resurser i databasen, inklusive historik, relaterade resurser och egenskaper.
Du kan hämta relaterade resurser för att fastställa beroenden mellan ett formulär och dess fragment. Om du till exempel har ett formulär kan du avgöra vilka fragment eller externa resurser som används. Om du har en bild kan du även ta reda på vilka formulär som använder bilden. Du kan också söka efter relaterade resurser med filtrering baserat på egenskaper. Du kan t.ex. söka efter alla formulär som använder en bild med ett visst namn, eller hitta en bild som används av ett formulär med ett visst namn. Du kan också söka med hjälp av resursegenskaper. Du kan till exempel utföra en fråga för att hitta alla formulär eller resurser vars namn börjar med en sträng som kan innehålla jokertecknen"%" och"_". Kom ihåg att sökningar som baseras på egenskaper inte baseras på relationer. Sådana sökningar baseras på antagandet att du har specifik kunskap om en viss resurs.
Frågesatser
En fråga innehåller en eller flera satser som är logiskt kopplade med villkor. En programsats består av en vänster operand, en operator och en höger operand. Dessutom kan du ange den sorteringsordning som ska användas för sökresultaten. sorteringsordningen innehåller information som motsvarar en SQL ORDER BY
-sats och består av element som innehåller de attribut som sökningen baseras på och ett värde som anger om stigande eller fallande ordning ska användas.
Du kan programmässigt söka efter resurser med Java API:t för databastjänsten. För närvarande går det inte att använda webbtjänstens API för att söka efter resurser.
Sorteringsbeteende
Sorteringsordningen respekteras inte när ResourceRepositoryClient
-objektets searchProperties
-metod anropas och en sorteringsordning anges. Anta till exempel att du skapar en resurs med tre anpassade egenskaper, där attributnamnen är name
, secondName
och asecondName
. Sedan skapar du ett sorteringsordselement i attributnamnet och ställer in värdet ascending
på true
.
Sedan anropar du ResourceRepositoryClient
-objektets searchProperties
-metod och skickar i sorteringsordningen. Sökningen returnerar rätt resurs med de tre egenskaperna. Egenskaperna sorteras dock inte efter attributnamn. De returneras i den ordning som de lades till: name
, secondName
och asecondName
.
Sammanfattning av steg summary_of_steps-5
Så här söker du efter resurser:
- Inkludera projektfiler.
- Skapa en databastjänstklient.
- Ange målmappen för sökningen.
- Ange de attribut som används i sökningen.
- Skapa frågan som används i sökningen.
- Skapa sorteringsordningen för sökresultaten.
- Sök efter resurserna.
- Hämta resurserna från sökresultatet.
Inkludera projektfiler
Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster inkluderar du proxyfilerna.
Skapa tjänstklienten
Innan du kan läsa en resurs programmatiskt måste du skapa en anslutning och ange autentiseringsuppgifter. Detta uppnås genom att en tjänstklient skapas.
Ange målmapp för sökningen
Skapa en sträng som innehåller den grundsökväg som sökningen ska utföras från. Syntaxen innehåller snedstreck, som i det här exemplet: "/path/folder".
Ange de attribut som används i sökningen
Du kan basera sökningen på attributen i resurserna. Ange värdena för attributen som sökningen ska utföras på.
Skapa frågan som används i sökningen
Skapa en fråga med hjälp av satser och villkor. Varje programsats anger vilket attribut sökningen ska baseras på, vilket villkor som ska användas och vilket attributvärde som ska användas i sökningen.
Skapa sorteringsordningen för sökresultaten
Sorteringsordningen består av element, som vart och ett innehåller ett av attributen som används i sökningen och ett värde som anger om stigande eller fallande ordning ska användas.
Sök efter resurserna
Sök efter resurser med hjälp av mappen, frågan och sorteringsordningen. Ange dessutom sökningens djup och en övre gräns för hur många resultat som ska returneras.
Hämta resurserna från sökresultatet
Iterera genom den returnerade resurslistan och extrahera informationen för vidare bearbetning.
Se även
Sök efter resurser med Java API
Sök efter resurser med Java API search-for-resources-using-the-java-api
Sök efter en resurs med hjälp av Repository Service API (Java):
-
Inkludera projektfiler
Inkludera JAR-klientfiler i Java-projektets klassökväg.
-
Skapa tjänstklienten
Skapa ett
ResourceRepositoryClient
-objekt med hjälp av dess konstruktor och skicka ettServiceClientFactory
-objekt som innehåller anslutningsegenskaper. -
Ange målmapp för sökningen
Ange URI:n för bassökvägen som sökningen ska utföras från. I det här exemplet är resursens URI
/testFolder
. -
Ange de attribut som används i sökningen
Ange värdena för attributen som sökningen ska utföras på. Attributen finns i ett
com.adobe.repository.infomodel.bean.Resource
-objekt. I det här exemplet utförs sökningen på name-attributet. Därför används enjava.lang.String
som innehållerResource
-objektets namn, som i det här fallet ärtestResource
. -
Skapa frågan som används i sökningen
Om du vill skapa en fråga skapar du ett
com.adobe.repository.query.Query
-objekt genom att anropa standardkonstruktorn för klassenQuery
och lägger till satser i frågan.Om du vill skapa en sats anropar du konstruktorn för klassen
com.adobe.repository.query.Query.Statement
och skickar följande parametrar:- En vänsteroperand som innehåller resursattributskonstanten. I det här exemplet används det statiska värdet
Resource.ATTRIBUTE_NAME
eftersom resursens namn används som grund för sökningen. - En operator som innehåller villkoret som används i sökningen efter attributet. Operatorn måste vara en av de statiska konstanterna i klassen
Query.Statement
. I det här exemplet används det statiska värdetQuery.Statement.OPERATOR_BEGINS_WITH
. - En högeroperand som innehåller attributvärdet som sökningen ska utföras på. I det här exemplet används name-attributet,
String
, som innehåller värdet"testResource"
.
Ange namnutrymmet för den vänstra operanden genom att anropa
Query.Statement
-objektetssetNamespace
-metod och skicka ett av de statiska värdena i klassencom.adobe.repository.infomodel.bean.ResourceProperty
. I detta exempel användsResourceProperty.RESERVED_NAMESPACE_REPOSITORY
.Lägg till varje sats i frågan genom att anropa
Query
-objektetsaddStatement
-metod och skickaQuery.Statement
-objektet. - En vänsteroperand som innehåller resursattributskonstanten. I det här exemplet används det statiska värdet
-
Skapa sorteringsordningen för sökresultaten
Om du vill ange den sorteringsordning som används i sökresultaten skapar du ett
com.adobe.repository.query.sort.SortOrder
-objekt genom att anropa standardkonstruktorn för klassenSortOrder
och lägger till element i sorteringsordningen.Om du vill skapa ett element för sorteringsordningen anropar du en av konstruktorerna för klassen
com.adobe.repository.query.sort.SortOrder.Element
. I det här exemplet används det statiska värdetResource.ATTRIBUTE_NAME
som den första parametern eftersom resursens namn används som bas för sökningen, och stigande ordning (värdetboolean
ärtrue
) anges som den andra parametern.Lägg till varje element i sorteringsordningen genom att anropa
SortOrder
-objektetsaddSortElement
-metod och skickaSortOrder.Element
-objektet. -
Sök efter resurser
Om du vill söka efter
resources
baserat på attributegenskaper anropar duResourceRepositoryClient
-objektetssearchProperties
-metod och skickar följande parametrar:- En
String
som innehåller bassökvägen som sökningen ska utföras från. I det här fallet används"/testFolder"
. - Frågan som används i sökningen.
- Sökningens djup. I det här fallet används
com.adobe.repository.infomodel.bean.ResourceCollection.DEPTH_INFINITE
för att ange att bassökvägen och alla dess mappar ska användas. - Ett
int
-värde som anger den första raden från vilken den ej växlade resultatmängden ska väljas. I det här exemplet har0
angetts. - Ett
int
-värde som anger det maximala antalet resultat som ska returneras. I det här exemplet har10
angetts. - Sorteringsordningen som används i sökningen.
Metoden returnerar
java.util.List
avResource
objekt i den angivna sorteringsordningen. - En
-
Hämta resurserna från sökresultatet
Om du vill hämta resurserna i sökresultatet itererar du genom
List
och konverterar varje objekt tillResource
för att extrahera informationen. I det här exemplet visas namnet på varje resurs.
Se även
Snabbstart (SOAP): Söka efter resurser med Java API
Skapar resursrelationer creating-resource-relationships
Du kan ange relationer mellan resurser i databasen. Det finns tre typer av relationer:
- Beroende: en relation där en resurs är beroende av andra resurser, vilket innebär att alla relaterade resurser behövs i databasen.
- Medlemskap (filsystem): en relation där en resurs finns i en angiven mapp.
- Anpassad: en relation som du anger mellan resurser. Om till exempel en resurs har tagits bort och en annan resurs har introducerats i databasen, kan du ange en egen ersättningsrelation.
Du kan skapa egna anpassade relationer. Om du till exempel lagrar en HTML-fil i databasen och en bild används, kan du ange en anpassad relation för att relatera HTML-filen till bilden (eftersom normalt bara XML-filer associeras med bilder som använder en databasdefinierad beroenderelation). Ett annat exempel på en anpassad relation är om du vill skapa en annan vy av databasen med en cyklisk diagramstruktur i stället för en trädstruktur. Du kan definiera ett cirkeldiagram tillsammans med ett visningsprogram för att gå igenom dessa relationer. Slutligen kan du ange att en resurs ersätter en annan resurs trots att de två resurserna är helt olika. I så fall kan du definiera en relationstyp utanför det reserverade intervallet och skapa en relation mellan dessa två resurser. Ditt program skulle vara den enda klienten som kunde identifiera och bearbeta relationen och det skulle kunna användas för att utföra sökningar i relationen.
Du kan programmatiskt ange relationer mellan resurser med Java API:t för databastjänsten eller webbtjänstens API.
Sammanfattning av steg summary_of_steps-6
Så här anger du en relation mellan två resurser:
- Inkludera projektfiler.
- Skapa en databastjänstklient.
- Ange URI:erna för resurserna som ska relateras.
- Skapa relationen.
Inkludera projektfiler
Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster inkluderar du proxyfilerna.
Skapa tjänstklienten
Innan du kan läsa en resurs programmatiskt måste du skapa en anslutning och ange autentiseringsuppgifter. Detta uppnås genom att en tjänstklient skapas.
Ange URI:er för resurserna som ska relateras
Skapa strängar som innehåller URI:erna för resursen som ska relateras. Syntaxen innehåller snedstreck, som i det här exemplet: "/path/resource".
Skapa relationen
Anropa databastjänstmetoden för att skapa och ange relationstypen.
Se även
Skapa relationsresurser med Java API
Skapa relationsresurser med hjälp av webbtjänstens API
Inkludera AEM Forms Java-biblioteksfiler
Snabbstart för databastjänst-API
Skapa relationsresurser med Java API create-relationship-resources-using-the-java-api
Skapa relationsresurser genom att använda Java API för databastjänsten och utföra följande uppgifter:
-
Inkludera projektfiler
Inkludera JAR-klientfiler i Java-projektets klassökväg.
-
Skapa tjänstklienten
Skapa ett
ResourceRepositoryClient
-objekt med hjälp av dess konstruktor och skicka ettServiceClientFactory
-objekt som innehåller anslutningsegenskaper. -
Ange URI:erna för resurserna som ska relateras
Ange URI:erna för resurserna som ska relateras. I det här fallet, eftersom resurserna har namnen
testResource1
ochtestResource2
och finns i mappentestFolder
, är deras URI:er"/testFolder/testResource1"
och"/testFolder/testResource2"
. URI:erna lagras som ettjava.lang.String
-objekt. I det här exemplet skrivs resurserna först till databasen och deras URI:er hämtas. Mer information om hur du skriver en resurs finns i Skriva resurser. -
Skapa relationen
Anropa
ResourceRepositoryClient
-objektetscreateRelationship
-metod och skicka följande parametrar:- Källresursens URI.
- Målresursens URI.
- Relationstypen, som är en av de statiska konstanterna i klassen
com.adobe.repository.infomodel.bean.Relation
. I det här exemplet upprättas en beroenderelation genom att ange värdetRelation.TYPE_DEPENDANT_OF
. - Ett
boolean
-värde som anger om målresursen automatiskt uppdateras till dencom.adobe.repository.infomodel.Id
-baserade identifieraren för den nya huvudresursen. I det här exemplet anges värdettrue
på grund av beroenderelationen.
Du kan också hämta en lista över relaterade resurser för en given resurs genom att anropa
ResourceRepositoryClient
-objektetsgetRelated
-metod och skicka följande parametrar:- URI för resursen som relaterade resurser ska hämtas för. I det här exemplet har källresursen (
"/testFolder/testResource1"
) angetts. - Ett
boolean
-värde som anger om den angivna resursen är källresursen i relationen. I det här exemplet anges värdettrue
eftersom så är fallet. - Relationstypen, som är en av de statiska konstanterna i klassen
Relation
. I det här exemplet anges en beroenderelation med samma värde som användes tidigare:Relation.TYPE_DEPENDANT_OF
.
Metoden
getRelated
returnerarjava.util.List
avResource
objekt genom vilka du kan iterera för att hämta alla relaterade resurser och omvandla objekten iList
tillResource
när du gör det. I det här exemplet förväntastestResource2
finnas i listan över returnerade resurser.
Se även
Snabbstart (SOAP läge): Skapa relationer mellan resurser med Java API
Skapa relationsresurser med hjälp av webbtjänstens API create-relationship-resources-using-the-web-service-api
Skapa relationsresurser med hjälp av Repository API (webbtjänsten):
-
Inkludera projektfiler
- Skapa en Microsoft .NET-klientsammansättning som använder WSDL för databasen.
- Referera till Microsoft .NET-klientsammansättningen.
-
Skapa tjänstklienten
Skapa ett
RepositoryServiceService
-objekt med Microsoft .NET-klientsammansättningen genom att anropa dess standardkonstruktor. Ange egenskapenCredentials
med ettSystem.Net.NetworkCredential
-objekt som innehåller användarnamnet och lösenordet. -
Ange URI:erna för resurserna som ska relateras
Ange URI:erna för resurserna som ska relateras. I det här fallet, eftersom resurserna har namnen
testResource1
ochtestResource2
och finns i mappentestFolder
, är deras URI:er"/testFolder/testResource1"
och"/testFolder/testResource2"
. När du använder ett språk som är kompatibelt med Microsoft .NET Framework (till exempel C#), lagras URI:erna som ettSystem.String
-objekt. I det här exemplet skrivs resurserna först till databasen och deras URI:er hämtas. Mer information om hur du skriver en resurs finns i Skriva resurser. -
Skapa relationen
Anropa
RepositoryServiceService
-objektetscreateRelationship
-metod och skicka följande parametrar:- Källresursens URI.
- Målresursens URI.
- Relationstypen. I det här exemplet upprättas en beroenderelation genom att ange värdet
3
. - Ett
boolean
-värde som anger om relationstypen har angetts. I det här exemplet har värdettrue
angetts. - Ett
boolean
-värde som anger om målresursen automatiskt uppdateras till denId
-baserade identifieraren för den nya huvudresursen. I det här exemplet anges värdettrue
på grund av beroenderelationen. - Ett
boolean
-värde som anger om målhuvudet har angetts. I det här exemplet har värdettrue
angetts. - Skicka
null
för den sista parametern.
Du kan också hämta en lista över relaterade resurser för en given resurs genom att anropa
RepositoryServiceService
-objektetsgetRelated
-metod och skicka följande parametrar:- URI för resursen som relaterade resurser ska hämtas för. I det här exemplet har källresursen (
"/testFolder/testResource1"
) angetts. - Ett
boolean
-värde som anger om den angivna resursen är källresursen i relationen. I det här exemplet anges värdettrue
eftersom så är fallet. - Ett
boolean
-värde som anger om källresursen har angetts. I det här exemplet anges värdettrue
. - En array med heltal som innehåller relationstyperna. I det här exemplet har en beroenderelation angetts genom att använda samma värde i arrayen som användes tidigare:
3
. - Skicka
null
för de återstående två parametrarna.
Metoden
getRelated
returnerar en array med objekt som kan konverteras tillResource
-objekt genom vilka du kan iterera för att hämta de relaterade resurserna. I det här exemplet förväntastestResource2
finnas i listan över returnerade resurser.
Se även
Låser resurser locking-resources
Du kan låsa en resurs eller en uppsättning resurser så att de bara kan användas av en viss användare eller för delad användning av flera användare. Ett delat lås är en indikation på att något kommer att hända med resursen, men det förhindrar inte någon annan från att vidta åtgärder med den resursen. Ett delat lås bör betraktas som en signaleringsmekanism. Ett exklusivt lås innebär att den användare som låste resursen kommer att ändra resursen och låset garanterar att ingen annan kan göra det förrän användaren inte längre behöver åtkomst till resursen och har släppt låset. Om en databasadministratör låser upp en resurs tas alla exklusiva och delade lås bort automatiskt för den resursen. Den här typen av åtgärd är avsedd för situationer där en användare inte längre är tillgänglig och inte har låst upp resursen.
När en resurs är låst visas en låsikon när du visar fliken Resurser i Workbench, vilket visas på följande bild.
Du kan programmässigt styra åtkomsten till resurser med hjälp av Java API:t för databastjänsten eller webbtjänstens API.
Sammanfattning av steg summary_of_steps-7
Så här låser du och låser upp resurser:
- Inkludera projektfiler.
- Skapa en databastjänstklient.
- Ange URI för resursen som ska låsas.
- Lås resursen.
- Hämta låsen för resursen.
- Lås upp resursen
Inkludera projektfiler
Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster inkluderar du proxyfilerna.
Skapa tjänstklienten
Innan du kan läsa en resurs programmatiskt måste du skapa en anslutning och ange autentiseringsuppgifter. Detta uppnås genom att en tjänstklient skapas.
Ange URI för resursen som ska låsas
Skapa en sträng som innehåller URI:n för resursen som ska låsas. Syntaxen innehåller snedstreck, som i det här exemplet: "/path/resource".
Lås resursen
Anropa databastjänstmetoden för att låsa resursen, ange URI, typ av lås och låsningsdjup.
Hämta låsen för resursen
Anropa databastjänstmetoden för att hämta låsen för resursen och ange URI:n.
Lås upp resursen
Anropa databastjänstmetoden för att låsa upp resursen och ange URI:n.
Se även
Lås resurser med webbtjänstens API
Lås resurser med Java API lock-resources-using-the-java-api
Lås resurser med hjälp av Repository Service API (Java):
-
Inkludera projektfiler
Inkludera JAR-klientfiler i Java-projektets klassökväg.
-
Skapa tjänstklienten
Skapa ett
ResourceRepositoryClient
-objekt med hjälp av dess konstruktor och skicka ettServiceClientFactory
-objekt som innehåller anslutningsegenskaper. -
Ange URI för resursen som ska låsas
Ange URI för resursen som ska låsas. I det här fallet är resursen
testResource
"/testFolder/testResource"
eftersom den finns i mappentestFolder
. URI:n lagras som ettjava.lang.String
-objekt. -
Lås resursen
Anropa
ResourceRepositoryClient
-objektetslockResource
-metod och skicka följande parametrar:- Resursens URI.
- Låsomfånget. I det här exemplet anges låsomfånget som
com.adobe.repository.infomodel.bean.Lock.SCOPE_EXCLUSIVE
eftersom resursen kommer att låsas exklusivt. - Låsdjupet. I det här exemplet anges låsningsdjupet som
Lock.DEPTH_ZERO
eftersom låsning endast gäller för den aktuella resursen och ingen av dess medlemmar eller underordnade.
note note NOTE Den överlagrade versionen av metoden lockResource
som kräver fyra parametrar genererar ett undantag. Se till att använda metodenlockResource
som kräver tre parametrar som visas i genomgången. -
Hämta låsen för resursen
Anropa
ResourceRepositoryClient
-objektetsgetLocks
-metod och skicka resursens URI som en parameter. Metoden returnerar en List med Lock-objekt som du kan iterera igenom. I det här exemplet skrivs låsägaren, djupet och omfånget ut för varje objekt genom att anropa varje Lock-objektsgetOwnerUserId
-,getDepth
- respektivegetType
-metoder. -
Lås upp resursen
Anropa
ResourceRepositoryClient
-objektetsunlockResource
-metod och skicka resursens URI som en parameter. Mer information finns i AEM Forms API Reference.
Se även
Snabbstart (SOAP): Låsa en resurs med Java API
Lås resurser med webbtjänstens API lock-resources-using-the-web-service-api
Lås resurser med hjälp av Repository-tjänstens API (webbtjänst):
-
Inkludera projektfiler
- Skapa en Microsoft .NET-klientsammansättning som förbrukar WSDL för databasen med Base64.
- Referera till Microsoft .NET-klientsammansättningen.
-
Skapa tjänstklienten
Skapa ett
RepositoryServiceService
-objekt med Microsoft .NET-klientsammansättningen genom att anropa dess standardkonstruktor. Ange egenskapenCredentials
med ettSystem.Net.NetworkCredential
-objekt som innehåller användarnamnet och lösenordet. -
Ange URI för resursen som ska låsas
Ange en sträng som innehåller URI:n för resursen som ska låsas. I det här fallet är resursen
testResource
"/testFolder/testResource"
eftersom den finns i mappentestFolder
. När du använder ett språk som är kompatibelt med Microsoft .NET Framework (till exempel C#), ska du lagra URI:n i ettSystem.String
-objekt. -
Lås resursen
Anropa
RepositoryServiceService
-objektetslockResource
-metod och skicka följande parametrar:- Resursens URI.
- Låsomfånget. I det här exemplet anges låsomfånget som
11
eftersom resursen kommer att låsas exklusivt. - Låsdjupet. I det här exemplet anges låsningsdjupet som
2
eftersom låsning endast gäller för den aktuella resursen och ingen av dess medlemmar eller underordnade. - Ett
int
-värde som anger antalet sekunder tills låset upphör att gälla. I det här exemplet används värdet1000
. - Skicka
null
för den sista parametern.
-
Hämta låsen för resursen
Anropa
RepositoryServiceService
-objektetsgetLocks
-metod och skicka resursens URI som den första parametern ochnull
för den andra parametern. Metoden returnerar enobject
-array som innehållerLock
objekt som du kan iterera igenom. I det här exemplet skrivs låsägaren, djupet och omfånget ut för varje objekt genom att varjeLock
-objektsownerUserId
-,depth
- respektivetype
-fält öppnas. -
Lås upp resursen
Anropa
RepositoryServiceService
-objektetsunlockResource
-metod och skicka resursens URI som den första parametern ochnull
för den andra parametern.
Se även
Resurser tas bort deleting-resources
Du kan ta bort resurser från en viss plats i databasen med hjälp av Java API(SOAP) för databastjänsten.
När du tar bort en resurs är borttagningen vanligtvis permanent, men i vissa fall kan ECM-databaser lagra resursens versioner enligt deras historikmekanismer. När du tar bort en resurs är det därför viktigt att du aldrig behöver den igen. De vanligaste skälen till att en resurs tas bort är behovet av att öka det tillgängliga utrymmet i databasen. Du kan ta bort en version av en resurs, men om du gör det måste du ange resursidentifieraren och inte dess logiska identifierare (LID) eller sökväg. Om du tar bort en mapp tas allt i den mappen, inklusive undermappar och resurser, bort automatiskt.
Relaterade resurser tas inte bort. Om du till exempel har ett formulär som använder filen logo.gif och du tar bort logo.gif, lagras en relation i den väntande relationstabellen. Du kan också ange att objektstatusen för den senaste versionen ska vara inaktuell för borttagning av version.
En raderingsåtgärd är inte transaktionssäker i ECM-system. Om du till exempel försöker ta bort 100 resurser och åtgärden misslyckas på den 50:e resursen, tas de första 49 instanserna bort, men inte resten. I annat fall är standardbeteendet återställning (ej åtagande).
com.adobe.repository.bindings.dsc.client.ResourceRepositoryClient.deleteResources()
med ECM-databasen (EMC Documentum Content Server och IBM FileNet P8 Content Manager) återställs inte transaktionen om borttagningen misslyckas för en av de angivna resurserna, vilket innebär att de filer som har tagits bort inte kan återställas.Sammanfattning av steg summary_of_steps-8
Så här tar du bort en resurs:
- Inkludera projektfiler.
- Skapa en databastjänstklient.
- Ange URI för resursen som ska tas bort.
- Ta bort resursen.
Inkludera projektfiler
Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster inkluderar du proxyfilerna.
Skapa tjänstklienten
Innan du kan läsa en resurs programmatiskt måste du skapa en anslutning och ange autentiseringsuppgifter. Detta uppnås genom att en tjänstklient skapas.
Ange URI för resursen som ska tas bort
Skapa en sträng som innehåller URI:n för resursen som ska tas bort. Syntaxen innehåller snedstreck, som i det här exemplet: "/path/resource". Om resursen som ska tas bort är en mapp kommer borttagningen att vara rekursiv.
Ta bort resursen
Anropa databastjänstmetoden för att ta bort resursen och ange URI:n.
Se även
Ta bort resurser med webbtjänstens API
Inkludera AEM Forms Java-biblioteksfiler
Snabbstart för databastjänst-API
Ta bort resurser med Java API(SOAP) delete-resources-using-the-java-api-soap
Ta bort en resurs med Repository API (Java):
-
Inkludera projektfiler
Inkludera JAR-klientfiler i Java-projektets klassökväg.
-
Skapa tjänstklienten
Skapa ett
ResourceRepositoryClient
-objekt med hjälp av dess konstruktor och skicka ettServiceClientFactory
-objekt som innehåller anslutningsegenskaper. -
Ange URI för resursen som ska tas bort
Ange URI för resursen som ska hämtas. I det här fallet är resursen testResourceToBeDeleted i mappen testFolder
/testFolder/testResourceToBeDeleted
. URI:n lagras som ettjava.lang.String
-objekt. I det här exemplet skrivs resursen först till databasen och dess URI hämtas. Mer information om hur du skriver en resurs finns i Skriva resurser. -
Ta bort resursen
Anropa
ResourceRepositoryClient
-objektetsdeleteResource
-metod och skicka resursens URI som en parameter.
Se även
Snabbstart (SOAP): Söka efter resurser med Java API
Ta bort resurser med webbtjänstens API delete-resources-using-the-web-service-api
Ta bort en resurs med Repository API (webbtjänsten):
-
Inkludera projektfiler
- Skapa en Microsoft .NET-klientsammansättning som förbrukar WSDL för databasen med Base64.
- Referera till Microsoft .NET-klientsammansättningen.
-
Skapa tjänstklienten
Skapa ett
RepositoryServiceService
-objekt med Microsoft .NET-klientsammansättningen genom att anropa dess standardkonstruktor. Ange egenskapenCredentials
med ettSystem.Net.NetworkCredential
-objekt som innehåller användarnamnet och lösenordet. -
Ange URI för resursen som ska tas bort
Ange URI för resursen som ska hämtas. I det här fallet är resursen
testResourceToBeDeleted
"/testFolder/testResourceToBeDeleted"
eftersom den finns i mappentestFolder
. I det här exemplet skrivs resursen först till databasen och dess URI hämtas. Mer information om hur du skriver en resurs finns i Skriva resurser. -
Ta bort resursen
Anropa
RepositoryServiceService
-objektetsdeleteResources
-metod och skicka enSystem.String
-array som innehåller resursens URI som första parameter. Skickanull
för den andra parametern.
Se även
Anropa AEM Forms med Base64-kodning