セマンティック・バージョン・チェックのルール
アダプタをOracle Integrationにプッシュすると、Oracleはセマンティック・バージョン・チェックを実行します。 このチェックにより、変更が下位互換性を維持しているかどうかが判断され、アダプタのバージョン番号を更新するためのガイダンスが提供されます。
ノート:
現在、Rapid Adapter Builderではメジャー・バージョンを変更できません。セマンティック・バージョニングについて
Oracleは、Rapid Adapter Builderを使用して構築されたすべてのアダプタに対して、セマンティック・バージョニング・ルール(SemVerとも呼ばれる)を適用します。
セマンティック・バージョニングでは、意味のある制御された方法でバージョン番号を増分します。 アダプタがセマンティック・バージョニングを使用していることがわかっている場合、バージョン番号によってバージョン内の変更のタイプについて簡単に説明できることがわかります。
詳細は、「セマンティック・バージョニング2.0.0」 webサイトを参照するか、引き続きお読みください。
セマンティック・バージョン・チェックについて
アダプタを公開すると、セマンティック・バージョン・チェックによって次のタスクが完了します。
| タスク | 詳細情報 |
|---|---|
|
下位互換性を損なう変更の特定 |
これらの変更を識別するために、セマンティック・バージョン・チェックでは、アダプタの以前のバージョンと現在のバージョンを比較します。 |
|
マンデート・セマンティック・バージョニング |
このチェックにより、変更のタイプに応じてyurバージョン番号が適切に増分されます。 たとえば、マイナー・リリースをバージョン1.1.1に更新する場合、次のバージョンは1.2以上である必要があります。 |
セマンティック・バージョニングによる更新のタイプ
セマンティック・バージョニングでは、次のタイプの更新がサポートされています。
| 更新のタイプ | 例 | ガイダンス |
|---|---|---|
|
メジャー・バージョン |
1.2.3から2.0.0 |
この変更は下位互換性を損なうか、下位互換性を損なう可能性があります。 |
|
マイナー・バージョン |
1.2.3から1.3.0 |
この変更により、下位互換性を維持しながら、新しい関数やパラメータなどの新機能が追加されます。 |
|
パッチ・バージョン |
1.2.3から1.2.4 |
この変更により、下位互換性を維持しながら品質が向上します。 |
メジャー・バージョン更新が必要な変更
ノート:
現在、Rapid Adapter Builderは、下位互換性を損なう変更をサポートしていません。次の変更により、概念的には下位互換性が損なわれます。 ライブ統合で変更が実際に下位互換性を損なうかどうかは、統合でアダプタがどのように使用されるかによって異なります。 たとえば、アダプタからアクションを削除すると、下位互換性が低下します。 ただし、このアクションを使用している統合がない場合、この変更はどの統合にも影響しません。
これらの変更には、メジャー・バージョンの更新が必要です。
| RuleID | 変更 |
|---|---|
|
A01 |
アクションまたはトリガーを削除します。 |
|
A02 |
トリガーまたはアクションの入力または出力を削除します。 |
|
A03 |
アクションまたはトリガーの識別子の変更。 |
|
A04 |
トリガーまたはアクションの入力または出力スキーマからのプロパティの削除。 ノート: フローが入出力スキーマを決定する場合、セマンティック分析はできません。 その結果、フローによってスキーマが決定されると、変更は下位互換性があるとみなされます。 |
|
A05 |
トリガーまたはアクションの入力スキーマに必要な必須プロパティの追加または既存のプロパティの変更。 |
|
A06 |
文字列から数値への変更など、既存のフィールドのデータ型を変更します。 |
|
A07 |
接続プロパティの変更。
|
|
A08 |
セキュリティ・ポリシーの変更。 |
|
A09 |
セキュリティ・プロパティの変更。 |
マイナー・バージョン更新が必要な変更
| RuleID | 変更 |
|---|---|
|
B01 |
アクションまたはトリガーの追加 |
|
B02 |
トリガーまたはアクションの入力または出力スキーマへのオプション・フィールドの追加 |
|
B03 |
既存のプロパティの必須からオプションへの変更 |
|
B04 |
列挙値の追加または変更 統合開発者が選択する一連のオプションを指定することで、プロパティの入力値を制限できます。 これらのオプションは列挙値と呼ばれます。 |
|
B05 |
パターン・マッチング正規表現の追加 正規表現を使用して、統合開発者がプロパティに入力できる許容パターンおよびテキストを指定できます。 必要に応じて、パターン強制をフィールドに追加できます。 |
|
B06 |
フィールドの書式設定の追加またはユーザー・インタフェースの外観のカスタマイズ ユーザー・フェイスでのフィールドのレンダリング方法を指定できます。 たとえば、フィールドに日時書式が設定されている場合、ユーザー・インタフェースには日付ピッカーが表示されます。 |
パッチ・バージョン更新が必要な変更
| RuleID | 変更 |
|---|---|
|
C01 |
不具合を修正するための内部変更など、入力または出力スキーマを変更せずに、下位互換の方法でフローのロジックを変更 |
|
C02 |
タイトル、説明、タグ、アイコンなど、アダプタのビジュアル表現を定義するプロパティの変更 |
|
C03 |
フィールドから列挙を削除することで、フィールドがより広い値セットを受け入れることができます |
|
C04 |
正規表現を強制する書式を削除することで、フィールドにより広い値セットを受け入れることができます |
|
C05 |
正規表現を適用するパターンの削除 |
|
C06 |
アダプタで統合開発者が接続をテストできる場合に、テスト参照を変更します。 |
|
C99 |
下位互換性があるとみなされるその他の変更 |