アクション

アクションの編集画面。識別と置き場所、スクリプトの区画、スクリプトが読み書きできるもの、すべての検証のメッセージ、実行の動詞とその記録、最後の実行を誰が呼び出したか、何がアクションを実行するか、有効化と無効化、複製と削除、そして実行の上限。

アクションは、アドレス空間を読み、内部値の変数とタグに書き込む JavaScript の文の集まりです。アクションは Logic の書き込みの道すじです。手動（実行）、トリガー、それにつないだダッシュボードのボタン、あるいは Process の実行の開始時か完了時に Logic のアクションの指令から走ります。Logic の欄の Actions の節でアクションを選ぶか、そのフォルダーまたは節の最上位の表でその行の開くを押すと、その編集画面が開きます（新規… > 新しいアクションで作ったアクションは開かれず、その表で強調表示されます。作成と複製を参照）。読むには Logic の表示、編集するには Logic の構成、実行するには Logic の操作が必要です。

見出しは、アクションの印、名前、「手動で実行するか、トリガーが実行してくれるスクリプトです。変数やタグに書き込みます。」の行、そしてアクションが切られている間は無効のピルを見せます。入力の欄には識別とスクリプトと使っている場所が、右側の帯には最後の実行が入ります。

識別

スクリプト

スクリプトのカードはスクリプトの編集画面そのもので、次の助言が付きます。「JavaScript の文（let、if、for、関数）です。内部値の変数は代入で書き込み（Variables.Setpoint = 21.5;）、タグは Connector.Driver.Device.Tag.Write(value) で書き込みます。読み取りに品質の関門はないので、.State() を確かめ、計算の前に ?? で欠測を守ってください。」スクリプトはキーを押すたびに自動で保存され、0.5 秒ごとに検証されます。メッセージは助言の下に出ます。検証がスクリプトを実行することはありません。

スクリプトは、式と同じアドレス空間と同じ読み取りの面の上に書く、ふつうの厳格モードの JavaScript（局所変数、if、繰り返し、関数、Math、Date、JSON）です。違いは 2 つあります。読み取りに品質の関門はありません。欠測は null として読まれるので、.State() を確かめ、計算は ?? で守ってください。悪い読み取りを扱うことこそ、アクションの役目です。そしてスクリプトは、式の変数を読めます（その公開された値です）。それを参照できないのは式だけです。

現在値のポイント（タグ、変数、警報、Process のチャンネル）は値ではなくポイントそのものなので、値はメンバーを通して読んでください：if (Variables.Start.ValueToBool())、Variables.Level.ValueToReal() > 80、if (Alarms.High.IsActive)。if、while、do、for、?: の条件、!、&&、|| の項、比較、算術（+= などの複合代入を含む）に裸で書くと、常に真とみなされるか、値が決して読まれません。if (Variables.Start) { … } は、変数の値にかかわらず、実行のたびにそのブロックを実行してしまいます。検証はこれを拒否し、代わりに読むメンバーを示します（検証が拒否するもの）。関数に渡したポイントと、ポイントのメンバーは、書いたとおりのままです。裸のポイントに対する switch やポイントを示す case（.Value で読みます）、?? の左側（.Value で読みます）、テンプレートリテラルの置き場所 ${…}（.ValueToString() で読みます）も同じです。変数への複合代入（Variables.Total += 1、-=、||= など）は、書き込む前に変数をポイントとして読むので、正しく動く単純な代入を示して拒否されます：Variables.Total = Variables.Total.ValueToReal() + 1。

アクションが書き込めるもの

現場を変えるのはちょうど 2 つの書き方で、どちらも記録される書き込みの経路を通ります。

タグは 2 つの書き込みの動詞を持ち、スクリプトは答えが要るかどうかで選びます。

待つのはアクションのレーンの上なので、遅い機器が足止めするのはその後ろのアクションだけですし、待っても書き込みが取り下げられることはありません。時間内に確認できなかった値はまだ道中にあり、届いたときにその知らせが記録されます。答えはそのとおりに述べます。「「Cmd」は 2000 ms 以内に確認できませんでした。値はまだ装置へ送信中です。」continueOnFailure を省いたか true のときは、動詞が false を答えてスクリプトは続きます。false のときは、その行で実行が終わり、相手と理由を名指しします。

書き込みだけで実行が止まることは、決してありません。何かが送られる前に拒まれた書き込みも、機器が拒んだり答えなかったりした書き込みも、その書き込みだけが失敗します。スクリプトの残りは走り、その実行は「書き込みが失敗した、成功した実行」として終わります。巻き戻しもありません。失敗した書き込みの前に適用されたものは適用されたままですし、記録はそれぞれの書き込みを、出どころをアクションとして古い値から新しい値へという形で見せます。拒否が読まれる理由は次のとおりです。

