参照
オンボーディングモーダルを実装する際のユーザーロールとベストプラクティスの参照情報。
ユーザーロール
オンボーディングモーダルには、構成と使用のために特定のロールのアサインが必要です。
| ロール | できること |
|---|---|
| admin | ガイダンスレコード、ガイダンスステップ、およびヘルプコンテンツを作成、編集、および削除するためのフルアクセス権。クライアントスクリプトと起動メカニズムを設定できます。すべての アダプションサービス モジュールにアクセスできます。 |
| help_content_admin | 完全な管理者権限なしで既存のガイダンスコンテンツを編集します。オンボーディング資料を管理するコンテンツ管理チームに役立ちます。 |
| ユーザー (任意のロール) | ロールに割り当てられたオンボーディングモーダルを表示して操作します。ステップをナビゲートし、質問に回答し、モーダルを却下または完了します。 |
ベストプラクティス
効果的なオンボーディングエクスペリエンスを作成するには、次のガイドラインに従ってください。
コンテンツデザイン
- ステップに重点を置く: 各ステップで 1 つの概念をカバーする必要があります。ユーザーが圧倒されないように、モーダルを最大 5 〜 7 ステップに制限します。
- 明確な言葉を使用する: 説明のない専門用語や専門用語は避けてください。経験の浅いユーザーペルソナ向けに書いてください。
- 視覚的なコンテキストを提供します。 機能がある場所を正確に示すスクリーンショットまたは注釈付き画像を含めます。ユーザーは視覚的な参照でよりよく学習できます。
- 出口を明確にする: 常に [後で] または [スキップ] オプションを指定します。重要な作業をブロックする必須のオンボーディングでユーザーを閉じ込めないでください。
技術的実装
- テーマ間でのテスト: ダーク、ライト、コーラルのテーマでのモーダルの外観を確認します。画像とテキストは、すべてのコンテキストで読み取り可能な状態を維持する必要があります。
- sys_id参照を検証します。 プログラムによるトリガーを使用する場合は、ガイダンスsys_idが正しいことを確認してください。無効な参照は、ユーザーが直面するエラーなしにサイレントで失敗します。
- 適切なロールを設定します。 モーダルロール要件を実際のユーザー集団に合わせます。過度に制限されたロールは、ユーザーがガイダンスを見ることができないことを意味します。過度に寛容なロールには無関係なコンテンツが表示されます。
- 説明的な名前を使用します。 保守性を考慮して、ガイダンスレコードと手順に明確な名前を付けます。今後の管理者は、すべてのコンテンツを読まずに目的を理解する必要があります。
メンテナンスと更新
- 四半期ごとにレビュー: 製品の更新や UI の変更により、オンボーディングコンテンツが古くなる可能性があります。正確性を維持するために、定期的なレビューをスケジュールします。
- ユーザーフィードバックの収集: フィードバックメカニズムを追加するか、オンボーディングについて言及しているヘルプデスクチケットを監視します。ユーザーは何が混乱しているのかを教えてくれます。
- バージョンコンテンツ: [ 順序] フィールドと [ステータス ] フィールドを使用して、コンテンツバージョンを管理します。変更を公開する前に、テスト用にドラフトバージョンを保持します。
- ドキュメントのカスタマイズ: カスタムクライアントスクリプトと起動メカニズムの外部ドキュメントを維持します。更新セットはすべての依存関係をキャプチャしない場合があります。