Prise en charge XFA. Adobe LiveCycle Production Print ES2

Документ

Prise en charge XFA

Le processeur XFA LiveCycle Production Print met en oeuvre un sous-ensemble de la spécification XFA, comme l'indique cette section.

La fonctionnalité relative à la création d'une sortie de document interactive n'est généralement pas prise en charge, excepté pour les propriétés de dessin d'objets rendus de façon statique dans les formats d'impression.

Il en va de même pour la mise en oeuvre des fonctions de script FormCalc et

ECMA.

Note :

LiveCycle Production Print ES2 est conçu pour atteindre un haut niveau de performance dans le traitement des modèles XFA. Le processeur XFA ne fonctionne pas tout à fait comme les processeurs XFA correspondants dans LiveCycle Output ES2 et LiveCycle Forms ES2. Pour des raisons de performances, il existe des différences au niveau de l'utilisation des contextes de scripts, comme l'explique cette section.

Pour plus d'informations sur les limitations connues, voir les notes de version sur

Adobe LiveCycle Production Print ES2.

Dans ce chapitre :

•

Eléments XFA

à la page 108

•

Fonctions de script XFA

à la page 113

107

Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B

108

Eléments XFA

Prise en charge XFA

Eléments XFA

Dans cette section :

•

Eléments XFA totalement pris en charge

à la page 108

•

Eléments XFA comportant des attributs non pris en charge

à la page 109

•

Eléments XFA utilisés uniquement pour l'ajout de données dans un PDF balisé

à la page 111

•

Eléments XFA non pris en charge

à la page 112

Eléments XFA totalement pris en charge

Les éléments XFA ci-dessous sont totalement pris en charge. Pour plus d'informations sur la dernière spécification XFA, consultez la page

Adobe XML

Forms Architecture (XFA) .

•

<arc>

• <area>

• <image>

•

<bind>

•

•

•

<color>

•

<comb>

•

•

•

<date>

•

•

•

<draw>

•

<edge>

•

•

<fill>

•

<float>

•

<font>

•

•

•

<line>

•

•

•

<occur>

•

•

•

•

<proto>

•

•

•

<solid>

•

•

•

<time>

•

<ui>

•

• <validate>

Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B

Eléments XFA

Prise en charge XFA

109

•

Eléments XFA comportant des attributs non pris en charge

Les éléments XFA ci-dessous sont partiellement pris en charge. Voir la section

Template Reference dans la spécification Adobe XML Forms Architecture (XFA) pour plus d'informations sur les éléments XFA.

Elément

<break>

Attributs non pris en charge

• charEncoding

• dataPrep

• printCheckDigit

• rowColumnRatio

• upsMode

• break

• bookendLeader

• bookendTrailer

• after

• before

• leader

• trailer

• targetType

• leader

• trailer

• targetType

• highlight

• override

• placement

• commitOn

• open

• textEntry

• hScrollPolicy

• picker

Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B

110

Eléments XFA

Prise en charge XFA

Elément

<event>

<field>

<items>

<keep>

<para>

Attributs non pris en charge

• leadDigits

• activity

• maxLength

• rid

• transferEncoding

• access

• accessKey

• access

• accessKey

• data

• ref

• intact

• next

• previous

• stock

• trayIn

• trayOut

• hScrollPolicy

• blankOrNotBlank

• initialNumber

• numbered

• oddOrEven

• pagePosition

• relation

• preserve

• hScrollPolicy

• runAt

• connection

Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B

Eléments XFA

Prise en charge XFA

111

Elément

<text>

<value>

Attributs non pris en charge

• access

• allowMacro

• layout

• restoreState

• baseProfile

• rid

• allowRichText

• hScrollPolicy

• vScrollPolicy

• override

Eléments XFA utilisés uniquement pour l'ajout de données dans un PDF balisé

Les éléments XFA ci-dessous ne sont utilisés que pour ajouter des données à un

PDF balisé. Voir la section Template Reference dans la spécification Adobe XML

Forms Architecture (XFA) pour plus d'informations.

•

•

<desc>

•

<speak>

•

•

•

Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B

112

Eléments XFA

Prise en charge XFA

Eléments XFA non pris en charge

Les éléments XFA ci-dessous ne sont pas pris en charge.

•

•

•

•

•

•

•

•

•

•

•

<oids>

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

<mdp>

•

