NAME 文書属性設定

FORMAT {%DW_SET_USER_ATTRIBUTE(属性名,属性値[,種類])}

処理中のDocuWorks文書に、文書属性を設定します。

属性名は、255文字以内で指定してください。
属性値は、種類により適した文字列を指定します。種類に適合しない文字列を指定した場合は、文字列型として設定します。

種類には、"INTEGER" (数値型), "STRING" (文字列型), "DATE" (日付型), "BOOL" (真偽値型)の何れかが指定できます。
種類が、日付型の場合は、「YYYY/MM/DD」の様に、年/月/日のフォーマットで指定します。
真偽値型では、「TRUE」(有)又は、「FALSE」(無)を指定します。

種類は省略可能です。省略した場合には、文字列型が選択されます。

属性名に以下の名前を指定した場合は、概要タブの各項目を設定できます。

NAME 文書属性取得

FORMAT {%DW_GET_USER_ATTRIBUTE(属性名)}

処理中のDocuWorks文書から、文書属性を取得します。

属性名は、255文字以内で指定してください。

属性名に以下の名前を指定した場合は、概要タブの各項目を取得できます。

NAME 文書属性削除

FORMAT {%DW_DELETE_USER_ATTRIBUTE(属性名)}

処理中のDocuWorks文書から、指定された文書属性を削除します。

属性名は、255文字以内で指定してください。

NAME TIFF画像出力

FORMAT {%DW_OUTPUT_TIFF_IMAGE(出力ファイル名,DPI(解像度),色,開始ページ,終了ページ,圧縮タイプ)}

処理中のDocuWorks文書から、Tiffイメージを出力します。

出力ファイル名は、フルパスで指定してください。
DPI(解像度)は、10〜600の数値を指定してください。

色には、"MONO" (白黒), "COLOR" (カラー),"MONO_HIGHQUALITY"(白黒高画質)の何れかが指定できます。
開始ページは、1以上の値を指定します。終了ページが開始ページより大きい場合で、文書のページが2ページ以上ある場合は、マルチTiff形式で出力されます。
圧縮タイプには、"NOCOMPRESS" , "PACKBITS","JPEG","G4"の何れかが指定できます。

NAME JPEG画像出力

FORMAT {%DW_OUTPUT_JPEG_IMAGE(出力ファイル名,解像度,色,変換ページ,圧縮タイプ)}

処理中のDocuWorks文書から、JPEGイメージを出力します。

出力ファイル名は、フルパスで指定してください。
DPI(解像度)は、10〜600の数値を指定してください。

色には、"MONO" (白黒), "COLOR" (カラー),"MONO_HIGHQUALITY"(白黒高画質)の何れかが指定できます。
変換ページは、1以上の値を指定します。
圧縮タイプには、" NORMAL " , " HIGHQUALITY "," HIGHCOMPRESS "の何れかが指定できます。

NAME BMP画像出力

FORMAT {%DW_OUTPUT_BMP_IMAGE(出力ファイル名,解像度,色,変換ページ)}

処理中のDocuWorks文書から、ビットマップイメージを出力します。

出力ファイル名は、フルパスで指定してください。
DPI(解像度)は、10〜600の数値を指定してください。

色には、"MONO" (白黒), "COLOR" (カラー),"MONO_HIGHQUALITY"(白黒高画質)の何れかが指定できます。
変換ページは、1以上の値を指定します。

ビットマップイメージは非圧縮のため、カラーで解像度を高くした場合には、出力されるファイルのサイズが大きくなります。注意してください。

NAME PDFファイル出力

FORMAT {%DW_OUTPUT_PDF_IMAGE(出力ファイル名,DPI(解像度),色,開始ページ,終了ページ,圧縮タイプ,変換方式)}

処理中のDocuWorks文書から、イメージPDFを出力します。

出力ファイル名は、フルパスで指定してください。
DPI(解像度)は、10〜600の数値を指定してください。

