HTML Forms renderen met CustomToolbars rendering-html-forms-with-customtoolbars

Projectbestanden opnemen

Neem client-JAR-bestanden, zoals adobe-forms-client.jar, op in het klassenpad van uw Java-project.

Een Forms Java API-object maken

• Maak een ServiceClientFactory -object dat verbindingseigenschappen bevat.
• Maak een FormsServiceClient -object door de constructor ervan te gebruiken en het ServiceClientFactory -object door te geven.

Verwijzen naar een aangepast XML-bestand met een fsmenu

• Maak een HTMLRenderSpec -object met behulp van de constructor.
• Als u een HTML-formulier met een werkbalk wilt weergeven, roept u de methode setHTMLToolbar van het object HTMLRenderSpec aan en geeft u een waarde HTMLToolbar enum door. Als u bijvoorbeeld een verticale werkbalk HTML wilt weergeven, geeft u door HTMLToolbar.Vertical .
• Geef de locatie van het XML-bestand van het fsmenu op door de methode setToolbarURI van het object HTMLRenderSpec aan te roepen en een tekenreekswaarde door te geven die de URI-locatie van het XML-bestand aangeeft.
• Stel, indien van toepassing, de waarde van de landinstelling in door de methode van het HTMLRenderSpec -object setLocale aan te roepen en een tekenreekswaarde door te geven die de waarde van de landinstelling opgeeft. De standaardwaarde is Engels.

Een HTML-formulier renderen

Roep de methode renderHTMLForm van het object FormsServiceClient 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 TransformTo opsommingswaarde die het voorkeurstype HTML aangeeft. Als u bijvoorbeeld een HTML-formulier wilt genereren dat compatibel is met dynamic HTML voor Internet Explorer 5.0 of hoger, geeft u TransformTo.MSDHTML op.
• 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 leeg com.adobe.idp.Document -object door.
• Het HTMLRenderSpec -object dat HTML-runtime-opties opslaat.
• Een tekenreekswaarde die de headerwaarde HTTP_USER_AGENT opgeeft, zoals Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322) .
• Een URLSpec -object dat URI-waarden opslaat die vereist zijn om een HTML-formulier te genereren.
• Een java.util.HashMap -object dat bestandsbijlagen opslaat. Dit is een optionele parameter en u kunt null opgeven als u geen bestanden aan het formulier wilt koppelen.

De methode renderHTMLForm retourneert een FormsResult -object dat een formuliergegevensstroom bevat die naar de webbrowser van de client moet worden geschreven.

De formuliergegevensstroom naar de webbrowser van de client schrijven

• Maak een com.adobe.idp.Document -object door de methode FormsResult object 's getOutputContent aan te roepen.
• Haal het inhoudstype van het object com.adobe.idp.Document op door de methode getContentType ervan aan te roepen.
• Stel het inhoudstype van het javax.servlet.http.HttpServletResponse -object in door de methode setContentType ervan aan te roepen en het inhoudstype van het com.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 methode javax.servlet.http.HttpServletResponse object getOutputStream aan te roepen.
• Maak een java.io.InputStream -object door de methode com.adobe.idp.Document object getInputStream aan te roepen.
• Maak een bytearray en vul deze met de formuliergegevensstroom door de methode read van het object InputStream aan te roepen en de bytearray als een argument door te geven.
• Roep de methode write van het object javax.servlet.ServletOutputStream aan om de gegevensstroom van het formulier naar de webbrowser van de client te verzenden. Geef de bytearray door aan de methode write .

Projectbestanden opnemen

• Maak Java-proxyklassen die gebruikmaken van de Forms-service WSDL.
• Neem de Java-proxyklassen op in het klassenpad.

Een Forms Java API-object maken

Maak een FormsService -object en stel de verificatiewaarden in.

Verwijzen naar een aangepast XML-bestand met een fsmenu

