コミュニティーのアセット・タイプは、コミュニティーに固有のものであるという点以外は、リポジトリー・レベルのアセット・タイプに似ています。
リポジトリー管理者は、リポジトリー全体を対象とするアセット・タイプを作成し、それらのアセット・タイプがすべてのコミュニティーに対して可視であるのか、一連の特定コミュニティーを対象範囲としているのかを指定します。
始める前に
コミュニティーのアセット・タイプを作成するには、
このタスクについて
アセット・タイプに関する補足: ユーザーおよび管理者は、以下のようなさまざまな目的のためにアセット・タイプを使用します。
- 組織の内部構造に合わせるため。
- ユーザーがアセット・タイプによって検索をフィルターに掛けられるようにするため。
- アセットに制約を課すため。
例えば、あるアセットが成果物として特定のファイル・タイプを備えていたり、特定の方法で別のアセットに関連していたりすることを要求できます。
- XML 成果物の内容に基づいてアセットにカテゴリーを自動的に割り当てるため。
- XML 成果物に索引を付けてキーワード検索で検出できるようにする規則を作成するため。
- リポジトリー内に存在するアセット数のメトリックをタイプ別に参照するため。
- コミュニティー内の特定のアセット・タイプに割り当てられたカスタム・レビュー・プロセスを起動するため。
- 特定のタイプのアセットに適用するコミュニティー・ロールを割り当てるため。
アセット・タイプを作成する際には、以下の質問を考慮する必要があります。
- 誰がそのアセットを使用しますか?
- そのアセットはどのように使用されますか?
- そのアセットはどの成果物を含む必要がありますか?
- そのアセットはどの記述情報を含む必要がありますか?
- ユーザーがアセットを検索して使用するためにどのような情報が必要ですか?
- そのアセットにはどのアセットが関連していて、どのような関係になっていますか?
- アセット成果物には XML コンテンツが含まれますか? 「はい」の場合、その XML コンテンツに基づいて自動的にカテゴリーを割り当てますか?
既存のアセット・タイプに類似したアセット・タイプを作成するには、「複製」をクリックします。
このアクションにより、既存のアセット・タイプが複製されます。このアセット・タイプの名前をクリックし、詳細を編集することによって、アセット・タイプの既存の名前および詳細を変更することができます。
既存のリポジトリー・レベルのアセット・タイプをご自分のコミュニティー用にカスタマイズするには、アセット・タイプを開き、「グローバル・アセット・タイプから構成をオーバーライド」を選択します。既存のリポジトリー・レベルのアセット・タイプは、このコミュニティー専用の新規のコミュニティー・レベルのアセット・タイプに置き換えられます。
重要: リポジトリー内のアセット・タイプが、アルファベット順に表示されます。特定のビジネス要件または部門に対応したアセット・タイプを作成する場合は、ユーザーがリストからアセット・タイプを簡単に見つけられるように、類似するアセット・タイプに同じ接頭部を付けてください。
例えば、サービス・アセット・タイプとして、以下のアセット・タイプ名を作成できます。
- サービス
- サービス設計
- サービス・モデル
- サービス実装
- サービス・テスト
- サービス・テスト結果
手順
アセット・タイプを作成または変更するには、以下のようにします。
- の Web アプリケーションにログインします。
- 「管理」をクリックします。
- 「アセット・タイプ」タブをクリックします。
- 以下のように、変更するアセット・タイプを選択するか、アセット・タイプを作成します。
- アセット・タイプを変更するには、変更するアセット・タイプの名前をクリックします。
既存のアセット・タイプを変更しようとしてもできない場合は、リポジトリー管理者に連絡して、そのアセット・タイプの対象範囲をご自分のコミュニティーに限定するように依頼してください。
- アセット・タイプを作成するため、「新規アセット・タイプ」をクリックします。
- 以下のようにして、アセット・タイプを記述します。
- 「名前」フィールドに、名前を入力します。
- 「説明」フィールドに、分かりやすい説明を入力します。 「アセットの登録」ウィザードを使用して新規アセットを登録している際に、このアセット・タイプを選択して、
「説明」ページにある「タイプ」フィールドのヘルプ・アイコンをクリックしたときに、この説明が表示されます。
- 複数のコミュニティーで使用可能なアセット・タイプを変更する場合は、「グローバル・アセット・タイプから構成をオーバーライド」チェック・ボックスを選択することで、アセット・タイプをこのコミュニティー用にさらにカスタマイズできます。既存のリポジトリー・レベルのアセット・タイプは、このコミュニティー専用の新規のコミュニティー・レベルのアセット・タイプに置き換えられます。
- オプション: そのアセット・タイプに使用可能なカテゴリー・スキーマを定義します。
リポジトリー内の使用可能なすべてのカテゴリーを許可するか、または選択された限られたカテゴリーを許可することができます。
- 「範囲指定」タブをクリックします。
- アセットにすべてのカテゴリーを適用できるようにする場合は、「カテゴリーの範囲指定」セクションで、「すべてのカテゴリー・スキーマを使用」を選択します。
- カテゴリー・スキーマのサブセクションのみを許可する場合は、「選択したカテゴリー・スキーマのみを使用」を選択して、1 つ以上のカテゴリー・スキーマを選択します。
- オプション: ある拡張子、フォーマット、またはラベルに適合する必要な成果物の定量化可能な範囲を指定することにより、成果物の制約を定義します。
- 「制約」タブをクリックします。
- 「成果物の制約」セクションで、「新規成果物の制約」をクリックします。
- 必要な成果物の範囲を選択し、制限のタイプを選択して、必要な成果物のタイプの値を入力します。 例えば、「プレゼンテーション」というアセット・タイプのアセットを作成する場合は、そのアセットにファイル拡張子 .ppt を持つ成果物が少なくとも 1 つ含まれているということを指定することができます。
フォーマットは、ファイルのコンテキストです (例えば、プレゼンテーション・モデルやプロセス・モデル)。
ファイル拡張子は、ファイルのタイプです (例えば、.txt、.xml、または .ppt)。
フォーマットは、ファイルの MIME 型に基づいて自動的に定義されます。
- オプション: 関係の制約を定義します。
- 「制約」タブをクリックします。
- 「関係の制約」セクションで、「新規関係の制約」をクリックします。
- 定量化可能な範囲を指定し、選択した関係と一致していなければならないアセット・タイプを選択します。
- このタイプのアセットを、ここに定義されている関係の制約のみを使用するように制限したい場合は、「これらの関係のみを許可 (Allow only these relationships)」を選択します。 ユーザーがこのタイプのアセットを登録または変更する際は、その他の関係はすべて選択できなくなります。
- オプション: ユーザーがアセットに関する追加情報を入力したり、事前定義値を選択したりできるようにアセットの属性を追加します。これらの属性は、
2 列編成で、アセットの一般情報ページに表示されます。
「非表示属性」セクションに移動された属性は、
アセットの一般情報ページには表示されません。
- 「制約」タブをクリックします。
- 属性の制約を各セクションに追加します。 セクションは、「列 1」、「列 2」、および「非表示属性」に分けられています。
属性を 2 列に編成して、アセットの一般情報ページで属性をグループ化できます。
「非表示属性」セクションに含まれている属性は、
アセットの一般情報ページには表示されません。属性の制約を追加するには、以下のようにします。
- セクション名にカーソルを合わせて、「挿入」アイコンをクリックします。
- 「属性の制約の追加」をクリックします。
- フィルターに名前を入力して属性を選択するか、Ctrl キーを押したまま複数の属性を選択して、
「追加して閉じる」をクリックします。
- 必要な属性の制約を選択します。
- 属性名にカーソルを合わせて、「編集」アイコンをクリックします。
「編集」アイコンが表示されない場合は、属性は既に必須になっており、編集できません。
- 「属性は必須です」チェック・ボックスを選択します。
- 「OK」をクリックします。
- 各セクション内にグループを作成します。
- 各セクションにカーソルを合わせて、「挿入」アイコンをクリックします。
- 「属性グループの追加」をクリックします。
- グループの名前を入力して、「追加して閉じる」をクリックします。
- アセットのユーザーの論理順序およびグループ化で属性を再配列します。 属性を別のセクションまたはグループに移動するには、
属性をクリックしたまま、カーソルを目的の場所に移動し、カテゴリーを放します。
- オプション: アセットにアップロードする XML 成果物のコンテンツに基づいてアセットにカテゴリーを自動的に適用する XPath 式および規則を定義します。
- 「自動カテゴリー化」タブをクリックします。
- 「新規 XML 成果物のカテゴリー化」をクリックします。
- 「名前空間マッピング」セクションにデータを取り込んで、XPATH 式をテストするには、ローカル・ファイル・システムにあるサンプル文書を参照し、「サンプルのアップロード」をクリックして、サンプルの XML 文書をアップロードします。 複数の文書をアップロードした場合は、最新の文書のみが使用できます。このサンプル・ファイルは、ログアウトするまで、複数のアセットで再利用できます。
- XML コンテンツを含める成果物ファイル・タイプを追加するために、「ファイル・タイプの追加」をクリックしてファイル拡張子を入力し、「OK」をクリックします。
- 「名前空間マッピングの追加」をクリックして、XML 名前空間の接頭部および URI を入力します。
「サンプル XML ファイル」セクションでファイルをアップロードした場合は、「サンプルからの追加」をクリックして、そのファイルからすべての名前空間情報を取得できます。
リストにある任意のマッピングを編集または削除できます。 デフォルトの名前空間は、接頭部「default.」を付けてリストされています。
実際の要素名を使用するようにこのマッピングを編集することも、XPath 式で要素名の代わりに「default」を使用することもできます。
- このタイプのアセットに指定の XPath 式と一致する成果物が含まれている場合に、
それらのアセットに自動的に適用される 1 つ以上のカテゴリーを選択するため、
「カテゴリーの追加」をクリックして、「カテゴリー化の選択」ウィンドウから 1 つ以上のカテゴリーを選択します。 カテゴリーを削除するには、「削除」をクリックします。
- 「XPath 式」フィールドに、XML 文書の検索に使用する XPath 式を入力します。 例: /wsdl:definitions/@targetNameSpace
- サンプル XML ファイルに対して XPath 式を評価するために、「サンプルのテスト」をクリックします。 評価の結果を表示することができます。
- 「内容」フィールドに、XPath 式と突き合わせる値を入力します。 例: example.com
このアセット・タイプを登録する際、
XPath 式の結果が「内容」フィールドの値と一致した場合に、指定したカテゴリーがアセットに適用されます。
- オプション: 検索結果に XML 成果物のコンテンツをどのように索引付けして表示するかを定義します。
- 「索引付け規則の検索」タブをクリックします。
- 「新規規則」をクリックします。
- 「XML 成果物規則」を選択して、「OK」をクリックします。 「XML 索引付け規則」ページが開きます。
- 「名前」フィールドに、規則の名前を入力します。
- 「説明」フィールドに、規則の分かりやすい説明を入力します。
- 「ファイル拡張子」フィールドに、索引付けするファイル拡張子のリストを入力します。
拡張子が複数ある場合はスペースで区切ります。 例: wsdl xml dita xsd
- 索引付けする XML 要素を定義するために、「規則構成」セクションで、「要素の追加」をクリックします。
- 「要素」フィールドに、索引付けする XML 要素を入力します。
その要素のすべての属性の内容にも索引付けする場合は、「すべての属性に索引付け」を選択します。
- 「OK」をクリックします。
- オプション: 索引付けする 1 つ以上の特定の要素属性を定義する場合は、「属性の追加」をクリックして属性名を入力し、「OK」をクリックします。
索引付けするすべての属性について、この作業を繰り返します。
- 「OK」をクリックします。「アセット・タイプ」ページが再オープンします。
規則を編集する場合は規則名をクリックし、削除する場合は「削除」をクリックします。
- 「OK」をクリックして、アセット・タイプを保管します。
タスクの結果
コミュニティー用にカスタマイズしたアセット・タイプには、3 ユーザーが示されたアイコンが表示されます。