# Oracle Opera ストリーミングインポートインテグレーション

この機能はベータ版です。詳細については、カスタマーサクセス担当者にお問い合わせください。

多くのホスピタリティ業界の企業は、予約、フロント業務、ハウスキーピング、請求などのさまざまな機能を効率化するために Oracle OPERA Property Management System (PMS) を使用しています。OPERA PMS アプリケーションサーバーのインスタンスを導入している企業にとって、このインテグレーションはリアルタイムでのデータ取り込みを可能にし、Treasure Data CDP を一元化されたダッシュボードとして使用して、卓越した顧客体験を提供できるようにします。

## 前提条件

- Treasure Data の基本的な知識
- Oracle OPERA Exchange Interface (OXI) を設定して、イベントやオブジェクトを外部システムに送信できる能力
- ファイアウォールポリシー、または同等のメカニズムを設定して、OXI コンポーネントが指定された Treasure Data 静的 IP アドレスに到達できるようにする能力


## 制限事項と制約事項

- このインテグレーションは、POST リクエストとして送信される XML データをサポートしています。その他のデータ形式は現在サポートされていません。
- インポートされたすべてのデータは、異なるビジネスオブジェクトである可能性がありますが、JSON に変換され、同じテーブルに保存されます。TD Workflow を使用した追加のデータ処理により、特定のユースケースに合わせてデータをカスタマイズできます。
- XML ペイロードの最大サイズは 998KB です。


## Treasure Data Integration の静的 IP アドレス

セキュリティポリシーで IP ホワイトリストが必要な場合は、接続を成功させるために Treasure Data の IP アドレスを許可リストに追加する必要があります。

リージョンごとに整理された静的 IP アドレスの完全なリストは、次のリンクにあります:
[https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/](https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/)

## TD Console を使用した Oracle Opera のインポート

### 新しい認証の作成

最初のステップは、認証情報のセットを使用して新しい認証を作成することです。

1. **Integrations Hub** を選択します。
2. **Catalog** を選択します。
![](/assets/integrationshub-catalog2.e33c0a4c7d81c40cc83dd056c2143b97b1406220e213cab14ef349d69412ffef.7705d4c2.png)
3. Catalog で Opera を検索し、アイコンにマウスを合わせて **Create Authentication** を選択します。
![](/assets/oracleopera.4fb14462070ec45f8300aff1e777ed4d7fa3215f96571ee6270626b67d4b6a40.211c5e0c.png)
4. **Credentials** タブが選択されていることを確認し、インテグレーションの認証情報を入力します。


**新しい認証のフィールド**

| パラメータ | 説明 |
|  --- | --- |
| TD API Key | データベースへのアクセスには、TD の書き込み専用 API キーが必要です。[API キーの取得](https://docs.treasuredata.com/smart/project-product-documentation/getting-your-api-keys) を参照してください。 |
| Public Key Pin | OXI サーバーで TLS/SSL 証明書を設定できる場合、このオプション設定を使用して、インテグレーションのセキュリティを強化できます。詳細については、Treasure Data カスタマーサクセス担当者にお問い合わせください。 |


1. 認証の名前を入力し、**Done** を選択します。


### ソースの作成

1. TD Console を開きます。
2. **Integrations Hub > Authentications** に移動します。
3. 新しい認証を見つけて、**New Source** を選択します。


Connection タブで、以下の情報を入力してから **Next** を選択します。

| パラメータ | 説明 |
|  --- | --- |
| Data Transfer Name | ソースの名前を指定します。 |
| Authentication | 使用する認証の名前を指定します。 |


![](/assets/oracle-opera-streaming-import-integration-2024-11-13-1.cb94d7483805c3f8a7b8d00ccdf488228fd2acfdadd8c03020e5e70a6156e9f0.211c5e0c.png)

#### データ設定の構成

Data Settings タブで、以下の情報を入力してから **Create** を選択します。

| パラメータ | 説明 |
|  --- | --- |
| Datastore | Plazma のみが利用可能なオプションです。 |
| Tags (optional) | カンマ区切りのタグリスト。これらのタグを使用すると、後でデータソースをより簡単に見つけることができます。 |
| Database | インポートデータが配置される Treasure Data 内のデータベースを指定します。 |
| Table | データベース内の（事前に作成された）テーブルを指定します。 |


![](/assets/operacreatesourcedatasetting.5b3dedaa159e0b0cedde857f11f551c68d7a8b24d523474b96fe77b7429a9546.211c5e0c.png)

### データインポート用のエンドポイントの構築

前のステップで作成されたソースの一意の ID は、TD アカウントへのデータインポートを可能にするエンドポイントの一部です。不正使用を防ぐため、ソース ID とエンドポイント URL は、許可されていない人物に開示しないでください。

Public Key Pin 認証を設定しない場合、ソース ID (UUID v4) またはエンドポイント URL を知っている人は誰でも、任意のデータをデータソースに送信できます。したがって、Treasure Data では、ソース ID を秘密の認証情報として扱うことを推奨しています。

1. **Integrations Hub > Sources** に移動します。
2. 作成したソースを検索します。
3. 使用するソースの行で、右端にある more アイコン(![](/assets/more3dots.bc4a1401016eaf0793b9566848561f9c8890f33f8ea5cf23c19795702a04882d.211c5e0c.png)) を選択し、**Copy Unique ID** を選択します。


ID は 32 文字の UUID です。
![](/assets/oracle-opera-streaming-import-integration-2024-11-13-3.7e841d1e3da71d8de775edb74074b3418067995870d6f7bf7977fc9abfed2095.211c5e0c.png)
4. コピーしたソース ID を次の URL の末尾に置き換えて、エンドポイントを構築します。

`https://opera-in-streaming.treasuredata.com/v1/task/<source\_id>`

完全なエンドポイントの例は次のようになります。

`https://opera-in-streaming.treasuredata.com/v1/task/abcdef12-3456-7890-abcd-ef1234567890`

## TD Workflow の組み込み

このインテグレーションに TD Workflow を組み込むには、[TD インテグレーションでの TD Workflow の使用](/ja/int/using-td-workflow-with-td-integrations) を参照してください。