拡張アダプターの構成の概要

デプロイ可能なパッケージをアセンブルする際に、構成に関して行うことを選択できます。パッケージに複数のアダプターが含まれている場合は、アダプターごとに異なる選択を行うことができます。

TDVが新しくデプロイされたアダプターで実行する内容は、アダプターの元の構成の状態によって異なります。

• アダプター用のアダプター構成ファイルが提供されていない場合、パッケージのデプロイメント時に、リレーショナルデータソース用の最も一般的な設定を含むデフォルト構成がアダプターに割り当てられます。

TDVは新しいデータソースについて何も知らないため、割り当てられたプロパティ値の一部がこの新しいデータソースに適していない可能性があります。そのため、デプロイ後にStudioでアダプター構成を開き、プロパティ値がデータソースの特性を正確に表すようにプロパティ値を体系的に変更する必要があります。また、ネイティブデータタイプに関する情報を提供することも重要です。

• アダプター用のアダプター構成ファイルが提供されているものの、TDVに最低限必要なプロパティとプロパティ値のセットがファイルに含まれていない場合は、アダプター構成ファイルが最初に検証されます。検証に成功すると、アダプター構成ファイルは、すべての必須プロパティとオプションのプロパティのコレクションとマージされます。

デプロイ後、Studioでアダプター構成ファイルを開き、すべてのプロパティに目的のデータソースに適した値が設定されていることを確認する必要があります。アダプター構成ファイルでネイティブデータタイプに関する情報が指定されていることを確認します。

• アダプター構成ファイルに最低限必要なプロパティとプロパティ値のセットが含まれている場合、検証に成功すると、アダプターは完全に有効になり、データソースインスタンスを作成できるようになります。

アダプター構成ファイルで少なくとも10個の関数が定義されていない場合、アダプターはTDVに認識されているすべての関数の完全なリストとマージされます。そうでない場合、開発者の時間を節約するため、マージは行われません。

この場合でも、Studioでアダプター構成を調べ、マージされた結果が目的のデータソースに適していることを確認するようお勧めします。アダプター構成ファイルでネイティブデータタイプに関する情報が指定されていることを確認します。

Studioでアダプター構成をセットアップする際に考慮すべき主な問題は次のとおりです。

• データソースUIで公開するプロパティと公開しないプロパティはどれか。それに応じて可視性フラグを設定します。

• データソースによるオーバーライドを許可するプロパティはどれか。それに応じて可視性フラグを設定します。

• どのようなネイティブタイプがあるか。また、それらを複合データタイプにマッピングするにはどうすればよいか。複合データタイプをネイティブデータタイプにマッピングするにはどうすればよいか。両方向のデータタイプマッピングを設定し、必要に応じて追加のデータタイプを定義します。

• 関連性のあるプロパティはどれか。それらのデフォルト値を設定し、それ以外を削除します。

• SQL句でサポートされないものは何か。それらのデータタイプを指定します。

• サポートされる演算子と関数はどれか。ネイティブの式と引数を適切に設定し、それ以外を削除します。

• 追加の演算子または関数が必要か。必要な場合は、カスタムの演算子と関数を定義します。

[Configuration(構成)]タブまたは[Text(テキスト)]タブで行った変更を保存すると、有効性チェックが行われます。

• アダプター構成ファイル(YAMLドキュメント)の形式が正しくないか、エラーが発生した場合、ファイルは保存されません。

• アダプター構成ファイルを([Text(テキスト)]タブで)直接編集した場合、次の理由でファイルが無効になる可能性があります。

— ドキュメントの構造のスキーマエラー(用語の前のスペース文字の数が間違っているなど)

• 検証で警告のみが生成された場合、デプロイは成功し、検証警告メッセージがサーバーログに書き込まれます。

成功した有効性チェックの一環として、一部の変更が自動的に行われる場合があります。例:

• 「Required for data source(データソースに必須)」がtrueに設定されているにもかかわらず「Display in UI(UIに表示)」がfalseに設定されている場合、有効性チェッカーによって「Display in UI(UIに表示)」がtrueに変更され、データソースの構成担当者が値を設定できるようになります。

• データタイププレフィックス「cis.」または「native.」が有効なデータタイプに使用されているものの、プレフィックスが不要な場合は、データタイプが保存される前にプレフィックスが削除されます。