ダイナミックコンテンツ

このガイドでは、GitLab における Zendesk ダイナミックコンテンツの作成、編集、管理方法について説明します（Zendesk Global でのみ使用）。管理者は管理者タスクセクションを確認してください。

ダイナミックコンテンツを理解する

ダイナミックコンテンツとは?

Zendesk によると:

ダイナミックコンテンツは、テキストのデフォルトバージョン（通常はデフォルト言語と同じ言語）と、サポートするその他のすべての言語のバリアントの組み合わせです。

私たちのダイナミックコンテンツの管理方法

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

そのため、私たちは同期リポジトリと管理コンテンツリポジトリを利用しています。

テーマでダイナミックコンテンツを使用する

テーマでダイナミックコンテンツアイテムを呼び出すには、以下のヘルパーを使用します:

{{dc 'item_to_call'}}

item_to_call をアイテムの placeholder 属性（中括弧と dc. コンポーネントを除いたもの）に置き換えます。

その他の領域でダイナミックコンテンツを使用する

テーマ以外でダイナミックコンテンツアイテムを呼び出すには、raw 属性内でダイナミックコンテンツアイテムの placeholder 属性を使用します。

使用する正確な raw 属性はアイテムごとに異なりますが、最も一般的な領域は次のとおりです:

• raw_display_name — チケットフォームでフォームの名前をダイナミックコンテンツアイテムとして表示する
• raw_title_in_portal — チケットフィールドでダイナミックコンテンツアイテムをフィールドのタイトルとして表示する
• raw_description — チケットフィールドでダイナミックコンテンツアイテムをフィールドの説明として表示する
• raw_name — チケットフィールドの custom_field_options 属性下のエントリで、ドロップダウンオプションをダイナミックコンテンツアイテムとして表示する

テキスト（コメントやメールなど）への挿入については、テキスト自体にダイナミックコンテンツアイテムの placeholder 属性を挿入するだけです。

管理者タスク

ダイナミックコンテンツアイテムを作成する

ダイナミックコンテンツアイテムを作成するには、同期リポジトリでマージリクエストを作成する必要があります。具体的な変更内容は、依頼自体に依存します。利用可能な開始テンプレートは以下のとおりです:

---
name: 'Name of item here'
placeholder: 'placeholder item (see below)'
default_locale_id: 1 # English
variants:
- content: 'content_to_use'
  locale_id: 1 # English
  active: true
  default: true

placeholder 属性は次の形式です:

1. 名前を小文字に変換します
2. スペースをアンダースコアに置き換えます
3. dc. というプレフィックスをつけます
4. 二重中括弧で囲みます: {{dc.placeholder_name}}

例として、Preferred Region for Support は {{dc.preferred_region_for_support}} になります。

プレースホルダーが何になるかわからない場合の便利なテクニックは、Zendesk インスタンスのサンドボックスに移動して、管理パネルでダイナミックコンテンツアイテムを作成し、生成されたものを確認することです（これを行う場合は、後で必ず削除してください）。

default_locale_id または locale_id のロケールについて詳しく知る必要がある場合は、Zendesk API を使ってアクティブなロケールのリストを取得できます。

ピアによるレビューと承認の後、マージリクエストをマージできます。次のデプロイメントが行われる際に、Zendesk に同期されます。

ダイナミックコンテンツアイテムを編集する

ダイナミックコンテンツアイテムを編集するには、同期リポジトリでマージリクエストを作成する必要があります。具体的な変更内容は、依頼自体に依存します。

ピアによるレビューと承認の後、マージリクエストをマージできます。次のデプロイメントが行われる際に、Zendesk に同期されます。

ダイナミックコンテンツアイテムを削除する

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

ダイナミックコンテンツアイテムを削除するには:

1. Zendesk インスタンスの管理ダッシュボードに移動します
   • Zendesk Global (production)
   • Zendesk Global (sandbox)
2. Workspaces > Agent tools > Dynamic content に移動します
   • Zendesk Global
   • Zendesk Global (sandbox)
3. 削除したいダイナミックコンテンツアイテムを見つけ、その横（右端）にある delete をクリックします
4. OK をクリックして変更を送信します

例外デプロイメントを実行する

ダイナミックコンテンツの例外デプロイメントを実行するには、対象のダイナミックコンテンツ同期プロジェクトに移動し、スケジュールパイプラインのページに移動して、同期項目の再生ボタンをクリックします。これにより、ダイナミックコンテンツの同期ジョブがトリガーされます。

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

マージ後にダイナミックコンテンツの変更が反映されない

ダイナミックコンテンツは Standard デプロイメントタイプに従うため、通常のデプロイメントサイクル（または例外デプロイメントが行われたとき）にのみデプロイされます。

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