Data (things)（データ「Thing」）

概要

Thing（シング） とは、データベース内で一意のレコードを指します。
これらのレコードは、アクションを使用して 作成・編集・削除 することができます。

Create a new thing…（新しいThingを作成）

このアクションは、アプリケーションデータベース内に新しいエントリを作成します。
これを Thing（シング） と呼びます。

このアクションのプロパティエディタ内の Type（タイプ） では、
ドロップダウンから既存のデータタイプを選択するか、
メニューの「Create a new type…（新しいタイプを作成）」を選んで新しいタイプを定義します。

たとえば、データタイプ一覧から「Event（イベント）」を選択した場合、
このアクションが実行されると、新しい「Event」Thingがアプリケーションデータベースに作成されます。

「Set another field（別のフィールドを設定）」をクリックすると、
既存のフィールドを選択するか、新しいフィールドを作成できます。
たとえば、Data Typesタブ内で「Event name（イベント名）」というフィールドをすでに作成している場合、
このオプションを選択して、入力要素の値を設定できます。
新しく「Start time（開始時刻）」というフィールドを作成したい場合は、
ドロップダウンの下部にある「Create a New Field（新しいフィールドを作成）」を選択します。

このアクションを実行すると、Data タブ → Data Types / App Data で変更を確認できます。

Type（タイプ）

作成するThingのタイプを選択します。
新しいタイプを定義するには、このドロップダウンメニュー内で「Create a new type…」を選びます。

Initial values（初期値）

「Add another field（別のフィールドを追加）」をクリックして新しいフィールドを追加し、
そのフィールドに異なる値を設定します。
変更するフィールド・操作・新しい値を選択します。

Make changes to thing…（Thingを変更）

このアクションは、アプリケーションデータベース内の既存のエントリを変更します。
たとえば、ユーザーが自分の名前を更新する場合、
「Current user’s first name（現在のユーザーの名）」に対して「Make change」アクションを使用します。

Thing to change（変更するThing）

変更対象のThingを選択します。

Create if the thing doesn’t exist（Thingが存在しない場合に作成）

デフォルトでは、変更対象のThingが存在しない場合、このアクションは何もしません。
このチェックボックスを有効にすると、動作が変わり、
アクションは「Create a new thing（新しいThingを作成）」と同等になります。
この場合、設定した変更内容が初期値として使用されます。

重要
変更対象（例：「Current user’s thing」など）が存在しない場合、Thingは作成されますが、
現在のユーザーとは関連付けられません。

警告
このオプションは 2017年7月18日 に廃止されました。
この日以降に作成されたアプリケーションでは使用できません（ランモードでは動作します）。
代わりに、条件付きアクションを使用して、Thingが存在しない場合は
「Change Thing」アクションの前にThingを作成するようにしてください。
既存アプリでこのオプションを使用している場合も、同様の構成に移行することを推奨します。

Changes（変更内容）

変更するThingに適用する変更を追加します。
変更するフィールド、操作、そして新しい値を選択します。
単純な値の代入以外にも、フィールドの種類によって以下のような操作が利用可能です。

• Add（追加）
  既存のリストに項目を追加します。型はフィールドと一致している必要があります。
  すでにリスト内にある場合は追加されません。
• Remove（削除）
  既存のリストから項目を削除します。
  型はフィールドと一致している必要があります。
  項目が存在しない場合は何も起こりません。
• Set list（リストを設定）
  現在のリストを新しいリストに置き換えます。
• Add list（リストを追加）
  指定したリストのすべての項目を既存リストに追加します。
  すでにある項目は追加されません。
• Remove list（リストを削除）
  指定したリスト内の項目を既存リストからすべて削除します。
• Clear list（リストをクリア）
  フィールドの内容を削除し、空のリストに置き換えます。

Make changes to a list of things…（Thingのリストを変更）

このアクションは「Make changes to a thing」と同等ですが、
複数のエントリを一括で変更します。

Type of things（Thingのタイプ）

変更するThingのタイプを選択します。
実際のリストとの型整合性を検証するために必要です。

List to change（変更するリスト）

変更対象のリストを定義します。
これは検索結果またはThingのリストフィールドの内容を指定できます。
型が一致しない場合、式は赤く表示され、アクションは実行されません。

Changes（変更内容）

変更対象に適用する変更を一覧で指定します。
フィールド、操作、新しい値を設定します。

