コマンドラインからのデータのインポートおよびエクスポート
Visual Builder APIを使用して、コマンド行から一括してデータをインポートおよびエクスポートできます。
Visual Builder APIは、基本APIを使用してコマンドラインからアプリケーションのチーム・メンバーにアクセスできます。データAPIを使用して個々のオブジェクトを問合せし、単一行操作を実行することができます。 たとえば、データをインポートおよびエクスポートし、ビジネス・オブジェクトのデータを別の表のデータと同期するように、日次のcronジョブを設定できます。
コマンドラインからデータをインポート
コマンドラインからビジネス・オブジェクトにデータをインポートするには、/resources/datamgr/importエンドポイントとともにPOSTメソッドを使用します。
データを含む.csv、.xlsまたは.xlsxファイルをアップロードする必要があります。 ファイル名は、更新するビジネス・オブジェクトのオブジェクトIDと一致する必要があります。 1つのビジネス・オブジェクトのデータをインポートするには、1つのファイルをアップロードします。 複数のビジネス・オブジェクトのデータをインポートする場合は、1つ以上の.csv、.xlsまたは.xlsxファイルを含むZIPアーカイブをアップロードする必要があります。
問合せのパラメータ
importエンドポイントは、appendパラメータのみを受け入れます:
| パラメータ | 説明 |
|---|---|
append |
ブール。trueによって、ファイル内の行が新しい行としてビジネス・オブジェクトに追加されます。 デフォルト値はfalseで、ファイル・データによってビジネス・オブジェクトの既存のデータが置換されます。
|
構文
POST https://host:port/ic/builder/design/appName/appVersion/resources/datamgr/importアプリの詳細は、「設定」エディタを参照してください: 「アプリケーション名」でappNameを検索し、appVersionの場合は、アプリケーションIDのダッシュに続く番号を使用します。
MyAppアプリケーションのバージョン1.0のすべてのビジネス・オブジェクトにデータをインポートするには、次を使用します:POST https://myserver:myport/ic/builder/design/MyApp/1.0/resources/datamgr/importインポートするデータ・ファイルをアップロードし、リクエスト本文にそのコンテンツ・タイプを指定することを忘れないでください。 たとえば、Postmanに似たREST APIツールを使用している場合は、「本文」タブを使用してデータ・ファイル(たとえば、MyObject.zip)をアップロードし、コンテンツ・タイプとして「バイナリ」を選択します。
POST https://host:port/ic/builder/design/appName/appVersion/resources/datamgr/import/objectIdMyAppアプリケーションのバージョン1.0のMyObjectビジネス・オブジェクトにデータをインポートするには、次を使用します:POST https://myserver:myport/ic/builder/design/MyApp/1.0/resources/datamgr/import/MyObjectノート:
データを「ステージング」または「生の」データベースにインポートするには、エンドポイント・パスの/design/を/deployment/に置き換えます。
アプリケーションが稼働している場合は、データをインポートする前に、オプション・メニューを使用してアプリケーションをロックします。 終了したらアプリケーションのロックを解除します。
「Oracle Visual BuilderのためのREST API」の「データ管理のRESTエンドポイント」も参照してください。
cURLコマンド
MyAppアプリケーションのバージョン1.0のMyObjectという名前のビジネス・オブジェクトのdevelopmentデータをインポートする場合、POSTメソッドを次のように使用します:curl -X POST -u user:password https://host:port/ic/builder/design/MyApp/1.0/resources/datamgr/import/MyObject -H Content-Type:text/csv -T MyObject.csv -vMyAppアプリケーションのバージョン1.0にある複数のビジネス・オブジェクトの開発データをインポートするには、次のようにPOSTメソッドを使用します:curl -X POST -u user:password https://host:port/ic/builder/design/MyApp/1.0/resources/datamgr/import -H Content-Type:application/zip -T myObject.zip -v MyAppアプリケーションのバージョン1.0にあるMyObjectという名前のビジネス・オブジェクトの「ステージングまたはライブ」データベースにデータをインポートする場合は、次のようにPOSTメソッドを使用します:curl -X POST -u user:password https://host:port/ic/builder/deployment/MyApp/1.0/resources/datamgr/import/MyObject -H Content-Type:text/csv -T MyObject.csv -vコマンドラインからのデータのエクスポート
コマンドラインからビジネス・オブジェクト・データをエクスポートするには、/resources/datamgr/exportエンドポイントとともにGETメソッドを使用します。
構文
GET https://host:port/ic/builder/design/appName/appVersion/resources/datamgr/exportアプリの詳細は、「設定」エディタを参照してください: 「アプリケーション名」でappNameを検索し、appVersionの場合は、アプリケーションIDのダッシュに続く番号を使用します。
MyAppアプリケーションのバージョン1.0のビジネス・オブジェクトから開発データをエクスポートするには、次を使用します:GET https://myhost:myport/ic/builder/design/MyApp/1.0/resources/datamgr/exportアプリケーション・データをエクスポートすると、アプリケーションの各ビジネス・オブジェクトの.csvファイルを含むZIPアーカイブが作成されます。
GET https://host:port/ic/builder/design/appName/appVersion/resources/datamgr/export/objectIdたとえば、MyAppアプリケーションのバージョン1.0にあるMyObjectビジネス・オブジェクトから開発データをエクスポートするには、次を使用します:
GET https://myhost:myport/ic/builder/design/MyApp/1.0/resources/datamgr/export/myObject単一のビジネス・オブジェクト結果でのデータのエクスポートは、指定されたビジネス・オブジェクト内のデータを含む.csvファイルです。
ノート:
データを「ステージング」または「生の」データベースにエクスポートするには、エンドポイント・パスの/design/を/deployment/に置き換えます。
アプリケーションが稼働している場合は、データをエクスポートする前に、オプション・メニューを使用してアプリケーションをロックします。 終了したらアプリケーションのロックを解除します。
「Oracle Visual BuilderのためのREST API」の「データ管理のRESTエンドポイント」も参照してください。
cURLコマンド
MyAppアプリケーションのバージョン1.0のdevelopmentデータをmyapp.zipという名前のZIPアーカイブにエクスポートする場合、GETメソッドを次のように使用します:curl -u user:password https://host:port/ic/builder/design/MyApp/1.0/resources/datamgr/export > myapp.zipこのコマンドは、MyAppの各ビジネス・オブジェクトの.csvファイルを含む.zipファイルmyapp.zipを作成します。
MyAppアプリケーションのバージョン1.0の「ステージングまたはライブ」データをmyapp.zipという名前のZIPアーカイブにエクスポートする場合、GETメソッドを次のように使用します:curl -u user:password https://host:port/ic/builder/deployment/MyApp/1.0/resources/datamgr/export > myapp.zip