action_item

Especifica el tipo de elemento de acción que desea crear (marca, vínculo, adjunto, campo de firma digital o contenido multimedia) y es un campo obligatorio al definir una interpretación activa. Esta palabra clave debe ocurrir antes de las otras palabras clave de acción.

Las siguientes constantes son válidas para la palabra clave action_item:

• Campo: Especifica que usted desea crear un campo de firma digital. Un campo de firma digital es una ubicación donde se recoge la entrada de usuario.
• Marca: Especifica que desea crear una marca. Una marca es un elemento de línea única en el Índice. Las marcas posibilitan navegar rápidamente hacia un punto de interés en una hoja, o bien pueden llevar a cabo acciones tales como reproducir un sonido o abrir una URL. Otra palabra clave de interés cuando se utiliza una marca puede ser bookmark_template en la sección Palabras clave globales.
• Vínculo: Especifica que desea crear un vínculo. Un vínculo es una región rectangular en una hoja que tenga una acción de navegación asociada, como una URL Web o un vínculo entre documentos.
• Marcador: Especifica que desea crear un marcador. Un marcador denota un área de interés en una hoja que marca un destino para la navegación. Un marcador se identifica mediante un nombre único. El software prefija automáticamente sheet_name al nombre del marcador. El nombre del marcador completamente calificado es sheet_name.marker_name. Otras palabras clave de interés cuando se utiliza un marcador pueden ser zoom_percentage en la sección Palabras clave globales.
• Vínculo: Especifica que desea crear un vínculo de archivo, sonido o película.
• Medios: Especifica que desea crear una película multimedia o un clip de sonido.

Sintaxis:

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

action_type

Especifica el tipo de acción que desea asociar con la asignación de action_item y es un campo requerido al definir una interpretación activa.

Las siguientes constantes son válidas para la palabra clave action_type:

• AREA_OF_INTEREST: Especifica que desea que el tipo de acción sea un área de interés. Se utiliza en la marca de área de interés para definir una sección o una vista particular en un documento. Esta sección o vista se define en el cuadro de rango rectangular acumulado del/de los elemento(s) que coincida con los criterios del guion de diseño.
• DESTINO: Especifica que desea que el tipo de acción sea un destino. Se utiliza cuando está creando un marcador tal y como se muestra en el fragmento de código que se encuentra abajo. El nombre de la hoja actual (sheet_name) se prefija al nombre de la acción (action_name) para asociarlo con la hoja. Por ejemplo, si action_name="Manipulador de aire" y el nombre de la hoja (sheet_name) es "Esquema de plomería", el nombre único resultante para el destino sería administrador de Esquema de plomería.Manipulador de aire.

  Si ((level_name = “uno”) y (tipo = forma)) luego
      action_item = marcador
      action_name = "Manipulador de aire"
      action_type = destino
  endif

• DIGSIG_FIELD: Especifica que desea que el tipo de acción sea un campo de firma digital. Se utiliza en campos de firma digital.
• DOCUMENTO: Especifica que desea que el tipo de acción sea un documento. Se utiliza al definir Marcas de documento y Vínculos de documento interno.
• FILE_ATTACHMENT: Especifica que desea que el tipo de acción sea un vínculo de archivo. Se utiliza en vínculos de archivo para vincular e incorporar los archivos dentro de un documento PDF.
• MOVIE_ATTACHMENT: Especifica que desea que el tipo de acción sea un clip de película. Se utiliza en Vínculos de película para incorporar una película en un documento PDF.
• PLAY_MEDIA: Especifica que desea que el tipo de acción sea una película multimedia o un clip de sonido. Se utiliza en multimedia.
• PLAY_SOUND: Especifica que desea que el tipo de acción sea un clip de sonido. Se utiliza en marcas de clips de sonido.
• SOUND_ATTACHMENT: Especifica que desea que el tipo de acción sea un vínculo de sonido. Se utiliza en Vínculos de sonido para incorporar sonido dentro de un documento PDF.
• TEXT_DESCRIPTION: Especifica que desea que el tipo de acción sea una descripción de texto. Se utiliza en las Marcas de descripción de texto para mostrar información de texto.
• WEB_URL: Especifica que desea que el tipo de acción sea una URL Web. Se utiliza con las Marcas de vínculo Web y con los vínculos de URL Web.

Sintaxis

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

Los valores de Action_name y action_spec no son constantes preestablecidas. Más bien son valores únicos que corresponden a action_item y a action_type que se están definiendo.

Action_name suele ser el nombre interno, único, que se utiliza para identificar el objeto al que action_item está definiendo. La excepción se produce cuando se está identificando una marca de Vínculo Web o una marca de clip de sonido. Para las marcas de vínculo Web, la palabra clave action_name identifica la URL. Para las marcas de clip de sonido, action_name identifica la especificación de archivo del archivo de sonido. Action_name es un campo obligatorio al definir un action_item.