色には、"MONO" (白黒), "COLOR" (カラー),"MONO_HIGHQUALITY"(白黒高画質)の何れかが指定できます。
開始ページは、1以上の値を指定します。
圧縮タイプには以下のの何れかが指定できます。

圧縮タイプにMRC圧縮を指定した場合、変換方式には、以下の何れかを指定します。

NAME 総ページ数取得

FORMAT {%DW_TOTAL_PAGE}

処理中のDocuWorks文書の総ページ数を返却します。

NAME バインダ内文書数取得

FORMAT {%DW_DOCUMENTS_IN_BINDER}

処理中のバインダ内の文書数を返却します。

NAME ページ横幅取得

FORMAT {%DW_PAGE_WIDTH(ページ)}

処理中のDocuWorks文書の引数に指定されたページの横幅(単位は1/100mm)を返却します。

NAME ページ縦幅取得

FORMAT {%DW_PAGE_HEIGHT(ページ)}

処理中のDocuWorks文書の引数に指定されたページの縦幅(単位は1/100mm)を返却します。

NAME ページのノイズ除去

FORMAT {%DW_REDUCE_PAGE_NOISE(ページ,強さ)}

処理中のDocuWorks文書の指定ページをノイズ除去します。 強さにはNORMAL(普通),WEAK(弱),STRONG(強)の何れかが指定可能です。

NAME ページの回転

FORMAT {%DW_ROTATE_PAGE(ページ,角度)}

処理中のDocuWorks文書の指定ページを指定角度回転させます。(時計回り) 角度には90 , 180 , 270 の何れかが指定可能です。

NAME ページの自動正立

FORMAT {%DW_ROTATE_PAGE_AUTO(ページ)}

処理中のDocuWorks文書の指定ページを自動正立します。

NAME ページの削除

FORMAT {%DW_DELETE_PAGE(ページ)}
{%DW_DELETE_PAGE(ユーザーデータ名)}

処理中のDocuWorks文書の指定ページを削除します。引数に数字が指定された場合は指定されたページを削除します。引数にユーザーデータ名が指定された場合は、指定されたユーザーデータに存在するキー(キーにページ番号をセットした状態。値は参照しません。)のページを削除します。

NAME ページの挿入

FORMAT {%DW_INSERT_DOCUMENT(ページ,ファイル名)}

処理中のDocuWorks文書の指定ページに、別のDocuWorks文書を挿入します。指定したページ番号の前に文書を挿入します。また、ページの指定に「BOTTOM」を指定すると、最終ページに挿入します。

NAME テキストアノテーション貼り付け

FORMAT {%DW_PASTE_TEXT_ANNOTATION(ページ,テキスト,X座標,Y座標,ユーザデータ名[,アノテーション番号])}

処理中のDocuWorks文書の指定ページにテキストアノテーションを貼り付けます。

アノテーションインポート機能を使うと簡単にマクロを作成できます。（ マクロ実行設定 参照）

テキストには任意の文字列を指定します。読み取り結果マクロなどを指定することもできます。

座標には、テキストを貼り付ける位置を左上を基準として指定します。(単位は1/100mm)

ユーザデータ名には、フォント情報等がセットされたユーザデータ名を指定します。

ユーザデータで設定可能な項目は以下の通りです。設定を行わない場合は、既定値が設定されます。

付箋上に貼り付ける場合は、付箋貼り付けマクロで返却されるアノテーション番号を指定します。

NAME リンクアノテーション貼り付け

FORMAT {%DW_PASTE_LINK_ANNOTATION(ページ,リンクテキスト,X座標,Y座標,ユーザデータ名)}

処理中のDocuWorks文書の指定ページにリンクアノテーションを貼り付けます。

リンクテキストには任意の文字列を指定します。読み取り結果マクロなどを指定することもできます。

