action_item

Spécifie le type d'élément d'action à créer (signet, lien, pièce jointe, champ de signature numérique ou multimédia). Ce champ est requis lors de la définition d'un rendu actif. Ce mot-clé doit survenir avant l'un des autres mots-clés d'action.

Les constantes suivantes sont valides pour le mot-clé action_item :

• Champ : précise que vous voulez créer un champ de signature numérique. Un champ de signature numérique est une localisation où la saisie de l'utilisateur est collectée.
• Signet : précise que vous voulez créer un signet. Un signet est un élément de ligne unique dans la Table des matières. Les signets permettent de naviguer rapidement vers un point d'intérêt sur une feuille ; ils peuvent également exécuter des actions telles que jouer un bruit ou ouvrir une URL. Un autre mot-clé présentant un intérêt lors de l'utilisation d'un signet est bookmark_template, dans la section de mots-clés Global.
• Lien : précise que vous voulez créer un lien. Un lien est une zone rectangulaire sur une feuille à laquelle est associée une action de navigation, comme un URL Web ou un lien inter-document.
• Marqueur : précise que vous voulez créer un marqueur. Un marqueur indique un centre d'intérêt sur une feuille qui marque une destination pour la navigation. Un marqueur est identifié par un nom unique. Le logiciel ajoute automatiquement sheet_name (nom de la feuille) avant le nom du marqueur. Le nom complet du marqueur est sheet_name.marker_name. Un autre mot-clé présentant un intérêt lors de l'utilisation d'un marqueur est zoom_percentage, dans la section de mots-clés Global.
• Pièce jointe : précise que vous voulez créer une pièce jointe sous forme de fichier, de son ou une pièce jointe de film.
• Multimédia : précise que vous voulez créer un clip vidéo ou de son multimédia.

Syntaxe :

ACTION_ITEM = <LINK | BOOKMARK | MARKER | MEDIA | FIELD | ATTACHMENT>

action_type

Spécifie le type d'action que vous voulez associer à l'affectation action_item. Ce champ est requis lors de la définition d'un rendu actif.

Les constantes suivantes sont valides pour le mot-clé action_type :

• AREA_OF_INTEREST : précise que vous voulez que le type d'action soit un centre d'intérêt. Utilisé dans un signet de centre d'intérêt pour définir une section ou une vue particulière dans un document. Cette section ou vue est définie par la zone de plage rectangulaire accumulée des éléments qui correspondent aux critères du script de conception.
• DESTINATION : précise que vous voulez que le type d'action soit une destination. Utilisé quand vous créez un marqueur comme indiqué dans l'extrait de code ci-dessous. Le nom de la feuille actuelle (sheet_name) est ajouté avant l'action_name pour l'associer à la feuille. Par exemple, si action_name="Air Handler" et que le nom de la feuille est Plumbing Schematics, le nom unique résultant de la destination serait Plumbing Schematics.Air Handler.

  If((level_name eq "one") and (type eq shape)) then
      action_item = marker
      action_name = "Air Handler"
      action_type = destination
  endif

• DIGSIG_FIELD : précise que vous voulez que le type d'action soit un champ de signature numérique. Utilisé dans les champs de signature numérique.
• DOCUMENT : précise que vous voulez que le type d'action soit un document. Utilisé lors de la définition de signets de document et de liens de document internes.
• FILE_ATTACHMENT : précise que vous voulez que le type d'action soit une pièce jointe fichier. Utilisé dans les pièces jointes fichier pour attacher et incorporer des fichiers dans un document PDF.
• MOVIE_ATTACHMENT : précise que vous voulez que le type d'action soit un clip vidéo. Utilisé dans les pièces jointes vidéo pour inclure une vidéo dans un document PDF.
• PLAY_MEDIA : précise que vous voulez que le type d'action soit un clip multimédia ou audio. Utilisé dans Multimedia.
• PLAY_SOUND : précise que vous voulez que le type d'action soit un clip audio. Utilisé dans les signets de clip audio.
• SOUND_ATTACHMENT : précise que vous voulez que le type d'action soit une pièce jointe audio. Utilisé dans les pièces jointes audio pour inclure un son dans un document PDF.
• TEXT_DESCRIPTION : précise que vous voulez que le type d'action soit une description de texte. Utilisé dans les signets de description de texte pour afficher des informations textuelles.
• WEB_URL : précise que vous voulez que le type d'action soit une URL Web. Utilisé avec des signets de liens Web et des liens d'URL Web.

