オブジェクト：レシピマネージャー

タブ：ストレージ

レシピマネージャーは、ユーザー定義の変数リストを維持するための関数を提供します。レシピの定義。レシピ定義は、PLCの「レシピファイル」に保存できます。

ストレージタイプ	テキスト： CODESYS 設定された列と区切り文字を使用して、レシピを読み取り可能な形式で保存します。バイナリ： CODESYS レシピを読み取り不可能なバイナリ形式で保存します。この形式では、必要なストレージスペースが少なくて済みます。注：変数リストを変更していない場合にのみ、バイナリレシピを再度読み取ることができます。
ファイルパス	`<directory name>` 例： `AllRecipes` ランタイムシステムのパス . ノート：パスは通常、ランタイムファイルのディレクトリ内のターゲットシステム上の相対パスです（`PlcLogic`）。ディレクトリ外のパスへのアクセス `PlcLogic` すべてのコントローラーで許可されているわけではありません。 Windowsシステムの絶対パスは、を押して選択できます。ボタン。ランタイムシステムのファイルパスの例： `PlcLogic/AllRecipes` CODESYS PLCにダウンロードするときに、レシピごとにこのディレクトリにファイルを保存します。要件は、を選択することです PLCでのレシピ管理オプション。ファイルは、アプリケーションが再起動されるたびにレシピマネージャーにロードされます。
ファイル拡張子	次の形式のレシピファイルのファイル拡張子 `.<file extension>` 結果として得られるレシピファイルのデフォルト名は、次の形式になります。 `<recipe>.<recipe definition>.<file extension>`
セパレーター	保存されたファイル内の個々の値の間のセパレータ
使用可能な列選択した列	レシピファイルに保存される情報とその順序を定義します
デフォルトとして保存	CODESYS 他のすべてのレシピマネージャーのプロジェクト全体でタブの設定を使用します。

タブ：一般

PLCでのレシピ管理

standard icon ：実行時にレシピをロードするには、ユーザープログラムまたは視覚化要素に対して選択する必要があります

レシピをPLCに転送する場合は、 CODESYS プログラミングインターフェイスの場合、このオプションをクリアできます。

表 2. レシピを保存

レシピの変更をレシピファイルに自動的に保存する

いつ PLCでのレシピ管理が選択されている場合、次のオプションがあります保存レシピ：

standard icon ：レシピマネージャーが「正常に」動作するのに役立つため、このオプションをお勧めします。

PLCのレシピファイルは、レシピが変更されるたびに実行時に自動的に更新されます。

表 3. レシピを読み込む

いつ PLCでのレシピ管理が選択されている場合、PLCからダウンロードするには次の2つのオプションがあります。

変数リストと完全に一致する場合にのみダウンロードしてください

：レシピは、PLC上のファイルに、アプリケーションのレシピ定義の変数リストからのすべての変数が含まれ、これらが同じ順序でソートされている場合にのみダウンロードされます。最後の追加エントリは無視されます。必要な一致が存在しない場合、エラーステータス ERR_RECIPE_MISMATCH 設定されています（RecipeManCommands.GetLastError）。

名前が一致する変数をダウンロードする

：レシピ値は、アプリケーションのレシピ定義でPLCのレシピファイルと同じ名前を持つ変数に対してのみダウンロードされます。変数リストの構成と並べ替えが異なる場合、エラーステータスは設定されません。

その結果、ファイルまたはレシピ定義の変数が削除されている場合は、レシピファイルもダウンロードできます。

ダウンロード時に既存のレシピを上書きする

standard icon ：同じ名前のレシピファイルがコントローラーに存在する場合、アプリケーションの起動時にプロジェクトから構成された値で上書きされます。代わりに既存のレシピファイルの値をロードする必要がある場合は、このオプションを無効にする必要があります。

要件：ストレージタイプはテキストそしてそのレシピの変更をレシピファイルに自動的に保存するオプションが選択されています。

表 4. レシピを書く

