ユーザーフィールド

このガイドでは、GitLab における Zendesk ユーザーフィールドを作成、編集、管理する方法について説明します。管理者は管理者タスクセクションを確認してください。

ユーザーフィールドを理解する

ユーザーフィールドとは

ユーザーフィールドは、Zendesk のユーザープロフィールに添付されるカスタムフィールドです。チケットに表示されるチケットフィールドとは異なり、ユーザーフィールドにはユーザー自身に関する情報が保存されます。

ユーザーフィールドの管理方法

Zendesk は UI を通じてユーザーフィールドを完全に管理する方法を提供していますが、私たちはよりバージョン管理されたメソドロジーを採用しています。これにより、定められたレビュープロセス、必要に応じたロールバックの実行などが可能になります。

このため、同期リポジトリを使用しています。

ユーザーフィールドの種類

GitLab で最もよく使用する種類は次のとおりです:

完全な一覧については、Zendesk のドキュメントを参照してください

管理者タスク

ユーザーフィールドを表示する

Zendesk のユーザーフィールドを表示するには:

1. Zendesk インスタンスの管理ダッシュボードに移動します
   • Zendesk Global（本番環境）
   • Zendesk Global（サンドボックス）
   • Zendesk US Government（本番環境）
   • Zendesk US Government（サンドボックス）
2. People > Configuration > User fields に移動します
   • Zendesk Global
   • Zendesk Global（サンドボックス）
   • Zendesk US Government
   • Zendesk US Government（サンドボックス）

注記: 非アクティブなユーザーフィールドを表示する場合は、Filter ボタンをクリックしてアクティブなフィルターを変更する必要がある場合があります

ユーザーフィールドを作成する

ユーザーフィールドを作成するには、同期リポジトリで MR を作成する必要があります。正確な変更内容はリクエスト自体によって異なります。正確なコンテンツはユーザーフィールドの種類によって異なる場合があります。

注記: 一般的なフィールドタイプのテンプレートを表示します。その他のタイプ（date、decimal、textarea、multiselect、regexp）では、type 属性を適宜変更し、タイプ固有の要件についてZendesk フィールドのドキュメントを参照してください。

ヒント: 下の各フィールドタイプをクリックすると、テンプレートが表示されます。

---
title: 'Your Title Here'
previous_title: 'Your Title Here'
description: 'Your description here'
type: 'checkbox'
active: true
position: 1 # Integer representing user field position, controls display order in user profile (lower numbers appear first)
tag: 'tag_to_add_when_checked' # Added onto the user when the checkbox is checked
regexp_for_validation: null # Always null unless "regexp"
custom_field_options: null # Always null unless "dropdown" or "multiselect"

---
title: 'Your Title Here'
previous_title: 'Your Title Here'
description: 'Your description here'
type: 'text'
active: true
position: 1 # Integer representing user field position, controls display order in user profile (lower numbers appear first)
regexp_for_validation: null # Always null unless "regexp"
custom_field_options: null # Always null unless "dropdown" or "multiselect"

---
title: 'Your Title Here'
previous_title: 'Your Title Here'
description: 'Your description here'
type: 'integer'
active: true
position: 1 # Integer representing user field position, controls display order in user profile (lower numbers appear first)
regexp_for_validation: null # Always null unless "regexp"
custom_field_options: null # Always null unless "dropdown" or "multiselect"

---
title: 'Your Title Here'
previous_title: 'Your Title Here'
description: 'Your description here'
type: 'dropdown'
active: true
position: 1 # Integer representing user field position, controls display order in user profile (lower numbers appear first)
regexp_for_validation: null # Always null unless "regexp"
custom_field_options:
- name: 'Name of option'
  value: 'tag_option_uses'
- name: 'Name of option 2'
  value: 'tag_option_uses_2'

ピアが MR をレビューして承認した後、MR をマージできます。次回のデプロイ時に Zendesk に同期されます。

ユーザーフィールドを編集する

ユーザーフィールドを編集するには、同期リポジトリで MR を作成する必要があります。正確な変更内容はリクエスト自体によって異なります。

ピアが MR をレビューして承認した後、MR をマージできます。次回のデプロイ時に Zendesk に同期されます。

ユーザーフィールドのタイトルを変更する

ユーザーフィールドのタイトルを変更する必要がある場合は、現在の値を previous_title 属性にコピーしてから、title 属性を変更します。これにより、同期は更新対象のユーザーフィールドを引き続き特定できます。

ユーザーフィールドを無効化する

ユーザーフィールドを無効化するには、同期リポジトリで MR を作成する必要があります。この MR では、対応するアクションに対して次の操作を行う必要があります:

1. ファイルを active フォルダーから inactive フォルダーに移動します
2. active 属性の値を false に変更します

ピアが MR をレビューして承認した後、MR をマージできます。次回のデプロイ時に Zendesk に同期されます。

ユーザーフィールドを削除する

同期リポジトリは削除を実行しないため、Zendesk 自体から削除する必要があります。

ユーザーフィールドを削除するには:

1. Zendesk インスタンスの管理ダッシュボードに移動します
   • Zendesk Global（本番環境）
   • Zendesk Global（サンドボックス）
   • Zendesk US Government（本番環境）
   • Zendesk US Government（サンドボックス）
2. People > Configuration > User fields に移動します
   • Zendesk Global
   • Zendesk Global（サンドボックス）
   • Zendesk US Government
   • Zendesk US Government（サンドボックス）
3. 削除するユーザーフィールドを見つけて名前をクリックします
   • Filter ボタンをクリックしてアクティブなフィルターを変更する必要がある場合があります
4. ページ右上の Actions をクリックします
5. Delete をクリックします
6. ポップアップで Delete をクリックして変更を送信します

例外デプロイを実行する

ユーザーフィールドの例外デプロイを実行するには、該当するユーザーフィールド同期プロジェクトに移動し、スケジュールパイプラインページで同期項目の再生ボタンをクリックします。これにより、ユーザーフィールドの同期ジョブがトリガーされます。

よくある問題とトラブルシューティング

マージ後にユーザーフィールドの変更が表示されない

ユーザーフィールドは Standard デプロイタイプに従うため、通常のデプロイサイクル中（または例外デプロイが実行された場合）にのみデプロイされます

ページのソースコードを見る - ページの編集 - please contribute.