オブジェクト
以下は、カスタムスクリプトの作成に使用できる関数のリストです。オブジェクトインスタンスにアクセスするには、commandArgs変数を使用してください。
この章で取り扱っている変数はいずれもグローバル変数で、プログラム全体をとおして表示されます。
フィールドを扱う関数
関数 | 摘要 |
---|---|
getCurrentField() | 現在のカスタムスクリプトを使用するフィールドオブジェクトのリンクを返します。 |
getFieldByName(namesPath)(*) |
カスタムスクリプトが開かれているフィールドへのリンクを返します。 例:
|
getFieldValue(namesPath)(*) |
以下を返します:
namesPath | fieldObject:
|
setCurrentFieldValue(value、forced、onSaved) |
カスタムスクリプトが開かれたフィールド値を変更します。 パラメーター:
カスタムスクリプトの場合、モードに関係なく更新が行われます。 このパラメーターは、デフォルトではつぎのように設定されています:false。
|
setFieldValue(namesPath | field、value、forced、onSaved)(*) |
フィールド値を変更します。 パラメーター:
カスタムスクリプトの場合、モードに関係なく更新が行われます。 このパラメーターは、デフォルトではつぎのように設定されています:false。
|
save() | カスタムスクリプトが実行されるウィンドウを閉じ、変更を保存します。 |
cancel() | カスタムスクリプトが実行されるウィンドウを閉じますが、変更は保存しません。 |
(*)上記の一部の関数では、フィールドへのパスが入力パラメーターとして設定されています。これは、フィールド名と親要素(フィールドグループ、セクション)の名称で構成されます。テーブル、繰り返しテーブル、繰り返しグループの場合、0(ゼロ)から始まるインスタンス番号を設定する必要があります。 例: ここでの[10]は繰り返しグループのインスタンスの番号です。 |
データセットを扱う関数
関数 | 摘要 |
---|---|
addEntity(entityInfo: {cacheName, columns, values}, onResult(newId)) |
データベースにエントリーを追加します。 パラメーター:
|
editEntity(entityInfo: {cacheName, columns, values}, onResult()) |
データベースのエントリーを編集します。 パラメーター:
|
getDict({cacheName, filters: [{FieldName, FieldValue}], cursorPos, allowMultipleColumnResults}, onResult (param: { FieldName, FieldValue, BoldMask}[][]) ) |
指定された値またはその一部のデータセット検索を実行します。一致する文字列をつぎの形式で返します: [{FieldName パラメーター:
例えば、会社名を検索するときに「ADO」と入力し、その後ろにカーソルがある場合、値「AVOCADO」が選択されます。
この場合:
BoldMask–文字列で、「0」と「1」からなり、検索中に見つかった値と長さが同じです。「1」は、見つかった値のうち、検索フィールドで対応する文字等と一致する文字等を表しており、「0」は一致しない文字等を表しています。 例えば、つぎがデータセットに存在する場合: CompanyName: ABBYY いま仮に「ABB」という文字を検索するとします。 そうすると、以下のものが返されてきます。 [ [ { FieldName: ‘CompanyName’, FieldValue: ‘ABBYY’, BoldMask: ‘11100’ }, ] ] 注: 返される配列には、最初に検索条件に適合しなかった値をはじめ、いくつかの値を含めることができます。配列内の検索結果は、BoldMask パラメーター値により、降順にソートされます(検索条件に最も一致する文字列が先頭)。 |
getDictAll({cacheName, filters: {FieldName, FieldValue}}, }, onResult (param: { FieldName, FieldValue, BoldMask}[][])) |
指定値全体についてデータベース検索を実行します。検出されたすべてのフィールドの値を返します。 パラメーター:
BoldMask–文字列で、「0」と「1」からなり、検索中に見つかった値と長さが同じです。「1」は、見つかった値のうち、検索フィールドで対応する文字等と一致する文字等を表しており、「0」は一致しない文字等を表しています。 例えば、つぎがデータセットに存在する場合: CompanyName: ABBYY いま仮に「ABB」という文字を検索するとします。 そうすると、以下のものが返されてきます。 [ [ { FieldName: ‘CompanyName’, FieldValue: ‘ABBYY’, BoldMask: ‘11100’ }, ] ] 注: 返される配列には、最初に検索条件に適合しなかった値をはじめ、いくつかの値を含めることができます。配列内の検索結果は、BoldMask パラメーター値により、降順にソートされます(検索条件に最も一致する文字列が先頭)。 |
データベース検索スクリプトのサンプル |
文書形式で作業するための関数
関数 | 摘要 |
selectRow(tablePath、rowNumber)(*) |
テーブル行を選択済みとしてマークします。
|
deselectRow(tablePath、rowNumber?)(*) |
テーブル行から選択を削除します。
|
scrollFormToField(namesPath)(*) |
フォームエディタをスクロールして、フィールドを表示します。
|
getDomElementPosition(domId, onResult: (result?: {width, height, top, left, right, bottom})) |
フォームエディタウィンドウ内の要素の位置を取得し、コールバック関数の結果を返します。
|
setStyles(styles、callback) |
カスタムアクションフレームウィンドウにCSSスタイルを追加します。
例:
|
(*)上記の一部の関数では、フィールドへのパスが入力パラメーターとして設定されています。これは、フィールド名と親要素(フィールドグループ、セクション)の名称で構成されます。テーブル、繰り返しテーブル、繰り返しグループの場合、ゼロから始まるインスタンス番号を設定する必要があります。 例: ここでの[10]は繰り返しグループのインスタンスの番号です。 |
commandArgsオブジェクトのプロパティ
変数
変数 | 型 | 摘要 |
---|---|---|
commandArgs.params.document | 文書 | 開いている文書のオブジェクトのコピーを保存します。これを使用することで、現在の文書のエラー、フィールド、領域にアクセスできるようになります。 |
commandArgs.params.currentField | (画像 | チェックマーク | チェックマークグループ | フィールドグループ | 表 | テキストフィールド) |
スクリプトが呼び出されたときのフィールドの状態を反映するフィールドオブジェクトへのリンクを返します。上記文書の一部。 注:スクリプトが初期化された後にフィールド値が変更された場合は、変更は適用されません。 |
commandArgs.params.appPath | 文字列 | サーバーのドメイン名。 |
commandArgs.params.coordinates | オブジェクト [{X1,X2,Y1,Y2}] |
カスタムスクリプトを呼び出したDOM要素の座標。 |
commandArgs.params.currentElementDomId | 文字列 | カスタムスクリプトを呼び出したDOM要素のID。 |
関数
関数 | 摘要 |
---|---|
commandArgs.events.addEventHandler | カスタムスクリプトのグローバルコンテキストにイベントハンドラを追加します。 |
commandArgs.events.triggerHandlers | カスタムスクリプトのグローバルコンテキストでイベントトリガを実行します。 |
commandArgs.events.removeEventHandler | カスタムスクリプトのグローバルコンテキストのイベントハンドラを削除します。 |
フィールドグループフィールド
名前 | 型 | 権利 | 摘要 |
---|---|---|---|
フィールド | (画像 | チェックマーク | チェックマークグループ | フィールドグループ | 表 | テキストフィールド)[] | 読み取り専用 | フィールドの配列 |
HasTableLayout | ブーリアン | 読み取り専用 | フィールド領域を表にするかどうかを設定します。 |
キャプション | 文字列 | 読み取り専用 | カスタムフィールド名、キャプション |
フィールドタイプ | 番号 | 読み取り専用 |
フィールドのタイプ。可能な値: 4― フィールドグループ |
ID | 番号 | 読み取り専用 | フィールドID |
IsReadOnly | ブーリアン | 読み取り専用 | フィールドの編集を禁止するかどうかを設定します。 |
IsVisible | ブーリアン | 読み取り専用 | フィールドをデータフォームで表示するかどうかを設定します。 |
MaxRegions | 番号 | 読み取り専用 | フィールド領域の最大数。値が-1の場合、任意の領域数が許可されます。 |
名前 | 文字列 | 読み取り専用 | フィールドのサービス名。 |
NamePath | String[] | 読み取り専用 | フィールドへのパスを形成するフィールド名とグループ名の配列。 |
NeedRecognize | ブーリアン | 読み取り/書き込み | ルールが再度チェックされるときに、領域からフィールド値を取得するかどうかを設定します。 |
領域 | { Id: number; Status: number; PageId: Number; IsNew : Boolean; Coordinates: Object [{X1,X2,Y1,Y2}] }[] |
読み取り専用 |
領域の配列。
|
セクションフィールド
名前 | 型 | 権利 | 摘要 |
---|---|---|---|
フィールド | (画像 | チェックマーク | チェックマークグループ | フィールドグループ | 表 | テキストフィールド)[] | 読み取り専用 | フィールドの配列 |
ページID | Number[] | 読み取り専用 | – セクションが配置されているページのID。 |
IsFlexible | ブーリアン | 読み取り専用 | セクションをフレキシブルにするかどうかを設定します。 |
キャプション | 文字列 | 読み取り専用 | カスタムフィールド名、キャプション |
フィールドタイプ | 番号 | 読み取り専用 |
フィールドのタイプ。可能な値: 6― セクション |
ID | 番号 | 読み取り専用 | フィールドID |
IsReadOnly | ブーリアン | 読み取り専用 | フィールド編集を不可にするかセクション内で |
IsVisible | ブーリアン | 読み取り専用 | フィールドをデータフォームで表示するかどうかを設定します。 |
MaxRegions | 番号 | 読み取り専用 | フィールド領域の最大数。値が-1の場合、任意の領域数が許可されます。 |
名前 | 文字列 | 読み取り専用 | フィールドのサービス名 |
NamePath | String[] | 読み取り専用 | フィールドへのパスを形成するフィールド名とグループ名の配列。 |
NeedRecognize | ブーリアン | 読み取り/書き込み | ルールが再度チェックされるときに、領域からフィールド値を取得するかどうかを設定します。 |
領域 | { Id: number; Status: number; PageId: Number; IsNew : Boolean; Coordinates: Object [{X1,X2,Y1,Y2}] }[] |
読み取り専用 |
領域の配列。
|
テーブルフィールド
名前 | 型 | 権利 | 摘要 |
---|---|---|---|
行 | { Id: number; RowNumber: number; HasColorImage: boolean; TableBlockID: number[]; Cells: (Picture | Checkmark | CheckmarkGroup | TextField)[]; }[] |
読み取り専用 |
表の行のリスト。 表中のオブジェクトの行のパラメーター:
|
キャプション | 文字列 | 読み取り専用 | カスタムフィールド名、キャプション |
フィールドタイプ | 番号 | 読み取り専用 |
フィールドのタイプ。可能な値: 7- 表 |
ID | 番号 | 読み取り専用 | フィールドID |
IsReadOnly | ブーリアン | 読み取り専用 | フィールド編集を不可にするかどうかを設定します。 |
IsVisible | ブーリアン | 読み取り専用 | フィールドをデータフォームで表示するかどうかを設定します。 |
MaxRegions | 番号 | 読み取り専用 | フィールドをデータフォームで表示するかどうかを設定します-1の場合、任意の領域数が許可されます。 |
名前 | 文字列 | 読み取り専用 | フィールドのサービス名。 |
NamePath | String[] | 読み取り専用 | フィールドへのパスを形成するフィールド名とグループ名の配列。 |
NeedRecognize | ブーリアン | 読み取り/書き込み | ルールが再度チェックされるときに、領域からフィールド値を取得するかどうかを設定します。 |
領域 | { Id: number; Status: number; PageId: Number; IsNew : Boolean; Coordinates: Object [{X1,X2,Y1,Y2}] }[] |
読み取り専用 |
領域の配列。
|
テキスト入力フィールド
名前 | 型 | 権利 | 摘要 |
---|---|---|---|
文字は、 | Number[] | 読み取り/書き込み |
フィールドと同じ長さの配列値。0と1で構成されています。 0–フラグの0と同じ位置の値にある文字は、検証が必要です。 |
ыSuggests | String[] | 読み取り専用 | 推奨フィールド値リスト |
値 | 文字列 | 読み取り/書き込み | フィールド値 |
TextTypes | 番号 | 読み取り専用 |
テキストフィールドの種類。可能な値:
|
キャプション | 文字列 | 読み取り専用 | カスタムフィールド名、キャプション |
フィールドタイプ | 番号 | 読み取り専用 |
フィールドのタイプ。可能な値: 0- テキストフィールド |
ID | 番号 | 読み取り専用 | フィールドID |
IsReadOnly | ブーリアン | 読み取り専用 | フィールド編集を不可にするかどうかを設定します。 |
IsVisible | ブーリアン | 読み取り専用 | フィールドをデータフォームで表示するかどうかを設定します。 |
MaxRegions | 番号 | 読み取り専用 | フィールド領域の最大数。値が-1の場合、任意の領域数が許可されます。 |
名前 | 文字列 | 読み取り専用 | フィールドのサービス名。 |
NamePath | String[] | 読み取り専用 | フィールドへのパスを形成するフィールド名とグループ名の配列。 |
NeedRecognize | ブーリアン | 読み取り/書き込み | ルールが再度チェックされるときに、領域からフィールド値を取得するかどうかを設定します。 |
領域 | { Id: number; Status: number; PageId: Number; IsNew : Boolean; Coordinates: Object [{X1,X2,Y1,Y2}] }[] |
読み取り専用 |
領域の配列。
|
IsVerified | ブーリアン | 読み取り/書き込み | フィールドを検証するかどうかを設定します。 |
NeedVerification | ブーリアン | 読み取り専用 | フィールドの検証が必要かどうかを設定します。 |
NeedDoubleVerification | ブーリアン | 読み取り専用 | フィールドの二重検証が必要かどうかを設定します |
IsSummary | ブーリアン | 読み取り専用 | データフォーム上でのデータサマリーの形成にフィールドを使用するかどうかを設定します。 |
チェックマークフィールド
名前 | 型 | 権利 | 摘要 |
---|---|---|---|
値 | ブーリアン | 読み取り/書き込み | フィールド値 |
キャプション | 文字列 | 読み取り専用 | カスタムフィールド名、キャプション |
フィールドタイプ | 番号 | 読み取り専用 |
フィールドのタイプ。可能な値: 2- チェックマーク |
ID | 番号 | 読み取り専用 | フィールドID |
IsReadOnly | ブーリアン | 読み取り専用 | フィールド編集を不可にするかどうかを設定します。 |
IsVisible | ブーリアン | 読み取り専用 | フィールドをデータフォームで表示するかどうかを設定します。 |
MaxRegions | 番号 | 読み取り専用 | フィールド領域の最大数。値が-1の場合、任意の領域数が許可されます。 |
名前 | 文字列 | 読み取り専用 | フィールドのサービス名。 |
NamePath | String[] | 読み取り専用 | フィールドへのパスを形成するフィールド名とグループ名の配列。 |
NeedRecognize | ブーリアン | 読み取り/書き込み | ルールが再度チェックされるときに、領域からフィールド値を取得するかどうかを設定します。 |
領域 | { Id: number; Status: number; PageId: Number; IsNew : Boolean; Coordinates: Object [{X1,X2,Y1,Y2}] }[] |
読み取り専用 |
領域の配列。
|
IsVerified | ブーリアン | 読み取り/書き込み | フィールドを検証するかどうかを設定します。 |
NeedVerification | ブーリアン | 読み取り専用 | フィールドの検証が必要かどうかを設定します。 |
NeedDoubleVerification | ブーリアン | 読み取り専用 | フィールドの二重検証が必要かどうかを設定します。 |
IsSummary | ブーリアン | 読み取り専用 | データフォーム上でのデータサマリーの形成にフィールドを使用するかどうかを設定します。 |
チェックマークグループフィールド
名前 | 型 | 権利 | 摘要 |
---|---|---|---|
MaxSelectedCount | 番号 | 読み取り専用 | 選択したフィールド値の最大数 |
MinSelectedCount | 番号 | 読み取り専用 | 選択したフィールド値の最小数 |
Values | Number[] | 読み取り/書き込み | フィールド値。レコードIDの配列で、可能なフィールド値のリストを構成するもの(バリアント)。 |
バリアント | {Id:number, Name:string}[] | 読み取り専用 |
想定されるフィールド値のリスト:
|
キャプション | 文字列 | 読み取り専用 | カスタムフィールド名、キャプション |
フィールドタイプ | 番号 | 読み取り専用 |
フィールドのタイプ。可能な値: 3― チェックマークグループ |
ID | 番号 | 読み取り専用 | フィールドID |
IsReadOnly | ブーリアン | 読み取り専用 | フィールド編集を不可にするかどうかを設定します。 |
IsVisible | ブーリアン | 読み取り専用 | フィールドをデータフォームで表示するかどうかを設定します。 |
MaxRegions | 番号 | 読み取り専用 | フィールド領域の最大数。値が-1の場合、任意の領域数が許可されます。 |
名前 | 文字列 | 読み取り専用 | フィールドのサービス名。 |
NamePath | String[] | 読み取り専用 | フィールドへのパスを形成するフィールド名とグループ名の配列。 |
NeedRecognize | ブーリアン | 読み取り/書き込み | ルールが再度チェックされるときに、領域からフィールド値を取得するかどうかを設定します。 |
領域 | { Id: number; Status: number; PageId: Number; IsNew : Boolean; Coordinates: Object [{X1,X2,Y1,Y2}] }[] |
読み取り専用 |
領域の配列。
|
IsVerified | ブーリアン | 読み取り/書き込み | フィールドを検証するかどうかを設定します。 |
NeedVerification | ブーリアン | 読み取り専用 | フィールドの検証が必要かどうかを設定します。 |
NeedDoubleVerification | ブーリアン | 読み取り専用 | フィールドの二重検証が必要かどうかを設定します。 |
IsSummary | ブーリアン | 読み取り専用 | データフォーム上でのデータサマリーの形成にフィールドを使用するかどうかを設定します。 |
画像フィールド
名前 | 型 | 権利 | 摘要 |
---|---|---|---|
キャプション | 文字列 | 読み取り専用 | カスタムフィールド名、キャプション |
フィールドタイプ | 番号 | 読み取り専用 |
フィールドのタイプ。可能な値: 1– 画像 |
ID | 番号 | 読み取り専用 | フィールドID |
IsReadOnly | ブーリアン | 読み取り専用 | フィールド編集を不可にするかどうかを設定します。 |
IsVisible | ブーリアン | 読み取り専用 | フィールドをデータフォームで表示するかどうかを設定します。 |
MaxRegions | 番号 | 読み取り専用 | フィールド領域の最大数。値が-1の場合、任意の領域数が許可されます。 |
名前 | 文字列 | 読み取り専用 | フィールドのサービス名。 |
NamePath | String[] | 読み取り専用 | フィールドへのパスを形成するフィールド名とグループ名の配列。 |
領域 | { Id: number; Status: number; PageId: Number; IsNew : Boolean; Coordinates: Object [{X1,X2,Y1,Y2}] }[] |
読み取り専用 |
領域の配列。
|
セクションフィールドの繰り返しグループ
名前 | 型 | 権利 | 摘要 |
---|---|---|---|
ID | 番号 | 読み取り専用 | フィールドID |
名前 | 文字列 | 読み取り専用 | フィールド名 |
セクション | セクション[] | 読み取り専用 | のフィールドの配列セクション型 |
フィールドタイプ | 番号 | 読み取り専用 |
フィールドのタイプ。 可能な値: 8– 定期セクショングループ。 |
文書オブジェクトのプロパティ
名前 | 型 | 権利 | 摘要 |
---|---|---|---|
AssemblingErrors | { DocumentNodeRef: number[][]; Description: string; SectionName: string[] }[] |
読み取り専用 |
以下に文書のビルドエラーがあります:
|
BatchId | 番号 | 読み取り専用 | ページID |
エラー | { DocumentNodeRef: number[][]; Severity: number; Message: string; RuleName: string; }[] |
読み取り専用 |
以下に文書のエラーがあります:
|
フィールド | (Section | SectionsGroup)[] | 読み取り専用 | セクションのリスト/重複するセクション |
ID | 番号 | 読み取り専用 | 文書 ID |
インデックス | 番号 | 読み取り専用 | パッケージ内の文書のインデックス。 |
ページ | { Id: number; Modification: number; HasColorImage: boolean; ImageResolution: number; KeyValue: string; SectionTemplateId: number; SectionTemplateName: string; FlexibleInstanceId: number; SectionTemplatePageNumber: number; Comment: string; ImageWidth: number; ImageHeight: number; }[] |
読み取り専用 |
つぎのものを含む文書ページのリスト:
|
ProjectId | 番号 | 読み取り専用 | プロジェクトID |
TaskId | 番号 | 読み取り専用 | タスクID |
TemplateId | 番号 | 読み取り専用 | 文書定義ID |
TemplateName | 文字列 | 読み取り専用 | 定義ドキュメントの名前 |
TemplateVersion | 番号 | 読み取り専用 | 文書の定義バージョン |
バージョン | 番号 | 読み取り専用 | 文書のバージョン |
12.04.2024 18:16:06