メタデータ API 開発者ガイド
jModerationRule
メンバー生成コンテンツをモデレートするために Experience Cloud サイトで使用されるルールを表します。各ルールには、ルールの適用対象となるメンバー生成コンテンツ、ルールを適用する条件、および実行するモデレーションアクションを指定します。モデレーションルールは、サイトをスパム、ボット、攻撃的または不適切なコンテンツから保護します。Metadata メタデータ型を拡張し、その fullName 項目を継承します。
メタデータ API で作成されたモデレーションルールは、[エクスペリエンス管理] の UI で設定されたモデレーションルールよりも強力です。たとえば、UI では、投稿およびコメントをモデレートするルールを作成できます。メタデータ API では、リンクフィード種別のリンク名のみをモデレートするルールを作成できます。複雑なモデレーションルールを表現するには、メタデータ API を使用します。
モデレーションルールを作成する場合は、次の点に注意してください。
- 組織では、最大 30 個のルールを設定できます。これは、サイト単位ではなく組織単位の制限です。この制限には、コンテンツルールと処理数ルールの両方が含まれます。
- 各ルールには最大 3 つのキーワード条件を含めることができます。
- コンテンツをブロックするルールが最初に実行され、続いてコンテンツを確認し承認するルール、コンテンツを置き換えるルール、コンテンツにフラグを設定するルールの順に実行されます。複数のルールが同じアクションを実行する場合、ルールが作成された日付を基準にして、古い順に実行されます。コンテンツを置き換えるルールは、コンテンツが確認ルールにも適用される場合は実行されません。つまり、コミュニティマネージャが元のコンテンツを確認するようにします。
ファイルのサフィックスおよびディレクトリの場所
ModerationRule コンポーネントのサフィックスは .rule で、このコンポーネントは対応するパッケージディレクトリの moderation ディレクトリに保存されます。ファイル名の形式は、site_name.moderation_rule_developer_name.rule のようになります。
バージョン
ModerationRule コンポーネントは、API バージョン 36.0 以降で使用できます。
特別なアクセスルール
モデレーションルールの参照、作成、編集、削除を行うには、「エクスペリエンスの管理」または「エクスペリエンスの作成および設定」権限が必要です。Spring '20 以降は、モデレーションルールを編集するための権限を持つユーザのみがこのオブジェクトにアクセスできます。
項目
宣言的なメタデータの定義のサンプル
ModerationRule コンポーネントの例を次に示します。
1<?xml version="1.0" encoding="UTF-8"?>
2<ModerationRule xmlns="http://soap.sforce.com/2006/04/metadata">
3 <description>Blocks Bad Word List in posts, comments, Link URLs, titles, and poll choices.</description>
4 <masterLabel>Blocking Rule</masterLabel>
5 <action>Block</action>
6 <active>true</active>
7 <userMessage>You can't use %BLOCKED_KEYWORD% or other inappropriate words in this site. Review your content and try again.</userMessage>
8 <!-- Applies the rule to FeedComment.RawCommentBody (an internal only field), if it contains words from the keyword list specified -->
9 <entitiesAndFields>
10 <entityName>FeedComment</entityName>
11 <fieldName>RawCommentBody</fieldName>
12 <keywordList>site1.badword_list</keywordList>
13 </entitiesAndFields>
14 <entitiesAndFields>
15 <entityName>FeedItem</entityName>
16 <fieldName>LinkUrl</fieldName>
17 <keywordList>site1.badword_list</keywordList>
18 </entitiesAndFields>
19 <!-- Applies the rule to FeedItem.RawBody (an internal only field), if it contains words from the keyword list specified -->
20 <entitiesAndFields>
21 <entityName>FeedItem</entityName>
22 <fieldName>RawBody</fieldName>
23 <keywordList>site1.badword_list</keywordList>
24 </entitiesAndFields>
25 <entitiesAndFields>
26 <entityName>FeedItem</entityName>
27 <fieldName>Title</fieldName>
28 <keywordList>site1.badword_list</keywordList>
29 </entitiesAndFields>
30 <entitiesAndFields>
31 <entityName>FeedPollChoice</entityName>
32 <fieldName>ChoiceBody</fieldName>
33 <keywordList>site1.badword_list</keywordList>
34 </entitiesAndFields>
35</ModerationRule>前の定義を参照する package.xml の例を次に示します。
1<?xml version="1.0" encoding="UTF-8"?>
2<Package xmlns="http://soap.sforce.com/2006/04/metadata">
3 <types>
4 <name>ModerationRule</name>
5 <members>site1.blocking_rule</members>
6 </types>
7 <version>36.0</version>
8</Package>マニフェストファイル内のワイルドカードのサポート
このメタデータ型では、package.xml マニフェストファイル内のワイルドカード文字 * (アスタリスク) がサポートされます。マニフェストファイルの使用についての詳細は、「zip ファイルを使用したメタデータのリリースと取得」を参照してください。