Syntaxe

ACTION_TYPE = <WEB_URL | DESTINATION | DOCUMENT | PLAY_SOUND | PLAY_MEDIA | DIGSIG_FIELD | AREA_OF_INTEREST | FILE_ATTACHMENT |SOUND_ATTACHMENT | MOVIE_ATTACHMENT | TEXT_DESCRIPTION>

action_name/action_spec

Les valeurs action_name et valeurs action_spec ne sont pas des constantes prédéfinies. En revanche, ce sont des valeurs uniques qui correspondent à action_item et à action_type en cours de définition.

Action_name est généralement le nom unique interne qui permet d'identifier l'objet en cours de définition par action_item. L'exception se produit quand vous identifiez un signet de ien Web ou un signet de clip audio. Pour les signets de lien Web, le mot-clé action_name identifie l'URL. Pour les signets de clip audio, action_name identifie la spécification du fichier audio. Action_name est un champ requis lors de la définition d'action_item.

Action_spec spécifie la position du signet dans la hiérarchie de signets, la spécification de fichier pour les éléments multimédia ou de pièce jointe, la chaîne qui s'affiche quand l'utilisateur passe le curseur de la souris sur le champ de signature numérique dans Adobe Acrobat, et le nom explicite du marqueur (c.-à-d. sheet_name.marker_name) pour un lien. C'est un champ requis lors de la définition d'un action_item, sauf pour les éléments de marqueur.

Syntaxe :

action_name = string
action_spec = string

Le tableau suivant fournit une liste de valeurs acceptables pour chaque action_type correspondant.

action_range

Spécifie si la plage lors de la définition d'une surface rectangulaire poçur créer un signet de lien, de champ,de marqueur, de pièce jointe, de multimédia ou de centre d'intérêt est basé sur la plage de l'élément actuel ou la plage de cellules associée à l'élément actuel. La valeur par défaut est element_range.

Les constantes suivantes sont valides pour le mot-clé action_range :

• ELEMENT_RANGE : précise que la surface rectangulaire lors de la création d'un rendu actif est basée sur la plage de l'élément actuel.
• CELL_RANGE : précise que la surface rectangulaire lors de la création d'un rendu actif est basée sur la cellule associée à l'élément actuel.

Syntaxe

ACTION_RANGE = <ELEMENT_RANGE | CELL_RANGE>

action_instance