座標には、リンクを貼り付ける位置を左上を基準として指定します。(単位は1/100mm)

ユーザデータ名には、属性情報がセットされたユーザデータ名を指定します。

ユーザデータで設定可能な項目は以下の通りです。設定を行わない場合は、既定値が設定されます。

NAME ビットマップアノテーション貼り付け

FORMAT {%DW_PASTE_BITMAP_ANNOTATION(ページ,ビットマップファイル名,X座標,Y座標[,アノテーション番号])}

処理中のDocuWorks文書の指定ページにビットマップ画像を貼り付けます。

アノテーションインポート機能を使うと簡単にマクロを作成できます。（ マクロ実行設定 参照）

ビットマップファイル名にはフルパスでファイルを指定します。

座標には、ビットマップ画像を貼り付ける位置を左上を基準として指定します。(単位は1/100mm)

付箋上に貼り付ける場合は、付箋貼り付けマクロで返却されるアノテーション番号を指定します。

NAME 矩形アノテーション貼り付け

FORMAT {%DW_PASTE_RECT_ANNOTATION(ページ,X座標,Y座標,幅,高さ,ユーザデータ名[,アノテーション番号])}

処理中のDocuWorks文書の指定ページに矩形アノテーションを貼り付けます。

アノテーションインポート機能を使うと簡単にマクロを作成できます。（ マクロ実行設定 参照）

座標には、矩形を貼り付ける位置を左上を基準として指定します。(単位は1/100mm)

ユーザデータ名には、矩形情報がセットされたユーザデータ名を指定します。

ユーザデータで矩形情報として設定可能な項目は以下の通りです。設定を行わない場合は、既定値が設定されます。

付箋上に貼り付ける場合は、付箋貼り付けマクロで返却されるアノテーション番号を指定します。

NAME 直線アノテーション貼り付け

FORMAT {%DW_PASTE_LINE_ANNOTATION(ページ,X座標,Y座標,水平移動量,垂直移動量,ユーザデータ名[,アノテーション番号])}

処理中のDocuWorks文書の指定ページに直線アノテーションを貼り付けます。

アノテーションインポート機能を使うと簡単にマクロを作成できます。（ マクロ実行設定 参照）

座標には、直線を貼り付ける位置を左上を基準として指定します。(単位は1/100mm)

ユーザデータ名には、直線情報がセットされたユーザデータ名を指定します。

ユーザデータで直線情報として設定可能な項目は以下の通りです。設定を行わない場合は、既定値が設定されます。

矢印をなしに指定した場合は、矢印の形状を指定することができます。

インポート機能で読み込みを行った場合、斜め線や矢印線で正確な位置が読み取れない場合があります。仕様上の制限となりますのでご了承ください。

付箋上に貼り付ける場合は、付箋貼り付けマクロで返却されるアノテーション番号を指定します。

NAME 日付印アノテーション貼り付け

FORMAT {%DW_PASTE_DATESTAMP_ANNOTATION(ページ,上部テキスト,下部テキスト,X座標,Y座標,ユーザデータ名[,幅][,アノテーション番号])}

処理中のDocuWorks文書の指定ページに日付印アノテーションを貼り付けます。

アノテーションインポート機能を使うと簡単にマクロを作成できます。（ マクロ実行設定 参照）

上部テキスト、及び下部テキストには任意の文字列を指定します。

座標には、日付印を貼り付ける位置を左上を基準として指定します。(単位は1/100mm)

ユーザデータ名には、日付印の属性情報がセットされたユーザデータ名を指定します。

幅には日付印の幅を指定します。省略可。(単位は1/100mm) (DocuWorks6.2以上)

ユーザデータで 日付印の属性 情報として設定可能な項目は以下の通りです。設定を行わない場合は、既定値が設定されます。

付箋上に貼り付ける場合は、付箋貼り付けマクロで返却されるアノテーション番号を指定します。

NAME 付箋アノテーション貼り付け

