Ayuda de MicroStation CONNECT Edition

Marcas

Las marcas PDF funcionan igual que las tablas de contenido: son una manera fácil y práctica de navegar por un documento PDF. Las marcas de guion de diseño le dejan saltar a secciones, vistas u hojas de un documento PDF, saltar a un vínculo Web, reproducir clips de sonido y extraer información del archivo de diseño y visualizarlo con una marca.

Puede crear los siguientes tipos de marcas:

Las marcas se visualizan en el panel Navegación de Adobe Reader/Acrobat y habitualmente se ordenan en una estructura jerárquica de vista en estructura jerárquica. Algunas entradas de marcas pueden no tener acciones asociadas a ellas, como Marcas de descripción de texto. En vez de eso, se utilizan como marcas para proporcionar estructura a la jerarquía de marcas.

El software crea siempre una marca principal para cada hoja del documento. Esta entrada de marca se ha definido en el valor de la palabra clave sheet_name. Cuando hace clic en la entrada de la marca principal, el visor visualiza la hoja entera ajustada a la pantalla. El resto de las marcas de esta hoja se crean como subordinadas de la marca principal.

Usando las palabras claves del guion de diseño, puede crear marcas que permitan a Reader/Acrobat Viewer hacer zoom a una determinada sección o vista de un documento. La sección o vista la define el cuadro de rango rectangular acumulado del elemento que coincida con los criterios del guion de diseño. El zoom o el factor de escala lo define el cuadro de rango acumulado del elemento y se pueden realizar más ajustes usando la palabra clave zoom_percentage.

Puede utilizar la palabra clave action_spec para especificar la posición de la marca en la jerarquía de marcas. Para más información, consulte Plantillas de marcas.

Marca de área de interés

Puede crear una marca para una determinada sección o vista de 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.

La siguiente tabla muestra los valores requeridos o por defecto de las palabras claves de acción cuando crea una marca de área de interés.

Palabra clave Valor Valor por defecto
action_item BOOKMARK Obligatorio
action_name Una cadena única utilizada para identificar la entrada de la marca en la ficha Marcas. Obligatorio
action_type AREA_OF_INTEREST Valor por defecto: opcional
action_spec Especifica la posición de la marca en la jerarquía de marcas. Si no se especifica un valor, la marca se pondrá abajo del todo de la jerarquía actual. Opcional
action_range Element_range | cell_range Element_range
action_instance Single_instance | Multiple_instance Single_instance

El siguiente guion de diseño crea una marca en un campo de firma digital.

Ejemplo:

! Create a area of interest Digital Signature Field
! The accumulated range box of the elements below 
! defines the Digital Signature field in the PDF document.
if ((level eq 1) and (color eq 9) and (type eq 3)) then
   action_item = field 	
   action_name = "Chief Engineer" 	
   action_type = digsig_field
   action_spec = "John Doe, P.E."

 ! Create a bookmark to the Digital Signature Field
   action_item = bookmark
   action_name = "Signature Field"	!Bookmark name (unique)
   action_type = AREA_OF_INTEREST	
   action_spec = "./digsig/engineer"
endif

El ejemplo de guion de diseño anterior crea la siguiente marca.



Marca de documento

Las marcas de documento le permiten saltar a una determinada hoja de un documento PDF. El software crea siempre una marca principal para cada hoja del documento, pero puede crear marcas adicionales que salten a otras hojas del documento.

Al crear una marca de documento, la palabra clave action_name especifica el nombre de hoja al cual la marca salta cuando hace clic en ella. Cada hoja se puede definir con un nombre usando la palabra clave sheet_name.

La siguiente tabla muestra los valores requeridos o por defecto de las palabras claves de acción cuando crea una marca de documento.

Palabra clave Valor Valor por defecto
action_item BOOKMARK Obligatorio
action_name sheet_name (define el nombre de la hoja de destino). Obligatorio
action_type DOCUMENTO Obligatorio
action_spec Especifica la posición de la marca en la jerarquía de marcas. Obligatorio
action_range No aplicable No aplicable
action_instance No aplicable No aplicable

Ejemplo:

! Create a bookmark that jumps to a particular 
! sheet in a document for all sheet names beginning with plan*.
if (sheet_name eq "plan*") then
   action_item = BOOKMARK 	
   action_name = "details" 	! Sheet to jump to
   action_type = DOCUMENT
   action_spec = "./Related pages/Details drawing"
endif

