Forms met rechten voor renderen rendering-rights-enabled-forms
De Forms-service kan formulieren weergeven waarop gebruiksrechten zijn toegepast. Gebruiksrechten hebben betrekking op functionaliteit die standaard beschikbaar is in Acrobat, maar niet in Adobe Reader, zoals de mogelijkheid om opmerkingen toe te voegen aan een formulier of formuliervelden in te vullen en het formulier op te slaan. Forms waarop gebruiksrechten zijn toegepast, worden formulieren genoemd die geschikt zijn voor rechten. Een gebruiker die een formulier met ingeschakelde rechten opent in Adobe Reader, kan bewerkingen uitvoeren die zijn ingeschakeld voor dat formulier.
Als u gebruiksrechten wilt toepassen op een formulier, moet de Acrobat Reader DC-extensieservice onderdeel zijn van de installatie van AEM formulieren. Bovendien moet u een geldige referentie hebben waarmee u gebruiksrechten kunt toepassen op PDF-documenten. Dit betekent dat u de Acrobat Reader DC-extensieservice op de juiste wijze moet configureren voordat u een formulier met ingeschakelde rechten kunt genereren. (Zie Ongeveer de de uitbreidingsdienst van Acrobat Reader DC.)
enableComments
, enableCommentsOnline
, enableEmbeddedFiles
of enableDigitalSignatures
. (Zie Prepopulating Forms met Stroombare Lay-outs.)Overzicht van de stappen summary-of-steps
Voer de volgende taken uit om een formulier waarvoor rechten zijn ingeschakeld, te genereren:
- Inclusief projectbestanden.
- Maak een Forms Client API-object.
- Stel uitvoeringsopties voor gebruiksrechten in.
- Een formulier met ingeschakelde rechten weergeven.
- Schrijf het formulier waarvoor rechten zijn ingeschakeld naar de webbrowser van de client.
omvat projectdossiers
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, dient u de proxybestanden op te nemen.
creeer een voorwerp van Forms Cliënt API
Voordat u programmatisch een client-API-bewerking voor Forms-services kunt uitvoeren, moet u een Forms-serviceclient maken.
plaats runtime opties van gebruiksrechten
Stel uitvoeringsopties voor gebruiksrechten in om een formulier met toegangsrechten te genereren. Geef de alias op van de referentie die wordt gebruikt om gebruiksrechten toe te passen op een formulier. Nadat u de alias-waarde hebt opgegeven, geeft u elk gebruiksrecht op dat u op het formulier wilt toepassen.
geef een recht-toegelaten vorm terug
Als u een formulier met ingeschakelde rechten wilt genereren, gebruikt u dezelfde toepassingslogica als voor het weergeven van een formulier zonder gebruiksrechten. Het enige verschil is dat u ervoor moet zorgen dat de gebruiksrechten tijdens runtime opties zijn opgenomen in uw toepassingslogica.
schrijf de stroom van vormgegevens aan cliëntWeb browser
Wanneer een formulier waarvoor rechten zijn ingeschakeld door de Forms-service wordt gegenereerd, wordt een formuliergegevensstroom geretourneerd die u moet schrijven naar de webbrowser van de client. Nadat het formulier naar de webbrowser van de client is geschreven, is het zichtbaar voor de gebruiker. Een gebruiker die het voor rechten ingeschakelde formulier in Adobe Reader weergeeft, kan bewerkingen uitvoeren die zijn ingeschakeld voor dat formulier.
zie ook
Formulieren waarvoor rechten zijn ingeschakeld, renderen met de Java API
Formulieren waarvoor rechten zijn ingeschakeld, renderen met de API voor webservices
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Formulieren waarvoor rechten zijn ingeschakeld, renderen met de Java API render-rights-enabled-forms-using-the-java-api
Een formulier met ingeschakelde rechten weergeven met de Forms API (Java):
-
Projectbestanden opnemen
Neem client-JAR-bestanden, zoals adobe-forms-client.jar, op in het klassepad van uw Java-project.
-
Een Forms Client API-object maken
- Maak een
ServiceClientFactory
-object dat verbindingseigenschappen bevat. - Maak een
FormsServiceClient
-object door de constructor ervan te gebruiken en hetServiceClientFactory
-object door te geven.
- Maak een
-
Opties voor het uitvoeren van gebruiksrechten instellen
- Maak een
ReaderExtensionSpec
-object met behulp van de constructor. - Geef de alias van de referentie op door de methode
setReCredentialAlias
van het objectReaderExtensionSpec
aan te roepen en geef een tekenreekswaarde op die de aliaswaarde vertegenwoordigt. - Stel elk gebruiksrecht in door de bijbehorende methode aan te roepen die bij het object
ReaderExtensionSpec
hoort. U kunt echter alleen een gebruiksrecht instellen als de referentie die u gebruikt dat toestaat. U kunt dus geen gebruiksrecht instellen als de referentie dit niet toestaat. Bijvoorbeeld. Als u het gebruiksrecht wilt instellen waarmee een gebruiker formuliervelden kan invullen en het formulier kan opslaan, roept u de methodesetReFillIn
van het objectReaderExtensionSpec
aan en geeft u dit doortrue
.
note note NOTE U hoeft de methode setReCredentialPassword
van het objectReaderExtensionSpec
niet op te roepen. Deze methode wordt niet gebruikt door de Forms-service. - Maak een
-
Een formulier met ingeschakelde rechten weergeven
Roep de methode
renderPDFFormWithUsageRights
van het objectFormsServiceClient
aan en geef de volgende waarden door:- Een tekenreekswaarde die de naam van het formulierontwerp opgeeft, inclusief de bestandsnaamextensie. Als u verwijst naar een formulierontwerp dat deel uitmaakt van een Forms-toepassing, moet u het volledige pad opgeven, bijvoorbeeld
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
. - Een
com.adobe.idp.Document
-object dat gegevens bevat die met het formulier moeten worden samengevoegd. Wanneer u geen gegevens wilt samenvoegen, geeft u een leegcom.adobe.idp.Document
-object door. - Een
PDFFormRenderSpec
-object dat uitvoeringsopties opslaat. - Een
ReaderExtensionSpec
-object dat gebruiksrechten opslaat. - Een
URLSpec
-object dat URI-waarden bevat die door de Forms-service worden vereist.
De methode
renderPDFFormWithUsageRights
retourneert eenFormsResult
-object dat een formuliergegevensstroom bevat die naar de webbrowser van de client moet worden geschreven. - Een tekenreekswaarde die de naam van het formulierontwerp opgeeft, inclusief de bestandsnaamextensie. Als u verwijst naar een formulierontwerp dat deel uitmaakt van een Forms-toepassing, moet u het volledige pad opgeven, bijvoorbeeld
-
De formuliergegevensstroom naar de webbrowser van de client schrijven
- Maak een
com.adobe.idp.Document
-object door de methodeFormsResult
objectgetOutputContent
aan te roepen. - Haal het inhoudstype van het object
com.adobe.idp.Document
op door de methodegetContentType
ervan aan te roepen. - Stel het inhoudstype van het
javax.servlet.http.HttpServletResponse
-object in door de methodesetContentType
ervan aan te roepen en het inhoudstype van hetcom.adobe.idp.Document
-object door te geven. - Maak een
javax.servlet.ServletOutputStream
-object dat wordt gebruikt om de formuliergegevensstroom naar de webbrowser van de client te schrijven door de methodejavax.servlet.http.HttpServletResponse
objectgetOutputStream
aan te roepen. - Maak een
java.io.InputStream
-object door de methodecom.adobe.idp.Document
objectgetInputStream
aan te roepen. - Maak een bytearray die deze met de gegevensstroom van het formulier vult door de methode
read
van het objectInputStream
aan te roepen en de bytearray door te geven als een argument. - Roep de methode
write
van het objectjavax.servlet.ServletOutputStream
aan om de gegevensstroom van het formulier naar de webbrowser van de client te verzenden. Geef de bytearray door aan de methodewrite
.
- Maak een
zie ook
Formulieren waarvoor rechten zijn ingeschakeld, renderen met de API voor webservices render-rights-enabled-forms-using-the-web-service-api
Een formulier met ingeschakelde rechten weergeven met de Forms API (webservice):
-
Projectbestanden opnemen
- Maak Java-proxyklassen die gebruikmaken van de Forms-service WSDL.
- Neem de Java-proxyklassen op in het klassepad.
-
Een Forms Client API-object maken
Maak een
FormsService
-object en stel de verificatiewaarden in. -
Opties voor het uitvoeren van gebruiksrechten instellen
- Maak een
ReaderExtensionSpec
-object met behulp van de constructor. - Geef de alias van de referentie op door de methode
setReCredentialAlias
van het objectReaderExtensionSpec
aan te roepen en geef een tekenreekswaarde op die de aliaswaarde vertegenwoordigt. - Stel elk gebruiksrecht in door de bijbehorende methode aan te roepen die bij het object
ReaderExtensionSpec
hoort. U kunt echter alleen een gebruiksrecht instellen als de referentie die u gebruikt dat toestaat. U kunt dus geen gebruiksrecht instellen als de referentie dit niet toestaat. Als u het gebruiksrecht wilt instellen waarmee een gebruiker formuliervelden kan invullen en het formulier kan opslaan, roept u de methodesetReFillIn
van het objectReaderExtensionSpec
aan en geeft utrue
door.
- Maak een
-
Een formulier met ingeschakelde rechten weergeven
Roep de methode
renderPDFFormWithUsageRights
van het objectFormsService
aan en geef de volgende waarden door:- Een tekenreekswaarde die de naam van het formulierontwerp opgeeft, inclusief de bestandsnaamextensie. Als u verwijst naar een formulierontwerp dat deel uitmaakt van een Forms-toepassing, moet u het volledige pad opgeven, bijvoorbeeld
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
. - Een
BLOB
-object dat gegevens bevat die met het formulier moeten worden samengevoegd. Als u geen gegevens wilt samenvoegen met het formulier, moet u eenBLOB
-object doorgeven dat is gebaseerd op een lege XML-gegevensbron. U kunt geenBLOB
-object doorgeven dat null is; anders wordt een uitzondering gegenereerd. - Een
PDFFormRenderSpec
-object dat uitvoeringsopties opslaat. - Een
ReaderExtensionSpec
-object dat gebruiksrechten opslaat. - Een
URLSpec
-object dat URI-waarden bevat die door de Forms-service worden vereist.
De methode
renderPDFFormWithUsageRights
retourneert eenFormsResult
-object dat een formuliergegevensstroom bevat die naar de webbrowser van de client moet worden geschreven. - Een tekenreekswaarde die de naam van het formulierontwerp opgeeft, inclusief de bestandsnaamextensie. Als u verwijst naar een formulierontwerp dat deel uitmaakt van een Forms-toepassing, moet u het volledige pad opgeven, bijvoorbeeld
-
De formuliergegevensstroom naar de webbrowser van de client schrijven
- Maak een
BLOB
-object dat formuliergegevens bevat door de methodeFormsResult
objectgetOutputContent
aan te roepen. - Haal het inhoudstype van het object
BLOB
op door de methodegetContentType
ervan aan te roepen. - Stel het inhoudstype van het
javax.servlet.http.HttpServletResponse
-object in door de methodesetContentType
ervan aan te roepen en het inhoudstype van hetBLOB
-object door te geven. - Maak een
javax.servlet.ServletOutputStream
-object dat wordt gebruikt om de formuliergegevensstroom naar de webbrowser van de client te schrijven door de methodejavax.servlet.http.HttpServletResponse
objectgetOutputStream
aan te roepen. - Maak een bytearray en vul deze door de methode
getBinaryData
van het objectBLOB
aan te roepen. Hierdoor wordt de inhoud van hetFormsResult
-object toegewezen aan de bytearray. - Roep de methode
write
van het objectjavax.servlet.http.HttpServletResponse
aan om de gegevensstroom van het formulier naar de webbrowser van de client te verzenden. Geef de bytearray door aan de methodewrite
.
- Maak een
zie ook
Forms met rechten voor renderen
AEM Forms aanroepen met Base64-codering