統合とマイクロアプリのエクスポートとインポート

次の手順を完了することで、統合とマイクロアプリのエクスポートとインポートが可能です。インポートおよびエクスポートする際、統合(マイクロアプリなし)およびマイクロアプリは一度につき1つずつしか実行できません。

新しい環境でマイクロアプリと全体の統合を更新するには、次の手順に従います:

  1. ソースの統合の構成をエクスポートします(ターゲットの統合に変更が加えられた場合にのみ必要)。
  2. ソースのマイクロアプリをエクスポートします。
  3. ソースの統合の構成を新しい統合としてターゲット環境へインポートします。
  4. 新しい統合にソースのマイクロアプリをインポートします。
  5. 新しい統合に欠落している資格情報を追加します。
  6. 新しいマイクロアプリに利用者を追加します。
  7. ターゲット環境上の元の統合を削除します。

統合の構成またはマイクロアプリの更新による既知の影響

エクスポート/インポートワークフローを完了する前に以下の問題を考慮してください:

  • 元のマイクロアプリを削除した際、既に生成されているフィードカードが削除される。
  • 新しいフィードカードとプッシュ通知が生成されると、新しい統合の完全同期が開始する。
  • ユーザーがよく使うアクションは、新しくインポートされたマイクロアプリが新しいものとして動作するため削除される。

統合が変更されていない新しいマイクロアプリバージョンをインポートします

  1. ソースのマイクロアプリをエクスポートします。
  2. 新しい統合にソースのマイクロアプリをインポートします。
  3. 新しいマイクロアプリに利用者を追加します。
  4. ターゲット環境上の元のマイクロアプリを削除します。

統合のエクスポート

  1. コンテキストメニューのオプションである [統合構成のエクスポート] を使用して、マイクロアプリ管理のマイクロアプリ一覧で統合構成をエクスポートします。

    統合のための統合構成ファイルは、ローカルマシンに.mappファイル形式でエクスポートされます。

    構成ファイルには次のエンティティが含まれています:

    • 構成(パスワードとクライアントシークレットなし)
    • 同期のセットアップ
    • Virtual Assistantリゾルバー
    • HTTP統合の場合:
      • データエンドポイント(チェーン化した子エンドポイントを含む)
      • 関係
      • サービスアクション
    • マイクロアプリはエクスポートされません。

統合のインポート

  1. [統合構成のインポート] オプションを使用して統合構成をインポートします。
  2. インポートの制限
    1. 統合はクライアントシークレットなしでエクスポートされるため、インポート後にクライアントシークレットを補う必要があります。これを行わないと、統合が適切に動作しません(キャッシングも操作も不可能)。
  3. インポート後の統合の状態
    1. ステータス[パスワードが必要]:
      1. 資格証明書を手動で入力するまで同期は起こりません。
      2. OAuthが認証方法に設定されている場合、OAuthの再認証が必要です。SORから更新されたトークンを取得するには、再認証が必要です。
      3. 資格証明書に入力するには、[管理]>[統合コンテキストメニュー]>[編集]>[プロパティ] へ移動し、欠落しているパスワード、シークレット、または再認証OAuthを入力します。
    2. マイクロアプリはありません(統合のみがインポートされます)。

マイクロアプリのエクスポート

  1. マイクロアプリ管理のマイクロアプリ一覧で、マイクロアプリにコンテキストメニューオプション [マイクロアプリのエクスポート] を使用してマイクロアプリをエクスポートします。
  2. マイクロアプリ定義を含む.mappファイルがダウンロードされます。
  3. エクスポートされる内容
    • マイクロアプリを定義する、以下を含む.mappファイル:
      • プロパティ(マイクロアプリ名、説明、アイコン、操作、操作ページ)。
      • 通知(トリガー、条件、通知内容、有効期限条件)。
      • ページ(名前、プロパティ、呼び出された操作などプロパティを含むすべてのコンポーネント)。
      • マイクロアプリ統合の識別(統合データキャッシュ層へのマイクロアプリコンポーネントのマッピング構造は、新たな統合に適切にマップする必要があります)。
    • 利用者の設定はエクスポートされません。

マイクロアプリのインポート

  1. 前提条件:統合がターゲット環境にインポートされているか、または統合がターゲット環境に存在する。
  2. マイクロアプリ管理のマイクロアプリ一覧で、統合にコンテキストメニューオプション [マイクロアプリのインポート] を使用してマイクロアプリをインポートします。
    1. ファイルをブレードにドラッグするか、ファイルシステムからファイルを選択してアップロードします。
  3. インポートの制限:
    1. マイクロアプリは、同じ統合にインポートする必要があります。
      1. 同じ統合タイプ(すぐに利用できる統合(ServiceNow、Concurなど)またはカスタムHTTP統合)。
        1. 基礎となるデータ構造がソースおよびターゲットの統合と同じであっても、マイクロアプリインポートによってマイクロアプリデータ構造と、異なるタイプの統合を一致させることはできません。
      2. データベース構造のマッチング - スキーマが異なるターゲット統合で、キャッシュされたテーブルが一部欠落している場合は、設定ミスとしてマイクロアプリがインポートされます。
        1. 構成ミスを防ぐために、ソースとターゲットの統合のスキーマは同じ統合コンテキストメニュー [編集]>[テーブル]>[スキーマを編集] を移動するようにしてください。
    2. マイクロアプリは、単一の統合の上に構築されなければなりません。
      1. マイクロアプリは、それが基づいている統合とは異なる統合から(ボタン操作スタック上の)操作を呼び出すことはできません。
      2. マイクロアプリは通知からもページボタンからも、ボタン操作スタックの[ページに移動]操作として、異なる統合からページへ移動することはできません。
      3. マイクロアプリは異なる統合から、テーブルの上にページまたは通知を構築することはできません(ページを作成する際、同じ統合のテーブルはインポートできるように使用されなければなりません)。

インポート後のマイクロアプリの状態

  • マイクロアプリには利用者は含まれません。利用者は手動で再作成する必要があります。
  • 通知は生成されません:通知は、通知トリガーの優先度に基づいて自動的に生成されます(通常は次の同期の後)。

マイクロアプリの新しいバージョンのインポート

マイクロアプリのオプション(省略記号)メニューから、マイクロアプリを新しいバージョンに更新できます。

  1. [マイクロアプリ統合]画面で、目的のマイクロアプリにある [新しいバージョンのインポート] を選択します。
  2. 新しいマイクロアプリをドラッグして、[インポート]を選択します。

    (オプション)古いバージョンのマイクロアプリをシステムから完全に削除する場合は、[既存のフィードカードの削除]を選択します。このオプションを選択しない場合、古いマイクロアプリはシステムに残り、終了(End-of-Life:EOL)フラグが付けられます。新しいバージョンがアクティブなマイクロアプリとして設定されます。作成したフィードカードを正しく機能させるために、古いマイクロアプリを削除しないことをお勧めします。

  3. [インポート] をクリックすると、新しいマイクロアプリがインポートされます。