El ejemplo de guion de diseño anterior crea la siguiente marca.



Marcas de vínculo Web

La marcas de vínculo Web le permiten saltar a página Web. Para todos los tipos de marcas, debería definir la palabra clave action_item en bookmark. La palabra clave action_name especifica la dirección URL y no el nombre de la entrada de la marca. El nombre de entrada de la marca se deriva de la entrada anterior de la palabra clave action_spec. Por ejemplo, si especifica action_spec="/Related Web Links/TDOT Standards Specifications" para la palabra clave action_spec, TDOT Standards Specifications es el nombre de entrada de la marca.

La palabra clave action_spec también especifica la posición de la marca en la jerarquía de marcas. action_type se debe definir en web_url.

La siguiente tabla muestra los valores requeridos o por defecto de las palabras claves de acción cuando crea una marca de vínculo Web.

Palabra clave Valor Valor por defecto
action_item BOOKMARK Obligatorio
action_name Especificación de URL HTTP (El valor define la URL del vínculo Web). ) Obligatorio
action_type WEB_URL Obligatorio
action_spec Especifica la posición de la marca en la jerarquía de marcas y define el nombre de entrada de la marca. Obligatorio
action_range No aplicable No aplicable
action_instance No aplicable No aplicable

Ejemplo:

! Create a bookmark that jumps to a Web page.
!
action_item = BOOKMARK 	
action_name = "http://www.dot.state.tx.us/cst/2003SpecProj/index.htm" 
action_type = WEB_URL
action_spec = "./Related Web Links/TDOT Standards Specifications"

El ejemplo de guion de diseño anterior crea la siguiente marca de vínculo Web.



Marca de clip de sonido

La marca de clip de sonido le permite reproducir los clips de sonido de audio de un documento PDF. Para todos los tipos de marcas, debería definir la palabra clave action_item en bookmark.

La palabra clave action_name identifica la especificación del archivo del archivo de sonido y no el nombre de la entrada de la marca. El nombre de entrada de la marca se deriva de la entrada anterior de la palabra clave action_spec.

Cuando crea una marca de clip de sonido, debe definir la palabra clave action_type en play_sound. La palabra clave action_spec especifica la posición de la marca en la jerarquía de marcas.

Nota: Si una especificación de archivo comienza con un número, tiene que poner barras diagonales o dos barras invertidas antes de dicho número. Por ejemplo, action_name = "c:\my audio files\\2004.wav" o action_name = "c:/my audio files/2004.wav".

La siguiente tabla muestra los valores requeridos o por defecto de las palabras claves de acción cuando crea una marca de clip de sonido.

Palabra clave Valor Valor por defecto
action_item BOOKMARK Obligatorio
action_name Especifica la especificación del archivo del archivo de sonido. Obligatorio
action_type PLAY_SOUND Obligatorio
action_spec Especifica la posición de la marca en la jerarquía de marcas y define el nombre de entrada de la marca. Obligatorio
action_range No aplicable No aplicable
action_instance No aplicable No aplicable

Ejemplo:

! Create a bookmark that plays a sound clip.
!
action_item = BOOKMARK
action_name = "c:\my audio files\instructions.wav"
action_type = PLAY_SOUND
action_spec = "./Audio Instructions/Listen Before Installing!"

Marcas de descripción de texto

Las marcas de descripción de texto le permiten visualizar la información del texto. Usando una marca de descripción de texto, puede extraer la información del texto de un archivo DGN y visualizarla con una marca, puede codificar una cadena de texto en una marca o puede visualizar cualquier de las palabras clave Character de una marca.

Para todos los tipos de marcas, debería definir la palabra clave action_item en bookmark. Para las marcas de descripción de texto, action_name especifica la cadena para identificar este elemento de la marca y el valor de la entrada de la marca. La palabra clave action_type se debe definir en text_description.

La palabra clave action_spec especifica la posición de la marca en la jerarquía de marcas.

La siguiente tabla muestra los valores requeridos o por defecto de las palabras claves de acción cuando crea una marca de descripción de texto.

Palabra clave Valor Valor por defecto
action_item BOOKMARK Obligatorio
action_name Cadena única para identificar este determinado elemento de marca. Este valor se utiliza como la nueva entrada de la marca. Obligatorio
action_type TEXT_DESCRIPTION Valor por defecto: opcional
action_spec Especifica la posición de la marca en la jerarquía de marcas. Si no se especifica un valor, la marca se pondrá abajo del todo de la jerarquía actual. Opcional
action_range No aplicable No aplicable
action_instance No aplicable No aplicable