Action_spec especifica la posición de la marca en la jerarquía de marcas, la especificación de archivo para los medios o los elementos del vínculo, la cadena que se muestra cuando el usuario se ubica sobre el campo de la firma digital en Adobe Acrobat y el nombre explícito del marcador (es decir, sheet_name.marker_name) para un vínculo. Este campo es obligatorio cuando se define un action_item, excepto para los elementos de marcador.

Sintaxis:

action_name = cadena
action_spec = cadena

La siguiente tabla proporciona una lista de valores aceptables para cada action_type correspondiente.

action_range

Especifica si, cuando se determina el área rectangular al crear una marca de vínculo, campo, marcador, adjunto, soporte o área de interés, el rango se basa en el rango del componente actual o en el rango de la célula asociada con el componente actual. El valor por defecto es element_range.

Las siguientes constantes son válidas para la palabra clave de action_range:

• ELEMENT_RANGE: Especifica que el área rectangular al crear una interpretación activa se basa en el rango del componente actual.
• CELL_RANGE: Especifica que el área rectangular al crear una interpretación activa se basa en la célula asociada al componente actual.

Sintaxis

ACTION_RANGE = <ELEMENT_RANGE | CELL_RANGE>

action_instance

Especifica si el área rectangular (para la marca de un vínculo o de un área de interés) se calcula con la célula o el rango de elementos actual o si se calcula sobre la base de la suma de todos los rangos de células coincidentes o componentes.

Las siguientes constantes son válidas para la palabra clave de action_instance:

• SINGLE_INSTANCE: Especifica que el área rectangular para la marca de un vínculo o de un área de interés se calcula sobre la base de la suma de todos los rangos de células coincidentes o componentes.
• MULTIPLE_INSTANCE: Especifica que el área rectangular para la marca de un vínculo o de un área de interés se calcula con la célula o el rango de elementos actual.

Sintaxis

ACTION_INSTANCE = <SINGLE_INSTANCE | MULTIPLE_INSTANCE>

Ejemplo 1:

! Crear una marca en una hoja de un documento.
!
 si (first_time = true) entonces
 si (sheet_name .ne. "detalles") luego
    action_item =marca
    action_name = "detalles"
    action_type = documento
    action_spec = “./Hoja de dibujo"
 endif
endif

Ejemplo 2:

! En la hoja del Índice, vincular
! todo el texto del índice con el nombre de hoja correspondiente
! en el documento. 
si (sheet_name = "Índice") luego
 si ((tipo = texto) y (color = 3)) entonces
 ! Definir la región rectangular alrededor de la cadena de texto actual
 ! que apunta/se vincula con la hoja correspondiente
 ! en el documento mediante el mismo nombre.
   action_item = vínculo
   action_name = caracteres
   action_type = documento
   action_spec = caracteres
 endif
endif

Ejemplo 3:

! Crear una marca en los elementos del equipo
! y asociar un video de mantenimiento con
! el equipo apropiado.
! Identificar el tipo de equipo que se abordará
si ((tipo = 2) y (nombre de célula = "Aspersor")) entonces
! Identificar el grupo de fichas
    tag_set="información de equipo"
    tag_name="número de serie"
! Definir una marca bajo el nombre de hoja de esta página
! que navegará hacia la pieza del equipo. Utilizar 
! sheet_name y TAG_CHAR para formar el nombre de elemento de acción.
    action_item = marca
    action_name = sheet_name + "." + TAG_CHAR
    action_type = AREA_OF_INTEREST
    action_spec = "." + sheet_name + "./" + TAG_CHAR
! Definir un clip de sonido multimedia que describa
! como instalar el equipo.
    action_item = soporte
    action_name = "Instrucciones de mantenimiento"
    action_type = PLAY_MEDIA
    action_spec = "c:\equipment\videos\sprinkler.wav"
endif

Palabras clave globales

Las siguientes palabras clave se pueden utilizar como sentencias de asignación, excepto para la palabra clave de first_time.

• first_time - Esta palabra clave de comparación le permite ejecutar un segmento de un guion de diseño una vez. Esta palabra clave (indicador) es TRUE la primera vez que se llama al guion de diseño y después el valor se define en FALSE. El valor no se puede reiniciar. Un buen uso de esta palabra clave se produce cuando especifica una plantilla de marca. Consulte el ejemplo al final de esta sección.
  Nota: Cuando el sistema procesa un guion de diseño, cada elemento en el archivo de diseño se procesa en un orden de arriba abajo hasta que se procese cada elemento. Si el primer elemento en el archivo de diseño ejecuta el fragmento de código first_time, los elementos restantes serán procesados, pero se saltarán el fragmento de código first_time.
• sheet_name - Especifica el nombre de la hoja actual y de la marca asociada para la página que se está trazando actualmente. El valor por defecto es el nombre de la definición de impresión.

  Sintaxis

  sheet_name = cadena

