お知らせ:

当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

行の作成

単一の行を作成する

以下に示すように、newRow()メソッドを使用して、指定されたインスタンスのData Storeテーブルに新しい行を作成できます。テーブル内の行の値を、カラム名と対応する行の値をキーと値のペアとして指定して設定する必要があります。

以下のコード構文で使用されている<ROW_INSTANCE>は、行インスタンスページで定義されたインスタンスです。カラム値は、カラム値の追加ページで説明されているメソッドを使用して設定されます。

パラメータ:

  • completion: 操作が成功した場合、completionブロックは作成された行の詳細(一意のROWIDやその他のメタ情報など)を返します。それ以外の場合は、エラーを返します。
Note: is_uniqueまたはis_mandatoryプロパティを有効にしてカラムを作成した場合、それぞれ値が一意であること、または値が必ず渡されることを確認する必要があります。また、カラムに渡すデータがカラムの設定されたデータ型であることも確認する必要があります。

サンプルコードスニペットは以下の通りです:

copy
let instance = ZCatalystApp.shared.getDataStoreInstance(tableIdentifier: "1096000000002071").newRow() //これをあなたのテーブルIDに置き換えてください
instance.setColumnValue(columnName: "Department_Name", value: "Marketing")
instance.setColumnValue(columnName: "Employee_Name", value: "Linda Page")
//これをあなたの列名に置き換えてください and value
instance.create() {(result) in
switch result{
  case .success ( let row) :
   print("A new row is successfully created with row id /(row.id)")
  case .error( let error ) :
   print( "Error occurred >>> \( error )" )
 }
}

複数の行を作成する

iOS SDKでは、指定されたインスタンスのテーブルに一度に複数の行を作成できます。テーブルに挿入する行を含む配列を渡すことで実行します。以下のコード構造に示すように、配列をcreate()メソッドの引数として渡します。

行インスタンスページで説明されているように各行のインスタンスを作成した後、<ROW_INSTANCE>の配列を渡す必要があります。カラム値は、カラム値の追加ページで説明されているように設定する必要があります。

以下のコードで使用されている<DATA_STORE_INSTANCE>は、Data Storeインスタンスページで先に作成されたインスタンスです。

copy
<DATA_STORE_INSTANCE>.create(_ rows: [ ZCatalystRow ], completion: @escaping(Result<[ZCatalystRow], ZCatalystError>) -> Void)

パラメータ:

  • rows: 作成する行の配列
  • completion: 操作が成功した場合、completionブロックは作成された行の詳細(ROWIDやその他のメタ情報など)を返します。それ以外の場合は、エラーを返します。

サンプルコードスニペットは以下の通りです:

copy
let row_instance1 = ZCatalystApp.shared.getDataStoreInstance(tableIdentifier: "1096000000002071").newRow() //ここにテーブルIDを入力してください
row_instance1.setColumnValue(columnName: "Department_Name", value: "Marketing")
row_instance1.setColumnValue(columnName: "Employee_Name", value: "Robert Jones")
//これをあなたの列名に置き換えてください and value
let row_instance2 = ZCatalystApp.shared.getDataStoreInstance(tableIdentifier: "1096000000002071").newRow()
//これをあなたのテーブルIDに置き換えてください
row_instance2.setColumnValue(columnName: "Department_Name", value: "Finance")
row_instance2.setColumnValue(columnName: "Employee_Name", value: "Louis Smith")
//これをあなたの列名に置き換えてください and value
ZCatalystApp.shared.getDataStoreInstance(tableIdentifier: "1096000000002071").create([row_instance1, row_instance2]) {(result) in
switch result{
  case .success ( let rows) :
   print("The rows ids which are successfully created are listed below")
    for row in rows{
     print(row.id)
    }
  case .error( let error ) :
   print( "Error occurred >>> \( error )" )
 }
}

最終更新日 2026-03-30 13:40:30 +0530 IST