対象領域ブックマーク

ドキュメント内の特定のセクションまたはビューへのブックマークを作成できます。セクションやビューの範囲はデザインスクリプトの基準に一致する要素を囲む長方形の累積範囲により決定されます。

次の表は、対象領域ブックマークを作成するときの操作キーワードの必須値と既定値を示しています。

次のデザインスクリプトを実行すると、デジタル署名フィールドへのブックマークが作成されます。

例:

! 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

上のデザインスクリプト例を実行すると、次のブックマークが作成されます。

ドキュメントブックマーク

ドキュメントブックマークをクリックすると、PDFドキュメント内の特定のワークシートにジャンプできます。ドキュメント内の各シートには常に親ブックマークが作成されますが、ドキュメント内の他のシートにジャンプするブックマークを追加することもできます。

ドキュメントブックマークを作成するには、ブックマークがクリックされたときのジャンプ先となるシート名をaction_nameキーワードで指定します。sheet_nameキーワードを使用して各シートの名前を定義することもできます。

次の表は、ドキュメントブックマークを作成するときの操作キーワードが必須であるかと、その既定値を示しています。

例:

! 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

上のデザインスクリプト例を実行すると、次のブックマークが作成されます。

Webリンクブックマーク

Webリンクブックマークをクリックすると、Webページにジャンプできます。どの種類のブックマークを作成する場合も、action_itemキーワードにbookmarkを設定する必要があります。action_nameキーワードでは、ブックマークエントリの名前ではなくURLアドレスを指定します。ブックマークエントリの名前はaction_specキーワードの最後のエントリに基づいて決定されます。たとえば、action_specキーワードで「action_spec="/Related Web Links/TDOT Standards Specifications"」と指定した場合は、TDOT Standards Specificationsがブックマークエントリの名前になります。

action_specキーワードを使用してブックマーク階層内でのブックマークの位置を指定することもできます。action_typeはweb_urlに設定する必要があります。

次の表は、Webリンクブックマークを作成するときの操作キーワードが必須であるかと、その既定値を示しています。

例:

! 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"

上のデザインスクリプト例を実行すると、次のWebリンクブックマークが作成されます。

音声クリップブックマーク

音声クリップブックマークをクリックすると、PDFドキュメント内の音声クリップを再生できます。どの種類のブックマークを作成する場合も、action_itemキーワードにbookmarkを設定する必要があります。

action_nameキーワードではブックマークエントリの名前ではなく音声ファイルの場所を指定します。ブックマークエントリの名前はaction_specキーワードの最後のエントリに基づいて決定されます。

音声クリップブックマークを作成するときは、action_typeキーワードにplay_soundを設定する必要があります。action_specキーワードを使用してブックマーク階層内でのブックマークの位置を指定することもできます。

次の表は、音声クリップブックマークを作成するときの操作キーワードが必須であるかと、その既定値を示しています。

例:

! 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!"

文字注記ブックマーク

文字注記ブックマークをクリックすると、文字情報を表示できます。文字注記ブックマークを使用すると、DGNファイルから抽出した文字情報へのブックマークを作成して文字情報を表示することができます。ブックマーク内に文字列をハードコーディングすることも、ブックマークの任意のCharactersキーワードを表示することもできます。

どの種類のブックマークを作成する場合も、action_itemキーワードにbookmarkを設定する必要があります。文字注記ブックマークの場合は、ブックマーク項目を識別するための文字列とブックマークエントリの値をaction_nameで指定します。action_typeキーワードはtext_descriptionに設定する必要があります。

action_specキーワードを使用してブックマーク階層内でのブックマークの位置を指定することもできます。

次の表は、文字注記ブックマークを作成するときの操作キーワードが必須であるかと、その既定値を示しています。

次のデザインスクリプトを実行すると、図面のタイトルブロックから抽出したシートの説明を表示するブックマークが作成されます。

例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

上のデザインスクリプト例を実行すると、次の文字注記ブックマークが作成されます。

次のデザインスクリプトを実行すると、ドキュメント内のシートの数を表示するブックマークが作成されます。

例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

ブックマークテンプレート

ブックマーク階層のレイアウトを定義するXMLファイルを作成できます。bookmark_templateキーワードでXMLファイルの場所を指定します。たとえば、「bookmark_template = "d:\anystreet\book.xml"」のように指定します。

action_specキーワードを使用すると、ブックマーク階層内でのブックマークの位置を指定できます。action_specの値ではブックマークの階層ブランチの名前を指定し、各ブランチ名をスラッシュ文字（/）で区切ります。ピリオド文字（.）はルートまたはブックマーク階層の最上位を表します（「"./ブランチ名1/ブランチ名2/ブランチ名3"」のように指定します）。

ブックマークテンプレートを使用する場合、テンプレート内で定義されていないブランチ名が検出されるまでaction_specの値に含まれる各ブランチ名が（左から右の順に）各ブックマークテンプレートのタイトルと比較されます。定義されていないブランチ名が見つかった場合は、指定されたブランチ名を使用して新しいブランチが作成されます。以下に示すブックマークテンプレートの例を使用してaction_specを「./StormWater/Pit15/MyBookmark」に設定した場合、次のブックマークが作成されます。

Storm Water System
  1.2 Kerb Opening (PIT15)
    MyBookmark

空の階層ブランチはブックマークツリーから削除されます。ただし、XML要素内でXML属性KeepAlwaysの値を1に設定すると、このような空の階層ブランチを保持できます。この機能を使用すると、Acrobat Professionalで後から値を設定したり編集したりすることができるようにブックマーク構造を定義できます。

ブックマークテンプレートファイルの例:

<?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>