• 「「X」への書き込みを拒否しました：値が有限ではありません。」（NaN か無限大）
• 「「タグ」は connector に実体化されていません。」（無効な機器や、Connector が運んでいないタグ）
• 「「値」を「タグ」のために変換できませんでした。」
• 「「X」は「<holder>」によって書き込みから守られています。」（レシピの実行やインターロックがその信号源を押さえています）
• 「「Cmd」は書き込まれませんでした。機器が接続されていません。」（その機器が落ちていると既に分かっているので、そこへは何もキューに入りません）
• 「「タグ」への書き込みに失敗しました。Connector が動いていません。」
• 「変数「X」は見つかりませんでした。」と「「Variables.X」は式の変数です。計算される値なので、書き込むことはできません。」
• 拒否が電線から来たときは、機器やそのドライバーが答えたことを、その言葉のままに。

同じタグへの新しい書き込みが機器のキューの中で追い越した値は、失敗ではありません。「「Cmd」は送信前に新しい値に置き換えられました。」が起きたことそのもので、機器に伝えられるのは新しいほうの値です。これはどこにも報告されません。報告される先は WriteAndWait だけで、この値は出ていったほうではないので false を答えます。

実行を終わらせるのは、スクリプト自身のエラー（構文の誤り、何も指さないアドレス、例外）、書き込みが失敗した WriteAndWait(…, false)、そして実行にある実行の上限です。

実行そのものがどの失敗を伝えられるかは、誰が待ったかで決まります。何かが送られる前に拒まれた Write は、スクリプトがまだ走っているうちに拒まれるので、実行がそれを数え、操作ログ帯がそう述べます。そのあとで機器が拒んだ Write は、実行が終わってからずっと後に答えが返るので、それを運ぶのはそのアクションの名前の下のイベントのコンソールであって、実行ではありません。WriteAndWait は答えを待ったので、答えがどちらに転んでも数えます。

検証が拒否するもの

WriteAndWait のこの 3 つのメッセージは、書かれた文字そのものを見て判断します。読むだけでは決められない引数（変数や、計算される式）は、その呼び出しが実際に行われるときに判断され、そのときは同じ一文がその行で実行を終わらせます。

JavaScript の局所変数（let x = 1; x = x + 1;）は、これらの規則に触れません。

実行

実行は、開いているアクションの上のバーの先頭の動詞です。Logic の操作を持つロールにだけ描かれ、ステーションが読み取り専用の間は「ランタイム停止中」で灰色になります（エンジニアリングロックはこれを灰色にしません。実行することは操作であって、構成ではないからです）。そのロールが Logic の構成も持つときは、編集画面の下書きが先に保存され、保存された定義が実行されます。持たないときは、保存されている定義が実行されます（入力欄が読み取り専用なので、2 つが食い違うことはありません）。

実行はどれも、アクションのレーンの上で、新しいスクリプトのエンジンを使って走ります。ですから実行と実行の間に状態は漏れませんし、2 つのスクリプトが同時に走ることもありません。頼まれた順に、1 つずつ走ります。このレーンは 100 ms の周期ではありません。式、警報、確認、そしてほかから届く書き込みは、スクリプトが走っている間も進み続けるので、周期が 1 つのスクリプトの途中に入り込むことがあり、同じスクリプトの中の 2 つの読み取りが別の周期を見ることもあります。その代わり、機器を待って止まるアクションが遅らせるのは、その後ろに並んだアクションだけで、ステーションのほかの何も遅らせません。

実行は 500 ms（「スクリプトを中止しました：500 ms の制限時間を超えました（無限ループの可能性があります）。」）、100,000 文、4 MB のメモリを超えると中止され、そのたびに超えた上限を名指しするメッセージが出ます。この 500 ms が測るのはスクリプトが走っている時間です。WriteAndWait が機器を待っている間は数えるのを止め、あとから続きを数えるので、正しいスクリプトが遅い設備のせいで責められることはありません。無効なアクションは走らずに失敗します（「このアクションは無効です。」）。ランタイムが止まっているときは「ロジックのランタイムが動いていません。」と答えます。

操作ログ帯は、すべての書き込みが通ったときは「12 ms で正常に実行しました。」、スクリプト自身は終わって書き込みが通らなかったときは「12 ms で正常に実行しました。書き込み 1 件が失敗しました：Cmd：「Cmd」は書き込まれませんでした。機器が接続されていません。」（2 件目の失敗からは、その後ろが「書き込み 3 件が失敗しました。最初は：Cmd：「Cmd」は書き込まれませんでした。機器が接続されていません。」になります）、実行そのものが悪く終わったときは「実行に失敗しました：<reason>」と伝えます。

