質問
DocuWare Controlとは何ですか？
解決方法
DocuWare Controlは、特殊なコマンドを使って文書の処理を行うことができます。DocuWare Controlの設定方法はこちらをご覧ください；
DocuWare Printerを使用したDocuWare Control
DocuWare Controlの各ステートメントは、<dwControl:.
- DWControl.ttf フォントは、DocuWare Printerと一緒にインストールされます。 または、"...◆DocuWare◆Desktop◆Printer◆DWControl.ttf "にあります。
- コマンドの色やサイズは関係ありませんので、例えば白い背景に白いコマンドを使用してもかまいません。
- すべてのコマンドは、処理後に文書から削除されます。
DWControlをDocuWare Importと一緒に使用する場合は、 dwControlなしで指定する必要があります：
- DW Printer用のDWControlコマンド ：
<dwControl:Field dbName="EMPLOYEE" type="Text" value="Mark Smith"/> - DWインポート用のDWControl コマンド：
<Field dbName="EMPLOYEE" type="Text" value="Mark Smith"/> - すべてのコマンドは、.dwcontrolファイルの <Page >セクションで指定する必要が あります。
- 大文字と小文字の使い分けに注意してください。
- それぞれの.dwcontrolファイルは次の行で始まる必要がある。
<ControlStatements xmlns="http://dev.docuware.com/Jobs/Control" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> - 詳細と例については、KBA-36502を参照して ください。
DocuWare Controlコマンド：DocuWare Controlコマンドの全リストは、Knowledge Center-DocuWare Controlを参照してください。その他の例や重要な情報については、以下の情報を参照してください：
SelectConfiguration
DocuWare Printer Configurationsに慣れていれば、名前を指定して簡単に1つのConfigurationを選択できます。文書は、あたかもその設定が自動的に認識されたかのように処理されます。
<dwControl:SelectConfiguration name="Letter"/>
注意：SelectConfigurationコマンドは、他のコマンドと組み合わせて使用することはできません。ドキュメント中に他のコマンドがあっても無視されます。
NewDocument
このコマンドがドキュメントのページにある場合、そのページは新しいドキュメントの最初のページになります。
<dwControl:NewDocument />
ファイルキャビネット
この例では、文書は "Invoices & Orders "というファイルキャビネットに保存されます。
<dwControl:FileCabinet name="請求書と注文書"/>
代わりにファイルキャビネットのGUIDを使うこともできます。
<dwControl:FileCabinet id="12345678-1234-1234-1234-123456789abc"/>
バスケットまたはドキュメントトレイ
ドキュメントをバスケットに保存するにはBasket またはDocumentTrayコマンドを使います。
<dwControl:Basket name="バスケット・サンダース"/>
<dwControl:DocumentTray name="Basket-Sanders"/>
フィールド
Fieldコマンドは、保存されるドキュメントのメタデータフィールドやインデックスフィールドを埋めるためのものです。フィールドはデータベースのカラム名で識別されます。現在、以下のセクションで説明する4種類のフィールドがサポートされています。dbNameと type属性は必須です。
- テキスト/メモの値
<dwControl:Field dbName="EMPLOYEE" type="Text" value="Mark Smith"/>
<dwControl:Field dbName="MEMO" type="Memo" value="Text"/> - キーワード値
<dwControl:Field dbName="Remark" type="Keyword" value="one"/>
<dwControl:Field dbName="Remark" type="Keyword" value="two"/>
注：1つのキーワードフィールドに複数の値を格納する場合は、複数のControlコマンドが必要です。 - 数値
異なる文化圏では、コロンやドット、その他の文字の解釈が異なるため、値を正しく解釈するために文化圏を指定する必要があります。例えば、ドイツでは3.000は3000と解釈されますが、イギリスでは3と解釈されます。与えられたサンプルでは、値は 31,20として保存さ れます。
<dwControl:Field dbName="SALARY" type="Numeric" value="31,2" culture="de-CH" decimalPlaces="2" />
文書をバスケットに格納する場合、古臭いDocuWareの制限により、バスケットに格納すべき値の小数点以下の桁数を知る必要があります。指定されたサンプルでは 、 decimalPlacesが 2の 場合 、値は自動的に 3120としてバスケットに保存 されます。バスケットからファイルキャビネットに文書を手動で保存 すると、31,20と なります。decimalValues が指定されていない場合、デフォルトは 2です。 - 日付の値
<dwControl:Field dbName="EMPLOYMENTDATE" type="Date" value="2010-04-03" culture="en-US" format="yyyy-MM-dd" />
<dwControl:Field dbName="EMPLOYMENTDATE" type="Date" value="03 April 2010" culture="en-US" format="dd MMMM yyyy" />
<dwControl:Field dbName="DATUM" type="Date" value="03.04.2010" culture="de-DE" format="dd.MM.yyyy" />
<dwControl:Field dbName="DATUMZEIT" type="DateTime" value="2010-04-03 7:43P" culture="en-US" format="yyyy-MM-dd h:mmt" />
書式
レターヘッドのない文書を作成する場合は、Formコマンドを使ってレターヘッドを追加できます。このコマンドは、そのコマンドがあるページにのみ関連します。1つのページに複数のFormコマンドがある場合は、最初のものが使用されます。
フォームまたはレターヘッドとして、pdfファイルを使用する必要があります。このファイルは、pathパラメータで定義されたローカルリソースに配置することもできますし、Printer Configurationの一部とすることもできます。
ローカルリソースの使用例
<dwControl:Form path="C:\forms\letterhead.pdf" />
プリンタ構成をフォームリポジトリとして使用する
各プリンタ構成では、最初のページまたは他のすべてのページにフォームを設定できます。パ ラ メ タ configName ・ configId はその よ う な設定を参照 し ます。configForm パラ メ タは、 参照 さ れてい る 構成内の フ ォームのいずれかを選択す る ために、 最初のページには値1 を、 それ以外のページには値2 を指定す る こ と がで き ます。こ の設定には使用権が必要です。
例えば、"Letters "コンフィギュレーションがあり、最初のページにレターヘッドが定義されている場合、このコマンドで使用することができます。
<dwControl:Form configName="Letters" configForm="1"/>
印刷
文書を別のプリンタにリダイレクトしたい場合は、Printコマンドを使うことができます。プリンタの名前はdevice属性で指定できます。このプリンタのデフォルト設定が使用されます。特定の設定が必要な場合は、別の名前でプリンタのインスタンスを作成し、そこで必要な設定を定義します。
さらに、Formコマンドを使用する場合、印刷をフォーム付きにするかフォームなしにするかを選択できます。定義されたフォームを印刷したくない場合はwithoutFormの値にtrueを、そうでない場合はfalseを入力します。
<dwControl:Print device="my printer" withoutForm="true" />
定義されていない場合、withoutFormは falseに設定されます。
デフォルトのプリンターに印刷します：
<dwControl:Print
文書の最後に取引条件などの追加文書を印刷するオプションがあります。ファイルはpdf形式でなければなりません。
<dwControl:Print device="my printer" additionalFilePath="C:\terms\conditions.pdf" />
プリンタ構成を追加ファイルリポジトリとして使用する
Formコマンドと同様に、Printer Configurationsを使用して、DocuWare Controlコマンドの実行者に必要なファイルを配置することができます。
additionalFileConfigNameは、追加印刷ファイルを定義する必要があるプリンター設定を参照します。この設定には、使用権が必要です：
<dwControl:Print device="my invoice printer" additionalFileConfigName="Invoices" />
署名
文書に電子的に署名したい場合は、Signコマンドを使用できます。Formコマンドと同様に、Printer Configurationsを使って必要な情報（この場合は証明書）を読み込むことができます。
certificateConfigNameは、署名を設定しなければならないPrinter Configurationsを参照します。この設定には使用権限が必要です。
<dwControl:Sign certificateConfigName="Sign pdf" />
特殊文字
値は、シングルクォーテーション「example」またはダブルクォーテーション「example」で囲まなければなりません。
DW PrinterでDWControlを使用する場合、特殊文字をエスケープする必要はありませんが、DW ImportでDWControlを使用する場合、特殊文字を正しくエスケープする必要があります。
特殊文字を使用したDocuWare Controlに関する情報については、次のKBAを参照してください：
- .dwcontrolメタデータで特殊文字を使用するには？ -KBA-35321
- DWControlファイルにウムラウトを埋め込む 方法を教えてください。
パラメータ値で使用できない文字列
DocuWare Controlのパラメータ内でこれらの文字列を使用しないでください：
DW Control文字列"<dwControl:... "を使用しないでください：
<dwControl:Field dbName="REMARK" type="Text" value="<dwControl:NewDocument/>"/>
シングルクォーテーションの中では、シングルクォーテーションは使用できません。
<dwControl:Field dbName="REMARK" type="Text" value='Say:'Hello''/>
二重引用符の中の二重引用符は全て禁止されています。
<dwControl:Field dbName="REMARK" type="Text" value="Say:"Hello""/>
KBAはクラウドとオンプレミスの組織に適用されます 。
ご注意：この記事は英語からの翻訳です。この記事に含まれる情報は、オリジナルの英語版製品に基づくものです。翻訳版の記事で使用されている文法などには、細かい誤りがある場合があります。翻訳の正確さを完全に保証することは出来かねますが、ほとんどの場合、十分な情報が得られると思われます。万が一、疑問が生じた場合は、英語版の記事に切り替えてご覧ください。