FORMAT {%DW_PASTE_FUSEN_ANNOTATION(ページ,X座標,Y座標,幅,高さ,ユーザデータ名)}

処理中のDocuWorks文書の指定ページに付箋アノテーションを貼り付けます。

座標には、付箋を貼り付ける位置を左上を基準として指定します。(単位は1/100mm)

ユーザデータ名には、属性情報がセットされたユーザデータ名を指定します。

ユーザデータで属性情報として設定可能な項目は以下の通りです。設定を行わない場合は、既定値が設定されます。

塗り潰し色にはカラーコードを指定することも可能です。

マクロの戻り値はアノテーション番号となっています。戻り値をユーザーデータにセットして、テキストアノテーションの貼り付けマクロに、アノテーション番号を指定すると、付箋上に貼り付けることができます。

NAME アノテーションツールファイルの貼り付け

FORMAT {%DW_PASTE_ANNOTATION_TOOL_FILE(ページ,X座標,Y座標,アノテーションツールファイル名,番号[,親アノテーション番号])}

処理中のDocuWorks文書の指定ページに、アノテーションツールファイルの指定番号のアノテーションを貼り付けます。

本マクロはDocuWorks8.0以降で使用できます。

座標には、アノテーションを貼り付ける位置を左上を基準として指定します。(単位は1/100mm)

アノテーションツールファイル名には、アノテーションツールファイル(.ann)のフルパスファイル名を指定します。アノテーションツールファイルは、事前にDocuWorks Viewerで作成しておく必要があります。

アノテーションツールファイルは通常「C:\Users\dev\Documents\Fuji Xerox\DocuWorks\DWFolders\Annotations」に格納されています。このフォルダから拡張子「.ann」のファイルを別フォルダにコピーして参照するようにしてください。

番号には、貼り付けを行うアノテーションツールファイルのアノテーションの番号を指定します。指定した番号が存在しない場合は、「AddAnnotationFile : その他のエラーです。」とエラーになります。

付箋上に貼り付ける場合は、付箋貼り付けマクロで返却されるアノテーション番号を親アノテーション番号に指定します。座標は付箋上の左上(0,0)からの位置となります。

マクロの戻り値はアノテーション番号となっています。貼り付けたアノテーションが、付箋などの貼り付け可能なアノテーションの場合、戻り値をユーザーデータにセットして、テキストアノテーションの貼り付けマクロにアノテーション番号を指定すると、アノテーション上に貼り付けることができます。貼り付けが出来ないアノテーションの場合はエラーとなります。

NAME アノテーション削除(タイプ別)

FORMAT {%DW_DEL_ANNO_TYPE(ページ,タイプが定義されたユーザデータ名,[座標範囲が定義されたユーザデータ名])}

処理中のDocuWorks文書の指定ページのアノテーションを削除します。アノテーションのタイプと座標範囲を指定できます。座標範囲は省略可能です。

タイプを指定するユーザデータで設定可能な項目は以下の通りです。ユーザーデータにはキーのみを指定して、値は空文字をセットします。データは複数指定することが可能です。(例3参照)

座標範囲を指定するユーザデータで設定可能な項目は以下の通りです。ユーザーデータのキーには、以下の項目をセットして、値には座標を1/100mm単位で指定します。(例4,例5参照)

NAME アノテーション削除(テキスト)

FORMAT {%DW_DEL_ANNO_TEXT(ページ,正規表現,[座標範囲が定義されたユーザデータ名])}

処理中のDocuWorks文書の指定ページの検索文字に合致するテキストアノテーションを削除します。検索用の正規表現と座標範囲を指定できます。座標範囲は省略可能です。

正規表現には、検索する文字を正規表現で記述します。正規表現は//で囲い最後に以下のオプションが指定出来ます。例えば「番号」が含まれるテキストアノテーションを対象にする場合には、「/番号/」と指定します。

