Application Development Frameworkデスクトップ統合を使用したルールの管理
ADF Desktop IntegrationをMicrosoft Excel (ADFdi)とともに使用すると、複数のモデルおよび環境間で共通のルール・セットを維持できます。
開発環境に接続されたスプレッドシートにルール定義データをダウンロードし、オプションで定義を変更して、同じまたは別のモデルまたは環境に定義をアップロードします。
ルール管理サマリー
コンフィギュレータ・ルールの管理時には、次の操作を実行できます:
|
|
---|---|
検索 |
ドラフト・モデルのルールを管理するには、モデルをその名前、ワークスペース、またはモデルを含むワークスペースの名前で検索します。 |
作成 |
検索したモデルのルールを作成するには、Application Development Framework Desktop Integration (ADFDI)対応のスプレッドシートを使用してそのルール・データをダウンロードし、ルールの詳細を追加して、ルール・データをアップロードします。 |
更新 |
検索したモデルの既存のルールを更新するには、そのルール・データをADFDI対応のスプレッドシートにダウンロードし、ルールの特定の詳細を変更してから、ルール・データをアップロードします。 |
管理手順
次の手順は、既存のルールの更新または補足、および別の環境でのルールのレプリケートの両方に適用されます。
この機能を使用する前に、ホーム・ページから「デスクトップ統合のダウンロード」を選択して、Microsoft ExcelとのADF Desktop Integrationの最新バージョンをダウンロードしてインストールしておく必要があります。
管理するルールを含むモデルは、ドラフト・ステータスである必要があり、未リリース・ワークスペース(ステータスが「開発中」のワークスペース)の関係者である必要があります。
ADFDIを使用してルールを作成または変更するには:
-
タスク・ドロワー・パネルの「ファイルベースのデータ管理」セクションで、ルールの管理タスクをクリックします。
-
プロンプトが表示されたら、Excelスプレッドシートを開きます。
-
プロンプトが表示されたら、Configurator Models(コンフィギュレータ・モデル)作業領域に使用する資格証明を使用してサインインします。 ADFDI接続を作成するたびにサインインが必要になる場合があります。
ルールを管理するためのスプレッドシートは、Microsoft Excelで自動的に開きます。 スプレッドシートには、ルールの管理という名前のワークシート・リボン・タブで、ADFDI関数を操作するためのコントロールが含まれています。
-
ADFDIタブで「検索」ボタンをクリックします。 ルールを管理するモデルの選択基準を入力します。 検索をモデル名またはワークスペース名(あるいはその両方)で制限できます。
検索が完了したら、ルールを管理するモデルを選択し、OKをクリックします。 スプレッドシートには、モデルに現在存在する各ルールの行が移入されます。
オプションで、ADFDIタブのボタンをクリックして、ADFDI接続からログアウトし、オフラインで作業できます。
-
ダウンロードしたルールを変更する場合は、次の表の説明に従って、スプレッドシートの列を使用して、ルールの既存の値を編集したり、新しい行を挿入して更新を実行する新しいルールまたはセル値を作成できます。 値を更新できる列は、「コンフィギュレータ・モデルの編集」ページのルール・タブのフィールドに対応しています。
キー列で生成された読取り専用値は一意である必要があるため、行全体をコピーして貼り付けて既存の行のデータをレプリケートしないでください。 更新可能なセルのみをレプリケートし、シェーディングなしで表示されます。
列
更新可能?
説明
変更済
No
最後のダウンロードまたはアップロード以降に行が変更または入力されたことを示します。
問題が報告されています
No
将来使用するために予約されています。
ステータス
No
各アップロードで実行された行データの検証結果が表示されます。 値は次のとおりです。
-
更新に失敗しました
-
挿入に失敗しました
-
行が正常に挿入されました
モデル
Yes
ルールを含む既存のモデルの名前。
この方法で新しいモデルを作成することはできません。
ワークスペース
Yes
ルールを含むモデル下書きを含む既存のワークスペースの名前。
この方法で新しいワークスペースを作成することはできません。
名前
Yes
ルールの名前。
新しい名前を入力すると、指定したモデル、ワークスペースおよびフォルダに新しいルールが作成されます。 この方法で既存のルールの名前を変更することはできません。
モデルの別の下書きにすでに存在するルール名は使用できません。
説明
Yes
ルールの説明。 必要に応じて説明を変更できます。
フォルダ・パス
Yes
ルールを含むフォルダの名前とパス。 新しいフォルダ名を入力すると、モデルの最上位レベルのルール・フォルダの下に新しいフォルダが作成されます。 サブフォルダを作成または使用するには、次の表記を使用:
subfolder/sub-subfolder/...
タイプ
Yes
ルールのタイプ。 文ルールのみがサポートされています。
ルール・クラス
Yes
ルールの現在のルール・クラス。 クラスを変更するには、次のいずれかを選択します:
-
制約
-
デフォルト
-
ディシジョンの検索
ルール・テキスト
Yes
ルールを定義するCDLテキスト。
ルール・テキストは、コンフィギュレータ・モデル作業領域のルールに適用されるすべてのルールに従って、アップロード時に検証されます。 無効なルール・テキストをアップロードできますが、アップロードされたルールのステータスは「エラー」になります。
ルール・テキストの解析時にノードを正しく配置できるように、ノード名が一重引用符で囲まれていることを確認してください。 ルールがノード名で始まる場合は、その前に一重引用符を追加して、Microsoft Excelの動作に対応します。
使用可能
Yes
ルールが有効かどうか。 YesまたはNoを選択します。
ルール・ステータス
No
各アップロードで実行されるルール・テキストの検証結果を表示します。 値は次のとおりです。
-
変更済
-
有効
-
エラー
終了日
No
関係者の終了によりこのルールが無効になる日付。
エラー・メッセージ
No
アップロード中にルールを検証するときにエラー・メッセージが生成されました。 メッセージは、コンフィギュレータ・モデル作業領域で検証によって生成されたメッセージと同じです。
キー
No
スプレッドシート行とルールを関連付けるためにADFDIで使用される一意キー値。
変更する各行のスプレッドシートの「変更済」列にマーカーが表示されます。 このマーカーは、モデルにアップロードされる行を示します。
ヒント: 更新に使用するデータを含む個別のオフライン・スプレッドシートを保守し、そのデータをコピーして、ダウンロードするADFDI接続スプレッドシートに貼り付けることができます。 -
-
ADFDI 「作成または更新」ボタンをクリックして、現在のADFDI接続を使用して更新を送信します。
アップロード・プロセスでは、ダウンロードしたADFDIスプレッドシートで行った変更に基づいてルール定義が更新されます。 アップロードのたびに、スプレッドシートの各行に2ステップ検証が適用されます:
-
スプレッドシート行のデータは、ADFDIによって検証されます。 結果は「ステータス」列に表示されます。
-
ルール・テキストはコンフィギュレータによって検証されます。 結果は「ルール・ステータス」列に表示されます。
-
-
スプレッドシートの「ステータス」列および「エラー・メッセージ」列のメッセージで、更新または考えられるエラーに関する情報を確認します。
行の「ステータス」セルに「挿入に失敗しました」が含まれている場合は、更新から保留中の変更を破棄するかどうかを確認するプロンプトが表示されたらNoをクリックし、「ステータス・ビューア」ボタンをクリックして失敗の詳細を確認します。
ルール更新の影響を確認するには、影響を受けるルール・ページが開いている場合は閉じてから再度開いて表示をリフレッシュする必要があります。
ルールの移行
単一のインスタンスでルールを作成または更新する場合と同様の方法で、コンフィギュレータ・モデル作業領域のインスタンス間でルールを移行できます。
たとえば、テスト・インスタンスから本番インスタンスにルールを移行するとします。 ルールを移行するには:
-
テストにサインインし、ルールを含むモデルを検索し、そのモデルからルールをダウンロードします。
-
ダウンロードしたルール・データをスプレッドシートからテスト用にコピーします。 更新可能なセルのみをコピーします。 ここで説明する、変更可能なデータに関する制限に従うかぎり、ルールを変更できます。
ヒント: コピーしたルール・データのバックアップは、ADFDIによって接続されていない別のスプレッドシートに貼り付けることで、脇に置くことができます。 -
本番にサインインし、ルールを受信するモデルを検索し、そのモデルからルールをダウンロードします。 コピーしたルール定義で参照されるワークスペースおよびモデルは、本番に存在する必要があります。
-
テストから取得したルール・データをコピーし、本番に接続されたスプレッドシートの更新に適格な列に貼り付けます。
-
ADFDI 「作成または更新」ボタンをクリックして、本番のモデルにルール・データをアップロードします。