イベント引数の保存(クライアント側を参照)

公開日: 2017年1月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

保存イベントで、実行コンテキスト オブジェクト getEventArgs メソッドを使用して、保存イベントを管理するために使用できるメソッドを格納したオブジェクトを取得できます。

保存イベント引数メソッド

• getSaveMode
  保存イベントがユーザーにどのように開始されたかを示す値を返します。

• isDefaultPrevented
  preventDefault メソッドがこのイベント ハンドラーまたは以前のイベント ハンドラー使用されたので、この保存イベントが取り消されたかどうかを示す値を返します。

• preventDefault
  保存操作を取り消しますが、イベントのハンドラーの残りすべては実行されます。

getSaveMode

保存イベントがユーザーにどのように開始されたかを示す値を返します。

execObj.getEventArgs().getSaveMode()

• 戻り値
  種類: 番号

  次の表は、エンティティ レコードがユーザーによって保存されたさまざまな方法を検出するのに返される、サポートされている値を示しています。

  エンティティ	イベント モード	値
  すべて	保存​​	1
  すべて	保存して​​閉じる	2
  すべて	保存して新規作成	59
  すべて	AutoSave	70
  活動	進捗状況を終了にして保存	58
  すべて	非アクティブ化​​	5
  すべて	再アクティブ化	6
  ユーザーまたはチームが所有するエンティティ	割り当て​​	47
  電子メール (E-mail)	送信する	7
  潜在顧客​​	見込みありと評価する	16
  潜在顧客​​	見込みなし	15

• 備考
  このメソッドは、組織のほとんどのフォームに自動保存を有効化し、特定のフォームでは無効にする場合に重要です。 渡された実行コンテキストと共に onSave イベントに登録されている次のコードは、ユーザーが自ら実行する保存は自動保存されないようにしますが、他のすべては許可します。 自動保存が有効にされると、フォームから移動すると保存して閉じることになります。 このコードは、30秒タイマーによって開始された保存、ユーザーがフォームから移動する際に保存していないデータを保存するのを防ぎます。

  function preventAutoSave(econtext) {
      var eventArgs = econtext.getEventArgs();
      if (eventArgs.getSaveMode() == 70 || eventArgs.getSaveMode() == 2) {
          eventArgs.preventDefault();
      }
  }
  

  レコードを保存するには、フォームの下部の [保存] アイコンか、コマンド バーに追加するカスタム [保存] コマンドをクリックする必要があります。

isDefaultPrevented

preventDefault メソッドがこのイベント ハンドラーまたは以前のイベント ハンドラー使用されたので、この保存イベントが取り消されたかどうかを示す値を返します。

execObj.getEventArgs().isDefaultPrevented()

• 戻り値
  種類: ブール値

preventDefault

保存操作を取り消しますが、イベントのハンドラーの残りすべては実行されます。

execObj.getEventArgs().preventDefault()

関連項目

クライアント側のプログラミング リファレンス
コレクション (クライアント側の参照)
フォーム スクリプトの簡易参照
実行コンテキスト (クライアント側の参照)
getEventArgs
Microsoft Dynamics 365 フォームのコードを記述する
Xrm.Page オブジェクト モデルの使用

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 著作権