コンテンツにスキップ
PynPyn

フォームフィールドの種類

フォームまたは投票のエディターでAdd Fieldを選ぶと、2つのカテゴリーを持つSelect Fieldが開きます。すべてのフィールドにはLabel、Description、そして許される場合にはRequiredがあります。Descriptionが設定されていると、Text、Likert Scale、Buddy、Mentorの各フィールドでは、Slackと回答ページ(およびCommonフィールドだけを表示するPreview)で回答者に見えるテキストがラベルから説明に置き換わります。Checkboxはラベルを見出しとして、説明をボックスの横に表示します。ラベルを表示するには説明を空のままにします。

フィールド 集めるもの 必須にできるか Slackでの表示 回答ページ(メール)での表示
Text 最大2,048文字の自由記述の回答。 できる。回答ページとWebhookで有効。Slackでは強制されない テキスト入力 テキスト入力
Checkbox trueまたはfalse。 できない。チェックなしも有効な回答 チェックボックス。投票では「✓ Yes」と「✗ No」のボタン チェックボックス。投票では「✓ Yes」と「✗ No」のボタン
Likert Scale 1〜5の数値:Very Dissatisfied、Dissatisfied、Neutral、Satisfied、Very Satisfied。 できる ラジオボタン。投票では5つのボタン ラジオボタン。投票では5つのボタン
Content 何も集めない。フィールドの間に表示される、画像とリンクを含む書式付きテキスト。 できない テキスト テキスト
フィールド 集めるもの 必須にできるか Slackでの表示 回答ページ(メール)での表示 書き込み先
Buddy ディレクトリの従業員1人。 できる Slackのユーザーピッカー 名前検索。2文字以上入力し、最大10件の候補から選ぶ プリンシパルのレコードのbuddyリレーション
Mentor ディレクトリの従業員1人。 できる Slackのユーザーピッカー 名前検索。2文字以上入力し、最大10件の候補から選ぶ プリンシパルのレコードのmentorリレーション

フォームに置けるBuddyとMentorのフィールドはそれぞれ最大1つです。プリンシパルはエンロールメントの対象となる従業員です。Webhookによる送信やキャンペーンのステップのように、エンロールメントの外で回答されたフォームでは、フォームが送られた人、またはペイロードが指定した従業員です。

回答ページの名前検索には、在籍中の従業員、入社予定者、休職中の人が表示され、退職者は表示されません。検索はメッセージの送信から14日間使えます。その後はフィールドが無効になり、「Choosing a person is no longer available for this form.」と表示されて必須ではなくなるため、フォームの残りの部分は送信できます。1つのリンクからの検索が多すぎると、フィールドには「This link has made too many searches.」と表示されます。

投票は同じピッカーを使いますが、どのフィールドも必須にできません。回答ページでは最初のクリックで投票が完了し、ページにはSubmittedと表示されて、それ以上のフィールドには回答できません。Slackでは各フィールドをクリックできます。投票の回答ページにTextフィールドは表示されないため、投票はリッカート尺度かチェックボックス1つに絞ってください。投票を参照してください。

Export to CSVは、employeeId、submissionId、続いてフィールドごとに1列を書き出します。列の見出しは、説明が設定されていればその説明、なければキーです。Contentフィールドは含まれません。リッカートの回答はその数値、チェックボックスはtrueまたはfalse、BuddyやMentorは選ばれた従業員のidとしてエクスポートされます。employeeIdはHRISでのその人のidで、PynがHRISのidを持っていない場合はunknownです。

エディターで追加したフィールドには生成されたキーが付きます。Webhookでは、ペイロードはフィールドをエイリアス、つまりラベルのキャメルケース(Job TitleはjobTitleになります)か、キーで指定します。ラベルから同じエイリアスが生成される2つのフィールドは、Webhookでは区別できません。BuddyやMentorのWebhookの値は、HRISのidではなくPynの従業員id(36文字)です。Webhook APIを参照してください。

  • フォームを作成する:フィールドを追加し、設定する方法です。
  • 投票:1クリックで答える形についてです。
  • Webhook API:ペイロードでのフィールドの指定方法です。