Content last updated 2026-05-26

組織フィールド

Zendesk 組織フィールドに関するドキュメント

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

組織フィールドを理解する

組織フィールドとは

組織フィールドは、Zendesk の組織に紐付くカスタムフィールドです。チケットフィールド (チケットに表示される) とは異なり、組織フィールドは組織自体に関する情報を保持します。

組織フィールドの管理方法

Zendesk は UI から組織フィールドをフルに管理する方法を提供していますが、私たちはよりバージョン管理されたメソドロジーを採用しています。これによって、定型化されたレビュープロセスや、必要に応じたロールバック等が可能になります。

そのため、私たちは同期リポジトリを利用しています。

組織フィールドの種類

GitLab で最もよく使われる種類は以下です:

名称API のタイプ値用途利用例
Checkboxcheckbox単一の true/false オプション“Self-Managed - Ultimate entitlement”
Datedate日付選択用“Expiration date”
Decimaldecimal小数を含む数値用“ARR associated”
Drop-downdropdown1 件選択可能なドロップダウン用“Highest plan level”
Multi-selectmultiselect複数選択可能なドロップダウン用“Subscription levels purchased”
Numericinteger小数を含まない数値用“Number of seats”
RegexregexpRegex 検証が必要なテキスト型フィールド用“Salesforce contact ID”
Texttext自由記述フィールド用“Account Manager”

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

現在の組織フィールド

現在のフィールドについて、データのソースは以下 3 つの領域のいずれかです:

  • Salesforce: データが Salesforce アカウントから直接来ているもの
  • Zendesk-Salesforce 同期: データが Zendesk-Salesforce 同期 によって決定されているもの
  • Agents: エージェントから (通常は内部リクエストフォーム経由で) 要求されたもの
