SignedWrite()
- Last UpdatedApr 28, 2026
- 1 minute read
セキュリティ書き込みまたは確認書き込みのセキュリティ分類で設定されたオートメーション オブジェクト属性への書き込みを実行します。
手記：SignedWrite()は現在、InTouchHMIアプリケーションでのみサポートされています。
カテゴリ
その他
構文
int SignedWrite(string Attribute,
オブジェクトの値、
StringReasonDescription,
ブールComment_Is_Editable、
Enum Comment_Enforcement,
string[] Predefined_Comment_List
);
各括弧 [ ] は配列を示します。
パラメータ
|
属性 |
これは更新する属性の名前で、文字列データタイプ。 定数文字列、参照、または式です。 バインドされている参照およびネストされたバウンド参照をサポートします。 Attribute パラメータの使用例の詳細については、『産業用グラフィックの作成および管理ユーザー ガイド』の「グラフィックの管理」の「SignedWrite() 関数で属性パラメータを使用する例」を参照してください。 例 1: "UserDefined_001.temp" 例2 "Pump15" + ".valve4" 例3 2 つの文字列属性（それぞれ "Tank1" および "Tank5" に設定された namestrA および namestrB）を含む UDO_7 を使用すると、以下のスクリプトは、strselect
が "A" に設定されているか "B" に設定されているかに応じて、Tank1.Level または Tank5.Level に書き込みます。 Dim strselect As String; [xを間接として暗くする] {strselectを「A」または「B」に設定するロジック} x.BindTo ("UDO_7.namestr" + strselect); SignedWrite(x + ".Level", 243, "Set " + x + " Level", true, 0, null); |
|
値 |
書き込まれる値です。データタイプはオブジェクトです。更新する属性のデータ型に一致する必要があります。 定数値、参照、式、またはNULL（入力するものがない場合）です。 |
|
理由説明 |
ターゲット属性の用途、およびターゲット属性を変更した場合の影響を説明するテキスト。 データタイプは、最大長が256文字の文字列です。定数文字列、参照、または式です。 ReasonDescriptionは書き込み操作の一部として示されるAttributeに渡されます。オブジェクトには、ユーザーの書き込みコメントも含まれます（存在する場合）。フィールド属性の説明は、属性がフィールド属性で、（null でない）説明がある場合のみ、ReasonDescription パラメータに使用されます。それ以外の場合、対応する ApplicationObject の短い説明が ReasonDescription パラメータに使用されます。 |
|
Comment_is _Editable |
ユーザーが書き込みコメントを編集できるかどうかを示します。 データタイプはBooleanです。 コメントテキストボックスは例外ありで有効化されています。
|
|
Comment_Enforcement |
このパラメーターはデータタイプEnumで、次の値のオプションがあります。 ランタイムユーザーはコメントを入力するか、空白のままにすることができます。 ランタイムユーザーは、コメントリストから選択するか、コメントボックスに入力することによってコメントを追加する必要があります。 ランタイムユーザーはコメントリストからコメントが選択できます。 |
|
Predefined_Comment_List |
定義済みコメントとして使用できる文字列の配列。 データタイプはstringです。最大20件のコメント。各コメントの最大長は200文字です。
|
戻り値
戻り値は成功または失敗のステータスを示します。ゼロ以外の値は失敗のタイプを示します。
|
0 |
以下の条件がすべて満たされる場合、関数は成功を意味する 0 の値を返します。
|
|
1 |
指定されたその他の戻り値によってカバーされなかったエラーが原因で関数の処理が失敗しました。指定されたその他の戻り値によってカバーされなかったエラーを示します。障害がある場合、特定のメッセージがロガーに記録されます。 |
|
2 |
ランタイム時にパラメータが適切なデータ型に強制変換されませんでした。 パラメータは、予期されるデータ型がブール値の参照です。ランタイム時、参照は True または False に強制変換できない文字列データ型です。この値が返され、メッセージがロガーに書き込まれます。 |
|
3 |
属性パラメータがランタイム時に有効ではありませんでした。
|
|
4 |
Comment_Enforcement パラメータ値は有効な列挙子の範囲外でした。 |
備考
SignedWrite() 関数はクライアント スクリプトでのみサポートされます。オブジェクト スクリプトではサポートされません。
0 の戻り値は属性が更新されたかどうかを示すものではなく、属性への書き込みのキューにエントリが配置されたことだけを示します。オペレータは、［セキュリティ書き込み］または［確認書き込み］ダイアログ ボックスが表示された後に操作をキャンセルできます。その場合、属性は更新されず、ユーザーが操作をキャンセルしたことを示すメッセージがロガーに配置されます。ユーザーが有効な資格情報を入力して［OK］を選択した場合でも、不適切な権限またはデータ強制変換の問題が原因で属性が更新されないことがあります。
SignedWrite() 関数は、開き引用符および閉じ引用符（""）で囲まれた最初のパラメータとして渡されるカスタム プロパティをサポートします。
次のスクリプトに示すようにカスタム プロパティ CP を設定した場合、関数は CP の解決を試み、参照があるかどうかを判断します。参照がある場合、参照が取得され、参照への書き込みが実行されます。
SignedWrite("CP",値,理由,編集可能,強制,Null);
SignedWrite() 関数の詳細については、『産業用グラフィックの作成および管理ユーザー ガイド』の「グラフィックの管理」の「セキュリティ書き込みおよび確認書き込みを行うための SignedWrite() 関数の操作」を参照してください。
例
SignedWrite("UserDefined_001.temp",185,"Thiswillchangetheoventemperature",true,1,Null);
次の例は、定義済みコメントの配列の使用方法を示します。
nを整数で暗くします。
SignedWrite("UserDefined_001.temp",185,"Thiswillchangetheoventemperature",true,1,Null);
ここで、UserDefined_001.OvenCommentArray は文字列の配列を含む属性です。