オブジェクト スキーマのインポート

オブジェクト タイプ、属性、オブジェクトなどの構造化データをアセット オブジェクト スキーマからインポートできます。同じサーバー上の別のスキーマや、まったく別のサーバー上のオブジェクト スキーマからデータをインポートすることもできますインポートの詳細をご確認ください。

次のようなユース ケースがあり得ます。

  • それぞれ異なるオブジェクト スキーマを実行している 2 つの異なるサーバーを同期する。

  • オブジェクト スキーマの完全なデータのサブセットを含むステージング インスタンスを作成する。

  • master サーバーと完全なデータのサブセットを含む一連の子サーバー間でデータを同期する。

インポートを作成、設定、有効化するには、ユーザーがオブジェクト スキーマのアセット マネージャーである必要があります。

次のセクションにジャンプ:

はじめる前に

オブジェクト スキーマをインポートするには、以下のことについても把握しておく必要があります。

  • このインポート タイプには、スキーマの自動化ルール、ロール、インポート設定、オブジェクト履歴、オブジェクト コメント、レポート、オブジェクトと課題の関係は含まれません。

  • 同期する 2 つのサーバーに同じ名前のオブジェクトが含まれている可能性があるため、オブジェクトの競合を防ぐために、別のサーバーからインポートされたすべてのオブジェクトには、属性として外部ハッシュ キーが割り当てられます。このハッシュ キーは、作成時に URL、スキーマ ID、オブジェクト キーが追加されて、より長い一意のハッシュとなります。

オブジェクト スキーマのインポート

別のインスタンスまたは同じインスタンスからアセットを取得するように新しいオブジェクト スキーマのインポートを設定すると、インポート プロセスによって定期的に同期されてデータが最新の状態に保たれます。アセットではすべてのオブジェクト タイプがコピーされ、マッピングが自動的に作成されます。

インポート構造を作成するには、次の手順に従います。
  1. サービス プロジェクトから、[アセット] > [オブジェクト スキーマ] の順に移動します。

  2. [オブジェクト スキーマ] リストから [ その他のアクション] > [構成] の順に選択します。
    オブジェクト スキーマ ウィンドウを構成する

  3. スキーマ構成ビューで [インポート] タブを開きます。

  4. [インポート] タブで、次の手順に従います。

    • インポート構造がない場合は、「インポート接続はまだありません」というメッセージが表示されます。新しいインポート構造を作成するには、[インポート設定を作成] を選択します。

    • インポート構造が作成済みである場合は、[設定を作成] を選択します。
      インポート構成ウィンドウを作成する

  5. [CSV インポート] > [次へ] の順に選択します。

  6. [一般]、[モジュール]、[スケジュール] の各インポート フィールドに入力します。
    インポート構成の一般的なフィールド

一般フィールド

次は、すべてのインポート タイプに共通する一般的なフィールドです。

名前

説明

名前インポートの名前。
説明 参考用の説明。
連結子

既定の連結子を指定できます。複数のデータ ロケーターを結合して 1 つのアセット属性を作成すると、これが既定の連結子となります。たとえば、"姓" と "名" のような 2 つの列を 1 つの属性に結合できます。つまり、"Mathias" (名) と "Edblom" (姓) は、連結子である \s によって "Mathias Edblom" として連結されます。

スペースの連結には \s を入力します。連結文字を含めるには、その値を二重引用符で囲みます ("\s")。

空の値

データ ロケーターが空である場合の処理は、次のように定義されます。

  • 無視 - オブジェクト内の既存の値は保持され、空の値で上書きされません。

  • 削除 - オブジェクトの既存の値が削除され、空のフィールド値に置き換えられます。

データ ロケーターが不明である場合の処理を定義しましょう。これは、"ステータス" や "選択" などの属性タイプで発生する可能性があります。 

  • 無視 - CSV の値は無視され、オブジェクト属性は空のままになります。

  • 追加 - CSV ファイルで渡された値がリストに追加され、オブジェクト属性が新しい値で更新されます。

インポート ソースの日付フィールドを Insight の日付に変換する際の形式。空のままにすると、Insight で正しい形式が自動で検索されます。
この形式は、Java の SimpleDateFormat のガイドラインに従って指定する必要があります。

インポート ソースの日付/時刻フィールドを Insight の日付に変換する際の形式。空のままにすると、Assets で正しい形式が自動で検索されます。
この形式は、Java の SimpleDateFormat のガイドラインに従って指定する必要があります。

モジュール フィールド

これらのフィールドはインポート タイプ (モジュール) に固有です。

設定

説明

URL

アセットで Jira を実行しているサーバーの URL。

ユーザ名他のサーバーとの認証用ユーザー名。
パスワード

他のサーバーとの認証用パスワード。

objectSchemaターゲット サーバーの名前またはオブジェクト スキーマ ID

スケジュール フィールド

スケジュール フィールドは、データの同期を維持するために使用されます。

名前説明
同期アカウント

データをアセットに同期する際に使用する Jira ユーザー。

LDAP およびデータベースのインポートでは、同期に使用するアカウントに Jira 管理者権限が必要です。

cron 式The interval for the automatic synchronization. Explore cron expressions
自動同期インポートを自動で同期するようにスケジュールするかどうか。

7. [インポート設定を保存] を選択します。

次に、インポート用の定義済みの構造と設定を作成できます。

事前定義済みの構造と設定

次のステップでは、定義済みの構造と構成を手動で作成することも、アセットで自動的に作成することもできます。このプロセスを自動化するには、以下を選択してください。
  • 定義済みの構造を作成する – これにより、スキーマに属性と関係を持つオブジェクト タイプが作成されます。

  • 定義済みの構成を作成する – これにより、インポート構成にタイプ マッピングが作成されます。

定義済みの構造と構成を作成する

さらに、オブジェクト スキーマのインポートの場合、事前定義済みの構造と設定は、ターゲット アセット オブジェクト スキーマの既存の設定に基づきます。初期設定では、一部のオブジェクト タイプ マッピングが無効になっている可能性があります。すべてのオブジェクト タイプ マッピングが有効になっていることを確認してください。

作成されたインポート設定

これでインポート設定を表示できるようになりましたが、まだ準備が完了していません。さらに、ソースとアセット間でオブジェクト参照または属性をマッピングする必要があります。

準備できたら「2. オブジェクト タイプと属性マッピングを作成する」に進みます。

最後に一言

オブジェクト タイプ マッピング

次のステップでは、オブジェクト マッピングの設定を作成します。オブジェクト スキーマのインポート タイプに固有の設定をいくつか紹介します。

名前

説明

セレクター

データ ロケーターは、オブジェクト タイプ マップのセレクターを指定した場合にのみ使用できます。セレクターは <objectTypeName>;<objectTypeSourceId> です。

たとえば、<objectTypeName> が「サーバー」で <objectTypeSourceId> が「205」の場合、セレクターは Server;205 になります。

最終更新日: 2024 年 12 月 30 日

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

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.