---
title: "辞書との仕事"
slug: "work-with-dictionaries"
abstract: "多言語サイトでの静的テキストの翻訳;コンテンツエディターでエントリを追加・整理し、GraphQL経由でアクセスできます。共有サイトの辞書にアクセスするには、フォールバックドメインを使いましょう。"
---
# 辞書との仕事

辞書を使ってラベル、ツールチップ、ボタン、その他多言語サイトで使われる静的なテキストを翻訳します。各テキストとその翻訳は辞書内の項目として表現されています。辞書は、すべてのローカライズされたコンテンツを一つの中央から管理するのに役立ちます。

マルチサイトソリューションでは、共有サイトに辞書エントリを作成し、他のサイトではフォールバックドメインオプションを使って共有サイトの辞書を参照します。

サイトを作成すると、次の経路で自動的に辞書が作成されcontent/{COLLECTION\_NAME}/{SITE\_NAME}/:

![The Content Editor interface showing a dictionary created at the path sitecore/content/collection-name/site-name](https://doc.sitecore.com/api/markdown-image/sai/ja/developers/sitecoreai/images/dictionary_content_editor.png)

各辞書項目には2つの属性があります:

-   **キー** - 辞書エントリの識別子(例:AboutUsLabel)。
-   **フレーズ** - 言語のローカライズされたテキスト文字列。

## 辞書のエントリを作成する

辞書のエントリーを作成するには:

1.  コンテンツエディターを開き、 /sitecore/content/{COLLECTION\_NAME}/{SITE\_NAME}/Dictionaryに移動します。
2.  辞書の項目を追加するには、以下のいずれかを行います。
    -   右クリックで**辞書**を選び、その後「辞**書のエントリ**ー >**挿入**」をクリックします。翻訳するテキストに関連して名前を定義できます。例えば、*AboutUs*。次に、エントリ内の**キー**と**フレーズ**を定義します。例えば、*AboutUsLabel*:
        
        ![The Content Editor interface showing the AboutUs entry created in the dictionary path](https://doc.sitecore.com/api/markdown-image/sai/ja/developers/sitecoreai/images/aboutus-label.png)
        
    -   あるいは、辞書のエントリーをアルファベット順のフォルダ内に作成することで、見つけやすく管理しやすくすることもできます。以下の例は、**A**とラベル付けされた辞書フォルダーと、その中に*A*で始まる**AboutUs**エントリを示しています。
        
        ![The Content Editor interface showing the hierarchical structure for the dictionary, folder A, and the AboutUs entry inside the folder](https://doc.sitecore.com/api/markdown-image/sai/ja/developers/sitecoreai/images/alphabeticalOption.png)
        

ルート辞書フォルダ内やアルファベット順フォルダ内でも、任意の数のエントリーを定義できます。異なる言語ではキー値は同じですが、サイトの言語に応じてフレーズの値を定義します。エントリを作成した後は、GraphQLクエリまたはコード内から[Dictionary Service](https://doc.sitecore.com/sai/en/developers/jss/22/jss-sai/fetch-dictionary-data-with-the-jss-graphql-dictionary-service.html)を使ってアプリケーション固有の辞書データを取得JSS GraphQLできます。

辞書エントリを作成または更新した後、個々の辞書エントリを公開してもExperience Edgeの辞書データは更新されません。Experience Edgeで辞書の変更を利用可能にするには、以下のいずれかを再公開してください:

-   サイトのルート項目(/sitecore/content/<site-collection>/<site>)、または
    
-   辞書ドメイン項目(/sitecore/content/<site-collection>/<site>/Dictionary)です。
    

どちらかの再出版で十分です。子どもや関連項目を公開する必要はありません。

辞書データはSitecore辞書APIに依存しています。デフォルトでは、フレーズが空の場合、APIは代わりに辞書キーを返します。

> !重要辞書キーではドット表記はパスセパレータとして解釈され、キーの一部として扱われないため使えません。例えば、辞書キー select.itemは解決されません。これは基盤となるNext.jsローカライゼーションライブラリの制限です。

## マルチサイトソリューションで辞書を共有する

マルチサイトソリューションでは、共有サイトと複数のサイトがコレクションにある場合、辞書のエントリはデフォルトで他のサイトと共有されません。辞書を共有するには、別のサイトの**Fallback Domain**設定を使い、共有サイトで作成した辞書を指し示す必要があります。

辞書を共有する場合:

1.  前述のように共有サイト内に辞書を作成し、その共有サイトを [公開](https://doc.sitecore.com/sai/en/users/sitecoreai/publish-content-in-sitecoreai.html) します。
    
2.  辞書を共有したいコレクション内の別のサイトで、コンテンツエディターを開き、/sitecore/content/{COLLECTION\_NAME}/{ANY\_SITE\_NAME}/Dictionaryに移動します。
    
3.  **データ**セクションで、**Fallback Domain**フィールドを共有サイト辞書に示し、そこで辞書エントリを作成しています:/sitecore/content/{COLLECTION\_NAME}/{SHARED\_SITE\_NAME}/Dictionary
    
    ![Sitecore Content Editor interface showing Dictionary with Fallback Domain pointing to the site where dictionary entries are created.](https://doc.sitecore.com/api/markdown-image/sai/ja/developers/sitecoreai/images/fallbackDomain.png)
    
4.  コレクション内の共有辞書を使用しているすべてのサイトについても繰り返します。