Force.com Apex コード開発者ガイド
jsObject に関連付けられたすべてのデータカテゴリへのアクセス
describeDataCategoryGroups メソッドおよび describeDataCategoryGroupStructures メソッドを使用して、特定のオブジェクトに関連付けられたカテゴリを返します。
- 選択したオブジェクトに関連付けられたすべてのカテゴリグループを返します (「describeDataCategoryGroups(sObjectNames)」を参照)。
- 返された対応付けから、詳細に検索するカテゴリグループ名と sObject 名を取得します (「DescribeDataCategoryGroupResult クラス」を参照)。
- カテゴリグループおよび関連付けられたオブジェクトを指定し、このオブジェクトに使用できるカテゴリを取得します (describeDataCategoryGroupStructuresを参照)。
describeDataCategoryGroupStructures メソッドは、指定したカテゴリグループのオブジェクトに使用できるカテゴリを返します。データカテゴリについての詳細は、Salesforce オンラインヘルプの「データカテゴリとは?」を参照してください。
次の例では、describeDataCategoryGroupSample メソッドは、Article オブジェクトおよび Question オブジェクトに関連付けられたすべてのカテゴリグループを返します。describeDataCategoryGroupStructures メソッドは、領域カテゴリグループの記事および質問に使用できるすべてのカテゴリを返します。記事および質問についての詳細は、Salesforce オンラインヘルプの「記事と翻訳の管理」および「アンサーの概要」を参照してください。
次の例を使用するには、次を行う必要があります。
- Salesforce ナレッジを有効化する。
- アンサー機能を有効化する。
- 領域というデータカテゴリグループを作成する。
- 領域をアンサーで使用するデータカテゴリグループとして割り当てる。
- 領域データカテゴリグループが Salesforce ナレッジに割り当てられていることを確認する。
データカテゴリグループの作成についての詳細は、Salesforce オンラインヘルプの「カテゴリグループの作成と変更」を参照してください。アンサーについての詳細は、Salesforce オンラインヘルプの「アンサーの概要」を参照してください。
1swfobject.registerObject("clippy.codeblock-0", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17public class DescribeDataCategoryGroupSample {
18 public static List<DescribeDataCategoryGroupResult> describeDataCategoryGroupSample(){
19 List<DescribeDataCategoryGroupResult> describeCategoryResult;
20 try {
21 //Creating the list of sobjects to use for the describe
22 //call
23 List<String> objType = new List<String>();
24
25 objType.add('KnowledgeArticleVersion');
26 objType.add('Question');
27
28 //Describe Call
29 describeCategoryResult = Schema.describeDataCategoryGroups(objType);
30
31 //Using the results and retrieving the information
32 for(DescribeDataCategoryGroupResult singleResult : describeCategoryResult){
33 //Getting the name of the category
34 singleResult.getName();
35
36 //Getting the name of label
37 singleResult.getLabel();
38
39 //Getting description
40 singleResult.getDescription();
41
42 //Getting the sobject
43 singleResult.getSobject();
44 }
45 } catch(Exception e){
46 }
47
48 return describeCategoryResult;
49 }
50}
51
521swfobject.registerObject("clippy.codeblock-1", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17public class DescribeDataCategoryGroupStructures {
18 public static List<DescribeDataCategoryGroupStructureResult>
19 getDescribeDataCategoryGroupStructureResults(){
20 List<DescribeDataCategoryGroupResult> describeCategoryResult;
21 List<DescribeDataCategoryGroupStructureResult> describeCategoryStructureResult;
22 try {
23 //Making the call to the describeDataCategoryGroups to
24 //get the list of category groups associated
25 List<String> objType = new List<String>();
26 objType.add('KnowledgeArticleVersion');
27 objType.add('Question');
28 describeCategoryResult = Schema.describeDataCategoryGroups(objType);
29
30 //Creating a list of pair objects to use as a parameter
31 //for the describe call
32 List<DataCategoryGroupSobjectTypePair> pairs =
33 new List<DataCategoryGroupSobjectTypePair>();
34
35 //Looping throught the first describe result to create
36 //the list of pairs for the second describe call
37 for(DescribeDataCategoryGroupResult singleResult :
38 describeCategoryResult){
39 DataCategoryGroupSobjectTypePair p =
40 new DataCategoryGroupSobjectTypePair();
41 p.setSobject(singleResult.getSobject());
42 p.setDataCategoryGroupName(singleResult.getName());
43 pairs.add(p);
44 }
45
46 //describeDataCategoryGroupStructures()
47 describeCategoryStructureResult =
48 Schema.describeDataCategoryGroupStructures(pairs, false);
49
50 //Getting data from the result
51 for(DescribeDataCategoryGroupStructureResult singleResult : describeCategoryStructureResult){
52 //Get name of the associated Sobject
53 singleResult.getSobject();
54
55 //Get the name of the data category group
56 singleResult.getName();
57
58 //Get the name of the data category group
59 singleResult.getLabel();
60
61 //Get the description of the data category group
62 singleResult.getDescription();
63
64 //Get the top level categories
65 DataCategory [] toplevelCategories =
66 singleResult.getTopCategories();
67
68 //Recursively get all the categories
69 List<DataCategory> allCategories =
70 getAllCategories(toplevelCategories);
71
72 for(DataCategory category : allCategories) {
73 //Get the name of the category
74 category.getName();
75
76 //Get the label of the category
77 category.getLabel();
78
79 //Get the list of sub categories in the category
80 DataCategory [] childCategories =
81 category.getChildCategories();
82 }
83 }
84 } catch (Exception e){
85 }
86 return describeCategoryStructureResult;
87 }
88
89 private static DataCategory[] getAllCategories(DataCategory [] categories){
90 if(categories.isEmpty()){
91 return new DataCategory[]{};
92 } else {
93 DataCategory [] categoriesClone = categories.clone();
94 DataCategory category = categoriesClone[0];
95 DataCategory[] allCategories = new DataCategory[]{category};
96 categoriesClone.remove(0);
97 categoriesClone.addAll(category.getChildCategories());
98 allCategories.addAll(getAllCategories(categoriesClone));
99 return allCategories;
100 }
101 }
102}
103
104sObject に関連付けられたすべてのデータカテゴリへのアクセスのテスト
次の例では、上記の describeDataCategoryGroupSample メソッドをテストします。返されたカテゴリグループおよび関連付けられたオブジェクトが正しいことを確認できます。
1swfobject.registerObject("clippy.codeblock-2", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17@isTest
18private class DescribeDataCategoryGroupSampleTest {
19 public static testMethod void describeDataCategoryGroupSampleTest(){
20 List<DescribeDataCategoryGroupResult>describeResult =
21 DescribeDataCategoryGroupSample.describeDataCategoryGroupSample();
22
23 //Assuming that you have KnowledgeArticleVersion and Questions
24 //associated with only one category group 'Regions'.
25 System.assert(describeResult.size() == 2,
26 'The results should only contain two results: ' + describeResult.size());
27
28 for(DescribeDataCategoryGroupResult result : describeResult) {
29 //Storing the results
30 String name = result.getName();
31 String label = result.getLabel();
32 String description = result.getDescription();
33 String objectNames = result.getSobject();
34
35 //asserting the values to make sure
36 System.assert(name == 'Regions',
37 'Incorrect name was returned: ' + name);
38 System.assert(label == 'Regions of the World',
39 'Incorrect label was returned: ' + label);
40 System.assert(description == 'This is the category group for all the regions',
41 'Incorrect description was returned: ' + description);
42 System.assert(objectNames.contains('KnowledgeArticleVersion')
43 || objectNames.contains('Question'),
44 'Incorrect sObject was returned: ' + objectNames);
45 }
46 }
47}この例では、describeDataCategoryGroupStructures メソッドをテストします。返されたカテゴリグループ、カテゴリ、および関連付けられたオブジェクトが正しいことを確認できます。
1swfobject.registerObject("clippy.codeblock-3", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17@isTest
18private class DescribeDataCategoryGroupStructuresTest {
19 public static testMethod void getDescribeDataCategoryGroupStructureResultsTest(){
20 List<Schema.DescribeDataCategoryGroupStructureResult> describeResult =
21 DescribeDataCategoryGroupStructures.getDescribeDataCategoryGroupStructureResults();
22
23 System.assert(describeResult.size() == 2,
24 'The results should only contain 2 results: ' + describeResult.size());
25
26 //Creating category info
27 CategoryInfo world = new CategoryInfo('World', 'World');
28 CategoryInfo asia = new CategoryInfo('Asia', 'Asia');
29 CategoryInfo northAmerica = new CategoryInfo('NorthAmerica',
30 'North America');
31 CategoryInfo southAmerica = new CategoryInfo('SouthAmerica',
32 'South America');
33 CategoryInfo europe = new CategoryInfo('Europe', 'Europe');
34
35 List<CategoryInfo> info = new CategoryInfo[] {
36 asia, northAmerica, southAmerica, europe
37 };
38
39 for (Schema.DescribeDataCategoryGroupStructureResult result : describeResult) {
40 String name = result.getName();
41 String label = result.getLabel();
42 String description = result.getDescription();
43 String objectNames = result.getSobject();
44
45 //asserting the values to make sure
46 System.assert(name == 'Regions',
47 'Incorrect name was returned: ' + name);
48 System.assert(label == 'Regions of the World',
49 'Incorrect label was returned: ' + label);
50 System.assert(description == 'This is the category group for all the regions',
51 'Incorrect description was returned: ' + description);
52 System.assert(objectNames.contains('KnowledgeArticleVersion')
53 || objectNames.contains('Question'),
54 'Incorrect sObject was returned: ' + objectNames);
55
56 DataCategory [] topLevelCategories = result.getTopCategories();
57 System.assert(topLevelCategories.size() == 1,
58 'Incorrect number of top level categories returned: ' + topLevelCategories.size());
59 System.assert(topLevelCategories[0].getLabel() == world.getLabel() &&
60 topLevelCategories[0].getName() == world.getName());
61
62 //checking if the correct children are returned
63 DataCategory [] children = topLevelCategories[0].getChildCategories();
64 System.assert(children.size() == 4,
65 'Incorrect number of children returned: ' + children.size());
66 for(Integer i=0; i < children.size(); i++){
67 System.assert(children[i].getLabel() == info[i].getLabel() &&
68 children[i].getName() == info[i].getName());
69 }
70 }
71
72 }
73
74 private class CategoryInfo {
75 private final String name;
76 private final String label;
77
78 private CategoryInfo(String n, String l){
79 this.name = n;
80 this.label = l;
81 }
82
83 public String getName(){
84 return this.name;
85 }
86
87 public String getLabel(){
88 return this.label;
89 }
90 }
91}