iオプションは大文字小文字を区別しないので、NoやNOどちらも対象にしたい場合には、「/NO/i」と指定します。

座標範囲を指定するユーザデータで設定可能な項目は以下の通りです。ユーザーデータのキーには、以下の項目をセットして、値には座標を1/100mm単位で指定します。(アノテーション削除(タイプ別)の例4,例5参照)

例3では、「No.」に「.」が含まれています。「.」は正規表現での意味のある文字になりますので、直前に「\」をつけて、「\.」と指定しますが、eDocArrangementのマクロでも「\」はエスケープ文字になりますので、「\\.」と表記します。

NAME アノテーション削除(日付印)

FORMAT {%DW_DEL_ANNO_STAMP(ページ,正規表現,[座標範囲が定義されたユーザデータ名])}

処理中のDocuWorks文書の指定ページの検索文字に合致する日付印アノテーションを削除します。検索用の正規表現と座標範囲を指定できます。座標範囲は省略可能です。

正規表現には、検索する文字を正規表現で記述します。正規表現は//で囲い最後に以下のオプションが指定出来ます。

日付印から取得される文字は、以下のようにタグで囲まれた文字となって取得されます。本マクロの正規表現は、以下のタグ付き文字列に対して検索を行うためのものです。

座標範囲を指定するユーザデータで設定可能な項目は以下の通りです。ユーザーデータのキーには、以下の項目をセットして、値には座標を1/100mm単位で指定します。(アノテーション削除(タイプ別)の例4,例5参照)

NAME ページ情報取得

FORMAT {%DW_GET_PAGE_INFORMATION(ページ)}

処理中のDocuWorks文書の指定ページの情報を取得します。

取得できる情報は以下の通りで、結果は「PageInformation」という名前のユーザデータに格納されます。

インストールされているDocuWorksのバージョンによって取得できる情報が変わります。

NAME ページカラー情報取得

FORMAT {%DW_GET_PAGE_COLOR_INFORMATION(ページ)}

処理中のDocuWorks文書の指定ページのカラー情報を取得します。取得できる情報は以下の通りで、結果は「PageInformation」という名前のユーザデータに格納されます。

インストールされているDocuWorksのバージョンによって取得できる情報が変わります。

NAME 文書属性のコピー

FORMAT {%DW_COPY_ATTRIBUTE(XDW文書ファイル名,SUMMARY|USER)}

処理中のXDW文書に引数で指定したXDW文書から文書属性をコピーします。

2番目の引き数にSUMMARYを指定すると文書属性の概要がコピーされます。USERを指定するとユーザー定義属性がコピーされます。SUMMARY|USERを指定すると両方がコピーされます。

NAME アノテーションのコピー

FORMAT {%DW_COPY_ANNOTATION(XDW文書ファイル名)}

処理中のXDW文書に引数で指定したXDW文書からアノテーションをコピーします。

コピー元とコピー先のXDW文書はページ数、用紙サイズを一致させるようにしてください。コピー元のページ数が多い場合は、コピー先にないページ番号以降の全てのアノテーションが、コピー先の最終ページに貼り付きます。また、ページサイズが違う場合はコピー先のページサイズに収まるように位置が調整されます。

カスタムアノテーション以外のアノテーションが対象となります。カスタムアノテーションを含む場合はエラーとなります。エラーとなった場合に出力されるメッセージは、「関数の引数に仕様外の値を渡しました。」となり、エラーの詳細はわかりません。コピー元となるXDW文書は新規で作成して、必要なアノテーションのみを追加したファイルを対象としてください。コピー元となるXDW文書のアノテーションの内容が不定の場合、本マクロを使用するのは推奨できません。このマクロはDocuWorksAPIのXDW_SucceedAttributeを使用していますので、仕様はXDW_SucceedAttributeと同じとなります。

NAME アノテーションの表示/非表示の切り替え

