起動としてOracle Service Cloud (RightNow)アダプタを構成するときにQueryCSV文を指定する

起動として「Oracle Service Cloud (RightNow)アダプタ」を構成する場合のQueryCSV文の指定

「Oracle Service Cloud (RightNow)アダプタ」を使用すると、Oracle Service Cloud (RightNow)内で表形式QueryCSVの文を実行できます。 QueryCSVを使用できるのは、「Oracle Service Cloud (RightNow)アダプタ」を起動として構成する場合のみです。

QueryCSVステートメントの指定

統合内の起動として「Oracle Service Cloud (RightNow)アダプタ」を追加します。

これにより、Adapter Endpoint Configuration Wizardが開始されます。
「基本情報」ページで、名前とオプションの説明を指定し、「次」をクリックします。
操作ページの「操作タイプの選択」リストから、ROQLを選択します。
ドロップダウン・リストからQueryCSVを選択します。

次の構文を使用して、エディタで問合せを指定します:

SELECT field list from primary object [WHERE condition expression]”

説明:

構文説明

構文	説明
`field list`	1つまたは複数のフィールドのリストをカンマで区切って指定します。指定するフィールドは、単純なフィールド(スカラー型のフィールド)でなければなりません。 `SELECT`ステートメントがプライマリ・オブジェクト、サブオブジェクトまたはリレーションシップ・オブジェクトで終了すると、障害が生成されます。
`primary object`	問合せするオブジェクトのタイプを指定します。
`condition expression`	`WHERE`句は、指定された`field list`でフィルタリングする行と値を決定します。指定されていない場合、問合せはオブジェクト内のすべての行を取得します。

field list

1つまたは複数のフィールドのリストをカンマで区切って指定します。

指定するフィールドは、単純なフィールド(スカラー型のフィールド)でなければなりません。 SELECTステートメントがプライマリ・オブジェクト、サブオブジェクトまたはリレーションシップ・オブジェクトで終了すると、障害が生成されます。

primary object

問合せするオブジェクトのタイプを指定します。

condition expression

WHERE句は、指定されたfield listでフィルタリングする行と値を決定します。指定されていない場合、問合せはオブジェクト内のすべての行を取得します。

「テストMy Query」をクリックします。

問合せの最初の10個の結果が表示されます:

図rightnow_querycsv.pngの説明

問合せパラメータを指定することもできます。問合せパラメータは、&とそれに続く変数名で定義されます。たとえば:
```
SELECT Status.ID,EndPoint FROM EventSubscription DESC limit 10 offset &offsetData 
```

Oracle Integrationのメモリー制限のため、結果の最初の100行のみが実行時に返されます。次の行を取得するには、limitとoffsetを問合せパラメータとして使用して、次の結果セットを返します。

次のタイプの問合せがあるとします:
```
SELECT Status.ID,EndPoint FROM EventSubscription DESC limit &limit offset &offsetData
```
最初の問合せでは、&offsetDataの値を0に、&limitの値を20に設定すると、最初の20行が取得されます。 2番目の問合せでは、&offsetDataの値を21に設定し、&limitの値を10に設定すると、次の10行などが取得されます。

次回の問合せのたびに更新されたオフセット値を送信する必要があります。
問合せでは、Useキーワードを使用できます。たとえば、USEを定義して、別のデータベースを問合せすることができます:
```
USE OPERATIONAL; SELECT id, name.first, name.last FROM Contact WHERE ID =3
```
問合せでは正規表現を使用できます。たとえば:
```
SELECT id FROM CO.MyObject WHERE LookupName REGEXP '^TEST.*$
```
Oracle Service Cloud (RightNow)でサポートされているフィールド式と論理演算子もQueryCSVでサポートされています。たとえば:
```
SELECT ID FROM Contact WHERE Contact.Name.First like 'Chris' AND Contact.Address.City='Bozeman'
```
別名を使用すると、問合せをより読みやすくすることができます:
```
SELECT O.Name FROM Organization O
```

サポートされていない機能

DESCRIBE問合せはサポートされていません。たとえば:
```
DESCRIBE Contact.Emails.EmailList
```

*を使用した問合せはサポートされていません。たとえば:

SELECT RoqlInformation.Concurrency.*, RoqlInformation.Maxjoinsize.* FROM SystemInformation;

複数の問合せのマージはサポートされていません。たとえば:

SELECT id, name.first, name.last FROM Contact WHERE ID=3; SELECT id, createdTime,updatedTime FROM Incident WHERE ID= 1;

連鎖はサポートされていません。たとえば:

SELECT ID as '@MyID' FROM Contact WHERE Organization = @MyOrg LIMIT 1

関数はサポートされていません。たとえば:

select sysdate(), select date_add(date, units, interval, round); select curAdminUser()

フォルト・シナリオ

不適切な記述が実行されないことがあります。不適切に記述された問合せが実行に失敗すると、指定された問合せに基づいて次のメッセージのいずれかを含むSOAP障害が戻されます:

Poor performing query - aborting
Poor performing query - blocked
Poor performing query - too many rows examined
Poor performing query - too much time taken
Current site configuration settings prevent execution of ROQL queries with the REGEXP operator
Too many ROQL queries with the REGEXP operator are running concurrently. Try again later

「起動操作」ページを参照してください。