API プロジェクトへのファイルのインポート

API 仕様と RAML フラグメントをプロジェクトにインポートできます。インポート元の場所として、自分のコンピュータ、URL、Anypoint Exchange の 3 つがあります。

インポートする API 仕様は、RAML 0.8、RAML 1.0、または OpenAPI Specification (OAS) 2.0 で記述できます。

1 つの API 仕様プロジェクトに複数の API 仕様を含めることができます。機能が関連した複数の仕様であれば 1 つのプロジェクトで管理することが望ましい場合もあります。プロジェクトを Exchange にパブリッシュする際には、仕様のいずれか 1 つをメイン仕様として選択します。

インポートするフラグメントは、RAML 0.8 または RAML 1.0 で記述できます。アノテーション種別、データ型、JSON 応答ペイロードの例、ライブラリ、リソース種別、セキュリティスキーマ、および特性をインポートできます。

手順

  • コードエディタのみ: コンピュータに保存されているファイルまたは .zip ファイルのコンテンツをインポートする手順は、次のとおりです。

    1. エディタの左側のペインで、[Files (ファイル)] の隣にあるドットをクリックして、[Import (インポート)] を選択します。

    2. [Import (インポート)] ダイアログで、[File or Zip (ファイルまたは Zip)] を選択します。

    結果: エディタの左側のペインにファイルのリストが表示されます。インポートした .zip ファイルに、フォルダ構造内のファイルが含まれる場合、ペインにそのフォルダ構造が表されます。

  • コードエディタのみ: URL を介して使用可能なファイルをインポートする手順は、次のとおりです。

    1. エディタの左側のペインで、[Files (ファイル)] の隣にあるドットをクリックして、[Import (インポート)] を選択します。

    2. [インポート] ダイアログで、[URL] を選択します。

      • URL を指定してオンラインで提供されているファイルをインポートする場合は、ファイルに !include ステートメント (RAML) または $ref ステートメント (OAS) が含まれていないように注意してください。エディタは、URL の場所にあるファイルのみをインポートします。

    結果: エディタの左側のペインにファイルが表示されます。

  • API 仕様または API フラグメントをその連動関係と共に Exchange からインポートする手順は、次のとおりです。

    1. 次のいずれかの方法を使用して、[Import Asset from Exchange (Exchange からアセットをインポート)] ダイアログを開きます。

      • コードエディタのみ: API Designer でプロジェクトと共に作成されたデフォルトファイルのみがプロジェクトに含まれる場合、[Files (ファイル)] ペインに表示されているリンクテキストをクリックします。

      • コードエディタのみ: 自分が作成した 1 つ以上のファイルがプロジェクトに含まれる場合、左側のペインの上部にある 3 つのドットのアイコンをクリックして、[Import from Exchange (Exchange からインポート)] を選択します。

      • ビジュアルエディタのみ: プロジェクトにリソースやデータ型がまだ含まれていない場合、[New API (新しい API)] ペインに表示されているリンクテキストをクリックします。

    2. ダイアログの左上隅にあるドロップダウンメニューで、アセットを所有するビジネスグループを選択します。

    3. 次の列を持つテーブルに表示されているいずれかのアセットを選択します。

      Name (名前)

      API 仕様または RAML フラグメントの名前。

      Version (バージョン)

      仕様またはフラグメントのバージョン。ダイアログの左下隅にある [Include snapshots (スナップショットを含める)] チェックボックスをオンにすると、この列にスナップショットが含まれます。

      Type (種別)

      アセットの種別。値は [API Specification (API 仕様)] または [RAML Fragment (RAML フラグメント)] のいずれかです。

      Language (言語) (コードエディタにインポートされる API 仕様の言語)

      言語は RAML または OAS のいずれかです。デフォルトで表示される値は、仕様の記述に使用された言語です。デフォルト以外の値は、仕様がパブリッシュされたときに Exchange でコピーを作成するために使用された言語です。

      コピーをインポートする必要がある場合、インポート後にコピー内のエラーの修正が必要になることがあります。Exchange でコピーを作成するために使用されるプロセス (RAML から OAS またはその逆への変換) で、エラーのない仕様が作成される保証はありません。

      Language (言語) (ビジュアルエディタにインポートされる API 仕様の言語)

      言語は常に RAML です。API Designer では、仕様の RAML バージョンがインポートされ、RAML バージョンが [RAML] ペインに、OAS バージョンが [OAS] ペインに表示されます。

      Language (言語) (RAML フラグメントの言語)

      OAS ではフラグメントが使用されないため、言語は常に RAML です。

      Date modified (変更日)

      現在選択されているアセットの現在選択されているバージョンがパブリッシュされた日付。

      Created by (作成者)

      現在選択されているアセットの現在選択されているバージョンをパブリッシュしたユーザのユーザ ID。

    4. [Import Asset (アセットをインポート)] をクリックします。

    結果: エディタの左側のペインにファイルのリストが表示されます。

Was this article helpful?

💙 Thanks for your feedback!

Edit on GitHub