• ignore_engineering_links - Especifica que si se encuentra un vínculo de ingeniería no se lo incluya como vínculo en la interpretación activa. El valor por defecto es FALSE.

  Sintaxis

  ignore_engineering_links = <TRUE|FALSE> 

• bookmark_template - Un archivo XML que define la composición de la jerarquía de marcas.

  Sintaxis

  bookmark_template = especificación de archivo a un archivo XML 

  Nota: Si una especificación de archivo comienza con un número, necesitará preceder el número con una barra diagonal o con dos barras. Por ejemplo, bookmark_template= c:\my templates\\2004.xml o bookmark_template= c:/my templates/2004.xml.
• zoom_percentage - Le permite controlar cómo se muestra la región circundante al hacer clic en la marca de un área de interés o en un vínculo a un marcador. Si especifica un porcentaje de zoom de 100, la región rectangular se ajusta al área de ventana actual de Acrobat Viewer. Un valor de 150 designa una área 50 % mayor que el límite exacto del marcador o de la región rectangular. El valor por defecto para el porcentaje del zoom es 120. El orden en el cual aparece la palabra clave zoom_percentage en el guion de diseño es muy importante. La palabra clave zoom_percentage necesita seguir las palabras clave action_item y action_name.

  Sintaxis

  zoom_percentage = entero (donde 100 es 100 %) 

Ejemplo:

si (first_time = true) entonces
! Cargar la plantilla de marca
    bookmark_template = "d:\anystreet\mybookmarktemplate.xml"
si (cellname = "steps") luego
    action_item = BOOKMARK
    action_name = "Step Detail"
    zoom_percentage = 150
    action_type = AREA_OF_INTEREST
    action_spec = "./details/steps"
endif

Palabras clave Publicación de propiedad

Las siguientes palabras clave se utilizan para publicar meta datos de objeto en PDF. Para ver los meta datos de objeto en un documento PDF, haga clic en el Árbol de modelo en Adobe Acrobat o Reader.

• propertycontainer_name - Le permite especificar un nombre contenedor para la propiedad activa. Cuando se ha asignado un valor de cadena, las acciones de property_maptoelement posteriores provocan que la propiedad activa se coloque bajo el nombre del contenedor dado. Es posible que los contenedores no puedan anidarse. Por defecto, las propiedades de diseño-guion definidas se colocan bajo un nodo de nombre de hoja de nivel superior en el árbol modelo.

  Sintaxis:

  propertycontainer_name = “cadena”

• property_name - Especifica que está creando un nombre de objeto de propiedad. Todos los nombres de objeto de la propiedad deben ser únicos.

  Sintaxis:

  property_name = “cadena”

• property_setvalues - Especifica que está creando atributos y valores para un objeto de propiedad. Esta palabra clave también se puede utilizar para modificar o actualizar un valor de atributo.

  Sintaxis:

  property_setvalues = "atributo = valor"
  property_setvalues = "attribute1 = value1;attribute2 = value2"

• property_maptoelement - Asocia el elemento gráfico actual con el objeto de la propiedad activa.

  Sintaxis:

  property_maptoelement = true
  property_maptoelement = false

• property_setqueryvalues - Especifica que desea consultar el valor del atributo de objeto de una propiedad.

  Sintaxis:

  property_setqueryvalues = "cadena"

• property_getvalue - Especifica que desea obtener el valor del atributo de objeto de una propiedad.

  Sintaxis:

  property_getvalue = "cadena”

• property_deleteattributes - Especifica que desea eliminar el atributo de objeto de una propiedad para el objeto de la propiedad activa.

  Sintaxis:

  property_deleteattributes = "cadena" 
  property_deleteattributes = “string1; string2”

  Ejemplo 1:

  !Especificar el nombre de propiedad, definir valores de propiedad,
  !eliminar valor de propiedad y asignar a componente.
  propertycontainer_name = "Ward 1"
  if ((tipo = forma) y (level_name = 'ward 1')) luego
     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"
  !Eliminar valor de propiedad
     Property_DeleteAttributes = "Useless"
     property_maptoelement = true
  endif
  ! Definir Ward 2
  propertycontainer_name = "Ward 2"
  si ((tipo = forma) y (level_name = 'ward 2')) luego
     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

  La siguiente imagen muestra la manera en que los valores de palabra clave de propertycontainer_name (Ward 1 y Ward 2) aparecen dentro del árbol modelo de Adobe Reader/Acrobat Model. También, tenga en cuenta que la propiedad Inútil (property_setvalues = "Useless=Stuff") no aparece en el árbol modelo puesto que fue eliminada (Property_DeleteAttributes = “Inútil”).

  

Ejemplo 2:

! Consultar el valor de atributo de una propiedad.
if (type == line) luego
 property_name = "Ward 1"
   property_setqueryvalues = "City"
 si (property_getvalue=="Dacula")
    color = "red"
 endif
endif