FORMAT {%DW_SHOW_AND_HIDE_ANNOTATION(SHOW|HIDE)}

XDW文書のアノテーションの表示/非表示を切り替えます。引数にSHOWを指定すると表示状態となります。HIDEを指定すると非表示状態となります。文書が複数ページの場合はすべてのページが対象となります。

NAME 検索文字の座標取得

FORMAT {%DW_GET_TEXT_POSITION(ページ,検索文字列,結果返却用ユーザーデータ,大文字小文字同一視(0|1),全角半角同一視(0|1),ひらがなカタカナ同一視(0|1),パディング値)}

検索文字列で指定された文字を、指定ページから検索し、見つかった文字の位置と高さと幅を結果返却用ユーザーデータにセットします。検索文字はスペース区切りで複数の文字を指定できます。

""で囲うとスペースを含めたそのままの文字で検索できます。""で囲わない場合に、スペースを検索対象としたい場合は、スペースの直前に\を付けます。\を検索する場合は、\\と記述します。"も特別な意味を持つことになるので、"を検索するときは\"と記述します。

検索対象はアプリケーション文書のテキスト情報、または、イメージ文書をOCR処理した結果のテキスト情報のいずれかとなります。イメージ文書は事前にOCR処理を行う必要があります。 (DocuWorks9以降はイメージ文書をOCR処理した場合は、取得不可となりました。)

大文字小文字同一視、全角半角同一視、ひらがなカタカナ同一視は、0又は1を指定します。1が指定されると、検索時に大文字小文字(全角半角、ひらがなカタカナ)を同一視して検索を行います。

パディング値(1/100mm)を指定すると、見つかった矩形にパディングを付けた状態で座標とサイズをセットする。

結果は複数になる場合があるため、「結果返却用ユーザーデータ名 + "_" + 番号(1〜)」の名前でユーザーデータが作成されます。結果の数は、「{%GET_USER_DATA(結果返却用ユーザーデータ名,Count)}」で取得できます。

1つの見つかった文字が、複数の矩形で構成される場合があります。文字が折り返している場合などは1行目と2行目が別の矩形となり、2つの矩形情報が取得されます。そのため、矩形の個数とインデックスを取得できるようにしてあります。

また、複数の矩形を一つにまとめた矩形の情報も取得できます。(RectIndexとRectCountが等しい場合に「MergeRectX, MergeRectY, MergeRectWidth, MergeRectHeight」にセットされます。矩形が1つだった場合は、これらの値は矩形の情報と同じになります。)

格納されるユーザーデータの内容は以下の通りです。

NAME 用紙サイズ取得

FORMAT {%DW_GET_PAPER_SIZE(幅,高さ,誤差範囲)}

用紙サイズを返却します。

引数の幅、高さには用紙の幅と高さを指定します。誤差範囲には、幅と高さの誤差の範囲をしていします。すべて1/100ミリ単位で指定します。
通常は幅と高さには、DW_GET_PAGE_INFORMATIONマクロで取得したページや元データの幅や高さを指定します。

返却される用紙サイズは、A0〜A6,B0〜B6,該当なしの何れかになります。用紙サイズの後ろに縦、及び横の文字が付加されて返却されます。
例えば、用紙サイズがA4縦の場合には、「A4縦」という文字が返却されます。定義済の用紙サイズの何れにも該当しない場合は、「該当なし」という文字が返却されます。

用紙の判定は、インストールフォルダにあるPaperSize.iniに記述されている数値を基に行われます。PaperSize.iniに追記、変更することで独自の用紙サイズ判定を行うことが可能です。

NAME 空のバインダを作成

FORMAT {%DW_CREATE_BINDER(バインダファイル名)}

空のバインダを作成します。バインダファイル名は、フルパスで指定してください。

NAME バインダにXDW文書を挿入

FORMAT {%DW_INSERT_DOCUMENT_TO_BINDER(XDWファイル名,バインダファイル名[,挿入位置])}