<oid>

•

•

<ref>

•

•

•

Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B

Fonctions de script XFA

Prise en charge XFA

113

Fonctions de script XFA

Dans cette section :

•

Fonctions de script prises en charge

à la page 113

•

Propriétés de script prises en charge

à la page 116

•

Modèles d'objet de script pris en charge

à la page 123

•

Evénements pris en charge

à la page 123

•

Considérations relatives aux fonctions de script

à la page 123

Fonctions de script prises en charge

Les fonctions de script répertoriées dans le tableau ci-dessous sont totalement ou partiellement prises en charge. Si une fonction n'apparaît pas dans le tableau, c'est qu'elle n'est pas mise en oeuvre.

• Les fonctions totalement prises en charge sont présentées dans le manuel de

référence des fonctions de script LiveCycle.

• Les fonctions partiellement prises en charge sont présentées dans le manuel

de référence des fonctions de script LiveCycle, ainsi que les exceptions mentionnées dans le tableau ci-dessous.

Fonction

absPage absPageCount absPageSpan addInstance addItem assignNode

Commentaires

Prise en charge totale

• Le paramètre booléen param

n'est pas pris en charge.

• La nouvelle instance n'est pas fusionnée avec le DOM de données.

• Cette fonction échoue si la valeur de l'attribut maxOccurs

d'un sous-formulaire, dans un contexte donné, est dépassée lorsque le sous-formulaire est ajouté.

Prise en charge totale

• Cette fonction ne s'applique qu'aux noeuds du DOM de formulaire ou du DOM de présentation.

• Le paramètre param3

n'est pas pris en charge.

• Il est impossible de créer de nouveaux noeuds.

• Cette fonction essaie toujours d'attribuer la valeur à un noeud existant, sinon elle échoue.

Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B

114

Fonctions de script XFA

Prise en charge XFA

Fonction

boundItem clearItems clone deleteItem execCalculate execEvent execInitialize getAttribute getDisplayItem getElement getItemState getSaveItem h isCompatibleNS isPropertySpecified item

Commentaires

Prise en charge totale

Cette fonction ne s'applique qu'aux noeuds du DOM de formulaire ou du DOM de présentation.

Prise en charge totale

Cette fonction n'est prise en charge que pour exclGroup

, field

, form

et subform

Prise en charge totale

Cette fonction n'est prise en charge que pour exclGroup

, field

, form

et subform

Prise en charge totale

• Cette fonction n'est prise en charge que pour field

, draw

, subform

et contentArea

• Le paramètre param3

doit être égal à 0. La fonction renvoie sinon la valeur 0.

• Pour les objets du DOM de modèle, du DOM de formulaire et du DOM de présentation, cette fonction renvoie la valeur

"true" (vrai) pour les espaces de noms ci-dessous : http://www.xfa.org/schema/xfa-template/ http://www.xfa.org/schema/xfa-template/2.1/ http://www.xfa.org/schema/xfa-template/2.4/ http://www.xfa.org/schema/xfa-template/2.5/ http://www.xfa.org/schema/xfa-template/2.6/

• Pour les objets du DOM de données, cette fonction renvoie la valeur "true" (vrai) pour : http://www.xfa.org/schema/xfa-data/

• La valeur "false" (faux) est renvoyée pour toutes les autres combinaisons espaces de noms/modèle d'objet.

Prise en charge totale

Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B

Fonction

message messageBox namedItem page pageContent pageCount pageSpan relayout remerge removeInstance resolveNode resolveNodes saveXML selectedMember setAttribute setElement

Fonctions de script XFA

Prise en charge XFA

115

Commentaires

Prise en charge totale

• Fonction mise en oeuvre en JavaScript uniquement. Aucune boîte de message n'est affichée.

• Cette méthode renvoie toujours la valeur 2 (annuler).

Prise en charge totale

• L'accès à tout le contenu de la page n'est pas pris en charge