El siguiente guion de diseño crea una marca que visualiza la descripción de la hoja desde el bloque de título del dibujo.

Ejemplo 1:

! Display the sheet description from the title block.
!
if (type .eq. text) then
 if ((level_name .eq. "titleblock") and (weight .eq. 1)) then
! Create a text description bookmark
    action_item = BOOKMARK 	
    action_name = characters	!Text string from the drawing. 
    action_type = text_description	
    action_spec = "./Description"
 endif
endif

El ejemplo de guion de diseño anterior crea la siguiente marca de descripción de texto.



El siguiente guion de diseño crea una marca que visualiza el número de hojas de un documento.

Ejemplo 2:

! Use a bookmark to display the number of sheets
! in the document.
if (sheet_name eq "index of sheets") then
! Create a text description bookmark
   action_item = BOOKMARK 
   action_name = total_pages 
   action_type = TEXT_DESCRIPTION	
   action_spec = "./Number of pages in document"
endif

Plantillas de marcas

Puede crear un archivo XML que defina la composición de la jerarquía de marcas. La palabra clave bookmark_templat especifica la especificación de archivo XML. Por ejemplo, bookmark_template = "d:\anystreet\book.xml".

Nota: Si una especificación de archivo comienza con un número, tendrá que poner barras diagonales o dos barras invertidas antes de dicho número. Por ejemplo, bookmark_template = "d:\anystreet\\2004book.xml" o bookmark_template = "d:/anystreet/2004book.xml".

Puede utilizar la palabra clave action_spec para especificar la posición de la marca en la jerarquía de marcas. El valor de action_spec se compone de los nombres de las ramas de la jerarquía de marcas, donde cada nombre de rama es separado por el carácter de la barra diagonal (/). El carácter del punto (.) indica la raíz o la zona superior de la jerarquía de marcas ("./branch name 1/branch name 2/branch name 3").

Si se utiliza una plantilla de marcas, cada nombre de rama en el valor de action_spec (empezando de izquierda a derecha) se compara con cada título de la plantilla de marcas hasta que encuentre un nombre de rama que no se defina en la plantilla. En esta situación, creará una nueva rama usando el nombre de rama especificado. Usando la plantilla de marcas de ejemplo (descrita más abajo), se crean las siguientes marcas cuando action_spec se define en ./StormWater/Pit15/MyBookmark.

Storm Water System
  1.2 Kerb Opening (PIT15)
    MyBookmark

Las ramas vacías de la jerarquía se quitan de la jerarquía de marcas. Sin embargo, puede mantener estas ramas jerárquicas vacías si define el valor del atributo XML KeepAlways en 1 en el elemento XML. Esta función le permite definir las estructuras de marcas que puede rellenar o editar en otro momento usando Acrobat Professional.

Archivo de plantilla de marcas de ejemplo:

<?xml version="1.0" encoding="UTF-8"  ?>
<bookmark-tree>
 <bookmark title="WasteWater">Waste Water Supply</bookmark>
 <bookmark title="WaterSupply">Water Supply System</bookmark>
 <bookmark title="StormWater">Storm Water System
  <bookmark title="PIT12">1.2 Kerb Opening (PIT12)</bookmark>
  <bookmark title="PIT13">1.2 Kerb Opening (PIT13)</bookmark>
  <bookmark title="PIT14">1.2 Kerb Opening (PIT14)</bookmark>
  <bookmark title="PIT15">1.2 Kerb Opening (PIT15)</bookmark>
  <bookmark title="PIT16">1.2 Kerb Opening (PIT16)</bookmark>
  <bookmark title="PIT17">1.2 Kerb Opening (PIT17)</bookmark>
  <bookmark title="PIT18">1.2 Kerb Opening (PIT18)</bookmark>
  <bookmark title="PIT19">1.2 Kerb Opening (PIT19)</bookmark>
  <bookmark title="PIT20" KeepAlways="1">1.2 Kerb Opening (PIT20)</bookmark>
 </bookmark>
 <bookmark title="digsig">Digital Signatures
  <bookmark title="engineer">Project Engineer</bookmark>
  <bookmark title="project">Project Manager</bookmark>
 </bookmark>
</bookmark-tree>
Nota: El archivo XML utiliza código UTF-8 para manejar los caracteres extendidos.