バインダにXDWファイルを挿入します。XDWファイル、及びバインダファイル名は、フルパスで指定してください。挿入位置に1を指定した場合は、バインダの先頭に文書を挿入します。挿入位置を省略した場合は、バインダの末尾に文書を挿入します。

文書の挿入に成功した場合は、戻り値にOKを返却します。

NAME バインダ内の全ての文書名を取得

FORMAT {%DW_GET_NAMES_OF_ALL_DOCUMENTS_IN_BINDER(バインダファイル名,結果用ユーザーデータ名)}

バインダに格納されている文書の名前を全て取得します。バインダファイル名はフルパスで指定してください。結果はユーザーデータに格納します。「キー:文書番号(1〜)、データ:文書名」の形式で格納されます。

NAME バインダ内文書の全てのページ数を取得

FORMAT {%DW_GET_PAGES_OF_ALL_DOCUMENTS_IN_BINDER(バインダファイル名,結果用ユーザーデータ名)}

バインダに格納されている文書のページ数を全て取得します。バインダファイル名はフルパスで指定してください。結果はユーザーデータに格納します。「キー:文書番号(1〜)、データ:ページ数」の形式で格納されます。

NAME バインダ内文書を全て出力

FORMAT {%DW_GET_ALL_DOCUMENTS_FROM_BINDER(バインダファイル名,出力フォルダ名)}

バインダに格納されている文書を全て出力します。バインダファイル名、出力フォルダ名はフルパスで指定してください。出力フォルダは事前に作成する必要があります。出力フォルダが存在しない場合は、エラーとなります。

また、出力フォルダに出力されるファイルと同名のファイルがある場合も、エラーとなります。

NAME バインダ内の指定の文書を出力

FORMAT {%DW_GET_DOCUMENT_FROM_BINDER(バインダファイル名,文書番号,出力ファイル名)}

バインダに格納されている文書を、文書番号(1〜)を指定して出力します。バインダファイル名、出力ファイル名はフルパスで指定してください。

出力されるファイルと同名のファイルがある場合は、エラーとなります。

NAME バインダ内の指定の文書を削除

FORMAT {%DW_DELETE_DOCUMENT_IN_BINDER(バインダファイル名,文書番号)}

バインダに格納されている文書を、文書番号(1〜)を指定して削除します。バインダファイル名はフルパスで指定してください。

文書の削除に成功した場合は、戻り値にOKを返却します。

NAME 処理中の文書を保存する。

FORMAT {%DW_SAVE_DOCUMENT}

このマクロはアノテーションを大量に追加してから、ページ情報を取得すると、異常に時間がかかってしまう問題の回避用です。

eDocArrangementでは、ファイルのオープン、クローズはマクロ内で行うので、ユーザー様はあまり意識しなくてもよい設計になっています。マクロ実行では、ページ毎にマクロを実行する機能があり、その機能を使った場合は、マクロ毎ではなく、最初にオープンを行い、複数ページ処理した後で、最後に保存とクローズを行うようになります。

DocuWorksAPIには、アノテーション貼り付けを何度も行ったあとに、ページ情報を取得するAPI(GetPageInformation)を呼び出すと異常に時間がかかってしまう問題が存在します。

eDocArrangementでは、ページ情報取得マクロ(DW_GET_PAGE_INFORMATION)や、付箋アノテーション貼り付けマクロ(DW_PASTE_FUSEN_ANNOTATION)で、ページ情報取得のAPIを使用しています。

そのため、複数のアノテーションを貼り付けたあとで、付箋アノテーションを貼り付けるようなマクロを書くと、異常に時間がかかるようになります。

この問題の回避方法として、アノテーションを貼り付けた後で、一度保存を行うと改善されるという現象があります。何度も保存するのは無駄ですが、不具合で待たされる時間より、保存の速度の方が速いので実用として使えます。