Spécifie si la surface rectangulaire (pour un signet de lien ou de centre d'intérêt) est calculée en utilisant la plage de cellules ou d'élément actuelle ou calculée d'après la somme de toutes les plages de cellules ou d'éléments correspondantes.

Les constantes suivantes sont valides pour le mot-clé action_instance :

• SINGLE_INSTANCE : précise que la surface rectangulaire pour un signet de lien ou de centre d'intérêt est calculée d'après la somme de toutes les plages de cellules ou d'éléments correspondantes.
• MULTIPLE_INSTANCE : précise que la surface rectangulaire pour un signet de lien ou de centre d'intérêt est calculée d'après la plage de cellules ou d'éléments correspondante.

Syntaxe

ACTION_INSTANCE = <SINGLE_INSTANCE | MULTIPLE_INSTANCE>

Exemple 1 :

! Créer un signet pour une feuille dans un document.
!
if (first_time eq true) then
 if (sheet_name .ne. "details") then
    action_item = bookmark
    action_name = "details"
    action_type = document
    action_spec = "./Drawing Sheet"
 endif
endif

Exemple 2 :

! Dans la feuille de table des matières, reliez
! tout le texte dans l'index au nom de feuille 
! correspondant dans le document. 
if (sheet_name eq "Table of Contents") then
 if ((type eq text) and (color eq 3)) then
 ! Définissez la région rectangulaire autour de la chaîne de texte 
 ! actuelle qui pointe vers/relie à la feuille 
 ! correspondante dans le document du même nom.
   action_item = link
   action_name = characters
   action_type = document
   action_spec = characters
 endif
endif

Exemple 3 :

! Créez un signet vers les éléments
! d'équipement et associez une vidéo de maintenance à
! l'équipement approprié.
! Identifiez le type d'équipement à traiter
if ((type eq 2) and (cellname eq "Sprinkler Head")) then
! Identifiez le jeu de libellés
    tag_set="equipment information"
    tag_name="serial number"
! Définissez un signet sous le nom de feuille pour cette page
! qui mènera à l'équipement. Utilisez
! sheet_name et TAG_CHAR pour former le nom de l'élément d'action.
    action_item = bookmark
    action_name = sheet_name + "." + TAG_CHAR
    action_type = AREA_OF_INTEREST
    action_spec = "." + sheet_name + "./" + TAG_CHAR
! Définissez un clip audio multimédia qui décrit
! comment installer l'équipement.
    action_item = media
    action_name = « Instructions de maintenance"
    action_type = PLAY_MEDIA
    action_spec = "c:\equipment\videos\sprinkler.wav"
endif

Mots-clés globaux

Les mots-clés suivants peuvent être utilisés comme instructions d'affectation, excepté le mot-clé first_time.

• first_time  : ce mot-clé de comparaison permet d'exécuter un segment d'un script de dessin une fois. Ce mot-clé (indicateur) est TRUE la première fois que le script de dessin est appellé, puis la valeur est définie sur FALSE. La valeur ne peut pas être réinitialisée. Une bonne utilisation de ce mot-clé consiste à spécifier un modèle de signet. Consultez l'exemple à la fin de cette section.
  Remarque : Quand le système traite un script de conception, chaque élément du fichier de conception est traité selon une séquence de haut en bas, jusqu'à ce que chaque élément soit traité. Si le premier élément du fichier de conception exécute l'extrait de code first_time, les éléments restants seront traités, mais ils ignoreront l'extrait de code first_time.
• sheet_name  : précise le nom de la feuille actuelle et du signet associé pour la page tracée actuellement. La valeur par défaut est le nom de la définition d'impression.

  Syntaxe

  sheet_name = chaîne

• ignore_engineering_links  : Précise que si un lien technique est trouvé, il n'est pas inclus en tant que lien dans le rendu actif. La valeur par défaut est Faux.

  Syntaxe

  ignore_engineering_links = <TRUE|FALSE> 

• bookmark_template  : un fichier XML qui définit la disposition de la hiérarchie des signets.

  Syntaxe

  bookmark_template = spécification d'un fichier XML 

  Remarque : Si une spécification de fichier commence par un nombre, vous devez faire précéder le nombre d'une barre oblique ou de deux barres obliques inverses. Par exemple, bookmark_template= c:\my templates\\2004.xml ou bookmark_template= c:/my templates/2004.xml.
• zoom_percentage  : permet de contrôler la façon dont la région environnante est affichée quand vous cliquez sur un signet de centre d'intérêt ou sur un lien vers un marqueur. Si vous spécifiez un pourcentage de zoom de 100, la région rectangulaire est ajustée dans la zone de fenêtre actuelle de la visionneuse Acrobat. Une valeur de 150 indique une surface 50 pour cent plus grande que la limite précise du marqueur ou de la région rectangulaire. La valeur par défaut du pourcentage de zoom est 120. L'ordre dans lequel le mot-clé zoom_percentage apparaît dans le script de dessin est très important. Le mot-clé zoom_percentage doit suivre les mots-clé action_item et action_name.

  Syntaxe

  zoom_percentage = integer (où 100 représente 100 %) 

Exemple :

if (first_time eq true) then
! Chargez le modèle de signet
    bookmark_template = "d:\anystreet\mybookmarktemplate.xml"
if (cellname eq "steps") then
    action_item = BOOKMARK
    action_name = "Step Detail"
    zoom_percentage = 150
    action_type = AREA_OF_INTEREST
    action_spec = "./details/steps"
endif

Mot-clés de publication de propriétés

Les mots-clés suivants servent à publier des métadonnées d'objet dans un fichier PDF. Pour afficher les métadonnées d'objet dans un document PDF, cliquez sur l'arborescence modèle dans Adobe Acrobat ou Reader.

• propertycontainer_name  : permet de spécifier un nom de conteneur pour la propriété active. Une fois qu'une valeur de chaîne leur est affectée, les actions property_maptoelement font en sorte que la propriété active soit placée sous le nom de conteneur donné. Les conteneurs ne peuvent pas être imbriqués. Par défaut, les propriétés définies par un script de dessin sont placées sous un noeud supérieur de nom de feuille dans l'arborescence modèle.

  Syntaxe :

  propertycontainer_name = "string"

• property_name  : précise que vous créez un nom d'objet de propriété. Tous les noms d'objet de propriété doivent être uniques.

  Syntaxe :

  property_name = "string"

• property_setvalues  : précise que vous créez des attributs et dles valeurs pour un objet propriété. Ce mot-clé permet également de modifier ou mettre à jour une valeur d'attribut.

  Syntaxe :

  property_setvalues = "attribute = value"
  property_setvalues = "attribute1 = value1;attribute2 = value2"

• property_maptoelement  : associe l'élément graphique actuel avec l'objet de propriété active.

  Syntaxe :

  property_maptoelement = true
  property_maptoelement = false

• property_setqueryvalues  : précise que vous voulez questionner une valeur d'attribut d'objet de propriété.

  Syntaxe :

  property_setqueryvalues = "string"

• property_getvalue  : précise que vous voulez obtenir une valeur d'attribut d'objet de propriété.

  Syntaxe :

  property_getvalue ="string"

• property_deleteattributes  : précise que vous voulez supprimer l'attribut d'un objet de propriété pour l'objet de propriété active.

  Syntaxe :

  property_deleteattributes = "string"
  property_deleteattributes = "string1;string2"

  Exemple 1 :

  !Spécifier le nom de propriété, définir les valeurs de propriétés
  ! supprimer la valeur d'une propriété et mapper vers l'élément.
  propertycontainer_name = "Ward 1"
  if ((type eq shape) and (level_name eq 'ward 1')) then
     property_name = "Ward 1"
     property_setvalues = "City=Dacula"
     property_setvalues = "Ward Name=Otonabee;Ward Zone=1"
     property_setvalues = "Mayor=J. Doe"
     Property_SetValues =  "Useless=Stuff"
  !Delete property value
     Property_DeleteAttributes = "Useless"
     property_maptoelement = true
  endif
  ! Configurer Ward 2
  propertycontainer_name = "Ward 2"
  if ((type eq shape) and (level_name eq 'ward 2')) then
     property_name = "Ward 2"
     property_setvalues = "City=Snellville"
     property_setvalues = "Ward Name=Wantonabee;Ward Zone=2"
     property_setvalues = "Mayor=J. Smith"
     property_maptoelement = true
  endif

  L'image suivante illustre la façon dont les valeurs de mots-clés propertycontainer_name (Ward 1 et Ward 2) s'affichent dans l'arborescence modèle Adobe Reader/Acrobat. En outre, notez que la propriété Useless (property_setvalues = "Useless=Stuff") ne s'affiche pas dans l'arborescence modèle puisqu'elle a été supprimée (Property_DeleteAttributes = "Useless").

  

Exemple 2 :

! Interroger la valeur d'attribut d'un objet.
if (type == line) then
   property_name = "Ward 1"
   property_setqueryvalues = "City"
 if (property_getvalue=="Dacula")
    color = "red"
 endif
endif