メタデータ API 開発者ガイド
jMyDomainSettings
ファイルのサフィックスおよびディレクトリの場所
MyDomainSettings の値は、settings ディレクトリの MyDomain.settings という 1 つのファイルに保存されます。.settings ファイルは、各設定コンポーネントに設定ファイルが 1 つしかないため、他の名前つきのコンポーネントとは異なります。
バージョン
MyDomainSettings コンポーネントは、API バージョン 47.0 以降で使用できます。
項目
| 項目名 | 項目の型 | 説明 |
|---|---|---|
| canOnlyLoginWithMyDomainUrl | boolean | true の場合、ユーザはログインに組織の [私のドメイン] ログイン URL を使用する必要があります。false (デフォルト) の場合、ユーザは組織のインスタンスの Salesforce URL (https://InstanceName.salesforce.com) を使用して、ログイン URL (https://login.salesforce.com) を介してログインすることもできます。 |
| doesApiLoginRequireOrgDomain | boolean | true の場合、ユーザは組織の [私のドメイン] ログイン URL を使用して Salesforce API にアクセスする必要があります。false (デフォルト) の場合、ユーザは汎用 Salesforce ページ (https://InstanceName.salesforce.com) を使用して、ログイン URL (https://login.salesforce.com) を介して Salesforce API にアクセスすることもできます。 |
| domainPartition | OrgDomainShard (string 型の列挙) | この組織のパーティション。none の場合、分割されたドメインは有効になりません。それ以外の場合は、[私のドメイン] ホスト名にパーティション値が含まれます。たとえば、ドメインが分割されている Developer Edition 組織の [私のドメイン] ログインホスト名の形式は MyDomainName.develop.my.salesforce.com です。 これは、API では参照のみの項目です。可能な値は次のとおりです。
Sandbox 組織は、拡張ドメインを有効にしたときにパーティション分割されます。拡張ドメインのある本番と Sandbox 以外の一部の組織については、Winter '23 より前にこの機能が使用可能になります。各パーティションが使用可能になると、その種別の新規組織がデフォルトでパーティション分割されます。この機能のリリースの最新情報を確認するには、Trailblazer Community の「My Domain and Enhanced Domains」グループのディスカッションに参加してください。 各パーティションが使用可能になると、拡張ドメインを持つその種別の新しい組織がデフォルトで分割され、対応する domainPartition 値を取得します。本番組織、および拡張ドメインを持たない組織の値は常に none です。 API バージョン 55.0 以降で利用できます。 |
| enableNativeBrowserForAuthOnAndroid | boolean | true の場合、Android モバイルアプリケーションの認証にネイティブブラウザを使用します。デフォルトは false です。 |
| enableNativeBrowserForAuthOnIos | boolean | true の場合、iOS モバイルアプリケーションの認証にネイティブブラウザを使用します。デフォルトは false です。 |
| myDomainName | string | この組織の [私のドメイン] URL で使用されるサブドメイン名 (MyDomainName.my.salesforce.com や MyDomainName.lightning.force.com など)。 これは、API では参照のみの項目です。[私のドメイン] の [設定] ページから組織の [私のドメイン] 名を変更できます。 API バージョン 51.0 以降で利用できます。 |
| myDomainSuffix | OrgDomainProdSuffix (string 型の列挙) | この組織の [私のドメイン] ログイン URL のドメインサフィックス。これは、API では参照のみの項目です。[私のドメイン] の [設定] ページから [私のドメイン] のサフィックスを変更できます。 可能な値は次のとおりです。
API バージョン 51.0 以降で利用できます。 |
| redirectForceComSitesUrls | boolean |
true の場合、Experience Cloud サイトと Salesforce サイトにサービスを提供している、末尾が .force.com の URL をコールすると、対応する現在の [私のドメイン] のサイト URL にリダイレクトされます。false の場合、このコールはリダイレクトされず、ファイルが見つかりません (404) というエラーが表示されます。デフォルトは true です。 この項目は次の場合にのみ適用されます。
API バージョン 55.0 以降で利用できます。 |
| redirectPriorMyDomain | boolean |
true の場合、以前の [私のドメイン] の名前に関連付けられている URL へのコールは、現在の [私のドメイン] に関連付けられている対応する URL にリダイレクトされます。false の場合、このコールはリダイレクトされません。新しい [私のドメイン] をリリースすると、この設定はデフォルトの true にリセットされます。 この項目は次の場合にのみ適用されます。
API バージョン 54.0 以降で利用できます。 |
| use3rdPartyCookieBlockingCompatibleHostnames | boolean | サードパーティ Cookie がブロックされたときに組織のインスタンス名を Visualforce URL に含めるか (true)、否か (false) を示します。この項目のデフォルト値は true です。この項目を true に設定すると、一貫性が確保された URL を使用して Visualforce ページを読み込んだ場合に問題が起こるのを防ぐことができます。 useStabilizedMyDomainHostnames が true に設定され、myDomainSuffix が MySalesforceLimited、CloudforceLimited、または DatabaseLimited に設定されている場合のみ適用されます。 API バージョン 51.0 以降で利用できます。 |
| useEdge | boolean | この組織の適格な [私のドメイン] URL が Salesforce Edge Network を介してルーティングされるか (true)、否か (false) を示します。この項目のデフォルト値は true です。 これは、API では参照のみの項目です。組織で Salesforce Edge Network を使用できる場合、この設定は [私のドメイン] の [設定] ページから有効にできます。[設定] からこの項目を true に設定すると、false に設定できなくなります。 API バージョン 51.0 以降で利用できます。 |
| useEnhancedDomainsInSandbox | boolean | 拡張ドメインが有効になっていない場合、この組織から作成された新規および更新済みの Sandbox がデフォルトで拡張ドメインを使用するか (true)、否か (false) を示します。デフォルト値は true です。 拡張ドメインが有効になっている場合、この組織から作成された新規および更新済みの Sandbox は常に拡張ドメインを使用します。この項目の影響はありません。 API 55.0 以降で使用できます。 |
| useStabilizedMyDomainHostnames | boolean | Visualforce、エクスペリエンスビルダー、Site.com Studio、およびコンテンツファイルの [私のドメイン] URL でインスタンス名が非表示か (true)、否か (false) を示します。この項目のデフォルト値は true です。たとえば、この項目が true に設定されている場合、MyDomainName--PackageName.na44.visual.force.com は MyDomainName--PackageName.visualforce.com になります。 |
| useStabilizedSandboxMyDomainHostnames | boolean | この項目は、Summer ’20 で適用されたリリース更新「Sandbox の [私のドメイン] URL のホスト名の一貫性の確保」に対応します。 true の場合、Sandbox 組織の [私のドメイン] URL でインスタンス名が非表示になります。たとえば、MyDomainName--test.cs5.my.salesforce.com は MyDomainName--test.my.salesforce.com になっています。API バージョン 49.0 以降では、この項目の値は自分で設定した値に関係なく常に true になります。この値を変更して false と表示されていたとしても、Salesforce に対しては効果がありません。 この変更は、この項目が最初に導入された API バージョン 47.0 まで遡って適用されます。以前は、API バージョン 47.0 から 49.0 では、この項目は Sandbox 組織の [私のドメイン] URL でインスタンス名が非表示か (true)、否か (false) を示していて、項目のデフォルト値は false でした。現在はすべての API バージョンでこの項目の値は false と表示されていたとしても常に true になります。 |
宣言的なメタデータの定義のサンプル
MyDomainSettings コンポーネントの例を次に示します。
1<?xml version="1.0" encoding="UTF-8"?>
2<MyDomainSettings xmlns="http://soap.sforce.com/2006/04/metadata">
3 <canOnlyLoginWithMyDomainUrl>false</canOnlyLoginWithMyDomainUrl>
4 <doesApiLoginRequireOrgDomain>false</doesApiLoginRequireOrgDomain>
5 <domainPartition>none</domainPartition>
6 <enableNativeBrowserForAuthOnAndroid>false</enableNativeBrowserForAuthOnAndroid>
7 <enableNativeBrowserForAuthOnIos>false</enableNativeBrowserForAuthOnIos>
8 <myDomainName>mycompany</myDomainName>
9 <myDomainSuffix>MySalesforce</myDomainSuffix>
10 <use3rdPartyCookieBlockingCompatibleHostnames>true</use3rdPartyCookieBlockingCompatibleHostnames>
11 <useEdge>true</useEdge>
12 <useEnhancedDomainsInSandbox>true</useEnhancedDomainsInSandbox>
13 <useStabilizedMyDomainHostnames>true</useStabilizedMyDomainHostnames>
14 <useStabilizedSandboxMyDomainHostnames>true</useStabilizedSandboxMyDomainHostnames>
15</MyDomainSettings>前の定義を参照する package.xml の例を次に示します。
1<?xml version="1.0" encoding="UTF-8"?>
2<Package xmlns="http://soap.sforce.com/2006/04/metadata">
3 <types>
4 <members>MyDomain</members>
5 <name>Settings</name>
6 </types>
7 <version>54.0</version>
8</Package>