メタデータ API 開発者ガイド
jNetwork
コミュニティを表します。コミュニティとは、従業員、顧客、パートナーをつなぐブランド空間です。ビジネスニーズに合わせてコミュニティをカスタマイズしながら作成することができ、その後もコミュニティ間をシームレスに移行できます。SalesforceCommunities には Network コンポーネントを使用します。Chatter アンサーおよび アイデアを含むゾーンを作成する場合は、Community (Zone) コンポーネントを使用します。Metadata メタデータ型を拡張し、その fullName 項目を継承します。
宣言的なメタデータファイルのサフィックスおよびディレクトリの場所
Network コンポーネントは、対応するパッケージディレクトリの networks ディレクトリに保存されます。ファイル名はコミュニティ名に一致し、拡張子は .network です。
バージョン
このオブジェクトは、API バージョン 28.0 以降で使用できます。
項目
| 項目 | データ型 | 説明 |
|---|---|---|
| allowedExtensions | string | コミュニティで許可されるファイルの種類を指定します。このファイルの種類のホワイトリストにより、コミュニティメンバーがアップロードできるファイルを制御でき、スパム送信者が不適切なファイルでコミュニティを汚染することを防止できます。APIバージョン 36.0 以降で利用できます。 |
| allowInternalUserLogin | boolean | 内部ユーザがコミュニティログインページで内部ログイン情報を使用してログインできるかどうかを決定します。API バージョン 40.0 以降で使用できます。 |
| allowMembersToFlag | boolean | コミュニティのユーザが投稿またはコメントを不適切としてフラグ付けできるかどうかを決定します。フラグが付けられた項目は、レビューのためにコミュニティモデレータに送信されます。API バージョン 29.0 以降で利用できます。 |
| branding | Branding | コミュニティで使用する配色、ヘッダー、フッター。 |
| caseCommentEmailTemplate | string | ケースコメントがケースに追加されたか変更された場合に、コミュニティメンバーに通知するときに使用されるメールテンプレート。 |
| changePasswordTemplate | string | パスワードがリセットされたことをユーザに通知するときに使用されるメールテンプレート。 |
| description | string | コミュニティの説明。 |
| emailSenderAddress | string | コミュニティメールの送信元となるメールアドレス。 |
| emailSenderName | string | コミュニティメールの送信元となる名前。 |
| enableGuestChatter | boolean | ゲストユーザがログインせずにコミュニティの公開 Chatter グループにアクセスできるかどうかを指定します。 |
| enableInvitation | boolean | ユーザが他のユーザをコミュニティに招待できるかどうかを指定します。 |
| enableKnowledgeable | boolean | コミュニティメンバーが、トピックに関する知識のあるユーザを表示し、その知識についてユーザを支持できるかどうかを決定します。API バージョン 30.0 以降で使用できます。 |
| enableNicknameDisplay | boolean | コミュニティのほとんどの場所に、ユーザの氏名ではなくニックネームを表示するかどうかを示します。デフォルトで false に設定されます。API バージョン 32.0 以降で使用できます。 |
| enablePrivateMessages | boolean | コミュニティメンバーが非公開メッセージを送受信できるかどうかを決定します。API バージョン 30.0 以降で使用できます。 |
| enableReputation | boolean | コミュニティのメンバーに対する評価が計算および表示されるかどうかを決定します。API バージョン 31.0 以降で使用できます。 有効な場合、reputationLevels と reputationPointsRules が使用されます。データファイルに reputationLevels と reputationPointsRules のどちらも定義されていない場合、デフォルト値が使用されます。 |
| enableSiteAsContainer | boolean | コミュニティでタブの代わりに Site.com ページを使用するかどうかを決定します。 |
| enableTopicAssignmentRules | boolean | これにより、組織はルールを使用してトピックをコミュニティ内の記事に割り当てることができます。これを有効にした後、システム管理者はコミュニティでルールを設定し、トピックを Salesforce ナレッジデータカテゴリに対応付けます。この項目は、API バージョン 40.0 以降で使用できます。 |
| forgotPasswordTemplate | string | ユーザがパスワードを忘れたときに使用されるメールテンプレート。 |
| gatherCustomerSentimentData | boolean | 顧客がコミュニティの記事とケースを確認するとき、Community 360 機能で使用するためのデータを収集します。この項目は、API バージョン 40.0 以降で使用できます。 |
| maxFileSizeKb | int | コミュニティでメンバーがアップロードできるファイルの最大サイズ (KB) を指定します。APIバージョン 36.0 以降で利用できます。3,072 KB から組織の最大ファイルサイズまでの数値を入力します。デフォルトの制限である 2 GB を使用するには、この項目を空にしておきます。 |
| navigationLinkSet | NavigationLinkSet | この項目は API バージョン 37.0 以降で使用できます。 |
| networkMemberGroups | NetworkMemberGroups | コミュニティへのアクセス権を持つプロファイルおよび権限セット。これらのプロファイルまたは権限セットを持つユーザは、コミュニティのメンバーです。 |
| networkPageOverrides | NetworkPageOverride | [パスワードの変更]、[パスワードを忘れた場合]、[ホーム]、[ログイン] のそれぞれがどのページ種別を参照するかを制御する、[管理] 領域 ([コミュニティ管理] または [コミュニティワークスペース] 内) の設定。API バージョン 40.0 以降で使用できます。 |
| newSenderAddress | string | EmailSenderAddressの新しい値として入力され、まだ未確認のメールアドレス。ユーザが送信元メールアドレスの変更を要求し、確認メールに正常に応答すると、NewSenderAddress の値で EmailSenderAddress の値が上書きされます。これが、コミュニティメールの送信元メールアドレスになります。 |
| picassoSite | string | コミュニティにリンクしている Site.com サイトの名前。 |
| reputationLevels | ReputationLevelDefinitions | メンバーが特定のアクションを実行してポイントを獲得したときに、メンバーに割り当てられる評価レベル。 |
| reputationPointsRules | ReputationPointsRules | メンバーが特定の定義済みアクションを実行したときに獲得するポイント。 |
| selfRegProfile | string | セルフ登録するユーザに割り当てられるプロファイル。この値は、コミュニティ�� selfRegistration が有効になっている場合にのみ使用されます。API バージョン 29.0 以降で利用できます。 |
| selfRegistration | boolean | コミュニティでセルフ登録が可能かどうかを指定します。 |
| sendWelcomeEmail | boolean | 新しいユーザがコミュニティに追加されたときに、お知らせメールを送信するかどうかを指定します。 |
| site | string | コミュニティに関連付けられている CustomSite。 |
| status | NetworkStatus[] | コミュニティの状況。選択可能な値は次のとおりです。
|
| tabs | NetworkTabSet | コミュニティで使用できるタブ。これらのタブは、コミュニティを作成したユーザが選択したものです。 |
| urlPathPrefix | string | サイトを他のサイトと区別する、サイトの URL 上のパスの最初の部分。たとえば、サイト URL が mycompany.force.com/partners である場合、partners は urlPathPrefix になります。 |
| welcomeTemplate | string | 新しいコミュニティメンバーにお知らせメールを送信するときに使用されるメールテンプレート。 |
Branding
コミュニティに適用されるブランド設定と配色を表します。
NetworkMemberGroup
コミュニティに割り当てられたプロファイルおよび権限セットを表します。いずれかのプロファイルまたは権限セットを持つユーザは、(顧客グループの) Chatter 顧客でない限り、コミュニティのメンバーです。
| 項目 | データ型 | 説明 |
|---|---|---|
| permissionSet | string | コミュニティに割り当てられた権限セット。 |
| profile | string | コミュニティの一部であるプロファイル。 |
NetworkPageOverride
[パスワードの変更]、[パスワードを忘れた場合]、[ホーム]、[ログイン] の各ページがどのページ種別を参照するかを制御する、[管理] 領域 ([コミュニティ管理] または [コミュニティワークスペース] 内) の設定を表します。
| 項目 | データ型 | 説明 |
|---|---|---|
| changePasswordPageOverrideSetting | NetworkPageOverrideSetting (string 型の列挙) | 必須。[パスワードの変更] ページの設定が適用されるページ種別を指定します。有効な値は次のとおりです。
|
| forgotPasswordPageOverrideSetting | NetworkPageOverrideSetting (string 型の列挙) | 必須。[パスワードを忘れた場合] ページの設定が適用されるページ種別を指定します。有効な値は次のとおりです。
|
| homePageOverrideSetting | NetworkPageOverrideSetting (string 型の列挙) | 必須。[コミュニティホーム] ページの設定が適用されるページ種別を指定します。有効な値は次のとおりです。
|
| loginPageOverrideSetting | NetworkPageOverrideSetting (string 型の列挙) | 必須。[ログイン] ページの設定が適用されるページ種別を指定します。有効な値は次のとおりです。
|
ReputationLevelDefinitions
コミュニティ内で特定の定義されたアクションを実行することでメンバーが達成できる評価レベルを表します。
| 項目 | データ型 | 説明 |
|---|---|---|
| level | ReputationLevel[] | 評価レベルを表します。 |
ReputationLevel
評価レベルの名前と下限値を表します。上限値はアプリケーションによって計算されます。
| 項目 | データ型 | 説明 |
|---|---|---|
| branding | ReputationBranding[] | 評価レベルに関連付けられたブランド設定を表します。具体的には、評価レベルのカスタム画像です。 この項目は省略可能です。指定されていない場合は、デフォルトの評価レベル画像が使用されます。API バージョン 32.0 以降で使用できます。 |
| label | string | 評価レベルの名前。 この項目は省略可能です。指定されていない場合、10 個のデフォルトのいずれかが使用されます。
|
| lowerThreshold | double | 必須。この評価レベルの範囲の下限値。たとえば、この評価レベルがポイント 1 ～ 50 の場合、1 が lowerThreshold です。 |
ReputationPointsRules
コミュニティのポイントシステムのポイントルールを表します。
| 項目 | データ型 | 説明 |
|---|---|---|
| pointsRule | ReputationPointsRule[] | 行動とそれに関連付けられたポイントを表します。 |
ReputationPointsRule
ポイントルールの行動と関連付けられたポイント値を表します。アクションを実行したユーザは、関連付けられたポイントを獲得します。
| 項目 | データ型 | 説明 |
|---|---|---|
| eventType | string | 必須。ポイントを獲得するためにメンバーが実行する必要がある行動の種別。次の値を使用できます。
|
| points | int | 必須。行動を実行してメンバーが取得するポイント数。行動ごとのデフォルトのポイント数は次のとおりです。
|
NetworkTabSet
| 項目 | データ型 | 説明 |
|---|---|---|
| customTab | string | コミュニティの一部であるカスタムタブ。 |
| defaultTab | string | コミュニティの [ホーム] タブ。メンバーがログインすると、このタブが最初のページとして表示されます。 |
| standardTab | string | コミュニティの一部である標準タブ。 |
宣言的なメタデータの定義のサンプル
次に、ネットワークの XML 定義のサンプルを示します。
1<?xml version="1.0" encoding="UTF-8"?>
2<Network xmlns="http://soap.sforce.com/2006/04/metadata">
3 <allowMembersToFlag>true</allowMembersToFlag>
4 <branding>
5 <loginFooterText>salesforce.com</loginFooterText>
6 <loginLogo>Communities_Shared_Document_Folder/header2_png.png</loginLogo>
7 <pageFooter>Branding/footer_html.html</pageFooter>
8 <pageHeader>Branding/header_Image.jpg</pageHeader>
9 <primaryColor>#AF5800</primaryColor>
10 <primaryComplementColor>#FFFFFF</primaryComplementColor>
11 <quaternaryColor>#286FB8</quaternaryColor>
12 <quaternaryComplementColor>#FFFFFF</quaternaryComplementColor>
13 <secondaryColor>#000000</secondaryColor>
14 <tertiaryColor>#FFFFFF</tertiaryColor>
15 <tertiaryComplementColor>#222222</tertiaryComplementColor>
16 <zeronaryColor>#0A3764</zeronaryColor>
17 <zeronaryComplementColor>#FFFFFF</zeronaryComplementColor>
18 </branding>
19 <changePasswordTemplate>unfiled$public/CommunityChangePasswordEmailTemplate</changePasswordTemplate>
20 <description>Metadata Community</description>
21 <emailSenderAddress>admin@networkMetadata.com</emailSenderAddress>
22 <emailSenderName>Admin User</emailSenderName>
23 <enableInvitation>false</enableInvitation>
24 <enableKnowledgeable>true</enableKnowledgeable>
25 <enableNicknameDisplay>false</enableNicknameDisplay>
26 <enablePrivateMessages>true</enablePrivateMessages>
27 <enableReputation>true</enableReputation>
28 <forgotPasswordTemplate>unfiled$public/CommunityForgotPasswordEmailTemplate</forgotPasswordTemplate>
29 <networkMemberGroups>
30 <permissionSet>Admin</permissionSet>
31 <permissionSet>Standard</permissionSet>
32 <permissionSet>ReadOnly</permissionSet>
33 <profile>Admin</profile>
34 <profile>Standard</profile>
35 <profile>ReadOnly</profile>
36 </networkMemberGroups>
37 <reputationLevels>
38 <level>
39 <branding>
40 <smallImage>communities_shared _document_folder/replevel_beginner.png</smallImage>
41 </branding>
42 <label>Beginner</label>
43 <lowerThreshold>0</lowerThreshold>
44 </level>
45 <level>
46 <branding>
47 <smallImage>communities_shared _document_folder/replevel_apprentice.png</smallImage>
48 </branding>
49 <label>Apprentice</label>
50 <lowerThreshold>51</lowerThreshold>
51 </level>
52 <level>
53 <branding>
54 <smallImage>communities_shared _document_folder/replevel_gettingthere.png</smallImage>
55 </branding>
56 <label>Getting There</label>
57 <lowerThreshold>101</lowerThreshold>
58 </level>
59 <level>
60 <branding>
61 <smallImage>communities_shared _document_folder/replevel_skilled.png</smallImage>
62 </branding>
63 <label>Skilled</label>
64 <lowerThreshold>151</lowerThreshold>
65 </level>
66 <level>
67 <branding>
68 <smallImage>communities_shared _document_folder/replevel_expert.png</smallImage>
69 </branding>
70 <label>Expert</label>
71 <lowerThreshold>201</lowerThreshold>
72 </level>
73 <level>
74 <branding>
75 <smallImage>communities_shared _document_folder/replevel_mentor.png</smallImage>
76 </branding>
77 <label>Mentor</label>
78 <lowerThreshold>251</lowerThreshold>
79 </level>
80 <level>
81 <branding>
82 <smallImage>communities_shared _document_folder/replevel_guru.png</smallImage>
83 </branding>
84 <label>Guru</label>
85 <lowerThreshold>301</lowerThreshold>
86 </level>
87 </reputationLevels>
88 <reputationPointsRules>
89 <pointsRule>
90 <eventType>FeedItemWriteAPost</eventType>
91 <points>5</points>
92 </pointsRule>
93 <pointsRule>
94 <eventType>FeedItemWriteAComment</eventType>
95 <points>3</points>
96 </pointsRule>
97 <pointsRule>
98 <eventType>FeedItemReceiveAComment</eventType>
99 <points>10</points>
100 </pointsRule>
101 <pointsRule>
102 <eventType>FeedItemLikeSomething</eventType>
103 <points>3</points>
104 </pointsRule>
105 <pointsRule>
106 <eventType>FeedItemReceiveALike</eventType>
107 <points>5</points>
108 </pointsRule>
109 <pointsRule>
110 <eventType>FeedItemMentionSomeone</eventType>
111 <points>5</points>
112 </pointsRule>
113 <pointsRule>
114 <eventType>FeedItemSomeoneMentionsYou</eventType>
115 <points>10</points>
116 </pointsRule>
117 <pointsRule>
118 <eventType>FeedItemShareAPost</eventType>
119 <points>5</points>
120 </pointsRule>
121 <pointsRule>
122 <eventType>FeedItemSomeoneSharesYourPost</eventType>
123 <points>10</points>
124 </pointsRule>
125 </reputationPointsRules>
126 <selfRegistration>false</selfRegistration>
127 <sendWelcomeEmail>true</sendWelcomeEmail>
128 <site>Network_11</site>
129 <status>UnderConstruction</status>
130 <tabs>
131 <defaultTab>Chatter</defaultTab>
132 <standardTab>Chatter</standardTab>
133 <standardTab>Account</standardTab>
134 <standardTab>Campaign</standardTab>
135 <standardTab>Case</standardTab>
136 <standardTab>Console</standardTab>
137 <standardTab>Contact</standardTab>
138 <standardTab>Contract</standardTab>
139 <standardTab>Dashboard</standardTab>
140 <standardTab>JigsawSearch</standardTab>
141 <standardTab>File</standardTab>
142 <standardTab>CollaborationGroup</standardTab>
143 <standardTab>home</standardTab>
144 <standardTab>Idea</standardTab>
145 <standardTab>Lead</standardTab>
146 <standardTab>Opportunity</standardTab>
147 <standardTab>Product2</standardTab>
148 <standardTab>UserProfile</standardTab>
149 <standardTab>report</standardTab>
150 <standardTab>Solution</standardTab>
151 </tabs>
152 <urlPathPrefix>network1</urlPathPrefix>
153 <welcomeTemplate>unfiled$public/CommunityWelcomeEmailTemplate</welcomeTemplate>
154</Network>