予算計画レイアウトの拡張

[アーティクル]
11/15/2023

この記事では、BudgetPlanLineActiveView テーブルの列数を拡張して、予算計画レイアウトの追加データに対応するプロセスを説明します。複数年にわたって情報を比較する場合、多くのシナリオを評価する場合、毎週または毎日の期間を評価する場合、このプロセスが必要になる場合があります。この記事は開発者が対象です。

BudgetPlanLineActiveView テーブル – この表はピボットされた予算計画データを含みます。初期状態では、36 の通貨列と 36 の数量列が含まれます。この既定の構成でユーザーは予算計画レイアウトを操作し、最大 3 年間の月次計画データを表示および比較できます。
BudgetPlanWorksheetEntity エンティティ – このエンティティは BudgetPlanLineActiveView テーブルに相当し、Microsoft Excel ワークシートのデータソースとして機能します。このエンティティの列は BudgetPlanLineActiveView テーブルの列にマップされます。テーブルの変更は、エンティティで複製する必要があります。

BudgetPlanLineActiveView テーブルで列を拡張する

4 ステップのプロセスを使用して BudgetPlanLineActiveView テーブルの列を拡張できます。これらの手順を完了したら、プロジェクトをビルドして変更を検証する必要があります。

ステップ 1: BudgetPlanLineActiveView テーブルに列を追加

プロセスを開始するには、新しい拡張機能を作成し、フィールドを追加して、追加するフィールドのデータ型を設定します。

Microsoft Visual Studio を開く
アプリケーションエクスプローラを開きます。
BudgetPlanLineActiveView テーブルで新しいプロジェクトの拡張を作成します。
デザイナーモードでテーブルを開きます。
フィールド を右クリックして 新規 > 実績 を選択します。
次に使用可能な名前を使用してフィールドに名前を付け、接尾語が増分されます (たとえば TransactionCurrencyAmount37)。
拡張データ型を BudgetPlanCurrencyAmount に設定します。
フィールド を右クリックして 新規 > 実績 を選択します。
次に使用可能な名前を使用してフィールドに名前を付け、接尾語が増分されます (たとえば Quantity37)。
拡張データ型を BudgetPlanQuantity に設定します。
必要な各拡張データ型のすべての追加列に対してステップ 5 〜 10 を繰り返します。
オプション: 金額フィールドグループの数量列に追加された通貨列を数量フィールドグループに追加します。

ステップ 2 : BudgetPlanWorksheetEntity エンティティに列を追加

BudgetPlanWorksheetEntity エンティティに列を追加するには、次の手順に従います。

既存のプロジェクトへの BudgetPlanWorksheetEntity エンティティで拡張機能を作成します。
エンティティ拡張機能をデザイナーモードで開きます。
データソースノードからフィールドノードに列をドラッグします。

ステップ 3: BudgetPlan フォームの拡張機能を作成

新しい列を含むように BudgetPlan フォームを更新するには、次の手順を実行します。

BudgetPlan フォームで拡張機能を作成します。

TransactionCurrencyAmount や数量フィールドに存在する新しいイベントハンドラーで、イベントやカスタマイズを新しいフィールドに複製します。次の例は CurrencyAmount と数量の両方に現在存在する標準イベントを示します。これらのイベントは、元の 36 の CurrencyAmount と Quantity の値を超えて作成する必要があります。

[FormDataFieldEventHandler(formDataFieldStr(BudgetPlan, BudgetPlanLineActiveView, TransactionCurrencyAmount37), FormDataFieldEventType::Modified)]
publicstaticvoid transactionCurrencyAmount37\_OnModified(FormDataObject \_sender, FormDataFieldEventArgs \_e)
{
    Object budgetPlanLineActiveView\_ds = \_sender.datasource() asFormDataSource;
    budgetPlanLineActiveView\_ds.updateTransactionCurrencyAmount(fieldNum(BudgetPlanLineActiveView, TransactionCurrencyAmount37));
}
[FormDataFieldEventHandler(formDataFieldStr(BudgetPlan, BudgetPlanLineActiveView, Quantity37), FormDataFieldEventType::Modified)]
publicstaticvoid quantity37\_OnModified(FormDataObject \_sender, FormDataFieldEventArgs \_e)
{
    Object budgetPlanLineActiveView\_ds = \_sender.datasource() asFormDataSource;
    budgetPlanLineActiveView\_ds.updateQuantity(fieldNum(BudgetPlanLineActiveView, Quantity37));
}

TransactionCurrencyAmount や数量列の作成した各コピーに対して、変更されたイベントハンドラーが存在することを確認します。
フォームデザイナーの上の検索フィールドに LineViewLinesGrid と入力して、ノードを見つけて展開します。

検索フィールドの最後で X を選択して、検索をキャンセルします。行ビューグリッドは展開されたまま表示されます。
追加したすべての新しい列を LineViewLinesGrid (グリッド) にドラッグします。
既存の命名パターンに従うように、新しいフィールドの名前を変更します (たとえば TransactionCurrencyAmount37 や Quantity37)。
Quantity と TransactionCurrencyAmounts の順序にフィールドを並べ替えます。
変更を保存します。

ステップ 4: デリゲートを介して BudgetPlanLineFieldActiveViewMapping クラスを更新

BudgetPlanLineActiveView と BudgetPlanLine テーブル間のマッピングを拡張するには、次の手順に従います。

新しいクラスを作成して gettingBudgetPlanLineFieldName デリゲートからイベントハンドラーメソッドに貼り付けます。拡張した TransactionCurrencyAmount と数量各フィールドごとに明細書が必要です。

[SubscribesTo(classStr(BudgetPlanLineFieldActiveViewMapping), staticDelegateStr(BudgetPlanLineFieldActiveViewMapping, gettingBudgetPlanLineFieldName))]
publicstaticvoid BudgetPlanLineFieldActiveViewMapping\_gettingBudgetPlanLineFieldName(FieldName \_budgetPlanLineActiveViewFieldName, EventHandlerResult \_result)
{
    FieldName budgetPlanLineFieldName;
    switch (\_budgetPlanLineActiveViewFieldName)
    {
        case
            fieldStr(BudgetPlanLineActiveView, TransactionCurrencyAmount37), fieldStr(BudgetPlanLineActiveView, TransactionCurrencyAmount38):
            budgetPlanLineFieldName = fieldStr(BudgetPlanLine, TransactionCurrencyAmount);
            break;
        case
            fieldStr(BudgetPlanLineActiveView, Quantity37), fieldStr(BudgetPlanLineActiveView, Quantity38):
            budgetPlanLineFieldName = fieldStr(BudgetPlanLine, Quantity);
            break;
    }
    \_result.result(budgetPlanLineFieldName);
}

プロジェクトの構築

プロジェクトをビルドし、データベースを同期します。

変更の検証

変更を検証するには、36 の通貨列や数量列を超える予算計画のレイアウトを作成する必要があります。すべてのステップを正しく完了した場合、各列に値を入力し値を保存して Excel で編集できます。

変更を検証した後は、拡張機能をローカルの開発環境を越えて発行および宣伝できます。