新しく作成されたスプリントブランチには、デフォルトでは何も含まれていません。このアプローチにより、開発者は現在のスプリントで必要な変更に集中できます。スプリントブランチ内でリソースを追加し、変更を加える主な方法は2つあります。手動変更: Apidogでリソースを手動でインポートまたは作成し、必要な変更を加えることができます。この方法は、APIファースト開発アプローチを採用しているチームに最適で、Apidogはその効果を高く評価しています。
OASインポート: 代わりに、OpenAPI仕様（OAS）をスプリントブランチに直接インポートすることもできます。インポートプロセス中、ApidogはOASの内容をメインブランチのAPIと自動的に比較し、関連するリソースや新しいリソースを生成します。また、変更されたOASを同じスプリントブランチに複数回インポートして、内容を更新することもできます。この方法は、コードファースト開発アプローチを好むチームに最適です。
手動変更#
スプリントブランチ内で手動で内容を変更することを強く推奨します。この方法では、リソースを手動で選択または作成することで、開発に着手する前にAPI仕様を明確に定義でき、効率が向上し、コラボレーションコストが削減されます。メインブランチからリソースをフォークする#
現在のスプリン トの要件に基づいて既存のAPI、スキーマ、またはレスポンスコンポーネントを変更およびアップグレードする必要がある場合、Fork from mainを使用して、必要なリソースのコピーを現在のスプリントブランチに作成します。リソースをインポートすると、その親フォルダも自動的に現在のスプリントブランチのフォルダにインポートされ、正確なフォルダ階層が保証されます。メインブランチからインポートされたリソースは、フォルダ内で関連付けを示す表示がされます。現在、APIケースはデフォルトでAPIと一緒にスプリントブランチにインポートされます。同様に、インポートされたAPIケースもフォルダ内で関連付けを示す表示がされます。メインブランチから最新の変更をプルする#
スプリントブランチで作業中に、緊急のリクエストによりライブAPIを即座に更新する必要が生じることがあります。その場合、メインブランチで直接変更を行う必要があるかもしれません。これにより、更新されたメインブランチとスプリントブランチの間に不一致が生じる可能性があります。これを解決するために 、メインブランチから最新の変更をスプリントブランチにプルして同期することができます。スプリントブランチに関連付けられたメインブランチのリソースが更新された場合、スプリントブランチでそれらのリソースにアクセスすると明確な通知が表示されます。通知をクリックすると、変更を確認し、メインブランチから更新をプルするか、現在のスプリントブランチを保持するかを選択できます。確認後、必要な内容を選択し、更新を確定します。このプロセスにより、スプリントブランチが適切に更新され、メインブランチの更新による競合が解決されます。新しいリソースを作成する#
現在のスプリントのビジネス要件を満たすために新しいAPI、スキーマ、またはレスポンスコンポーネントを作成する必要がある場合、New機能を使用してこれらの新しいリソースを現在のスプリントブランチに追加します。スプリントブランチでの作成機能は、メインブランチと同じように機能します。スプリントブランチ内の任意のフォルダにリソースを作成できます。新しいリソースに必要な親フォルダがスプリントブランチに存在しない場合は、Select Endpoint FoldersまたはNew Endpoint Folder機能を使用して必要な親フォルダを作成してから、必要なリソースを作成できます。Select Endpoint Folders: 
New Endpoint Folder: 
フォルダ内容の並べ替えと調整#
スプリント中に、現在の要件を満たすためにリソースの順序を変更したり、既存または新しいフォルダの内容を変更したりする必要があるかもしれません。スプリントブランチでは、インポートまたは新しく作成されたリソースに対して、メインブランチと同じ操作を実行できます。これには、APIの順序変更や親フォルダ設定の変更が含まれます。フォルダツリー内の項目をドラッグしてAPIの順序を調整し、整理された構造を維持します。インポートされた場合、フォルダにも関連付けを示す表示がされます:リソースの削除/復元#
スプリントブランチでは、リソースを自由に削除でき、削除されたリソースはTrashに表示され、復元を選択できます。この機能は、メインブランチのゴミ箱と同じように機能します。スプリントブランチで同じメインブランチリソースを繰り返しインポート、削除、復元すると、予期しないデータ問題が発生する可能性があります。データの整合性を維持し、潜在的な問題を回避するため、可能な限りこれらの操作を最小限に抑えることが最善です。APIのモック、比較、コラボレーション#
スプリントブランチのAPIには、そのブランチ固有のモックアドレスがあります。モック内容は完全に現在のスプリントブランチ内のAPI定義に依存し、関連するチームメンバーがスプリントの変更されたAPIのレスポンスを正確にシミュレートできます。スプリントブランチのリソースをメインブランチの対応するリソースと比較して、特定の違いを特定できます。スプリントブランチのAPIは、コラボレーションリンクを介して共有することもでき、他のプロジェクトメンバーに送信してコラボレーションできます。別のブランチにいる間にスプリントブランチのAPIコラボレーションリンクをクリックすると、システムはAPIを表示するためにブランチを切り替えるよう促します。切り替える前に、現在のブランチの変更を必ず保存してください。OASインポート#
OAS（OpenAPI仕様、Swagger仕様とも呼ばれる）を手動、スケジュール、またはAPIインポートなど、さまざまな方法でスプリントブランチに直接インポートできます。スプリントブランチにOASをインポートする#
スプリントブランチにOASをインポートするには、左上隅でターゲットブランチが選択されていることを確認し、Project Settings > Import Dataページに移動して、現在のブランチにデータをインポートします。スプリントブランチにOASを自動的にインポートするスケジュールを設定する場合は、スケジュールされたインポートの作成中にターゲットブランチを選択します。メインブランチとのOASの自動比較#
スプリントブランチにOASをインポートする際、処理ロジックは次の手順に従います:OASファイル内の各APIの「Path & Method」をメインブランチのものと比較:「Path & Method」が一致し、OAS内容がメインブランチと同じ場合、APIはスプリントブランチにインポートされません。
一致する「Path + Method」が見つかり、OAS内容がメインブランチと異なる場合、APIはメインブランチに関連付けられ、スプリントブランチにインポートされます。
一致する「Path + Method」が見つからない場合、スプリントブランチに新しいAPIが作成されます。
OASファイル内のスキーマ名をメインブランチのものと比較:スキーマ名が一致し、OAS内容が同じ場合、スキーマはスプリントブランチにインポートされません。
一致するスキーマ名が見つかり、OAS内容が異なる場合、スキーマはメインブランチに関連付けられ、スプリントブランチにインポートされます。
一致するスキーマ名が見つからない場合、スプリントブランチにスキーマが作成されます。
インポートが成功すると、スプリ ントブランチに追加された新しいリソースと変更されたリソースの概要が表示されます。
Modified at 2025-01-08 08:16:37