PLCの変数にレシピ値を書き込むには、次のオプションを使用できます。
レシピ値が範囲外の場合は、変数を最小/最大に制限します	：レシピに定義で指定された値の範囲外の値が含まれている場合、定義された最小値または最大値がこの値の代わりにPLC変数に書き込まれます。
レシピ値が最小/最大範囲外の場合は変数に書き込まないでください	：レシピに定義で指定された値の範囲外の値が含まれている場合、PLC変数に値は書き込まれません。現在の値を保持します。

表 5. レシピを読む

次のオプションを使用できます読んだ PLCからプロジェクトのレシピへのレシピ値：

レシピの変更を確認する

常に機能ブロックを使用してください RecipeManCommands から RecipeManagement.library レシピを読む。メソッドを周期的に呼び出さないでください。これは、各呼び出しがファイルシステムに書き込まれる可能性があるためです。これは時間とコントローラーに負担をかけます。たとえば、RaspberryPiの書き込みサイクル数には制限があります。

standard icon ：各メソッド呼び出しで、現在のPLC変数値が最初にレシピに読み込まれます。次に、システムは値が変更されたかどうかをチェックします。値が変更された場合にのみ、レシピが保存されます。これは、レシピファイルが現在のレシピで上書きされることを意味します。

このオプションは、PLCでレシピ値が変更された場合にのみ、ローカルファイルシステムのレシピファイルを更新するために使用できます。ただし、チェック用の追加コードが生成されるため、パフォーマンスに影響します。

：各メソッド呼び出しで、現在のPLC変数値が最初にレシピに読み込まれます。次に、レシピがローカルファイルシステムのレシピファイルに書き込まれます。

注：ファイルシステムは各呼び出しに書き込まれるため、コントローラーに大きな負担がかかる可能性があります。

オンラインモード中のレシピ

表 6. 「レシピ変更をレシピファイルに自動的に保存する」オプションが選択されています。

メニューコマンド	プロジェクトで定義されたレシピの動作	実行時の定義済みレシピの動作
オンライン→ウォームリセットオンライン→コールドリセットオンライン→ダウンロード	すべてのレシピ定義のレシピは、現在のプロジェクトの値とともにダウンロードされます。	動的に生成されたレシピは変更されません。
オンライン→原点リセット	アプリケーションがPLCから削除されます。その後、ダウンロードを再度行うと、オンラインリセットウォームのようにレシピが復元されます。
PLCのシャットダウンと再起動	再起動後、レシピは自動的に作成されたファイルから再度ダウンロードされます。これにより、シャットダウン前と同じ状態が復元されます。
オンライン→オンライン変更	レシピの値は変更されません。ランタイムモードでは、レシピは機能ブロックコマンドを介してのみ変更できます `RecipeManCommands`。
デバッグ→停止デバッグ→開始	PLCを停止または開始しても、レシピは変更されません。

表 7. 「レシピ変更をレシピファイルに自動的に保存する」オプションが選択されていません。

行動	プロジェクトで定義されたレシピ	実行時に定義されたレシピ
オンライン→ウォームリセットオンライン→コールドリセットオンライン→ダウンロード	すべてのレシピ定義のレシピは、現在のプロジェクトの値とともにダウンロードされます。ただし、これらはメモリにのみ設定されます。レシピをファイルに保存するには、を実行する必要がありますレシピを保存明示的にコマンド。	動的に生成されたレシピは失われます。
オンライン→原点リセット	アプリケーションがPLCから削除されます。その後、ダウンロードを実行すると、レシピが復元されます。	動的に生成されたレシピは失われます。
PLCのシャットダウンと再起動	再起動後、自動的に作成されたファイルからレシピが再度ダウンロードされます。これにより、シャットダウン前と同じ状態が復元されます。
オンライン→オンライン変更	レシピの値は変更されません。ランタイムモードでは、レシピは機能ブロックコマンドを介してのみ変更できます `RecipeManCommands`。
デバッグ→停止デバッグ→開始	PLCを停止または開始しても、レシピは変更されません。

このセクションの内容:

オブジェクト：レシピマネージャー

タブ：ストレージ

タブ：一般

オンラインモード中のレシピ

検索結果