パッケージをインポートする

パッケージ全体、または選択された項目を TotalAgility にインポートできます。項目名、アーティファクト、バージョン、最終更新日といった項目の詳細も表示されます。

zip 形式と xpdl 形式のファイルがサポートされています。Internet Explorer 9 を使用して非常に大きなプロジェクトをインポートすることはできません。Internet Explorer 10 以降を使用して大きなプロジェクトをインポートする場合は、パフォーマンスを向上させるためにブラウザで新しいウィンドウが開きます。

パッケージの自動インポートの推奨アプローチについては、Kofax TotalAgility Best Practices Guide (TotalAgility ベスト プラクティス ガイド) のパッケージの自動エクスポートおよび自動インポートを参照してください。

パッケージ内のすべての項目をインポートするか、パッケージから選択した項目をインポートするか、パッケージ内の各グループ (アーティファクト) から個々の項目をインポートできます。パッケージ内の項目は、次のグループに属します。

  • [すべて]

  • [キャプチャ]

  • [デバイス]

  • [エクスポート コネクタ]

  • [結合]

  • [モニタリング]

  • [パッケージ]

  • [クエリ]

  • [リソース]

  • [システム]

  • [システム データ]

  • [ユーザー インターフェイス]

  • [ワークフロー]

さらに、選択した展開構成に基づいて項目を含めることができます。インポート中には、選択した展開タイプに基づいて項目の値を上書きできます。

  • パッケージのインポート時に展開が選択されていない場合、パッケージで定義された展開が行われますが、グローバル変数、サーバー変数、Web サービス、デバイス設定、エクスポート コネクタ設定の値は上書きされません。

  • 選択された項目のインポート時に展開が選択されていない場合、項目の基本値がインポートされます。

  • パッケージのインポート時に展開が選択された場合、定義された展開がすべて行われ、選択された展開タイプの値が上書きされます。

    展開タイプを選択してパッケージをインポートする場合、既存の Transformation 設定の値は上書きされず、追加の Transformation 設定だけがアーティファクト リストに追加されます。

  • 選択した項目をインポートするときに展開を選択した場合、選択された項目の値だけが、選択した展開タイプの値で上書きされます。Transformation 設定の値は上書きされません。

  1. [インポート] に移動します。
  2. [参照] をクリックしてインポートするパッケージの zip ファイルを選択するか、zip ファイルを [インポートするファイル] フィールドにドラッグします。

    選択したパッケージのアーティファクトがすべて表示されます。デフォルトでは、パッケージ内のグループに関係なく、グローバル変数、サーバー変数、Web サービス レファレンス、カスタム サービス、カスタム サービス グループ、カテゴリ、フィールド バリデータ、デバイス設定、エクスポート コネクタのマッピングを含むすべての項目が選択されます。ただし、各項目のチェック ボックスをオフにすることで、インポートする項目を含めるか除外するかを選択できます。リストをさらにフィルタリングして、特定のグループの項目を表示できます。たとえば、あるプロセスの項目だけを表示するには、[アーティファクト] リストで [プロセス] を選択します。

  3. [フォーム インポート オプション] グループで、次のインポート オプションを含めるか除外します (デフォルト: クリア)。

    • [セキュリティ トークン]

    • [セキュリティ ロール]

    • [セキュリティ ロール メンバー]

  4. 個々の項目 (ロール メンバー、サーバー変数、グローバル変数、Web サービス レファレンス、デバイス、デバイス プロファイル、デバイス設定) の値を上書きするか、全項目の値を上書きするかを選択できます。個々の項目の値を上書きするには、ステップ 5、6、7、8 を参照してください。全項目の値を一度に上書きするには、次の手順を実行します。
    1. [上書きオプション] グループで、[すべて上書き] を選択します。(デフォルト: クリア)

      自動的に、全項目が選択されます。

    2. アーティファクト テーブルの [アクション] 列で、各項目の [更新] をクリックし、必要に応じて[値]を変更し、[更新] をクリックします。

      パッケージに展開構成を追加するときに定義された項目の値が上書きされます。

  5. 既存のターゲット システム上のグローバル変数またはサーバー変数の値を上書きするには、次の手順を実行します。
    1. [上書きオプション] グループで、[グローバル変数] または [サーバー変数] を選択します。(デフォルト: クリア)
    2. アーティファクト テーブルの [アクション] 列で、その変数の [更新] をクリックし、必要に応じて [値] の内容を変更して [更新] をクリックします。
      複合変数と XML 式の変数は更新できません。グローバル変数やサーバー変数がターゲット システムに存在しない場合、変数の上書き設定に関係なく、指定された値で変数がシステムに追加されます。
  6. 既存のターゲット システム上の Web サービス レファレンスの値を上書きするには、次の手順を実行します。
    1. [上書きオプション] グループで、[Web サービス レファレンス] を選択します。(デフォルト: クリア)
    2. アーティファクト テーブルの [アクション] 列で、[更新] をクリックします。
    3. 必要に応じて [URL][エンドポイント URL] 、および [ユーザー資格情報] ([ユーザー名][パスワード]) の値を変更し、[更新] をクリックします。
      Web サービス レファレンスがターゲット システムに存在しない場合、Web サービス レファレンスの上書き設定に関係なく、指定された値で Web サービス レファレンスがシステムに追加されます。
  7. ターゲット システムのデバイス設定の値を上書きするには、[上書きオプション] グループで、次の手順を実行します。
    1. すべてのデバイスのデータを上書きしてインポートするには、[デバイス] を選択します。(デフォルト: クリア。この状態では、ターゲット システムに存在しないデバイスだけがインポートされます。)
    2. すべてのデバイスのプロファイル データを上書きしてインポートするには、[デバイス プロファイル] を選択します。(デフォルト: クリア。この状態では、ターゲット システムに存在しないデバイス プロファイルだけがインポートされます。)
    3. すべてのデバイスの設定を上書きしてインポートするには、[デバイス設定] を選択します。(デフォルト: クリア。この状態では、ターゲット システムに存在しないカスタムの詳細設定だけがインポートされます。)
    4. アーティファクト テーブルの [アクション] 列で、変更する設定の [更新] をクリックします。
    5. 設定が上書きされるように、[オーバーライド可能] チェック ボックスが選択されていることを確認します。
    6. [値] の内容を変更して、[更新] をクリックします。

      webdav.trust.all.certificates などのデバイス設定の場合、証明書をアップロードできます。

    7. 必要に応じて、他のデバイス設定の値を更新します。

    パッケージに展開構成を追加するときに定義されたデバイス設定の値が上書きされます。

    デバイス設定がターゲット システムに存在しない場合、上書き設定に関係なく、指定された値でデバイス設定がシステムに追加されます。

  8. エクスポート コネクタ設定の値を上書きするには、[キャプチャ] グループで、次の手順を実行します。
    1. [コネクタ マッピング] を選択します。(デフォルト: クリア)
    2. アーティファクト テーブルの [アクション] 列で、更新するコネクタ マッピングの [更新] をクリックします。
    3. 必要に応じて [値] の内容を変更します。
    4. [上書き] チェック ボックスを選択します。
    5. 同一のコネクタ タイプとプロパティを持つ設定のすべてのインスタンスを同じ値で更新するには、[すべてのインスタンスの '{0}' 値を同じ値で更新する] チェック ボックスをオンにします。
    6. [更新] をクリックします。
    7. 必要に応じて、他のコネクタ マッピングの値を更新します。

    パッケージに展開構成を追加するときに定義されたエクスポート コネクタ設定の値が上書きされます。

  9. [バージョン管理されていない項目] グループで、[上書き] を選択して (デフォルト: いいえ)、ターゲット システムに存在するバージョン管理されていない項目をパッケージに含まれる項目で上書きします。バージョン管理されておらず、上書きできる項目には次のものがあります。チェックリスト、ルックアップ、スキャン/VRS プロファイル、PDF プロファイル、分割プロファイル、メモ タイプ、ホットキー、作業タイプ、作業割り当てルール、イベント、ターゲット、アラート、テーマ、ナビゲーション、サイト、その他のファイル、ドキュメント テンプレート、.Net 参照、スタイルシート、イメージ、カスタム ページ、ローカリゼーション文字列、ジョブ クエリ、作業キュー クエリ、システム クエリ、ペルソナ、ページ レンディション、ノードの色、フォーマッタ、レポート タグ。

    バージョン管理されていない項目を上書きするよう選択した場合、既存のレンディション設定は、パッケージに含まれている設定によって上書きされます。たとえば、ターゲット マシンにレンディション 1 とレンディション 2 があり、パッケージにレンディション A とレンディション B がある場合、レンディション A とレンディション B がターゲット マシンに保持されます。それ以外の場合は、レンディション 1 とレンディション 2 がターゲット マシンに保持されます。

  10. 次のいずれかのオプションを選択します。
    1. パッケージ全体をインポートするには、[インポート] をクリックします。

      インポートのサマリーが表示されます。エラー メッセージや警告メッセージがある場合は、あわせて表示されます。

    2. 選択した項目をパッケージからインポートするには、次のいずれかを実行します。
    • [すべて] の項目のリストで、除外する項目のチェック ボックスのチェックを選択解除し、[選択した項目をインポート] をクリックします。

    • 特定のグループから選択した項目をインポートするには、[アーティファクト] リストで、プロセスなどのアーティファクトを選択し、除外する項目のチェック ボックスを選択解除して、[選択した項目をインポート] をクリックします。

      インポートのサマリーが表示されます。エラー メッセージや警告メッセージがある場合は、あわせて表示されます。

    • パッケージ全体がインポートされるのは、そのパッケージのバージョンがターゲット システムに存在するパッケージのバージョンより大きい場合のみです。

    • パッケージから選択項目をインポートするときに、そのパッケージにサブ パッケージが含まれている場合、メイン パッケージとサブ パッケージで選択された項目のみがインポートされます。

    • パッケージをインポートするときに、プロセス バージョンがターゲット システムに存在するバージョンと同じ場合、パッケージはインポートされません。たとえば、パッケージ内のバージョン 3 のプロセスがターゲット システムにすでに存在する場合、インポートされません。

    • パッケージ全体をインポートするよう選択した場合、インポートから一部の項目を除外するよう選択しても、パッケージ内のすべての項目がインポートされます。

    • パッケージをインポートするときに、パッケージに含まれているフォームとプロセスがカスタム サービスを使用している場合、パッケージの一部としてサービスも自動的にインポートされます。

    • カスタム サービス グループを含んだパッケージをインポートすると、グループに関連付けられた項目、つまり、カテゴリ、カスタム サービス、サーバー変数、および Web サービス レファレンスもインポートされます。
    • リソース拡張はシステム設定に保存されます。ターゲット システムにすでにリソース拡張が存在する場合は、インポートされたリソース拡張が追加されます。

    • パッケージにリソース グループ メンバーが含まれている場合、ターゲット システムに存在しないリソースのみがインポートされます。

    • パッケージにホットキーが含まれている場合、ランタイムでホットキーが機能するように IIS アプリケーション プールを再起動する必要があります。