フォームフィールドの種類
フォームまたは投票のエディターでAdd Fieldを選ぶと、2つのカテゴリーを持つSelect Fieldが開きます。すべてのフィールドにはLabel、Description、そして許される場合にはRequiredがあります。Descriptionが設定されていると、Text、Likert Scale、Buddy、Mentorの各フィールドでは、Slackと回答ページ(およびCommonフィールドだけを表示するPreview)で回答者に見えるテキストがラベルから説明に置き換わります。Checkboxはラベルを見出しとして、説明をボックスの横に表示します。ラベルを表示するには説明を空のままにします。
Common
Section titled “Common”| フィールド | 集めるもの | 必須にできるか | 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 | 何も集めない。フィールドの間に表示される、画像とリンクを含む書式付きテキスト。 | できない | テキスト | テキスト |
Employee Fields
Section titled “Employee Fields”| フィールド | 集めるもの | 必須にできるか | 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つに絞ってください。投票を参照してください。
エクスポートでの扱い
Section titled “エクスポートでの扱い”Export to CSVは、employeeId、submissionId、続いてフィールドごとに1列を書き出します。列の見出しは、説明が設定されていればその説明、なければキーです。Contentフィールドは含まれません。リッカートの回答はその数値、チェックボックスはtrueまたはfalse、BuddyやMentorは選ばれた従業員のidとしてエクスポートされます。employeeIdはHRISでのその人のidで、PynがHRISのidを持っていない場合はunknownです。
キーとエイリアス
Section titled “キーとエイリアス”エディターで追加したフィールドには生成されたキーが付きます。Webhookでは、ペイロードはフィールドをエイリアス、つまりラベルのキャメルケース(Job TitleはjobTitleになります)か、キーで指定します。ラベルから同じエイリアスが生成される2つのフィールドは、Webhookでは区別できません。BuddyやMentorのWebhookの値は、HRISのidではなくPynの従業員id(36文字)です。Webhook APIを参照してください。
- フォームを作成する:フィールドを追加し、設定する方法です。
- 投票:1クリックで答える形についてです。
- Webhook API:ペイロードでのフィールドの指定方法です。