電子申告 (ER) 機能の一覧の拡張

  • [アーティクル]

テキスト、日時、算術、論理、情報、データ型変換、およびその他 (ビジネス ドメインの特定の関数) といったさまざまなタイプの関数がデータ変換のための電子報告式 (ER) でサポートされています。 組み込み関数に加えて、ER により使用可能な関数の一覧を拡張できます。 この記事では、新しい機能を導入するために完了しなければならない重要なタスクの概要について説明します。

重要

Microsoft Dynamics 365 Finance、Enterprise edition 7.3 では、ERExpression クラスの拡張機能の使用は非推奨になっています。 ERExpression クラスの拡張機能を使用してカスタムの組み込み ER 関数を追加する代わりに、カスタム クラスのパブリック メソッドとしてカスタム ロジックを実装することができます。 これらのメソッドは、クラス タイプまたはオブジェクト タイプのいずれかの必要な ER データ ソースを構成する ER 形式および ER モデル マッピングから呼び出すことができます。 詳細については、アプリケーション クラスのメソッドを呼び出す ER 式の設計を参照してください。

アプリケーション コードのすべての ER 機能は、ERExpression クラスを拡張するクラスとして表示されます。 2 種類の関数が認識されます。

  • 引数の数を固定 – これらの関数は、接頭語 parm (次のサンプルコードの parmInput、parmStartNumを参照してください) を持つメソッドを含むクラスで表されます。 引数の順序は、SysOperationDisplayOrderAttribute 属性によって設定されます。
  • 可変数の引数 – これらの機能は (ERExpressionGenericCase クラスを参照してください)ERIObjectContainer インターフェイスを実装するクラスで表されます。 追加の追加メソッドを使用して関数を受け入れる型を宣言します。

ER の新しい機能を導入するのに推奨されている手順を次に示します。

  • 戻り値の型に基づいて関数の基本クラスを選択します (以下のサンプル コードで ERExpressionString を参照してください)。

    • 選択したクラスを拡張する新しいクラスを作成します (サンプル コードの ERExpressionStringMid を参照してください)。

      • 必須属性を提供:

        • SysOperationLabelAttribute – この属性は、関数の名前を定義します。
        • SysOperationHelpTextAttribute – この属性は、関数のヘルプ テキストを定義します。
        • ERComponentGroupAttribute - この属性は、この機能が属するグループを定義します。 (詳細については、 電子申告 (ER) のフォーミュラ デザイナー を参照してください。)

      • 引数を提供します。

        • 引数関数の固定番号については、接頭語 parm を持つメソッドを提供し、SysOperationDisplayOrderAttribute 属性を使用して引数の順序を設定します。
        • 引数関数の変数番号で、ERIObjectContainer インターフェイスを実装します。

      • 評価方法を提供します。

次に例を示します。

/// <summary>
/// Returns the characters from the middle of a text string, given a starting position and length.
/// </summary>
[
    SysOperationLabelAttribute ('MID'),
    SysOperationHelpTextAttribute ("@ElectronicReporting:ExpressionStringMidHelpText"),
    ERComponentGroupAttribute ("@ElectronicReporting:String")
]
class ERExpressionStringMid extends ERExpressionString
{
    ERExpressionString input;
    ERExpressionInt startNum;
    ERExpressionInt numChars;
    public str evaluateString(ERIDataContext _dataContext)
    {
        return subStr(
            this.parmInput().evaluateString(_dataContext),
            this.parmStartNum().evaluateInt(_dataContext),
            this.parmNumChars().evaluateInt(_dataContext));
    }
    [DataMemberAttribute, SysOperationLabelAttribute ("@ElectronicReporting:Input"), SysOperationDisplayOrderAttribute ("1")]
    public ERExpressionString parmInput(ERExpressionString _input = input)
    {
        input = _input;
        return input;
    }
    [DataMemberAttribute, SysOperationLabelAttribute ("@ElectronicReporting:NumChars"), SysOperationDisplayOrderAttribute ("3")]
    public ERExpressionInt parmNumChars(ERExpressionInt _numChars = numChars)
    {
        numChars = _numChars;
        return numChars;
    }
    [DataMemberAttribute, SysOperationLabelAttribute ("@ElectronicReporting:StartNum"), SysOperationDisplayOrderAttribute ("2")]
    public ERExpressionInt parmStartNum(ERExpressionInt _startNum = startNum)
    {
        startNum = _startNum;
        return startNum;
    }
    public str toString()
    {
        return ERExpressionStringPresenter::namedFunctionToStr(this);
    }
}

推奨されるガイダンス

次のガイダンスは、カスタム ER 機能の設計を支援することを目的としています。

  • ER 式が Excel と同じようにされるため、可能な限り Microsoft Excel の関数名を再利用してください。 この方法で、ER のフォーミュラをエンド ユーザーにわかりやすく保持します。
  • ER では、プリミティブ データ型のリスト タイプがサポートされません。 したがって、単一の Value 項目を持つデータ コンテナー リストを使用することに決めました。
  • 新しい関数の一覧の拡張機能を新しいアプリケーションの修正プログラムとしてリリースします。 ER デザイナーは、新しいユーザー定義関数を使用する ER コンフィギュレーションの修正プログラム番号を参照します。 このタイプの構成が新しいインスタンスにインポートされるときはいつでも、必要な修正プログラムがインストールされたかどうかが ER によって評価され、ER と、構成がインポートされるバージョンとの間のコンプライアンスを維持します。

追加リソース

電子申告 (ER) の概要

電子申告 (ER) のフォーミュラ デザイナー