Content last updated 2026-07-14

組織フィールド

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

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

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

組織フィールドとは

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

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

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

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

組織フィールドの種類

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

名前API タイプ値目的使用例
チェックボックスcheckbox単一の true/false オプション「Self-Managed - Ultimate entitlement」
日付date日付選択用「有効期限」
小数decimal小数を使用する数値用「関連する ARR」
ドロップダウンdropdown1 つの選択を許可するドロップダウン用「最高プランレベル」
複数選択multiselect複数選択を許可するドロップダウン用「購入済みサブスクリプションレベル」
数値integer小数を使用しない数値用「シート数」
正規表現regexpRegex 検証が必要なテキスト形式フィールド用「Salesforce 連絡先 ID」
テキストtext自由形式フィールド用「アカウントマネージャー」

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

現在の組織フィールド

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

  • Salesforce: データは Salesforce アカウントから直接取得されます
  • Zendesk-Salesforce sync: データはZendesk-Salesforce syncを通じて決定されます
  • エージェント: エージェントからリクエストされます(通常は内部リクエストフォーム経由)
Zendesk Global 用
API キー値フィールド名タイプ目的値のソース
account_ownerAccount OwnerTextAccount Manager (AM) の名前を表示するSalesforce
account_typeAccount TypeDrop-downアカウントのタイプを表示するSalesforce
am_project_idAM Project IDTextコラボレーションプロジェクトの gitlab.com プロジェクト IDエージェント
aarARRDecimalアカウントの年間経常収益 (ARR)Salesforce
assigned_seAssigned SETextAssigned Support Engineer (ASE) の Zendesk ユーザー IDエージェント
technical_account_managerCustomer Success ManagerTextCustomer Success Manager (CSM) の名前Salesforce
migration_dateDate to MigrateDate組織が別のインスタンスに移行する日付Zendesk-Salesforce sync
org_in_escalated_stateEscalated StateCheckbox組織がエスカレーション状態にあるかどうかSalesforce
expiration_dateExpiration dateTextサブスクリプションの最新の有効期限Salesforce
support_levelGitLab PlanDrop-downサブスクリプションの最高レベルプランSalesforce
ignore_deletionIgnore deletionCheckbox削除プロセスでこの組織をスキップするかどうかZendesk-Salesforce Sync
mark_for_deletionMark for deletionCheckbox削除プロセスでこの組織をレビューするかどうかZendesk-Salesforce Sync
migratingMigratingCheckbox組織が新しいインスタンスに移行中かどうかZendesk-Salesforce Sync
seats_decimalNumber of SeatsDecimalサブスクリプション内の最大シート数Salesforce
partner_customerPartner CustomerCheckboxアカウントが OEM パートナーのものかどうかZendesk-Salesforce sync
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 ArchitectTextSolutions Architect (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 sync
account_ownerAccount OwnerTextAccount Manager (AM) の名前を表示するSalesforce
account_typeAccount TypeDrop-downアカウントのタイプを表示するSalesforce
am_project_idAM Project IDIntegerコラボレーションプロジェクトの gitlab.com プロジェクト IDエージェント
arrARRDecimalアカウントの年間経常収益 (ARR)Salesforce
assigned_seAssigned SETextAssigned Support Engineer (ASE) の Zendesk ユーザー IDエージェント
technical_account_managerCustomer Success ManagerTextCustomer Success Manager (CSM) の名前Salesforce
migration_dateDate to MigrateDate組織が別のインスタンスに移行する日付Zendesk-Salesforce sync
org_in_escalated_stateEscalated StateCheckbox組織がエスカレーション状態にあるかどうかSalesforce
expiration_dateExpiration DateTextサブスクリプションの最新の有効期限Salesforce
ignore_deletionIgnore deletionCheckbox削除プロセスでこの組織をスキップするかどうかZendesk-Salesforce Sync
market_segmentMarket SegmentTextアカウントの規模(従業員数に基づく)Salesforce
mark_for_deletionMark for deletionCheckbox削除プロセスでこの組織をレビューするかどうかZendesk-Salesforce Sync
migratingMigratingCheckbox組織が新しいインスタンスに移行中かどうかZendesk-Salesforce Sync
number_of_seatsNumber of SeatsIntegerサブスクリプション内の最大シート数Salesforce
restricted_accountRestricted AccountCheckboxアカウントに法的制限があるかどうかSalesforce
salesforce_idSalesforce IDText18 文字の Salesforce アカウント IDSalesforce
sfdc_short_idSFDC Short IDText15 文字の Salesforce アカウント IDSalesforce
solutions_architectSolutions ArchitectTextSolutions Architect (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 デプロイタイプに従うため、通常のデプロイサイクル中(または例外デプロイが実行された場合)にのみデプロイされます