アセットにインポートするデータを準備する

Jira Service Management のアセットは、Premium と Enterprise のみの機能です。アセットの詳細についてご確認ください。

アセットにデータを理解させるには、いくつかの基本的な仕様に従う必要があります。これらの仕様はデータタイプごとに異なります。一部の属性タイプは、正しくインポートするために特定の書式が必要になる場合もあります。

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」を入力できます。
日付属性の正しい日付形式は MM/dd/yyyy です。MM は月、dd は日、yyyy は年を示します。ソースファイルが MM/dd/yyyy とは異なる形式を使用している場合、アセットで日付情報を正しく読み取れるように、インポート構造で日付形式を dd/MM/yyyy に明示的に設定して、日付形式を正しく変換する必要があります。
CSV ファイルからアセットにオブジェクトをインポートする場合は、名前やキーではなく、ラベルとして割り当てられた属性でオブジェクトを識別する必要があります。
Jira ユーザーまたはグループをアセットにインポートしている場合は、名前ではなく ID によってユーザーまたはグループを識別する必要があります。
アセットに URL をインポートする場合、URL を URL 属性タイプに変換するには、文頭に http:// または https:// がついている必要があります。http:// プレフィックスまたは https:// プレフィックスが含まれていない場合は、文字列属性タイプとしてインポートされます。属性タイプの詳細をご確認ください。
Google スプレッドシートのリンクから CSV データをインポートする場合に、使用する URL を正しく機能させるには編集が必要です。URL の末尾から /edit#gid=0 を削除して、/export?format=csv に置き換えます。

3 つのビジネスサービスに関する情報を含む CSV データのサンプルを次に示します。単一の属性に対する複数の値は、二重パイプ「||」文字の区切りによって含まれることにご注意ください。

"Name", "Owner", "Service Category", "Hosts"
"Confluence", "Ellen McDonald", "Finance", "Oracle-E-Business-Server"
"Email Service", "Bea Owenstein", "Infrastructure", "http://exchange.prod.main1"||"http://exchange_mssql_2012"
"Partner portal", "Les Weinen", "Infrastructure"||"Marketing", "http://mysql.prod.app7"

JSON ファイルのインポート

アセットにインポートされる JSON ファイルは、適切な形式のヘッダーがあり、JSON 標準に準拠している必要があります。
JSON インポートのセレクターは、[Attribute.*[Attribute] の形式である必要があります。JSON 配列のみがセレクターとして有効です。
JSON ファイルからアセットにオブジェクトをインポートする場合は、ラベルとして割り当てられた属性でオブジェクトを識別する必要があります。
Jira ユーザーまたはグループをアセットにインポートしている場合は、名前ではなく ID によってユーザーまたはグループを識別する必要があります。

3 つのホストを含む JSON 情報のサンプルを次に示します。属性「名前」がラベルとして選択されると 3 つのオブジェクト「exchange.prod.app7」、「exchange.prod.main」、「mail server」が作成されます。

{
  "Hosts": [
    {
      "Name": "exchange.prod.app7",
      "Status": "Running"
      "Environment": "Production",
      "Server Owner": "Bea Owenstein",
    },
    {
      "Name": "exchange.prod.main1",
      "Environment": "Production",
      "Server Owner": "Ginger Rogers",
    },
    {
      "Name": "Mail Server",
      "Environment": "Production",
      "Server Owner": "Bing Crosby",
    }
  ]
}

Asset Discovery ファイルのインポート

Asset Discovery は、エージェントの有無にかかわらず使用できるネットワークスキャンツールです。ローカルネットワークに接続しているハードウェアとソフトウェアを検出して、各アセットに関する詳細情報を抽出します。その後、このデータを Jira Service Management のアセットにインポートして、ローカルネットワーク内にあるすべてのデバイスと構成アイテムを管理できます。

Asset Discovery からデータをインポートする場合は、ZIP ファイルが正しい形式である必要があります。
「インポート設定の作成 - 一般フィールド」画面で日付パターンを指定する必要はありませんが、日付パターンを指定するとパフォーマンスが向上する場合があります。
- 日付パターンの例: dd/MM/yyyy
- 日付/時刻パターンの例: dd/MM/yyyy hh:mm

アセットにデータをインポートする方法

アセットにデータをインポートするには、次の 5 つのステップに従います。
1. データを準備します。
2. インポート構造を作成します。インポートには 4 つのタイプがあります。
  1. Discovery。Discovery のデータをアセットに取り込む方法の詳細をご確認ください。
  2. CSV。インポート用に CSV を設定する方法の詳細をご確認ください。
  3. JSON インポート。JSON ファイルからのデータのインポートに関する詳細をご確認ください。
  4. 外部インポート。アセットにデータをインポートするアプリの開発方法に関する詳細をご確認ください。
3. データをマッピングします。次の 2 つのオプションがあります。
  1. オブジェクトタイプと属性を自動で作成することで、データを自動でマッピングするか、
  2. 次の方法でデータを手動でマッピングします。
    1. オブジェクトタイプマッピングによってアセットオブジェクトタイプを作成する
    2. オブジェクトタイプ属性マッピングによってアセット属性と参照を作成する
    3. 子オブジェクトタイプマッピングによって階層的な親と子の構造を作成する。
4. オブジェクトタイプマッピングを作成したら、それらを有効にする必要があります。すべてのオブジェクトタイプマッピングが [有効化] に設定されるまで、インポート構造は実行されません。オブジェクトタイプマッピングが有効にされていない場合は、オブジェクトタイプマッピングを右クリックして [有効化] をクリックして有効にします。
5. インポートを実行します。

この内容はお役に立ちましたか?

正確ではなかった

明確ではなかった

関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問