Network
Metadata メタデータ型を拡張し、その fullName 項目を継承します。
宣言的なメタデータファイルのサフィックスおよびディレクトリの場所
Network コンポーネントは、対応するパッケージディレクトリの networks ディレクトリに保存されます。ファイル名はサイト名に一致し、拡張子は .network です。
バージョン
このオブジェクトは API バージョン 28.0 以降で使用できます。
項目
Branding
Experience Cloud サイトに適用されるブランド設定と配色を表します。API バージョン 40.0 以前で使用できます。API バージョン 41.0 以降では NetworkBranding に置き換わります。
CommunityRoles
Experience Cloud サイトのカスタマーロール、パートナーロールまたは従業員ロールを識別するために使用される表示ラベル。API バージョン 41.0 以降で利用できます。
項目 | 項目の型 | 説明 |
---|---|---|
customerUserRole | string | カスタマーユーザーロールの表示ラベル。 |
employeeUserRole | string | 従業員ユーザーロールの表示ラベル。 |
partnerUserRole | string | パートナーユーザーロールの表示ラベル。 |
NetworkAuthApiSettings
ヘッドレス登録フロー、ヘッドレスのパスワードを忘れた場合のフロー、ヘッドレスパスワードレスログインフロー、およびそれらに関連する API の有効化、アクセス、およびセキュリティを制御する設定を表します。API バージョン 60.0 以降で利用できます。
項目 | 項目の型 | Details |
---|---|---|
doesForgotPasswordRequireAuth | boolean | パスワードのリセットの要求で、パスワードを忘れた場合のヘッドレス API へのアクセスに認証が必要かどうかを決定します。true の場合、/services/auth/headless/forgot_password エンドポイントへの最初の POST 要求で、内部インテグレーションユーザーに発行されたアクセストークンが必要です。アクセストークンには forgot_password 範囲を含める必要があります。 |
doesPwdlessLoginRequireAuth | boolean | ユーザー情報を Salesforce に送信する際に、ヘッドレスパスワードレスログイン API にアクセスするための認証が必要かどうかを決定します。true の場合、/services/auth/headless/init/passwordless/login エンドポイントへの最初の POST 要求で、内部インテグレーションユーザーに発行されたアクセストークンが必要です。アクセストークンには pwdless_login_api 範囲を含める必要があります。 |
doesRegistrationRequireAuth | boolean | ユーザー登録情報を Salesforce に送信する際に、ヘッドレス登録 API にアクセスするための認証が必要かどうかを決定します。true の場合、/services/auth/headless/init/registration エンドポイントへの最初の POST 要求で、内部インテグレーションユーザーに発行されたアクセストークンが必要です。アクセストークンには user_registration_api 範囲が含まれている必要があります。 |
emailTmplsAllowlist | NetworkEmailTmplAllowlist[] | ヘッドレス登録フロー、パスワードなしのヘッドレスログインフロー、ヘッドレスのパスワードを忘れた場合のメールテンプレート許可リスト。許可リストは、これらのフロー中にエンドユーザーに送信される検証メールに使用できるメールテンプレートを定義します。 |
isForgotPwdAllowed | boolean | ヘッドレスのパスワードを忘れた場合のフローが有効になっているかどうかを判定します。 |
isForgotPwdEmailTemplateAllowlistingEnabled | boolean | ヘッドレスのパスワードを忘れた場合のフローでメールテンプレートの許可リストが有効になっているかどうかを判定します。true の場合、パスワードを忘れた場合のヘッドレス API に対する初期要求の emailtemplate パラメーターは、許可リストに登録したメールテンプレートしか含めることができなくなります。 |
isHeadlessUserRegistrationAllowed | boolean | ヘッドレス登録フローが有効になっているかどうかを判定します。 |
IsPwdlessLoginAllowed | boolean | ヘッドレスパスワードレスログインフローが有効であるか (true)、否か (false) を決定します。 |
isRecaptchaRequiredForgotPwd | boolean | パスワードのリセットの要求で、パスワードを忘れた場合のヘッドレス API へのアクセスに reCAPTCHA トークンが必要かどうかを決定します。true の場合、/services/auth/headless/forgot_password エンドポイントへの最初の POST 要求で、reCAPTCHA トークンが必要です。 |
isRecaptchaRequiredPwdlessLogin | boolean | ユーザー情報を Salesforce に送信する際に、ヘッドレスパスワードレスログイン API にアクセスするための reCAPTCHA トークンが必要かどうかを決定します。true の場合、/services/auth/headless/init/passwordless/login エンドポイントへの最初の POST 要求で、reCAPTCHA トークンが必要です。 |
isRecaptchaRequiredRgstr | boolean | ユーザー登録情報を Salesforce に送信する際に、ヘッドレス登録 API にアクセスするための reCAPTCHA トークンが必要かどうかを決定します。true の場合、/services/auth/headless/init/registration エンドポイントへの最初の POST 要求で、reCAPTCHA トークンが必要です。 |
isUniversalClientRgstrAllowed | boolean | ユニバーサル登録 API を介したセルフ登録とパスワードなしのログインが有効かどうかを判定します。 |
maxPasswordResetAttempts | int | ユーザーが新しいワンタイムパスワード (OTP) を要求するまで、ヘッドレスのパスワードを忘れた場合のフローで許可するパスワードリセット試行回数の最大値です。 |
recaptchaScoreThreshold | double | ヘッドレス ID API へのアクセス要求を受け入れる最低の reCAPTCHA スコア。この値は、0.5 ~ 1 の間にする必要があります。スコアが 0.5 に近い場合はボットである可能性が高く、スコアが 1 に近い場合は有効なユーザーである可能性が高くなります。 doesForgotPasswordRequireAuth または doesRegistrationRequireAuth の項目が true に設定されている場合、スコアしきい値を設定する必要があります。reCAPTCHA の設定は、ヘッドレス登録フローとヘッドレスのパスワードを忘れた場合のフローの両方に適用されます。 Google は、reCAPTCHA v3 の実装に対してのみ、reCAPTCHA スコアを発行しています。reCAPTCHA v2 を実装している場合、この項目は適用されません。 |
recaptchaSecretKey | string | API キーペアの reCAPTCHA 秘密鍵。reCAPTCHA を設定する場合は、Google から API キーペアを入手します。秘密鍵によりアプリケーションは Google と安全に通信できます。doesForgotPasswordRequireAuth または doesRegistrationRequireAuth が true に設定されている場合、秘密鍵を入力する必要があります。reCAPTCHA の設定は、reCAPTCHA が有効になっているすべてのヘッドレス ID フローに適用されます。 |
registrationExecutionUser | string | ヘッドレス登録 Apex ハンドラーを実行するユーザー。 |
registrationHandler | string | ヘッドレス登録 Apex ハンドラー。 |
registrationUserDefaultProfile | string | 新規ユーザーの登録時に割り当てられるデフォルトプロファイル。 |
NetworkEmailTmplAllowlist
ヘッドレス登録フロー、パスワードなしのヘッドレスログインフロー、ヘッドレスのパスワードを忘れた場合にエンドユーザーに送信されるワンタイムパスワード (OTP) メールテンプレートの許可リストを表します。API バージョン 60.0 以降で利用できます。
項目 | 項目の型 | 説明 |
---|---|---|
emailTemplate | string | 必須。登録、パスワードなしのログイン、パスワードを忘れた場合のヘッドレス承認フロー中にユーザーに送信できるメールテンプレート。複数のテンプレートをリストできます。アプリケーションがヘッドレス登録 API またはパスワードなしのヘッドレスログイン API に最初の要求を送信するとき、emailtemplate パラメーターには許可リストからメールテンプレート ID のみを含めることができます。ヘッドレスのパスワードを忘れた場合の API についても同様に動作しますが、それは NetworkAuthApiSettings メタデータ型の isForgotPwdEmailTemplateAllowlistingEnabled 項目が true の場合のみです。 |
NetworkMemberGroup
Experience Cloud サイトに割り当てられたプロファイルおよび権限セットを表します。いずれかのプロファイルまたは権限セットを持つユーザーは、(顧客グループの) Chatter 顧客でない限り、サイトのメンバーです。
項目 | 項目の型 | 説明 |
---|---|---|
permissionSet | string | サイトに割り当てられた権限セット。 |
profile | string | サイトの一部であるプロファイル。 |
NetworkPageOverride
RecommendationAudience
新しい Experience Cloud サイトメンバーによる利用者を作成します。または、カスタマイズした利用者メンバーのリストを管理しておすすめを整理または対象にするために使用できます。API バージョン 41.0 以降で利用できます。
項目 | 項目の型 | 説明 |
---|---|---|
recommendationAudienceDetails | RecommendationAudienceDetail | おすすめの利用者の詳細。 |
RecommendationAudienceDetail
おすすめの利用者の詳細。API バージョン 41.0 以降で利用できます。
項目 | 項目の型 | 説明 |
---|---|---|
audienceCriteriaType | AudienceCriteriaType (string 型の列挙) | おすすめ利用者種別の条件。値は次のとおりです。
|
audienceCriteriaValue | string | 新規メンバー条件では、ユーザーがメンバーになった時点からの最大日数。カスタムリスト条件では Null です。 |
setupName | string | おすすめ利用者の名前。 |
RecommendationDefinition
Experience Cloud サイトのエンゲージメントを促進するカスタムおすすめのリストを表します。API バージョン 41.0 以降で利用できます。
項目 | 項目の型 | 説明 |
---|---|---|
recommendationDefinitionDetails | RecommendationDefinitionDetail[] | カスタムおすすめとその詳細のリスト。 |
RecommendationDefinitionDetail
カスタムおすすめの詳細。API バージョン 41.0 以降で利用できます。
項目 | 項目の型 | 説明 |
---|---|---|
actionUrl | string | ユーザーがおすすめに対してアクションを実行できるようにするボタンの URL。 |
description | string | ユーザーが実行できるアクションを提案するおすすめの説明。 |
linkText | string | ボタンのテキスト表示ラベル。 |
scheduledRecommendations | ScheduledRecommendation | スケジュール済みおすすめのリスト。 |
setupName | string | [設定] に表示されるおすすめの名前。 |
title | string | おすすめのタイトル。 |
ReputationLevelDefinitions
Experience Cloud サイト内で特定の定義されたアクションを実行することでメンバーが達成できる評価レベルを表します。
項目 | 項目の型 | 説明 |
---|---|---|
level | ReputationLevel[] | 評価レベルを表します。 |
ReputationLevel
評価レベルの名前と下限値を表します。アプリケーションが上限値を計算します。
項目 | 項目の型 | 説明 |
---|---|---|
branding | ReputationBranding[] | 評価レベルに関連付けられたブランド設定を表します。具体的には、評価レベルのカスタム画像です。 この項目は省略可能です。指定されていない場合は、デフォルトの評価レベル画像が使用されます。API バージョン 32.0 以降で利用できます。 |
label | string | 評価レベルの名前。 この項目は省略可能です。指定されていない場合、10 個のデフォルトのいずれかが使用されます。
|
lowerThreshold | double | 必須。この評価レベルの範囲の下限値。たとえば、この評価レベルがポイント 1 ~ 50 の場合、1 が lowerThreshold です。 |
ReputationPointsRules
Experience Cloud サイトのポイントシステムのポイントルールを表します。
項目 | 項目の型 | 説明 |
---|---|---|
pointsRule | ReputationPointsRule[] | 行動とそれに関連付けられたポイントを表します。 |
ReputationPointsRule
ポイントルールの行動と関連付けられたポイント値を表します。アクションを実行したユーザーは、関連付けられたポイントを獲得します。
項目 | 項目の型 | 説明 |
---|---|---|
eventType | string | 必須。ポイントを獲得するためにメンバーが実行する必要がある行動の種別。次の値を使用できます。
|
points | int | 必須。行動を実行してメンバーが取得するポイント数。行動ごとのデフォルトのポイント数は次のとおりです。
|
ScheduledRecommendation
スケジュール済みおすすめのリストを表します。API バージョン 41.0 以降で利用できます。
項目 | 項目の型 | 説明 |
---|---|---|
scheduledRecommendationDetails | ScheduledRecommendationDetail[] | スケジュール済みおすすめのリスト。 |
ScheduledRecommendationDetail
スケジュール済みおすすめの詳細。API バージョン 41.0 以降で利用できます。
項目 | 項目の型 | 説明 |
---|---|---|
channel | RecommendationChannel (string 型の列挙) | おすすめをグループ化して、おすすめをサイトのどこに表示するのかを決定する手段。有効な値は、次のとおりです。
|
enabled | boolean | スケジュールが有効になっているかどうかを示します。true の場合、おすすめが有効になり、サイトに表示されます。 false の場合、Salesforce モバイル Web でのフィードのおすすめは削除されませんが、新しいおすすめは表示されなくなります。サイトでは、無効にしたおすすめは表示されません。 |
rank | int | 表示順序を決定するチャネル内のおすすめのランク。 スケジュール済みおすすめは、rank で指定された位置に挿入されます。それ以降のすべてのスケジュール済みおすすめの rank が 1 つずつ下がります。指定された rank がリストのサイズよりも大きい場合は、スケジュール済みおすすめがリストの末尾に配置されます。 rank が指定されていない場合は、スケジュール済みおすすめがリストの末尾に配置されます。 |
recommendationAudience | string | このスケジュール済みおすすめの利用者の名前。 |
NetworkTabSet
項目 | 項目の型 | 説明 |
---|---|---|
customTab | string | サイトの一部であるカスタムタブ。 |
defaultTab | string | サイトの [ホーム] タブ。メンバーがログインすると、このタブが最初のページとして表示されます。 |
standardTab | string | サイトの一部である標準タブ。 |
宣言的なメタデータの定義のサンプル
次に、ネットワークの XML 定義のサンプルを示します。
<?xml version="1.0" encoding="UTF-8"?>
<Network xmlns="http://soap.sforce.com/2006/04/metadata">
<allowMembersToFlag>true</allowMembersToFlag>
<changePasswordTemplate>unfiled$public/CommunityChangePasswordEmailTemplate</changePasswordTemplate>
<description>Metadata Community</description>
<emailSenderAddress>admin@networkMetadata.com</emailSenderAddress>
<emailSenderName>Admin User</emailSenderName>
<enableInvitation>false</enableInvitation>
<enableKnowledgeable>true</enableKnowledgeable>
<enableNicknameDisplay>false</enableNicknameDisplay>
<enablePrivateMessages>true</enablePrivateMessages>
<enableReputation>true</enableReputation>
<enableUpDownVote>true</enableUpDownVote>
<forgotPasswordTemplate>unfiled$public/CommunityForgotPasswordEmailTemplate</forgotPasswordTemplate>
<networkMemberGroups>
<permissionSet>Admin</permissionSet>
<permissionSet>Standard</permissionSet>
<permissionSet>ReadOnly</permissionSet>
<profile>Admin</profile>
<profile>Standard</profile>
<profile>ReadOnly</profile>
</networkMemberGroups>
<recommendationDefinition>
<recommendationDefinitionDetails>
<actionUrl>https://www.apple.com/iphone</actionUrl>
<description>Better specs and high performance for iPhones</description>
<linkText>iPhone 7</linkText>
<scheduledRecommendations>
<scheduledRecommendationDetails>
<channel>DefaultChannel</channel>
<enabled>false</enabled>
<rank>1</rank>
<recommendationAudience>New Member Audience</recommendationAudience>
</scheduledRecommendationDetails>
</scheduledRecommendations>
<setupName>Apple iPhone</setupName>
<title>iPhone7</title>
</recommendationDefinitionDetails>
<recommendationDefinitionDetails>
<actionUrl>https://www.bose.com/qc35</actionUrl>
<description>New Amazing Noise cancellation Headphones</description>
<linkText>Bose QC35</linkText>
<scheduledRecommendations>
<scheduledRecommendationDetails>
<channel>DefaultChannel</channel>
<enabled>true</enabled>
<rank>2</rank>
<recommendationAudience>Custom Audience</recommendationAudience>
</scheduledRecommendationDetails>
</scheduledRecommendations>
<setupName>Bose Headphones</setupName>
<title>Bose QC35</title>
</recommendationDefinitionDetails>
</recommendationDefinition>
<reputationLevels>
<level>
<branding>
<smallImage>communities_shared _document_folder/replevel_beginner.png</smallImage>
</branding>
<label>Beginner</label>
<lowerThreshold>0</lowerThreshold>
</level>
<level>
<branding>
<smallImage>communities_shared _document_folder/replevel_apprentice.png</smallImage>
</branding>
<label>Apprentice</label>
<lowerThreshold>51</lowerThreshold>
</level>
<level>
<branding>
<smallImage>communities_shared _document_folder/replevel_gettingthere.png</smallImage>
</branding>
<label>Getting There</label>
<lowerThreshold>101</lowerThreshold>
</level>
<level>
<branding>
<smallImage>communities_shared _document_folder/replevel_skilled.png</smallImage>
</branding>
<label>Skilled</label>
<lowerThreshold>151</lowerThreshold>
</level>
<level>
<branding>
<smallImage>communities_shared _document_folder/replevel_expert.png</smallImage>
</branding>
<label>Expert</label>
<lowerThreshold>201</lowerThreshold>
</level>
<level>
<branding>
<smallImage>communities_shared _document_folder/replevel_mentor.png</smallImage>
</branding>
<label>Mentor</label>
<lowerThreshold>251</lowerThreshold>
</level>
<level>
<branding>
<smallImage>communities_shared _document_folder/replevel_guru.png</smallImage>
</branding>
<label>Guru</label>
<lowerThreshold>301</lowerThreshold>
</level>
</reputationLevels>
<reputationPointsRules>
<pointsRule>
<eventType>FeedItemWriteAPost</eventType>
<points>5</points>
</pointsRule>
<pointsRule>
<eventType>FeedItemWriteAComment</eventType>
<points>3</points>
</pointsRule>
<pointsRule>
<eventType>FeedItemReceiveAComment</eventType>
<points>10</points>
</pointsRule>
<pointsRule>
<eventType>FeedItemLikeSomething</eventType>
<points>3</points>
</pointsRule>
<pointsRule>
<eventType>FeedItemReceiveALike</eventType>
<points>5</points>
</pointsRule>
<pointsRule>
<eventType>FeedItemMentionSomeone</eventType>
<points>5</points>
</pointsRule>
<pointsRule>
<eventType>FeedItemSomeoneMentionsYou</eventType>
<points>10</points>
</pointsRule>
<pointsRule>
<eventType>FeedItemShareAPost</eventType>
<points>5</points>
</pointsRule>
<pointsRule>
<eventType>FeedItemSomeoneSharesYourPost</eventType>
<points>10</points>
</pointsRule>
</reputationPointsRules>
<selfRegistration>false</selfRegistration>
<sendWelcomeEmail>true</sendWelcomeEmail>
<site>Network_11</site>
<status>UnderConstruction</status>
<tabs>
<defaultTab>Chatter</defaultTab>
<standardTab>Chatter</standardTab>
<standardTab>Account</standardTab>
<standardTab>Campaign</standardTab>
<standardTab>Case</standardTab>
<standardTab>Console</standardTab>
<standardTab>Contact</standardTab>
<standardTab>Contract</standardTab>
<standardTab>Dashboard</standardTab>
<standardTab>JigsawSearch</standardTab>
<standardTab>File</standardTab>
<standardTab>CollaborationGroup</standardTab>
<standardTab>home</standardTab>
<standardTab>Idea</standardTab>
<standardTab>Lead</standardTab>
<standardTab>Opportunity</standardTab>
<standardTab>Product2</standardTab>
<standardTab>UserProfile</standardTab>
<standardTab>report</standardTab>
<standardTab>Solution</standardTab>
</tabs>
<urlPathPrefix>network1</urlPathPrefix>
<welcomeTemplate>unfiled$public/CommunityWelcomeEmailTemplate</welcomeTemplate>
</Network>
マニフェストファイル内のワイルドカードのサポート
このメタデータ型では、package.xml マニフェストファイル内のワイルドカード文字 * (アスタリスク) がサポートされます。マニフェストファイルの使用についての詳細は、「zip ファイルを使用したメタデータのリリースと取得」を参照してください。