• Maak een HTMLRenderSpec -object met behulp van de constructor.
• Als u een HTML-formulier met een werkbalk wilt weergeven, roept u de methode setHTMLToolbar van het object HTMLRenderSpec aan en geeft u een waarde HTMLToolbar enum door. Als u bijvoorbeeld een verticale werkbalk HTML wilt weergeven, geeft u door HTMLToolbar.Vertical .
• Geef de locatie van het XML-bestand van het fsmenu op door de methode setToolbarURI van het object HTMLRenderSpec aan te roepen en een tekenreekswaarde door te geven die de URI-locatie van het XML-bestand aangeeft.
• Stel, indien van toepassing, de waarde van de landinstelling in door de methode van het HTMLRenderSpec -object setLocale aan te roepen en een tekenreekswaarde door te geven die de waarde van de landinstelling opgeeft. De standaardwaarde is Engels.

Een HTML-formulier renderen

Roep de methode renderHTMLForm van het object FormsService 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 TransformTo opsommingswaarde die het voorkeurstype HTML aangeeft. Als u bijvoorbeeld een HTML-formulier wilt genereren dat compatibel is met dynamic HTML voor Internet Explorer 5.0 of hoger, geeft u TransformTo.MSDHTML op.
• Een BLOB -object dat gegevens bevat die met het formulier moeten worden samengevoegd. Geef null door als u geen gegevens wilt samenvoegen.
• Het HTMLRenderSpec -object dat HTML-runtime-opties opslaat.
• Een tekenreekswaarde die de headerwaarde HTTP_USER_AGENT opgeeft, zoals Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322 . U kunt een lege tekenreeks doorgeven als u deze waarde niet wilt instellen.
• Een URLSpec -object dat URI-waarden opslaat die vereist zijn om een HTML-formulier te genereren.
• Een java.util.HashMap -object dat bestandsbijlagen opslaat. Deze parameter is optioneel en u kunt null opgeven als u geen bestanden aan het formulier wilt koppelen.
• Een leeg com.adobe.idp.services.holders.BLOBHolder -object dat door de methode renderHTMLForm wordt gevuld. Met deze parameterwaarde wordt het gerenderde formulier opgeslagen.
• Een leeg com.adobe.idp.services.holders.BLOBHolder -object dat door de methode renderHTMLForm wordt gevuld. In deze parameter worden de XML-uitvoergegevens opgeslagen.
• Een leeg javax.xml.rpc.holders.LongHolder -object dat door de methode renderHTMLForm wordt gevuld. In dit argument wordt het aantal pagina's in het formulier opgeslagen.
• Een leeg javax.xml.rpc.holders.StringHolder -object dat door de methode renderHTMLForm wordt gevuld. In dit argument wordt de waarde van de landinstelling opgeslagen.
• Een leeg javax.xml.rpc.holders.StringHolder -object dat door de methode renderHTMLForm wordt gevuld. In dit argument wordt de gebruikte HTML-renderwaarde opgeslagen.
• Een leeg com.adobe.idp.services.holders.FormsResultHolder -object dat de resultaten van deze bewerking bevat.

Met de methode renderHTMLForm wordt het com.adobe.idp.services.holders.FormsResultHolder -object dat als laatste argumentwaarde wordt doorgegeven, gevuld met een formuliergegevensstroom die naar de webbrowser van de client moet worden geschreven.

De formuliergegevensstroom naar de webbrowser van de client schrijven

• Maak een FormResult -object door de waarde van het gegevenslid van het com.adobe.idp.services.holders.FormsResultHolder object value op te halen.
• Maak een BLOB -object dat formuliergegevens bevat door de methode FormsResult object getOutputContent aan te roepen.
• Haal het inhoudstype van het object BLOB op door de methode getContentType ervan aan te roepen.
• Stel het inhoudstype van het javax.servlet.http.HttpServletResponse -object in door de methode setContentType ervan aan te roepen en het inhoudstype van het BLOB -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 methode javax.servlet.http.HttpServletResponse object getOutputStream aan te roepen.
• Maak een bytearray en vul deze door de methode getBinaryData van het object BLOB aan te roepen. Hierdoor wordt de inhoud van het FormsResult -object toegewezen aan de bytearray.
• Roep de methode write van het object javax.servlet.http.HttpServletResponse aan om de gegevensstroom van het formulier naar de webbrowser van de client te verzenden. Geef de bytearray door aan de methode write .