Jira Service Management の管理者向けの利用開始ガイド
最初に、Jira Service Management の使用を開始する方法を確認します。
IT 資産管理 (ITAM) 用のインポート構造を作成する
Jira Service Management のアセットは、Premium と Enterprise のみの機能です。アセットの詳細についてご確認ください。
このガイドの使用方法
アセット ガイドのこの章では、アセットにインポート構造を作成する方法について説明します。この章を十分に理解するには、以下の前の章を完了しておく必要があります。
このガイドの各ステップには、Jira Service Management でアセットを使用するための詳しい手順だけでなく、チームの IT 資産管理 (ITAM) プロセスの一環として使用する場合にこの強力な機能を最大限に活用するためのヒントやベスト プラクティスも記載されています。
このガイドには次の 2 種類の情報があります。
背景が青いヘッダーはアセットの利用開始に役立ちます。データの例や各機能の使用方法など、ガイドの各ステップに関する情報です。
背景が白いテキストは、アセットの操作手順、またはアセットのコンセプトに関する詳細な情報です。
他にも次のような情報があります。
太字の情報は、メニュー オプションの名前、オン/オフを切り替えることができる機能、ボタンなど、アセット自体にあるテキストを示しています。
code の情報は、IT 資産管理 (ITAM) 用サンプル オブジェクト スキーマに含まれるテキストです。
太字で斜体になっている情報は、アセットの重要な部分を形成する概念またはアイデアです。
インポートの概要
インポートとは、外部データをアセットに取り込んで、アセットのオブジェクト タイプ、オブジェクト、属性、参照に変換する手段です。
インポートは、インターフェイスを使用してデータを作成するよりもスピーディかつ簡単で、動的であるため、データをアセットに取り込む方法として推奨されています。
アセットにデータをインポートするには次の 3 つが必要です。
データ: アセットに取り込む未加工の情報です。このデータは、CSV または JSON ファイルの形式でも、サードパーティのアプリやプロバイダーから直接入手したものでもかまいません。
構造: データのフレームワークを提供するアセットのオブジェクト タイプ、属性、参照です。インポートの管理方法によっては、あらかじめ手動で作成した構造を使用した方が良い場合もあれば、オブジェクト タイプと属性の作成をアセット自体にすべて任せた方が良い場合もあります。
マッピング: データ ソースの特定の情報を構造内の特定のオブジェクトまたは値とリンクすることで、データと構造を結びつける手段です。さらに、マッピングを行うことでこのデータが正しい場所に収まり、この情報が正規化されて正確になります。
アセットには、インポート マッピング、オブジェクト タイプ マッピング、属性タイプ マッピングの 3 つのレベルのマッピングがあります。
それぞれが他のマッピングの中にネストされています。つまり、インポート マッピングはオブジェクト マッピングのグループであり、それらのオブジェクト マッピングにはそれぞれ複数の属性マッピングを含めることができます。
インポート マッピングには、エンコード方法やオブジェクトとオブジェクト タイプへの分割方法など、未加工データの設定方法に関する一般的な情報が含まれています。
オブジェクト タイプ マッピングには、マッピングからオブジェクトとオブジェクト タイプを作成する方法に関するより具体的な情報が含まれています。
属性タイプ マッピングには、未加工データを新しいオブジェクトの属性に変換する方法の詳細が含まれています。
これらが IT 資産管理 (ITAM) でどのように機能するかを見てみましょう。
このガイドの前のセクションに従って、情報を格納するオブジェクト スキーマと属性を作成しました。これが今回の構造になります。次に、データをアセットに取り込み、マッピングしてオブジェクトと属性を作成します。
データは、モデル データ ソースと資産データ ソースの 2 つの異なるデータ ソースから取得します。これらのデータ ソースはいずれも CSV 形式になります。
インポート時の情報アーキテクチャの概要
アセットの重要な概念の 1 つは情報アーキテクチャです。これは、データを整理する最良の方法の理解と開発を意味します。アセットにおける情報アーキテクチャとは、データを保持するためのオブジェクト タイプと属性をどのように構築したかを指します。
以前オブジェクト タイプを作成したときに見たのと同じ一般的なルールがインポート構造の作成にも適用されます。それらを確認していきましょう。
インポート構造は適切なサイズになっています。インポート構造はインポートするデータが収まるサイズになっています。作成するオブジェクトごとに 1 つのオブジェクト タイプ マッピングがあり、そのオブジェクト内の属性ごとに 1 つの属性タイプ マッピングがあります。
インポート構造は一意です。あるインポート構造が別のインポート構造にあるマッピングと同じになることはありません。1 つのオブジェクト候補のセットから複数の異なるオブジェクト タイプを作成する場合は、子オブジェクト マッピングを使用してすべてを一度に作成するようにしてください。
インポート構造は拡張可能です。オブジェクト構造は、データが変更された場合だけでなく、スキーマが変更された場合でも修正できるように設計されています。[属性マッピング] 画面の [AQL] フィールドを使用してインポートする場合は、本格的なオブジェクトを作成することをお勧めします。
データを取り込む際には、モデルと資産のデータを別々に取り込み、それぞれ一意のものとして扱います。これには次のようにいくつかの理由があります。
各データ ソースはオブジェクト スキーマの異なる場所に接続します。既存の在庫の資産によって Hardware assets オブジェクト タイプとその子が設定されるのに対して、IT 資産候補のモデルによって Model オブジェクト タイプとその子が設定されます。データ セットごとにマッピング先が異なるため、それぞれに一意のマッピングを使用します。
また、各データ セットを個別に処理します。Model データは直接インポートできますが、Hardware assets データについては以前のインポートの結果と比較することで正規化します。これは、不足している資産、予想していなかった余分な資産、または予想と実際の在庫レベルの間に異常がないかどうかを確認できるようにするためです。
最後になりますが、モデルとアセットのデータ セットは必ずしも同時に更新されるわけではありません。これらを分けておくことで、資産を最新の状態に保ちながら、モデルの重要性を低くすることができます。
インポート構造の概要
インポート構造はインポートの実行方法をアセットに指示するためのレシピです。アセットがデータを見つけられる場所、アセットがデータの構造を構築する場所、アセットがデータを細かく分割し、マッピングを使用して正しい場所にそれらを配置する方法など、上記のすべての詳細がこのレシピには含まれています。
さまざまな種類の複数のインポートを管理および実行する機能や、異なるソース (または同じソース) からの情報を重ね合わせることで正確な最新の信頼できる唯一の情報源を作成する機能がアセットには備わっています。
アセットで使用できるさまざまなデータ ソースに関連して、さまざまな種類のインポート構造があります。現在、インポート構造には主に次の 4 種類があります。
CSV
JSON
Assets Discovery
外部インポート
また、REST API フレームワークを使用して、外部ソースからデータをインポートすることもできます。REST API を使用したインポートの詳細については、開発者向けドキュメント セクションの「Imports REST API」ガイドをご覧ください。
CSV データのフォーマット
あらかじめ用意されているサンプル データを使用するため、今回はデータのフォーマットについて心配する必要はありませんが、それ以外の状況では極めて非常になる場合があります。CSV または JSON データ ファイルに構文エラーがある場合、インポートによって予期しない結果になったり、実行されなかったりする可能性があります。
ここからは、CSV のデータ フォーマットについて、今後知っておくべき情報をいくつか紹介します。
UTF-8 (初期設定)、UTF-16、ISO-8859-1、ISO-8859-15、Windows-1250、Windows 1252 のいずれかの形式を使用できます。
CSV ファイルには、インポート用のデータ ロケーターの作成に使用されるヘッダーが必要です。
CSV ファイルには、1 文字の区切り文字を含める必要があります。デフォルトの区切り文字は、通常はカンマです。インポート設定の作成時に、[Delimiter (区切り文字)] フィールドでカスタムの区切り文字を選択できます。区切り文字を含めるには、値を二重引用符で囲みます。区切り文字または二重引用符を含めるには、それぞれの値を二重引用符で囲みます。また、「\t」と入力するとタブ区切り文字を使用できます。
複数の値を分割するには (複数のカーディナリティを持つアセット属性の場合)、CSV ファイル内で「||」(2 つのパイプ文字) を使用します。
複数の値を 1 つのアセット属性に結合する場合は、CSV ファイルで連結子を使用します。既定ではダッシュ記号「-」です。データがスペースで連結されている場合は、インポート設定を作成するときに [連結] フィールドに「\s」を入力できます。
CSV ファイルからアセットにオブジェクトをインポートする場合は、名前やキーではなくラベルとして割り当てられた属性によってオブジェクトを識別する必要があります。
Jira ユーザーまたはグループをアセットにインポートする場合は、名前ではなく ID によってユーザーまたはグループを識別する必要があります。
アセットに URL をインポートする場合、URL を URL 属性タイプに変換するには、先頭を http:// か https:// にする必要があります。先頭が http:// または https:// ではない場合は、文字列属性タイプとしてインポートされます。属性タイプの詳細をご確認ください。
Google スプレッド シートのリンクから CSV データをインポートする場合に、使用する URL を正しく機能させるには編集が必要です。URL の末尾から /edit#gid=0 を削除して、/export?format=csv に置き換えます。
データ セットの作成
アセットへのデータのインポートを始める前に、データ ソースを用意する必要があります。データ ソースは、アップロードされた CSV や JSON などの静的データ ファイルでも、Web 上でホストされているものでも構いません。
このチュートリアルでは、モデルとアセットという 2 つの独立したデータ ソースを使用します。モデルには、発生する可能性のあるすべての IT 資産に関する情報が格納され、アセットには現在システム内にあるインベントリ アイテムのみが一覧表示されます。モデルとアセットに分けることで、ベンダー リストなど 1 か所からモデルをインポートし、現在の資産インベントリと同期できるようになります。
モデルや技術仕様などのモデル一覧情報のサンプル CSV データを次に示します。このモデルには現在 40 個のオブジェクト (10 種類のラップトップ モデル、10 種類の電話モデル、10 種類のサーバー モデル、10 種類のプリンター モデル) があります。
各モデルには、カテゴリ、 モデル、単価、説明を指定する詳細が含まれています。データ ファイル内のこれらの詳細は、モデル オブジェクト タイプの適切な属性にマップされます。
このデータをテキスト ファイルにコピーして models.csv というファイル名を付けます。このデータは、入手可能なノート パソコンの現行モデルを表しています。
各 CSV ファイルは必ず UTF-8 形式で保存してください。アセットはさまざまな形式のデータを受け入れることができますが、UFT-8 は CSV ファイルで最も一般的に使用されている形式です。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
Model Name,Category,Unit Price,Description
iPhone 12,Phone,999,Apple iPhone 12 64GB
iPhone 11,Phone,799,Apple iPhone 11 64GB
Galaxy S21,Phone,999,Samsung Galaxy S21 128GB
Galaxy S20,Phone,899,Samsung Galaxy S20 128GB
Dell XPS 15,Laptop,2000,Dell XPS 15 9500 15.6" Laptop
HP Spectre x360,Laptop,1500,HP Spectre x360 13.3" Laptop
Lenovo ThinkPad X1 Carbon,Laptop,1900,Lenovo ThinkPad X1 Carbon 14" Laptop
MacBook Pro 16,Laptop,2400,Apple MacBook Pro 16" Laptop
Dell PowerEdge R640,Server,5000,Dell PowerEdge R640 1U Rack Server
HP ProLiant DL380,Server,5500,HP ProLiant DL380 Gen10 2U Rack Server
Lenovo ThinkSystem SR630,Server,6000,Lenovo ThinkSystem SR630 1U Rack Server
HP LaserJet Pro MFP M428fdw,Printer,350,HP LaserJet Pro MFP M428fdw Monochrome Laser Printer
Canon imageCLASS MF743Cdw,Printer,500,Canon imageCLASS MF743Cdw Color Laser Printer
Brother MFC-L2750DW,Printer,250,Brother MFC-L2750DW Monochrome Laser Printer
Epson WorkForce Pro WF-4830,Printer,300,Epson WorkForce Pro WF-4830 All-in-One Printerモデル情報が定義できたら、資産についても同じ作業をしましょう。資産のデータ ファイルには、シリアル番号、所有者、購入日、ステータスなど、手元にある実際の IT 資産に固有の情報が含まれます。
このデータを別のテキスト ファイルにコピーして、assets.csv という名前を付けます。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
Device Type,Serial Number,Model Name,Purchase Date,Owner Group,Status,Asset Tag,PO Number,Asset Status
Phone,SN001,iPhone 12,01/01/2021,HR,Active,AT001,PO001,In Use
Phone,SN002,iPhone 11,01/02/2020,Sales,Active,AT002,PO002,In Use
Phone,SN003,Galaxy S21,03/01/2021,IT,Inactive,AT003,PO003,In Stock
Phone,SN004,Galaxy S20,12/01/2019,Finance,Active,AT004,PO004,In Use
Laptop,SN005,Dell XPS 15,06/01/2020,HR,Active,AT005,PO005,In Use
Laptop,SN006,HP Spectre x360,07/01/2019,Sales,Inactive,AT006,PO006,Disposed
Laptop,SN007,Lenovo ThinkPad X1 Carbon,08/01/2018,IT,Active,AT007,PO007,In Use
Laptop,SN008,MacBook Pro 16,10/01/2020,Finance,Active,AT008,PO008,In Use
Server,SN009,Dell PowerEdge R640,04/01/2018,IT,Active,AT009,PO009,In Use
Server,SN010,HP ProLiant DL380,05/01/2019,IT,Inactive,AT010,PO010,In Stock
Server,SN011,Lenovo ThinkSystem SR630,11/01/2020,IT,Active,AT011,PO011,In Use
Printer,SN012,HP LaserJet Pro MFP M428fdw,02/01/2021,Sales,Active,AT012,PO012,In Use
Printer,SN013,Canon imageCLASS MF743Cdw,05/01/2020,HR,Active,AT013,PO013,In Use
Printer,SN014,Brother MFC-L2750DW,08/01/2019,Finance,Inactive,AT014,PO014,Disposed
Printer,SN015,Epson WorkForce Pro WF-4830,03/01/2021,IT,Active,AT015,PO015,In Useインポート構造の作成
CSV データが 2 セットできたら、それぞれのインポート構造を作成します。各インポート構造には、データをアセットのオブジェクトと属性に変換する方法の詳細が含まれます。
それぞれのインポート構造を作成するため、データを設定し、前のセクションで作成した CSV ファイルをアップロードする手順を説明します。
最初のインポート構造に models-import という名前を付けます。前のセクションで作成した models.csv ファイルをアップロードします。
2 つ目のインポート構造に assets-import という名前を付けます。前のセクションで作成した assets.csv ファイルをアップロードします。
モデル データのオブジェクト タイプと属性はすでに作成しているので、両インポート構造の [オブジェクト タイプと属性を自動で作成] を無効にして、オブジェクト マッピングと属性マッピングをイチから手動で作成します。
現時点では、区切り文字、エンコード、連結子、空の値、不明な値、または日付形式の既定の設定は変更しません。
以下のプロセスは、model-import に対して 1 回、assets-import に対して 1 回の計 2 回行う必要があります。
インポート構造を作成するには、次の手順に従います。
サービス プロジェクトから、[アセット] > [オブジェクト スキーマ] の順に移動します。
オブジェクト スキーマを選択します。
[スキーマ設定] を選択して、次に [インポート] タブを選択します。
[インポート] タブで、次の手順に従います。
インポート構造がない場合は、メッセージ「インポート構造が作成されていません」が表示されます。[最初に作成] をクリックします。
インポート構造がすでに作成されている場合は、[インポートを作成] をクリックして新しいインポート構造を追加します。
表示されたオプションから [CSV インポート] を選択します。
次に、[インポート構造を定義] 画面でインポート構造を設定します。外部インポートを作成する場合は 、このステップをスキップできます。
Name (required) (名前 (必須)): インポート設定の名前を入力します。
説明: インポート設定の説明を入力します。
ファイルをドラッグ & ドロップするか参照する (必須) - ここにソース データ ファイルをドラッグ & ドロップするか参照します。
オブジェクト タイプと属性を自動で作成する - このオプションを無効にするには、データのインポート前にデータをスキーマに手動でマッピングする必要があります。データの手動マッピングに関する詳細についてご確認ください。
その他のオプション - アセットが区切り文字、エンコード、空または不明な値、連結子、日付形式を処理する方法を変更するには、ここで既定値を変更します。
Delimiter (required) (区切り文字 (必須): ファイルで使用する区切り文字を選択します。区切り文字は、ある値の終わりと次の値の始まりの場所を示す文字です。「\ t」で示される「タブ」文字を除いて、1 文字の長さの区切り文字のみが許可されます。区切り文字または二重引用符を含めるには、それぞれの値を二重引用符で囲みます。
Encoding (required) (エンコーディング (必須)): CSV ファイルで使用するエンコーディングを選択します。デフォルトのエンコーディングは UFT-8 です。
連結子 (必須) - 複数の値を 1 つのアセット属性に結合する場合は、連結子を使用できます。デフォルトはダッシュ記号「-」です。 データがスペースで連結されている場合は「\s」を入力できます。
空の値 - オブジェクトが更新される際に、外部ソースからの空の値で既存の値を削除するかどうかを選択します。次の項目から選択します。
削除 - 現在の値を削除します。属性がステータス、選択、または複数の値を持つ参照タイプ属性である場合、すべての値が削除されます。
無視 - 該当するオブジェクト タイプに対して現在の値を保持します。属性がステータス、選択、または複数の値を持つ参照タイプ属性である場合、すべての値が保持されます。
Unknown values (required) (不明な値 (必須)): 空の値を無視するか追加するかを選択します。
日付形式 - 日付をアセットに変換する形式を選択します。何も指定されていない場合は、アセットが正しい形式を自動で検索します。
日時の形式 - 日時をアセットに変換するための日時形式。何も指定されていない場合は、アセットが正しい形式を自動で検索します。
[作成] を選択します。
これで、[インポート] タブに新しいインポート構造が入力されます。
自動マッピングと手動マッピングの概要
新しいインポート構造を作成する際は、オブジェクト タイプと属性を手動または自動で作成するオプションがあります。
オブジェクト タイプと属性を自動で作成することを選択した場合、アセットは、選択したインポートのタイプとインポートするデータの構造に基づいて既定の構造と構成を作成します。たとえば、CSV ファイルのデータを自動的にマッピングする場合、アセットは CSV ファイルの名前で新しいオブジェクト タイプを作成し、ファイルの各行に対して新しいオブジェクトを作成し、CSV のヘッダー行の値に基づいて各オブジェクトの属性を作成します。
インポートする CSV ファイルと同じ名前のオブジェクト タイプがオブジェクト スキーマにすでにある場合、アセットは新しいオブジェクト タイプを作成せず、既存のオブジェクトとその属性をデータ・ソースの同じオブジェクトで上書きします。
インポートを手動で作成する場合、インポート構造によってオブジェクト タイプや属性が自動的に作成されることはなく、データ ファイルのデータがインポートに自動的にマッピングされることもありません。インポート構造は「空」になり、インポートを実行する前に、インポート マッピング、オブジェクト マッピング、および属性マッピングを使用してデータをアセットにマッピングする必要があります。
お疲れ様でした!
ここでは、インポートとインポート構造の仕組みを学び、モデルになるデータ用、資産になるデータ用の 2 つのインポート構造を作成しました。
次に、ガイドの次のセクション「IT 資産管理 (ITAM) 用のオブジェクトと属性をマッピングする」に進みましょう。
この内容はお役に立ちましたか?
さらにヘルプが必要ですか?
アトラシアン コミュニティをご利用ください。