NetSuite の始め方| N/auth: auth.changeEmail(options)メソッド

前の記事NetSuiteの始め方 | SuiteScript 2.x モジュールについてで、レコードの操作に使用されるSuiteScriptモジュールおよびN/recordモジュールNetSuiteの始め方| N/auth Module 概要を学習しました。次に、N/auth: auth.changeEmail(options) Methodのメンバーの1つについて詳しく説明します。

auth.changeEmail()メソッドは、現在ログインしているユーザーのNetSuite電子メール・アドレスを更新します。このEメールは、ユーザーのログイン・ユーザー名としても使用されます。

次に、一般的なユースケースを示します。

• ユーザーがカスタムSuiteletを使用して電子メールを更新できるようにする
• アカウント全体または単一アカウントでの電子メール更新のサポート
• 現在のパスワードを要求して認証を強制する

パラメータの概要

このメソッドは、次のプロパティを持つ単一のオプション・オブジェクトを受け入れます。

必須パラメータ

パラメータ	タイプ	摘要
options.newEmail	文字列:	ログイン・ユーザーの新しいNetSuite電子メール・アドレス
options.password	文字列:	ユーザーの現在のNetSuiteパスワード

オプション・パラメータ

パラメータ	タイプ	摘要
options.onlyThisAccount	ブール値	Eメール変更の範囲を決定します

onlyThisAccountの動作:

• true (デフォルト):現在のアカウントのロールの電子メールのみを更新します
• false:ユーザーがアクセス権を持つすべてのアカウントおよびロールにわたってEメールを更新します

構文

auth.changeEmail({
            newEmail: 'new.email@example.com',
            password: 'currentPassword123',
            onlyThisAccount: true // optional
        });

重要な注意: 電子メールの変更のリスク

• 電子メール・アドレスを変更すると、ユーザーのNetSuiteログイン・ユーザー名がただちに更新されるため、新しい電子メールが間違って入力されると、一時的なアクセスの問題が発生する可能性があります。
• 電子メールの変更がすべてのアカウントおよびロールに適用されると、ユーザーは、認証または統合のために前の電子メール・アドレスに依存する他のNetSuiteアカウントへのアクセスを失う可能性があります。

ここに記載されているサンプルコードは、法律で許可される最大限の範囲で、いかなる種類の保証もなく「現状のまま」提供されます。Oracle + NetSuite Inc. は、サンプルコードの開発プラットフォームへの実装や、独自のWebサーバー構成の使用において、開発者の個々の成功を保証または保証しません。

Oracle + NetSuite Inc. は、サンプルコードに関連するデータまたは情報の使用、使用結果、正確性、適時性、完全性に関して、いかなる保証も行わず、すべての保証（明示的または黙示的）を否認します。特に、商品性、特定の目的への適合性、コードに関連するサービスまたはソフトウェアに関する保証を否認します。

Oracle + NetSuite Inc. は、サンプルコードに関連する行動から生じるいかなる種類の直接的、間接的または結果的な損害や費用についても責任を負いません。

SuiteScriptのデプロイの詳細は、これらのNetSuiteの始め方記事を確認してください。 

• NetSuite の始め方 | スクリプトレコードの作成方法
• NetSuite の始め方 | SuiteScript 2.x レコードでスクリプトタイプを設定する方法
• NetSuite の始め方 | スクリプトレコードの展開方法
• NetSuiteの始め方 | SuiteScript の種類の概要

今後の記事では、個々のSuiteScript 2.xモジュールを分解し、それらをSuiteCloud製品領域内のスクリプトで効果的に使用する方法を説明します NetSuiteの始め方 > SuiteCloud カテゴリをフォローして、新しい記事が公開されるたびに通知を受信しましょう。