使用方法は、複数のアノテーションを貼り付けて、その後、付箋アノテーションを貼り付けたり、ページ情報取得マクロを使ったりする場合は、その直前などで、本マクロを記述してください。

NAME オリジナルデータ数取得

FORMAT {%DW_GET_COUNT_OF_ORIGINAL_DATA}

XDW文書等のオリジナルデータの数を取得します。

処理中のファイルが入れ物の場合は、入れ物内のファイルの数を取得します。(DW9以上のみ)

処理中のファイルがバインダの場合は、バインダ内のXDW文書のオリジナルデータの数を取得します。番号は通番となります。

NAME オリジナルデータの名前取得

FORMAT {%DW_GET_NAMES_OF_ORIGINAL_DATA(結果用ユーザーデータ名)}

XDW文書等のオリジナルデータのファイル名リストを取得します。

処理中のファイルが入れ物の場合は、入れ物内のファイル名リストを取得します。(DW9以上のみ)

処理中のファイルがバインダの場合は、バインダ内のXDW文書のオリジナルデータのファイル名リストを取得します。番号は通番となります。

結果は「キー:番号(1〜)、データ:ファイル名」の形式で格納されます。

NAME オリジナルデータ取得

FORMAT {%DW_GET_ORIGINAL_DATA(番号,出力ファイル名)}

XDW文書等のオリジナルデータをファイルに出力します。番号には、1〜オリジナルデータ数のいずれかを指定します。

処理中のファイルが入れ物の場合は、入れ物内のファイルを出力します。(DW9以上のみ)

処理中のファイルがバインダの場合は、バインダ内のXDW文書のオリジナルデータを出力します。番号の指定は通番となります。

出力先に同名のファイルがある場合は、ファイル名の末尾に連番を付与して、重ならないファイル名で出力されます。

NAME オリジナルデータ挿入

FORMAT {%DW_INSERT_ORIGINAL_DATA(挿入先ファイル名,挿入元ファイル名,[位置])}

XDW文書等にオリジナルデータを挿入します。挿入元ファイル名には、オリジナルデータを格納するXDW文書、又は入れ物(DW9以上のみ)を指定します。挿入元ファイル名には、オリジナルデータとして挿入するファイルを指定します。位置は、挿入する位置の番号(1〜)を指定します。位置を省略すると末尾に挿入されます。

挿入先ファイル名に入れ物を指定した場合は、入れ物にファイルを挿入します。(DW9以上のみ)

オリジナルデータの挿入は、バインダに対して行う事ができません。(エラーとなります。)

オリジナルデータの挿入に成功した場合は、戻り値にOKを返却します。

オリジナルデータを挿入すると、挿入した位置以降の番号が後ろにずれます。例えば、以下のような状態で、

1:aaa.pdf
2:bbb.pdf

1の位置に「ccc.pdf」を挿入すると以下のようになります。

1:ccc.pdf
2:aaa.pdf
3:bbb.pdf

NAME オリジナルデータ削除

FORMAT {%DW_DELETE_ORIGINAL_DATA(ファイル名,番号)}

XDW文書等のオリジナルデータを削除します。ファイル名には、オリジナルデータを削除するXDW文書、バインダー、又は入れ物(DW9以上のみ)を指定します。位置は、削除する番号(1〜)を指定します。

ファイル名に入れ物を指定した場合は、入れ物内のファイルを削除します。(DW9以上のみ)

ファイル名にバインダーを指定した場合は、バインダ内のXDW文書のオリジナルデータを削除します。番号の指定は通番となります。

オリジナルデータの削除に成功した場合は、戻り値にOKを返却します。

オリジナルデータを削除すると、削除した位置以降の番号が前にずれます。例えば、以下のような状態で、

1:aaa.pdf
2:bbb.pdf
3:ccc.pdf

1を削除すると以下のようになります。

1:bbb.pdf
2:ccc.pdf