補足
一部のユーザーはこのアクションを、後続のワークフローで参照するためにリストを事前ロードする目的で使用しています。
ただし、このアクションは実行時に即座にクエリを発行し、ワークロードを消費 します。
その結果を後のステップで使用するかどうかに関わらず、実行されます。
このため、パフォーマンス面を考慮し、高度な用途として慎重に使用 することを推奨します。

Bubbleはこのユースケースに対応するため、
「ワークフローローカル変数」の概念を実装中です。

Delete thing…（Thingを削除）

データベースからThingを削除します。

To delete（削除対象）

削除するThingを選択します。

Delete a list of things…（Thingのリストを削除）

このアクションは「Delete thing」と同様ですが、複数のエントリを削除します。

Type of things（Thingのタイプ）

削除対象のThingのタイプを選択します。

List to delete（削除するリスト）

削除対象のリストを定義します。
検索結果またはThingリストフィールドの内容を使用できます。
型が一致しない場合、式は赤く表示され、アクションは実行されません。

Copy a list of things…（Thingのリストをコピー）

Thingのリストを複製します。

重要
パフォーマンスおよびセキュリティの理由により、初期リストの件数は 100件まで に制限されています。
それを超える場合、このアクションは何も実行しません。

Type of things（Thingのタイプ）

コピーするThingのタイプを選択します。

List to copy（コピーするリスト）

コピーするリストを定義します。
型が一致しない場合、式は赤く表示され、アクションは完了しません。

Set a Thing’s slug…（Thingのスラッグを設定）

既存のThingのスラッグ値を変更します。

Thing to change（変更するThing）

変更対象のThingを選択します。

Slug（ベータ版）

新しいスラッグ値を指定します。

Download data as CSV（データをCSVとしてダウンロード）

このアクションにより、ユーザーはデータをCSV形式でダウンロードできます。
独自の管理ページを作成する際に利用できます。
エンドユーザーは保存先を選択するよう求められます。
※この機能は 有料プランのユーザーのみ利用可能 です。

Type of data（データタイプ）

エクスポートするデータタイプを選択します。

Data source（データソース）

エクスポートするリストを定義します。

File name（ファイル名）

出力するファイル名を入力します。

Date formatting（日付フォーマット）

日付スタイルを選択します（Excel互換／完全表示（タイムゾーン付き）／カスタム）。

Separator（区切り文字）

CSVファイルで使用する区切り文字を選択します。

Include labels in first row（1行目にラベルを含める）

有効にすると、CSVの最初の行に列ラベルが含まれます。

Use field captions instead of IDs（IDの代わりにフィールド名を使用）

デフォルトではフィールドIDが列見出しになります。
チェックを入れると、Data Typesセクションで定義されたキャプション が使用されます。
※「Include labels in first row」を有効にしておく必要があります。

Wrap values in double quotes（値をダブルクオーテーションで囲む）

有効にすると、値が二重引用符で囲まれます。

Hidden columns（非表示列）

CSVに含めないフィールドを選択します。

Upload data as CSV（CSVをアップロード）

このアクションにより、CSVファイルをアップロードしてアプリのデータベースに追加できます。
各列は、選択したタイプのフィールドと一致する必要があります。
フィールドの型は以下に対応します：

• text（テキスト）
• number（数値）
• date（日付）
• address（住所）
• yes/no（真偽値）
• unique id（別のThingのユニークID）

リスト型フィールドへのアップロードは JSON配列 形式で行います。
他のデータタイプの配列（例：ユニークID配列）は現時点でサポートされていません。

重要
この機能は 有料プランのユーザーのみ利用可能 です。
1回のアップロードで追加できる件数は、プランによって制限されます。

Type of data（データタイプ）

アップロード対象のデータタイプを選択します。

CSV file（CSVファイル）

アップロードするファイルを指定します（通常はFile uploader要素を使用）。

Separator（区切り文字）

CSV内で使用する区切り文字を選択します。

Delete an uploaded file（アップロード済みファイルを削除）

このアクションは、アプリケーションストレージ内のアップロード済みファイルを削除します。
アプリがアップロードしたファイルのみ削除可能です。
ファイルが存在しない場合は何も実行しません。

注意
この操作はファイルを完全に削除します。
削除したファイルは復元できません。
また、ファイルを参照しているThingのURLは自動で削除されないため、必要に応じて
ワークフロー内で先にその参照をクリアしてください。

File URL（ファイルURL）

削除するファイルのURLを指定します。
例:

https://s3.amazonaws.com/appforest_uf/...
https://domain.com/fileupload/...（プライベートファイルの場合）

現在のユーザーにファイルの読み取り権限がない場合、削除することはできません。