Fields (フィールド)
すべての入力フィールドと出力フィールドには型があります。基本的な型は5種類あります。
- Text(テキスト)
- Number(数値)
- True/False
- Date & Time(日時)
- File(ファイル)
上記の型を組みあわせた特殊な型も2種類あります。
- Object(オブジェクト):オブジェクトはキーと値の集合です。それぞれの値は異なる型にすることができます。たとえば、Customer(顧客)オブジェクトであれば、テキスト文字列のFirst Name(名)とLast Name(姓)、数値のID、日時のSign Up(契約日)などで構成されることが考えられます。
- List(リスト):リストは、数値のリストやオブジェクトのリストなど、すべて同じ型のアイテムの集合です。
フィールド型エラー
フローでエラーが発生した場合、まずはフィールドの型を確認する必要があります。
たとえば、数値が[Number(数値)]型ではなく[Text(テキスト)]型に設定されている場合、数値の並べ替えは誤って行われます。入力フィールドであれば、カードは入力値を入力フィールドに指定されている型に自動的に変換します。
関数またはアクションで特定の型が想定されるときに、変換不能な別の型のデータを受信した場合も型の不一致が生じます。たとえば、Math - Add関数は入力としてテキストを受け付け、それを数値に変換します。10
とpotato
を追加すると、数値10
は文字列として10に変換されますが、potato
という文字列を数値に変換する方法は不明です。
カスタム出力フィールドでは、型を正しく設定しなければエラーが発生する可能性があります。たとえば、数値を受け付けるが、それをオブジェクトとして渡すような定義はしないでください。
Custom Fields(カスタムフィールド)
多くのカードでは、独自の入力フィールドと出力フィールドを作成できます。該当する場合、[Click or drag to create(クリックまたはドラッグして作成)]
(カスタム出力用)または[Click or drop to create(クリックまたはドロップして作成)]
(カスタム入力用)と書かれ、無効化されたフィールドが表示されます。フィールドをクリックすると、一意の名前を付けられるようになります。
出力を入力までドラッグすると、カスタムフィールドはドラッグ元とドラッグ先の名前と型を取得します。たとえば、Math-Add関数には2つの入力が定義されていますが、3つ以上の数値を追加できるように入力を追加できます。
Dynamic fields(動的フィールド)
一部のカードには、動的フィールドが含まれます。例:
- Google Sheets - Read Row:出力フィールドは、選択したスプレッドシートの列見出しに対応します。
- Salesforce - Find Record:入力は、検索対象レコードの型に依存します。
カードの共通の警告
The fields below may change(次のフィールドは変化する場合があります)
この警告は、次の場合にイベントカードまたはアクションカードで表示されます。アプリに接続していない場合、アカウントを選択していない場合、または必須パラメーターが見つからない場合。
カードの入力または出力が、選択したアカウントとパラメーターに依存する場合。
この警告をクリアするには、接続を追加または更新して入力と出力を再同期させる必要があります。カードの端にある歯車アイコンを通じて[Choose Fields(フィールドの選択)]設定メニューを表示し、閉じます。
Some fields failed to load(一部のフィールドの読み込みに失敗しました)
この警告は、次の場合にイベントカードまたはアクションカードで表示される場合があります。アカウントの構成が不適切な場合。
ネットワークエラーにより、フィールドを読み込めない場合。