• FieldAccessPathを構築する方法
• フォームオブジェクトを取得する方法
• 項目の選択肢を取得する方法
• フォームを送信する方法
• 項目の値を設定する方法
• メディア項目にファイルをアップロードし、フォームを送信する方法
• Creatorアプリ内のセクションを取得する方法
• レポートを取得する方法
• レポート内のデータを処理する方法
• 通知履歴を取得する
• エンドユーザーが通知をタップした際にデータ概要を表示する
• 通知からデータのメタデータを取得する

FieldAccessPathの構築方法

FieldAccessPathを使用すると、必須項目を必須フォーム内で参照できます。構築方法は次の通り異なります。

通常項目の場合：

FieldAccessPath.項目(linkName: <FieldLinkName>)

複合項目のサブフィールドの場合（例：名前項目のfirst_nameや、住所項目の国など）：

FieldAccessPath.compositeField(linkName: <CompositeFieldLinkName>, subFieldLinkName: <SubFieldLinkName>)

サブフォーム内の普通項目の場合：

FieldAccessPath.subFormField(linkName: <SubFormLinkName>, entryId: <EntryId>, fieldLinkName: <FieldLinkName>)

サブフォーム内の複合項目のサブフィールドの場合：

FieldAccessPath.subFormCompositeField(linkName: <CompositeFieldLinkName>, subFormLinkName: <SubFormLinkName>, entryId: <EntryId>, subFieldLinkName: <SubFieldLinkName>)

フォームオブジェクトを取得する方法

データを追加する際にアクセスしたときと同じ表示でフォームオブジェクトを取得するには、次のようにします。

データの編集画面で表示されるフォームオブジェクトを取得するには、以下のようにします。

項目から選択肢を取得する方法

Zoho Creator では、選択肢は以下の項目タイプで表示されます：ドロップダウン、ラジオ、マルチ選択、チェックボックス、ルックアップ、名前項目の接頭語サブフィールド、住所項目の国サブフィールドが該当します。必須項目のAccessPathの構築方法については本セクションを参照してください。フォームからデータを追加する際に項目が表示する選択肢を取得するには、下記の手順を確認してください。

// FieldAccessPath 構築を参照として確認let=FieldAccess.項目(:<ChoiceFieldLinkName>)ZCFormAPIService.fetchChoices(:<SearchString>,:,in:<>,:<


  フォームでデータを編集する際、項目が表示する選択肢を取得するには:
let=>,:<FromInde>){()in切り替える{case.完了(let)://選択肢case.failure(_)://失敗}}
 
フォームを送信する
データを追加するためにフォームを送信します。

ZCFormAPIService.送信する(form: <Form>) { (result) in
    切り替える result {
      case .完了(let response):
        //送信する response
      case .failure(let error):
        //エラー
    }
  }


フォームを送信してデータを編集するには：

ZCFormAPIService.updateRecord(:<>,:<ReportLinkName>,:<Form>){()in切り替える{case.完了(let
項目の値を設定する方法
必須項目のAccessPathを作成します。
フォームから項目とindexを取得する:
 

<form>.getFieldAndIndex(using: <fieldAccessPath>)
// (項目,index)
項目の現在の値を取得する:
 

<field>.getValue()
// InputValues
項目
single 折れ線グラフメール番号パーセント小数通貨複数行テキストリッチテキストメモ追加日付日付・時間時間
        

InputValues.textFieldValue(fieldValue: “<your_input>”)
decision 箱項目の値を設定するには: 
        

InputValues.decisionFieldValue(fieldValue: <boolean_value>)
ドロップダウン、ラジオ、ルックアップ ユーザー連携
        

if case InputValues.singleSelectChoiceFieldValue(var existingValue) = <field>.getValue() {
   existingValue.selectedChoice = { existingValue.choice から適切な値を選択できます }
   let newField = field.setValueFor(value: existingValue) //updated 項目
}
checkbox、multi 選択する、またはlookup
        

if case InputValues.multiSelectChoiceFieldValue(var existingValue) = <field>.getValue() {
   existingValue.selectedChoice = { existingValue.choice から該当する値を選択できます }
   let newField = field.setValueFor(value: existingValue) //updated 項目
}
電話番号項目に値を設定するには: 
        

let newField = field.setValueFor(value: InputValues.phoneNumberFieldValue(countryCode:<コード>,number: <PhoneNumber>))
URL項目の値を設定するには: 
        

let newField = field.setValueFor(value: InputValues.urlFieldValue(url:<url>,title:<title>,linkName:<linkName>))
項目をフォームに更新します:
 

<form>.setField(updatedField,at: index)
メディア項目にファイルをアップロードし、フォームを送信する方法
画像、file アップロード、audio、video、または署名項目にファイルをアップロードし、フォームを送信してデータを追加するには、以下の手順を実行します。
funcsubmitMediaField(:データ,:文字列,:文字列) {let=FormInfo (:'',:'',:'',:'',:nil)// フォームを取得ZCFormAPIService.fetch(for:),)=.getFieldAndIndex(:),caseInputValues.mediaFieldValue(var)=.getValue(){//アップロードする mediaZCFormAPIService.アップロードする(:,:for:,::)//フォームを送信するZCFormAPIService.送信する(:){()in切り替える{case.sucess(let)://完了のレスポンス印刷する('完了')case.failure(_)://失敗印刷する


  ファイルを 画像、file アップロードする、audio、video、または署名項目にアップロードし、フォームを送信してデータを更新します。
=.let=FieldAccessPath.項目(:)iflet(,)=.getFieldAndIndex(:),caseInputValues.mediaFieldValue(var)=.getValue(){//メディアをアップロードするZCFormAPIService.アップロードする(:,:,for:,:){()in切り替える{case.sucess(let):// メディア項目の値を設定.=.iflet=.setValueFor(:.mediaFieldValue(:)){.setField(,:)// データを更新するZCFormAPIService.updateRecord(:,:,:){()in切り替える{case.sucess(let):// 完了 Response印刷する( '完了' )case.failure(_)://失敗印刷する( '失敗' )}}}case.failure(let):印刷する()}}
Creatorアプリで利用可能なセクションを取得する
レポートを取得する方法
nil,:'',:'',:'<レポート-リンク-名前>',:.,:nil,:nil,:無効)let=ListReportAPIConfiguration(:1,:50,:ReportAPIConfiguration.init
レポート内のデータ利用可能を処理する方法
guardlet=..first//最初のデータを返品します。（必要に応じて、目的のデータを指定することも可能です）else{返品する}do{let=try.recordValue(for:'<項目 リンク 名前 of the desired 項目>')//上記で指定した項目の表示用文字列を差出人として返品しますlet=..displayValue(for:.)//受領済みの値をさらに処理する場合切り替える.{case.text(let)://text値項目の場合：single折れ線グラフ、multi折れ線グラフ、メール、番号、日付、リッチテキストなど。.//文字列を返すcase.file(let)://media項目の場合：ファイルアップロード、画像、音声、動画、署名.//ファイルのURLを返す.//項目に関連する追加プロパティを返すcase.名前(let)://名前項目の場合.//名前項目の表示値を返す.//返品サブフィールド値 差出人 名前項目: 接頭語、first_name、last_name、接尾語case.住所(let)://住所項目の場合.//返品 住所項目の表示値.//返品サブフィールド値 差出人 住所項目: address_line_1、address_line_2、district_city、state_province、postal_Code、国.//利用可能な場合は緯度を返す.//利用可能な場合は経度を返すcase.phoneNumber(let)://電話番号項目の場合.//電話番号を返すcase.リンク)://リンク項目の場合.//リンク項目の表示値を返します.//項目に対応するリンクを返しますcase.linkedRecords(let,:let)://参照やサブフォーム項目で、表示するプロパティへのリンクが設定されている場合let=.first//最初のデータを返します。（必要に応じて希望するデータを指定することも可能です）?.//データの表示文字列を返します?.//データのIDを返しますcase.choices(let,:let)://選択項目の場合：radio、ドロップダウン、multi-選択する、checkboxlet=.first//最初の選択肢を返します。（希望する選択肢を指定することも可能です）?.//選択肢の文字列を返しますcase.values(let)://multi-選択する lookup 項目の関連値の場合//ここで「values」は、上記の説明の通りさらに処理できる配列ですbreak}}catchlet{印刷する('\(recordValueError)の発生時にデータ値の処理中にエラーが発生しました')}case.failure(let)://エラー処理をここで行います印刷する('レポート エラーが発生しました: \(エラー)')}}
通知履歴を取得する方法
funcfetchAllNotifications(){ZCAPIService.{(
エンドユーザーが通知をタップした際にデータ概要を表示する
通知からデータのメタデータを取得する方法
'\(エラー)')}}}}else{// Zoho Creator サーバーからの差出人ではありません}completionHandler()}}