失敗した実行はイベントのコンソールに届き、そのアクションの名前と、それを呼んだもの（動詞なら手動、ボタンなら Dashboard、エージェントなら MCP、周期による実行ならそのトリガーの名前、Process の実行なら Process · <unit> · <action>）とともに記録されます。最初は警告として記録され、同じ原因で失敗し続けている間は要約され、回復したときにもう 1 行残ります。成功した実行がそこに書く記録は、その回復の 1 行だけです。拒まれた書き込みも同じやり方で、同じ名前の下でコンソールに届きます。そこで名指しされるのが実行ではなくアクションなのも同じ理由です。機器の答えは実行が終わって数秒あとに届くことがあり、そのときには失敗させるべき実行が残っていないからです。ただ成功した実行と、そこで書き込まれたすべての値は、詳細記録にだけ書かれます。周期のたびに書き込むスクリプトは値を何千も生みますし、それで埋まったコンソールでは、誰もステーションの知らせを読めないからです。

最後の実行の帯は、そのアクションが最後に走った時刻（あるいは「まだ実行していません。」）、「所要時間：N ms」、誰が呼び出したか（下で説明します）、最後のエラーを注意の形で、その実行で失敗した書き込みをそれ専用の注意の形で（操作ログ帯が運んだのと同じ一文なので、成功しながら設定値をそのままにしてしまった実行は、ここでもそう述べます）、そして次の覚え書きを見せます。「実行はアクションのレーンで、一度に 1 つずつ処理されます。イベントのコンソールに届くのは失敗した実行だけで、成功した実行と、そこで書き込まれたすべての値は詳細記録のために保たれます。トリガーは、決めた周期でアクションを呼び出します。」この帯は動いているアクションのものです。自動保存でこれが空になることはありませんが、ランタイムの再起動では空になります。

呼び出し元

所要時間の下の「呼び出し元: …」の行は、最後にアクションを実行したものを言います。

使っている場所

使っている場所のカードは、そのアクションを実行する、ステーションの中のすべてを並べます（「このアクションを実行する、ステーションの中のすべてです。」）。アクションを開いたときに読まれ、それを呼び出す Process の指令、それに結び付いたトリガー、それを実行するダッシュボードのボタンが 1 つにつき 1 行です。

何もなければ「このアクションを実行するものは、ステーションの中にありません。」と出ます。参照を読めないときは「このアクションはまだ使われている可能性があります。削除や名前の変更をする前に、もう一度お試しください。」と出て、もう一度試すが付きます。カードは読むだけなので、どのロールにも見え、ステーションがエンジニアリングでロックされている間も見えます。アクションを無効にしたり削除したりする前に読んでください。アクションがなくなった Process の指令は何も実行せず、自分のページでそう言います。

呼び出した実行を読む

Process の実行が完了時に呼び出したアクションは、その実行をユニットの LastRun の枝の下で読みます。アクションが走るときには、枝はもうその実行を持っています。開始時に呼び出したアクションは、始まる実行のメタデータを Procedure.Metadata の下で読みます。Process のポイントは、変数と違い、後ろに .Value を付けないそのままの値として読まれます。実行が持っていないポイントは null と読まれるので、確かめてから使います。

if (Process.Oven_soak.Oven_1.LastRun.Verdict === "Ok") {
  Variables.Last_serial = Process.Oven_soak.Oven_1.LastRun.Metadata.Serial;
}
const peak = Process.Oven_soak.Oven_1.LastRun.Evaluations.Soak_check.Temperature_in_range.MaxValue;
if (peak !== null) {
  Variables.Last_peak = peak;
}

アドレスは、スクリプトのどのアドレスとも同じく、まるごと書きます。変数からアドレスを組み立てることはできません。

コマンド

Actions の最上位のパネルは、すべてのアクションを、値の列にその状態とともに並べます。「有効 · 最後の実行 <when>」で、最後の実行が失敗していれば「· エラー」が、実行が成功してその書き込みが通らなかったときは「· 書き込み失敗」が付き、切られていれば「無効」です。

アクションがしないこと

Process の実行コマンドを送りませんし、手順を用意しませんし、実行のコメントも足しません（それらのポイントは、読み取り専用の準備状態と用意の値です）。警報を確認しません。並行して走りません。実行と実行の間に状態を残さず、関数も共有しません。そして、値の変化や条件で発火することはありません。実行、トリガーの周期、ダッシュボードのボタン、エージェント、Process の実行の指令だけがアクションを走らせます。Process の実行は、呼び出したアクションを決して待たず、アクションの結果が実行記録に書かれることもありません。