Flex Gateway新着情報
Governance新着情報
Monitoring API Managerテキストエディターで作成する API 仕様プロジェクトや API フラグメントプロジェクトでは、1 つのファイルが常に「ルートファイル」として指定されます。 [Files (ファイル)] ペインでは、ルートファイルが [Root file (ルートファイル)] という表示ラベルが付けられた長方形で示されます。プロジェクトを Anypoint Exchange にパブリッシュすると、ルートファイルにより、プロジェクトのファイルを検証するパーサーのコンテキストが設定されます。
たとえば、RAML API 仕様プロジェクトに 2 つの仕様が含まれていて、それぞれの仕様では !include
キーワードを使用して、異なる API フラグメントセットが設定されているとします。これは、プロジェクトにもあります。プロジェクトを Exchange にパブリッシュすると、プロジェクトのすべてのファイルがパブリッシュされます。ただし、Exchange はプロジェクトに含まれる仕様とファイルを検証する必要があります。ルートファイルがないと、Exchange は最初に解析するファイルや解析対象のファイルセットを確認できません。
別の例として、複数のフラグメントが含まれる API フラグメントプロジェクトをパブリッシュするとします。1 つは独立しており、フラグメントの残りのファイルはライブラリフラグメントとその連動関係です。プロジェクトでルートファイルが指定されていない場合、Exchange はファイルを適切に解析できません。この場合、独立したフラグメントをルートファイルとして設定し、そのファイルが単独で解析可能であることを Exchange に示すことができます。または、ライブラリファイルをルートファイルとして設定し、そのファイルから解析を開始して、独立したフラグメントに進む必要があることを Exchange に示すことができます。
API Designer の 2020 年 2 月 8 日リリースの前の作成されたプロジェクトをテキストエディターで初めて開く場合、ルートファイルを設定するように求められます。 |
すべての API 仕様プロジェクトは、デフォルトルートファイルを使用して作成されます。プロジェクトに複数の仕様がある場合、ルートファイルを切り替えることができます。
API 仕様プロジェクトを作成すると、デフォルトで作成されるファイルがルートファイルとして設定されます。
1 | RAML API 仕様プロジェクトの名前は Orders API です。 |
2 | このデフォルトファイルは orders-api.raml という名前で、ルートファイルとして設定されています (すべての API 仕様プロジェクトにはルートファイルが必要であるため)。 |
仕様をプロジェクトにインポートすると、API Designer から、その仕様をプロジェクトのルートファイルとして設定するかどうかを尋ねられます。
API 仕様プロジェクトの任意の仕様をそのプロジェクトのルートファイルとして設定できます。たとえば、次の画像は 2 つの仕様が含まれているプロジェクトを示しています。
1 | OAS バージョンのインベントリプロセス API 仕様。 |
2 | RAML バージョンのインベントリプロセス API 仕様。このバージョンの仕様が現在ルートファイルとして設定されます。 |
現在ルートファイルでない仕様の右側にある 3 つのドットをクリックすると、その仕様をルートファイルとして設定するオプションが含まれるメニューが表示されます。
オプション。]
1 | クリックするとファイルのアクションメニューが開く 3 つのドット。 |
2 | アクションメニューの上部にある [Set as root file (ルートファイルとして設定)] オプション。 |
すべての API フラグメントプロジェクトは、デフォルトルートファイルを使用して作成されます。プロジェクトに複数のフラグメントがある場合、ルートファイルを切り替えることができます。
API フラグメントプロジェクトを作成すると、デフォルトで作成されるファイルがルートファイルとして設定されます。
1 | RAML API フラグメントプロジェクトの名前は Retail Common です。 |
2 | このデフォルトファイルは retail-common.raml という名前で、ルートファイルとして設定されています (すべての API フラグメントプロジェクトにはルートファイルが必要であるため)。 |
フラグメントを API フラグメントプロジェクトにインポートすると、API Designer から、そのフラグメントをプロジェクトのルートファイルとして設定するかどうかを尋ねられます。
API フラグメントプロジェクトの任意のフラグメントをそのプロジェクトのルートファイルとして設定できます。たとえば、次の画像は 2 つのフラグメントが含まれていて、最初のフラグメントがルートファイルとして設定されているプロジェクトを示しています。
1 | ルートファイルとして設定されているフラグメント。 |
2 | もう一方のフラグメント。 |
現在ルートファイルでないフラグメントの右側にある 3 つのドットをクリックすると、そのフラグメントをルートファイルとして設定するオプションが含まれるメニューが表示されます。
オプション。]
1 | クリックするとファイルのアクションメニューが開く 3 つのドット。 |
2 | アクションメニューの上部にある [Set as root file (ルートファイルとして設定)] オプション。 |