コマンドラインからのデータのインポートおよびエクスポート

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メソッドを使用します:

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メソッドを使用します:

POST https://host:port/ic/builder/design/appName/appVersion/resources/datamgr/import/objectId

たとえば、MyAppアプリケーションのバージョン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コマンド

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 -v

MyAppアプリケーションのバージョン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

cURLコマンドライン・ツールを使用して、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メソッドを使用します:

GET https://host:port/ic/builder/design/appName/appVersion/resources/datamgr/export

たとえば、MyAppアプリケーションのバージョン1.0のビジネス・オブジェクトから開発データをエクスポートするには、次を使用します:

GET https://myhost:myport/ic/builder/design/MyApp/1.0/resources/datamgr/export

アプリケーション・データをエクスポートすると、アプリケーションの各ビジネス・オブジェクトの.csvファイルを含むZIPアーカイブが作成されます。

特定のビジネス・オブジェクトの開発データをエクスポートするには、次のようにGETメソッドを使用します:

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コマンド

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を作成します。

cURLコマンドライン・ツールを使用して、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