(c'est-à-dire valeur "empty" (vide) pour param2

• Le paramètre param3

n'est pas pris en charge.

• Cette fonction recherche toujours dans la totalité de la page, y compris pageArea

et contentAreas

Prise en charge totale

• Fonctionnalité limitée. La présentation actuelle est entièrement terminée, puis un second passage est exécuté. Ce second passage recrée toutes les pages et présente tous les objets en commençant au début des pages.

• Les scripts des noeuds de formulaire ne sont pas renvoyés une fois le second passage effectué. Seuls les scripts présents sur les en-têtes et pieds de page de débordement et les objets standard seront exécutés.

Cette fonction exécute une modification complète du DOM de formulaire, mais cette modification n'est effectuée qu'une seule fois.

Si la fonction remerge

est de nouveau appelée lors du second passage pour la fusion du DOM, cela n'aura aucun impact.

Prise en charge totale

Cette fonction est mise en oeuvre, mais l'exactitude du document

XML renvoyé n'est pas garantie.

Prise en charge totale

Cette fonction est mise en oeuvre, mais elle ne fonctionne pas correctement. Le remplacement de certains éléments n'est pas toujours répercuté dans la sortie.

Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B

116

Fonctions de script XFA

Prise en charge XFA

x y

Fonction

setItems setItemState sheet sheetCount w

Commentaires

Prise en charge totale

Cette fonction renvoie toujours la même valeur que la valeur page

• Cette fonction n'est prise en charge que pour field

, draw

, subform

, contentArea

et pageArea

• Le paramètre param3

doit être égal à 0. La fonction renvoie sinon la valeur 0.

Le paramètre param3

doit être égal à 0. La fonction renvoie sinon la valeur 0.

Le paramètre param3

doit être égal à 0. La fonction renvoie sinon la valeur 0.

Propriétés de script prises en charge

Les propriétés de script répertoriées dans le tableau ci-dessous sont totalement ou partiellement prises en charge. Si une propriété n'apparaît pas dans le tableau, c'est qu'elle n'est pas mise en oeuvre.

• Les propriétés totalement prises en charge sont présentées dans le manuel

de référence des fonctions de script LiveCycle.

• Les propriétés partiellement prises en charge sont présentées dans le manuel

de référence des fonctions de script LiveCycle, ainsi que les exceptions mentionnées dans le tableau ci-dessous.

Propriété

#text

{default} activity after afterTarget all allowNeutral

Commentaires

Prise en charge totale

Cette propriété est en lecture seule et ne peut pas être définie à partir des scripts.

Prise en charge totale

Lorsque vous définissez cette propriété, seuls les noms des sousformulaires du modèle actuel peuvent être utilisés.

Prise en charge totale

Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B

Propriété

allowRichText anchorType aspect baselineShift before beforeTarget borderColor borderWidth bottomInset break cap charEncoding checksum circular classAll classIndex className colSpan columnWidths contentType count cSpace data dataColumnCount dataLength dataRowCount

Fonctions de script XFA

Prise en charge XFA

117

Commentaires

Prise en charge totale

Lorsque vous définissez cette propriété, seuls les noms des sousformulaires du modèle actuel peuvent être utilisés.

Prise en charge totale

Cette propriété est prise en charge pour les objets suivants :

• exData

(lecture/écriture)

• image

(lecture/écriture)

• script

(lecture seule).

Prise en charge totale

Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B

118

Fonctions de script XFA

Prise en charge XFA

Propriété

editValue endChar errorCorrectionLevel excludeAllCaps excludeInitialCap fillColor fontColor fontHorizontalScale fontVerticalScale formattedValue fracDigits h hAlign hand highlight href id index initial instanceIndex intact inverted isContainer

Commentaires

Cette propriété permet de définir ou d'obtenir la valeur rawValue

Aucune distinction n'est effectuée entre les valeurs rawValue

et editValue

Prise en charge totale

La mise en oeuvre de la césure diffère entre LiveCycle et

StreamServe. Il n'est donc pas garanti que le texte auquel la césure est appliquée aura le même rendu.

La mise en oeuvre de la césure diffère entre LiveCycle et

StreamServe. Il n'est donc pas garanti que le texte auquel la césure est appliquée aura le même rendu.

Prise en charge totale

Lorsque vous définissez cette propriété, la propriété rawValue l'est également. Lorsque vous activez cette propriété, la valeur rawValue

est formatée avant de revenir au programme d'appel.

Prise en charge totale

Fonction utilisée uniquement dans les objets image

. Elle peut

également être définie et lue dans exData

, mais n'a aucune signification dans cet objet.

Lecture seule

Prise en charge totale

Lecture seule

Prise en charge totale

Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B

Propriété

isNull marginRight mark bind max maxChars maxH maxW min minH minW moduleHeight moduleWidth join kerningMode ladderCount layout leadDigits leader leftInset length letterSpacing lineHeight lineThrough lineThroughPeriod listen locale long marginLeft

Fonctions de script XFA

Prise en charge XFA

119

Commentaires

Prise en charge totale

Prise en charge pour breakAfter

, breakBefore

et overflow

Prise en charge totale

Lecture seule

Prise en charge totale

Lecture seule

Prise en charge totale

Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B

120

Fonctions de script XFA

Prise en charge XFA

Propriété

multiLine name next nodes ns numberOfCells numPages orientation overflowLeader overflowTarget overflowTrailer override parent parentSubform passwordChar placement posture presence preserve previous printCheckDigit pushCharacterCount radius radixOffset rate

Commentaires

Prise en charge totale

L'option pageArea

n'est pas prise en charge.

Prise en charge totale

Lecture seule

Prise en charge totale

Lecture seule

Prise en charge totale

Lecture seule

Lecture seule. Elle peut être définie, mais n'a aucun impact une fois le modèle chargé.

Lecture seule

Prise en charge totale

L'option pageArea

n'est pas prise en charge.

Prise en charge totale

La mise en oeuvre de la césure diffère entre LiveCycle et

StreamServe. Il n'est donc pas garanti que le texte auquel la césure est appliquée aura le même rendu.

Prise en charge totale

Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B

Fonctions de script XFA

Prise en charge XFA

121

save scope selectedIndex shape short size slope somExpression spaceAbove spaceBelow startAngle startChar startNew stroke sweepAngle tabDefault

Propriété

rawValue ref relation relevant remainCharacterCount reserve rightInset rotate runAt

Commentaires

formattedValue

et editValue

correspondent aux mêmes valeurs que rawValue

dans Production Print. Lorsque vous définissez l'une de ces valeurs, toutes auront alors la même valeur. formattedValue

sera toutefois formatée une fois encore lors de la sortie. Ce problème est connu.

Lecture seule

Prise en charge totale

La mise en oeuvre de la césure diffère entre LiveCycle et

StreamServe. Il n'est donc pas garanti que le texte auquel la césure est appliquée aura le même rendu.

Prise en charge totale

Traitée en lecture seule. Elle peut être définie, mais n'aura aucun impact.

Prise en charge totale

Lecture seule

Prise en charge totale

Lecture seule

Prise en charge totale

Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B

122

Fonctions de script XFA

Prise en charge XFA

Propriété

target targetType textIndent textLocation thickness this topInset trailer transferEncoding truncate type typeface underline underlinePeriod use usehref vAlign value w weight wideNarrowRatio wordCharacterCount x

Commentaires

Prise en charge pour breakAfter

et breakBefore

. Lorsque vous définissez cette propriété, seuls les noms des sous-formulaires du modèle actuel peuvent être utilisés.

Les options pageEven

et pageOdd

ne sont pas prises en charge.

Prise en charge totale

Prise en charge pour breakAfter

et breakBefore

. Lorsque vous définissez cette propriété, seuls les noms des sous-formulaires du modèle actuel peuvent être utilisés.

Cette fonction n'est prise en charge que pour image

Prise en charge totale

Cette fonction est prise en charge pour barcode

, linear

, pattern et radial

Cette fonction est prise en charge, mais la police correspondante doit être incluse dans le Projet StreamServe.

Prise en charge totale

Lecture seule

Prise en charge totale

Pour les objets qui prennent en charge rawValue

, value et rawValue

renverront le même résultat et définiront la même valeur.

Prise en charge totale

La mise en oeuvre de la césure diffère entre LiveCycle et

StreamServe. Il n'est donc pas garanti que le texte auquel la césure est appliquée aura le même rendu.

Prise en charge totale

Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B

Fonctions de script XFA

Prise en charge XFA

123

Propriété

Commentaires

Prise en charge totale

Modèles d'objet de script pris en charge

Les modèles d'objet de script répertoriés dans le tableau ci-dessous sont totalement ou partiellement pris en charge. Voir

Fonctions de script prises en charge

à la page 113 et

Propriétés de script prises en charge

à la page 116 pour

plus d'informations sur la prise en charge partielle.

Si un modèle d'objet ne figure pas dans la liste, c'est qu'il n'est pas pris en charge.

• Data model (modèle de données)

• Form model (modèle de formulaire)

• Host model (modèle d'hôte)

• Layout model (modèle de présentation)

• Log model (modèle de journal)

• XFA model (modèle XFA)

Evénements pris en charge

Les événements figurant dans la liste ci-dessous font l'objet d'une prise en charge totale. Les événements totalement pris en charge sont présentés dans le manuel

utilisateur LiveCycle Designer ES2 Scripting Basics.

Si un événement ne figure pas dans la liste, c'est qu'il n'est pas pris en charge.

• calculate

• form:ready

• indexChange

• initialize

• layout:ready

• prePrint

• validate

Considérations relatives aux fonctions de script

Fonctions de script dans le DOM de présentation

Le DOM de présentation est d'abord entièrement créé, puis distribué dans les pages, les zones de contenu, etc. Ensuite, tous les scripts layout-ready et preprint sont exécutés dans l'ordre indiqué dans la spécification XFA 3.1. Si un script layout-ready ou preprint modifie le DOM de présentation et si, suite à cette modification, certains objets basculent sur une autre page, le DOM de présentation est entièrement recréé.

Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B

124

Fonctions de script XFA

Prise en charge XFA

Le recréation du DOM de présentation entraîne la suppression de tous les objets suivants :

• Objets de présentation créés dynamiquement, tels que les caractères de début et de fin

• Objets sur les pages principales

Tous les autres objets de présentation (tels que les champs du DOM de formulaire) restent inchangés, de même que les valeurs de ces objets.

Pour que les valeurs restent correctes, aucun script de présentation d'objet de formulaire n'est exécuté une fois le DOM de présentation recréé. Seuls les scripts attachés aux objets de présentation créés dynamiquement (caractères de début, objets de page principale, etc.) sont exécutés.

Les scripts du DOM de présentation ne sont exécutés qu'une seule fois pour chaque objet, avec toutefois quelques exceptions :

• Les scripts layout-ready et preprint sur le sous-formulaire racine sont tous les deux exécutés la première fois et la seconde fois (le cas échéant) que le

DOM de présentation est créé et organisé.

• Les scripts initialize et calculate pour les objets de page principale peuvent

être exécutés deux fois.

Vous devez donc être particulièrement attentif lorsque vous utilisez des variables globales et lorsque vous les initialisez, ou lorsque vous accédez à des champs et

à d'autres valeurs dans des sous-formulaires créés dynamiquement dans le DOM de formulaire :

• Toute initialisation des variables globales et toute modification apportée en externe (à partir d'autres parties du DOM) aux objets de présentation créés dynamiquement doivent être effectuées dans le sous-formulaire racine ou dans les fonctions de script appelées à partir du sous-formulaire racine.

• Si vous mettez à jour des valeurs dans les objets du DOM de formulaire au sein d'un en-tête de débordement par exemple, il se peut que vous obteniez des résultats inattendus.

Exemple : subform.field.x = subform.field.x + 100;

dans un caractère de début entraîne une augmentation de 100 de la valeur subform.field.x

lorsque le DOM de présentation est créé la première fois.

Si le DOM de présentation est créé une nouvelle fois, la valeur 100 est encore ajoutée à x

Variables globales incorporées dans des scripts Java

• Les variables globales incorporées dans des scripts Java dans le DOM de formulaire (par exemple initialize

ou form ready

) ne peuvent pas être utilisées dans le DOM de présentation avec les valeurs initialisées. Il y a toutefois une exception à cette règle : les variables globales déclarées dans des objets de script dédiés. Ces variables peuvent être initialisées dans des scripts fu DOM de formulaire et être utilisées dans des scripts du DOM de présentation.

Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B

Fonctions de script XFA

Prise en charge XFA

125

• Il est impossible d'employer dans des scripts form calc et des expressions

SOM des variables globales incorporées dans des scripts Java (par exemple, pour transférer des valeurs dans les variables StreamServe). Pour pouvoir

être utilisées, ces variables doivent être déclarées en tant que variables de formulaire (c'est-à-dire qu'elles doivent apparaître dans la hiérarchie

LiveCycle Designer ES2).

Ordre d'exécution des scripts

L'ordre d'exécution des scripts pour les objets au sein d'un type d'Evénement dans

XFA n'est pas défini. N'écrivez pas de scripts qui reposent sur un ordre d'exécution particulier.