Zendesk Global の場合
API キーの値フィールド名タイプ用途値のソース
account_ownerAccount OwnerTextアカウントマネージャー (AM) の名前を表示Salesforce
account_typeAccount TypeDrop-downアカウントの種類を表示Salesforce
am_project_idAM Project IDTextコラボレーションプロジェクト用の gitlab.com プロジェクト IDAgents
aarARRDecimalアカウントの Annual Recurring Revenue (ARR)Salesforce
assigned_seAssigned SEText割り当てられたサポートエンジニア (ASE) の Zendesk ユーザー IDAgents
technical_account_managerCustomer Success ManagerTextカスタマーサクセスマネージャー (CSM) の名前Salesforce
migration_dateDate to MigrateDate組織が別インスタンスへ移行する日付Zendesk-Salesforce 同期
org_in_escalated_stateEscalated StateCheckbox組織がエスカレーション状態にあるかどうかSalesforce
expiration_dateExpiration dateTextサブスクリプションの最新有効期限Salesforce
support_levelGitLab PlanDrop-downサブスクリプションのうち最上位のプランレベルSalesforce
ignore_deletionIgnore deletionCheckbox削除プロセスがこの組織をスキップすべきかどうかZendesk-Salesforce 同期
mark_for_deletionMark for deletionCheckbox削除プロセスがこの組織をレビューすべきかどうかZendesk-Salesforce 同期
migratingMigratingCheckbox組織が新しいインスタンスへ移行中かどうかZendesk-Salesforce 同期
seats_decimalNumber of SeatsDecimalサブスクリプションのうち最大シート数Salesforce
partner_customerPartner CustomerCheckboxアカウントが OEM パートナーからのものかどうかZendesk-Salesforce 同期
org_regionRegionDrop-down組織が属するリージョンSalesforce
restricted_accountRestricted AccountCheckboxアカウントに法的制限があるかどうかSalesforce
salesforce_idSalesforce IDText18 文字の Salesforce アカウント IDSalesforce
sales_segmentationSales SegmentationTextアカウントの規模 (従業員規模に基づく)Salesforce
sfdc_short_idSFDC Short IDText15 文字の Salesforce アカウント IDSalesforce
solutions_architectSolutions ArchitectTextソリューションアーキテクト (SA) の名前を表示Salesforce
sub_eduSubscription: Community - EDUCheckboxエンタイトルメント情報Salesforce
sub_ossSubscription: Community - OSSCheckboxエンタイトルメント情報Salesforce
sub_community_otherSubscription: Community - OtherCheckboxエンタイトルメント情報Salesforce
sub_consumption_cicd_minutesSubscription: Consumption - CI_CD MinutesCheckboxエンタイトルメント情報Salesforce
sub_consumption_eapSubscription: Consumption - Enterprise Agile PlanningCheckboxエンタイトルメント情報Salesforce
sub_consumption_duo_enterpriseSubscription: Consumption - GitLab Duo EnterpriseCheckboxエンタイトルメント情報Salesforce
sub_consumption_duo_amazon_qSubscription: Consumption - GitLab Duo powered by Amazon QCheckboxエンタイトルメント情報Salesforce
sub_consumption_duo_premiumSubscription: Consumption - GitLab Duo PremiumCheckboxエンタイトルメント情報Salesforce
sub_consumption_storageSubscription: Consumption - StorageCheckboxエンタイトルメント情報Salesforce
sub_dotcom_premiumSubscription: GitLab.com - PremiumCheckboxエンタイトルメント情報Salesforce
sub_dotcom_ultimateSubscription: GitLab.com - UltimateCheckboxエンタイトルメント情報Salesforce
sub_gitlab_dedicatedSubscription: GitLab DedicatedCheckboxエンタイトルメント情報Salesforce
sub_sm_premiumSubscription: Self-Managed - PremiumCheckboxエンタイトルメント情報Salesforce
sub_sm_ultimateSubscription: Self-Managed - UltimateCheckboxエンタイトルメント情報Salesforce
sub_ss_aseSubscription: Support Services - ASECheckboxエンタイトルメント情報Salesforce
sub_ss_growthSubscription: Support Services - Success AdvancedCheckboxエンタイトルメント情報Salesforce
sub_ss_enterpriseSubscription: Support Services - Success SignatureCheckboxエンタイトルメント情報Salesforce
support_holdSupport HoldCheckboxアカウントに保留があるかどうかSalesforce
Zendesk US Government の場合
API キーの値フィールド名タイプ用途値のソース
emergency_support_24x724x7 Emergency SupportCheckbox24x7 のエンタイトルメントを持つかどうかZendesk-Salesforce 同期
account_ownerAccount OwnerTextアカウントマネージャー (AM) の名前を表示Salesforce
account_typeAccount TypeDrop-downアカウントの種類を表示Salesforce
am_project_idAM Project IDIntegerコラボレーションプロジェクト用の gitlab.com プロジェクト IDAgents
arrARRDecimalアカウントの Annual Recurring Revenue (ARR)Salesforce
assigned_seAssigned SEText割り当てられたサポートエンジニア (ASE) の Zendesk ユーザー IDAgents
technical_account_managerCustomer Success ManagerTextカスタマーサクセスマネージャー (CSM) の名前Salesforce
migration_dateDate to MigrateDate組織が別インスタンスへ移行する日付Zendesk-Salesforce 同期
org_in_escalated_stateEscalated StateCheckbox組織がエスカレーション状態にあるかどうかSalesforce
expiration_dateExpiration DateTextサブスクリプションの最新有効期限Salesforce
ignore_deletionIgnore deletionCheckbox削除プロセスがこの組織をスキップすべきかどうかZendesk-Salesforce 同期
market_segmentMarket SegmentTextアカウントの規模 (従業員規模に基づく)Salesforce
mark_for_deletionMark for deletionCheckbox削除プロセスがこの組織をレビューすべきかどうかZendesk-Salesforce 同期
migratingMigratingCheckbox組織が新しいインスタンスへ移行中かどうかZendesk-Salesforce 同期
number_of_seatsNumber of SeatsIntegerサブスクリプションのうち最大シート数Salesforce
restricted_accountRestricted AccountCheckboxアカウントに法的制限があるかどうかSalesforce
salesforce_idSalesforce IDText18 文字の Salesforce アカウント IDSalesforce
sfdc_short_idSFDC Short IDText15 文字の Salesforce アカウント IDSalesforce
solutions_architectSolutions ArchitectTextソリューションアーキテクト (SA) の名前を表示Salesforce
sub_consumption_duo_enterpriseSubscription: Consumption - GitLab Duo EnterpriseCheckboxエンタイトルメント情報Salesforce
sub_consumption_duo_amazon_qSubscription: Consumption - GitLab Duo powered by Amazon QCheckboxエンタイトルメント情報Salesforce
sub_consumption_duo_premiumSubscription: Consumption - GitLab Duo PremiumCheckboxエンタイトルメント情報Salesforce
sub_gitlab_dedicatedSubscription: GitLab DedicatedCheckboxエンタイトルメント情報Salesforce
sub_sm_premiumSubscription: Self-Managed - PremiumCheckboxエンタイトルメント情報Salesforce
sub_sm_ultimateSubscription: Self-Managed - UltimateCheckboxエンタイトルメント情報Salesforce
sub_ss_aseSubscription: Support Services - ASECheckboxエンタイトルメント情報Salesforce
sub_usgov_12x5Subscription: US Government - 12x5Checkboxエンタイトルメント情報Salesforce
sub_usgov_24x7Subscription: US Government - 24x7Checkboxエンタイトルメント情報Salesforce
support_holdSupport HoldCheckboxアカウントに保留があるかどうかSalesforce
support_levelSupport LevelDrop-downサブスクリプションのうち最上位のプランレベルSalesforce

