翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 説明文の表現エディタを使用する
<a name="using-narratives-expression-editor-step-by-step"></a>

次のウォークスルーは、説明文をカスタマイズする方法の例を示しています。この例では、期間対期間計算タイプを使用します。

1. 既存の分析から開始します。**期間対期間**インサイトを追加します。これを行う最も簡単な方法は、\$1 アイコンを選択してから [**Add insight (インサイトの追加)**] を選択し、リストから洞察の種類を選択することです。どのタイプの計算インサイトを自動説明文として追加できるかについては、[自動説明文が含まれるインサイト](auto-narratives.md)を参照してください。

   インサイトのタイプを選択したら、[**Select (選択)**] を選択してウィジェットを作成します。空の説明文を作成するには、テンプレートを選択せずにこの画面を閉じます。この例を実行するには、[**Period over period (期間対期間)**] を選択します。

   インサイトを追加した際に選択したビジュアルがある場合、フィールドウェルには、日付、メトリクス、カテゴリのフィールドがあらかじめ設定されています。これらは、洞察を作成したときに選択した視覚化からきています。必要に応じて、フィールドをカスタマイズできます。

   カスタマイズできるのは、新規または既存のインサイト (テキストベース) ウィジェットの説明文だけです。既存のビジュアル (チャートベース) にこれを追加することはできません。これはウィジェットの種類が異なるためです。

1. ビジュアル上のメニューを選択し、式エディタの説明文を編集したら、[**Customize narrative (説明文のカスタマイズ)**] を選択します。

   このコンテキストでは、[**Computations (計算)**] は、データを記述するためのテンプレートで参照できる定義済みの計算 (期間の経過、期間の経過、成長率、最大、最小、上位製品など) です。現在、Amazon Quick Sight はインサイトに追加できる 13 種類の計算をサポートしています。この例では、推奨インサイトパネルから**期間別の期間**テンプレートを選択することで、**PeriodOverPeriod** がデフォルトで追加されます。

1. 右下の [**Add computation (計算の追加)**] を選択して新しい計算を追加してから、リストから選択します。このチュートリアルでは、[**Growth rate (成長率)**] を選択してから [**Next (次へ)**] を選択します。

1. 計算する期間の数を選択して計算を設定します。デフォルト値は 4 で、この例で使用します。必要に応じて、画面上部で計算の名前を変更できます。ただし、ここでは名前は変更しないでください。
**注記**  
作成した計算名は、インサイトの中で一意です。説明文テンプレートで同じタイプの複数の計算を参照できます。たとえば、売上とユニットの 2 つのメトリクスがあるとします。名前が異なる場合は、それぞれのメトリクスに対して成長率計算を作成することができます。  
ただし、異常計算は、同じウィジェット内の他の計算タイプと互換性がありません。異常検出は、それ自体がインサイトの中に存在しなければなりません。同じ分析で他の計算を使用するには、それらを異常とは別のインサイトに入れます。

   続行するには、[**Add (追加)**] を選択します。

1. 右側の [**Computations (計算)**] を展開します。ストーリーの一部である計算はリストに表示されます。この場合は、[**PeriodOverPeriod**] と [**GrowthRate**] です。

1. ワークスペースで、末尾のピリオドの後に **Compounded growth rate for the last** のテキストを追加してから、スペースを追加します。

1. 次に、計算を追加するには、「**last**」という単語の後にあるスペースの後にカーソルを置きます。右側の [**GrowthRate**] で、[**timePeriods**] という名前の式を選択します (1 回だけクリックすると追加されます)。

   これを行うと、式 [**GrowthRate.timePeriods**] が挿入されます。これは、[**GrowthRate**] で設定した期間数です。

1. 文を ** days is ** (前後にスペースを置く) で完成させ、 **GrowthRate.compoundedGrowthRate.formattedValue** という式を追加してピリオド (`.`) を末尾に付けます。式を入力するのではなく、リストから式を選択します。ただし、追加した後で式の内容を編集することはできます。  
![\[エクスプレッションリストが開いているエクスプレッションエディター。\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/narrative-add-expression.png)
**注記**  
[**formattedValue**] 式は、フィールドの指標に適用されている書式設定に基づいて書式設定された文字列を返します。メートル法による計算を実行するには、代わりに [**value (値)**] を使用します。これは、raw 値を整数または 10 進数として返します。

1. 条件ステートメントとフォーマットを追加します。`formattedValue` 式の後のテンプレートの末尾にカーソルを置きます。必要に応じてスペースを追加します。[**Edit narrative (説明文の編集)**] メニューバーで、[**Insert code (コードを挿入)**] を選択し、一覧から [**Inline IF (インライン IF)**] を選択します。式ブロックが開きます。

1. 式ブロックを開いた状態で、式リストから [**GrowthRate**]、[**compoundedGrowthRate**]、[**value**] を選択します。式の末尾に **>0** を入力します。[**Save (保存)**] を選択します。まだカーソルを移動しないようにします。

   条件付きコンテンツの入力を求めるプロンプトが表示されたら、**better than expected\$1** と入力します。入力したテキストを選択したら、上部の書式設定ツールバーを使用してこのテキストを緑色と太字にします。

1. 前の手順を繰り返して、成長率がそれほど大きくなかった場合のために、別の式ブロックを追加します。ですが今回は、**<0** として、**worse than expected** というテキストを入力します。緑の代わりに赤にします。

1. [**Save (保存)**] を選択します。作成したカスタマイズ済みの説明文は、次のようになります。  
![\[カスタマイズされた説明文。\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/narrative-example-result.png)

式エディタは、ストーリーをカスタマイズするための洗練されたツールです。分析またはダッシュボード用に作成したパラメータを参照し、さらにカスタマイズするための一連の組み込み関数を使用することもできます。

**ヒント**  
空の説明文を作成するには、[**\$1**] アイコンを使用してインサイトを追加してから、[**Add insights (インサイトの追加)**] を選択します。ただし、テンプレートを選ぶのではなく、画面を閉じます。  
ストーリーをカスタマイズすることを始める最も良い方法は、構文を学ぶために既存のテンプレートを使うことです。