本製品 は、Jira API をリレーショナルテーブル、ビュー、およびストアドプロシージャとしてモデル化します。これにより、Jira Cloud アカウントやJira Server インスタンスへのデータベースライクな接続が可能になります。

カスタムフィールドへのアクセス

デフォルトでは、テーブルスキーマおよびビュースキーマは、Jira エンティティのシステムフィールドのカラム動作を記述します。システムフィールド同様、Issues のカスタムフィールド にアクセスするには、接続文字列のIncludeCustomFields を設定できます。スキーマを拡張してカスタムフィールド へのアクセスを設定することもできます。

スキーマのカスタマイズ

スキーマは.rsd コンフィギュレーションファイルで定義されます。これらのファイルはシンプルな形式で、簡単に拡張できます。例えばカスタムフィールドをより詳細に制御することができます。

スキーマを.rsd ファイルに保存するには、例えばIncludeCustomFields 接続プロパティを設定した状態で、CreateSchema ストアドプロシージャを呼び出します。

カスタムスキーマを使用するには、Location プロパティを.rsd ファイルを有するフォルダに設定します。本製品 に含まれるスキーマはインストールフォルダのdb サブフォルダにあります。

カラム名の制御

You can use the following properties to gain more control over column names:

• UseSimpleNames: boolean determining if simple names should be used for columns.
• UseDisplayNames: boolean determining if the display names for custom fields should be used instead of the API names.

Handling Key Column Operators

By default, all supported operators are passed directly to the Jira API, enabling efficient server-side filtering. However, when queries include invalid Id or Key values, this approach can lead to inconsistent outcomes. On Jira Cloud, depending on the UseJqlSearchEndpoint setting, invalid filters may return 0 results instead of throwing an error, whereas on Jira Data Center they may cause API errors. The KeyColumnOperators connection property allows you to control this behavior.

By default, the KeyColumnOperators is set to Server-Side.

• All supported operators are sent as-is to the Jira API.
• On legacy endpoints (when UseJqlSearchEndpoint is set to False) or on Jira Data Center, this may cause API errors if invalid filter values are provided.
• On Jira Cloud with UseJqlSearchEndpoint set to true (the default), the API does not throw an error for filters with invalid keys or IDs; instead, it returns 0 results. For example, a JQL filter such as id > 123 (when 123 is not a valid issue ID) will yield 0 results rather than failing. This behavior can lead to inconsistent outcomes if you expect a complete result set.

To ensure consistent results, you can set the KeyColumnOperators connection property to Client-Side. In this mode, the following operators applied to the Id and Key columns are handled client-side by the 本製品 rather than being included in the JQL sent to the Jira API:

• Logical operator: OR
• Comparison operators: IN, NOT IN, >, >=, <, <=, !=

By handling these operators client-side, the 本製品 avoids strict server-side filtering rules that could cause the entire query to fail or return zero results due to a single invalid value. However, enabling this property can impact performance:

• For IN filters, the 本製品 will execute a separate request for each value, potentially increasing query execution time.
• For other filters, since the 本製品 retrieves all records before applying the filter client-side, queries may take longer due to the additional processing.