管理者タスク

組織フィールドを表示する

Zendesk 上の組織フィールドを表示するには:

  1. Zendesk インスタンスの管理ダッシュボードに移動します
  2. People > Configuration > Organization fields に移動します

注: 非アクティブな組織フィールドを表示したい場合は、Filter ボタンをクリックしてアクティブフィルターを変更する必要があるかもしれません。

組織フィールドを作成する

組織フィールドを作成するには、同期リポジトリで MR を作成する必要があります。具体的な変更内容はリクエスト次第です。組織フィールドのタイプによって正確な内容は異なります。

注: よく使われるフィールドタイプ向けのテンプレートを示しています。その他のタイプ (date、decimal、textarea、multiselect、regexp) については、type 属性を適宜変更し、タイプ固有の要件については Zendesk のフィールドドキュメント を参照してください。

ヒント: 下のフィールドタイプをクリックすると、それぞれのテンプレートが見られます。

checkbox
---
title: 'Your Title Here'
previous_title: 'Your Title Here'
description: 'Your description here'
key: 'Your API key name here'
type: 'checkbox'
active: true
position: 1 # Integer representing organization field position, controls display order on organization page (lower numbers appear first)
tag: 'tag_to_add_when_checked' # Added onto the organization when the checkbox is checked, field is not present for other types
regexp_for_validation: null # Always null unless "regexp"
custom_field_options: null # Always null unless "dropdown" or "multiselect"
text
---
title: 'Your Title Here'
previous_title: 'Your Title Here'
description: 'Your description here'
key: 'Your API key name here'
type: 'text'
active: true
position: 1 # Integer representing organization field position, controls display order on organization page (lower numbers appear first)
regexp_for_validation: null # Always null unless "regexp"
custom_field_options: null # Always null unless "dropdown" or "multiselect"
integer
---
title: 'Your Title Here'
previous_title: 'Your Title Here'
description: 'Your description here'
key: 'Your API key name here'
type: 'integer'
active: true
position: 1 # Integer representing organization field position, controls display order on organization page (lower numbers appear first)
regexp_for_validation: null # Always null unless "regexp"
custom_field_options: null # Always null unless "dropdown" or "multiselect"
dropdown
---
title: 'Your Title Here'
previous_title: 'Your Title Here'
description: 'Your description here'
key: 'Your API key name here'
type: 'dropdown'
active: true
position: 1 # Integer representing organization field position, controls display order on organization page (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. 組織フィールドのページ に移動します
  2. 削除したい組織フィールドを見つけて名前をクリックします
    • Filter ボタンをクリックしてアクティブフィルターを変更する必要があるかもしれません
  3. ページ右上の Actions をクリックします
  4. Delete をクリックします
  5. ポップアップの Delete をクリックして変更を送信します

例外的なデプロイを実施する

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

一般的な問題とトラブルシューティング

マージ後に組織フィールドの変更が反映されない

組織フィールドは Standard デプロイタイプに従うため、通常のデプロイサイクル中 (または例外デプロイが行われた場合) にのみデプロイされます。