addNotification (クライアントAPI参照)

エラー または 推奨 通知をコントロールに対して表示し、通知に基づいて実行するアクションを指定することができます。 通知のエラーの種類を指定するときは、赤の "X" アイコンはコントロールの横に表示されます。 通知の推奨の種類を指定するときは、"i" アイコンはコントロールの横に表示されます。 Dynamics 365 モバイル クライアント上でアイコンをタップすると、メッセージが表示され、適用ボタンをクリックするまたはメッセージを閉じることによって、設定済みのアクションを実行することができます。

サポートされているコントロールの種類

すべて

構文

formContext.getControl(arg).addNotification(notification);

パラメーター

Name 種類​​ 必須出席者 内容
通知 オブジェクト あり 追加する通知。 オブジェクトには、次の属性が含まれています。
  • 操作: (任意) オブジェクトの配列。 次の属性を含むオブジェクトのコレクションです:
    • メッセージ: (オプション) 文字列。 ユーザーに表示される通知の本文です。 最適な結果を得るため、メッセージは 100 文字に制限します。
    • 操作: (任意) 関数の配列。 メッセージに対応するアクションです。
  • メッセージ: 文字列の配列。 通知で表示されるメッセージ。 現在のリリースでは、配列で指定され最初のメッセージのみが表示されます。 ここで指定する文字列は太字のテキストとして通知に表示され、通常、通知のタイトルまたは件名に使用されます。 最適な結果を得るため、メッセージは 50 文字に制限する必要があります。
  • notificationLevel: 文字列。 通知の種類を定義します。 有効な値は、エラーまたはレコメンデーションです。
  • uniqueId: 文字列。 clearNotification メソッドを使用する場合にこの通知をクリアする ID。

戻り値

種類: ブール値

説明: メソッドが成功したかどうかを示します。

備考

addNotification メソッドには指定したメッセージと共に通知と次の 2 つの標準ボタンが表示されます: 適用および解除適用をクリックすると定義するアクションが実行されます。解除をクリックし、通知メッセージをクローズします。

取引先企業名フィールドに "Microsoft" が含まれ、株式銘柄コードが "MSFT" に設定されていない場合は、次のサンプル コードによって取引先企業フォームの取引先企業名フィールド上で通知が表示され、株式銘柄コードを設定します。 通知で適用をクリックすると株式銘柄コードフィールドは "MSFT" に設定されます。

function addTickerSymbolRecommendation(executionContext) {
    var formContext = executionContext.getFormContext();
    var myControl = formContext.getControl('name');
    var accountName = formContext.data.entity.attributes.get('name');
    var tickerSymbol = formContext.data.entity.attributes.get('tickersymbol');

    if (accountName.getValue() == 'Microsoft' && tickerSymbol.getValue() != 'MSFT') {
        var actionCollection = {
            message: 'Set the Ticker Symbol to MSFT?',
            actions: null
        };

        actionCollection.actions = [function () {
            tickerSymbol.setValue('MSFT');
            myControl.clearNotification('my_unique_id');
        }];

        myControl.addNotification({
            messages: ['Set Ticker Symbol'],
            notificationLevel: 'RECOMMENDATION',
            uniqueId: 'my_unique_id',
            actions: [actionCollection]
        });
    }
    else
        console.log("Notification not set");
}

clearNotification

setNotification