# ボタンの作成 ボタンを使用すると次を実行できます。 * アプリケーションでの選択とナビゲーションを容易にするクイック リンクの追加 * データをリロード 編集中のシートにボタンを作成できます。これは、選択を行ってから別のシートに移動するボタンを作成する方法を示しています。アクションを実行するボタン、またはナビゲートするボタンを作成することもできます。 次の手順を実行します。 1. [アセット] パネルで [チャート] を開き、 [ダッシュボード オブジェクト] から [ボタン] オブジェクトをシートにドラッグします。 2. プロパティ パネルの [アクション] で [アクションの追加] をクリックします。 3. 使用するアクションを選択します。 一部のアクションでは、アクションの詳細を提供する必要があります。たとえば、[Select values in a field] アクションの場合、項目を選択し、その項目で選択する値を指定する必要があります。 4. [Navigation (ナビゲーション) ] で使用するナビゲーションオプションを選択します。別のシート、ストーリーまたは Web サイトにナビゲートできます。 5. プロパティパネルの [基本] の下の [ラベル] にボタンのラベルを設定します。 これで、データを選択し、選択したアプリケーション内の場所にナビゲートするボタンが表示されます。 ## アクションを設定します ボタンがクリックされたときに実行される1つ以上のアクションを追加できます。一部のアクションでは、アクションの詳細を提供する必要があります。 アクションは、[アクション] にリストされている順序で実行されます。アクションをドラッグして順序を変更できます。 実行時評価のオンとオフを切り替えて、ボタン内の数式がいつ評価されるかを変更します。この設定がオフの場合、ボタン内の数式 (変数の値の式など) は互いに独立して評価されます。この設定をオンにすると、各アクションの数式がアクションの実行時に評価されます。これにより、アクションに設定された数式の値をチェーン内の将来のアクションに引き継ぐことができます。 ヒント メモボタンでナビゲーションを実行するだけの場合、アクションを追加する必要はありません。 ### 関連動画コンテンツ ボタン アクションの構成は、シート アクションの設定と似ています。主な違いは次のとおりです。 * シートがフォーカスされているオブジェクトの場合、シート アクションはプロパティ パネルの [アクション] で構成されます。 * ボタン アクションは、ボタンが選択されたときにプロパティ パネルの [アクションとナビゲーション] で構成されます。 * ボタンとシートでは、使用できるアクションが一部異なります。 シート アクションの構成を説明する動画コンテンツについては、「[シートへのアクションの追加](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Sheets/setting-sheet-actions.htm)」を参照してください。 ### ブックマークの適用 選択したブックマークで定義されている選択を適用できます。 ### 選択をすべてクリアする アプリケーションのすべての状態において、すべての選択をクリアできます。オプションで、ロックされた選択を上書きできます。 ### 他の項目の選択をクリア 指定したものを除くすべての項目から選択をクリアできます。オプションで、ロックされた選択を上書きできます。 指定した項目で何も選択されていない場合は、この項目のすべての値が選択されます。 ### 選択で前に進む 選択履歴を1ステップ進めることができます。 ### 選択で後ろに進む 選択履歴を1ステップ戻すことができます。 ### 項目の選択をクリア 指定した項目からすべての選択をクリアできます。 ### すべての選択をロック アプリケーション内のすべての選択をロックできます。 ### 特定の項目をロック 指定した項目で選択をロックできます。 ### すべての選択をロック解除 アプリケーション内のすべての選択をロック解除できます。 ### 特定の項目をロック解除 指定した項目で選択をロック解除できます。 ### 項目のすべての値を選択 指定した項目で全ての値を選択できます。オプションで、ロックされた選択を上書きできます。 ### 項目の値を選択 指定した項目で値のリストを選択できます。選択する値をセミコロンで区切ります。オプションで、ロックされた選択を上書きできます。 情報メモ項目は、日付、日付と時刻、または通貨データ型では使用できません。 情報メモこのボタン アクションでは、テキストとして保存または分類されている数値は選択されません。この目的のためには、代わりに [検索条件に一致する値を選択] アクションを使用してください。 ### 検索条件に一致する値を選択 指定した検索条件からの検索結果に一致する値すべてを選択できます。検索条件は、文字列として指定する必要があります。オプションで、ロックされた選択を上書きできます。 * 数式を使用する場合は、数式を一重引用符で囲む必要があります。例: [='=Sum([Sales Amount]) > 200000'] * 文字列の一部を検索する場合は、ワイルド カード (\*, ?,^) を使用する必要があります。ワイルド カードを使用しない場合は、完全に一致する文字列のみが選択されます。 ### 代替値を選択 指定した項目で、すべての代替値を選択します。オプションで、ロックされた選択を上書きできます。 ### サイクリック軸に移動 選択したサイクリック軸内の項目を前後にサイクルさせます。 #### 制限事項 サイクリック軸に移動には次の制限があります。 * Qlik Analytics モバイル アプリでは、ステップ サイクリック軸に移動を持つボタンは、ボタンがコンテナ内にある場合は軸のみをサイクルします。 * Qlik Analytics モバイル アプリでは、ステップ サイクリック軸に移動を持つボタンは、オフライン モードでは軸をサイクルしません。 [Adding step cyclic dimensions to button](https://play.vidyard.com/t2UCwyGFhDr2CHZc1L1Zp5) ### アクティブな項目を設定 サイクリック軸内のアクティブな項目を設定します。 #### 制限事項 [アクティブな項目を設定] には、次の制限があります。 * [アクティブな項目を設定] は、サイクリック軸内の選択した項目の位置を使用します。サイクリック軸内で項目の順序が変更された場合、 [アクティブな項目を設定] では、最初に選択した項目と同じ位置の項目が使用されます。これを解決するには、ボタンのプロパティで項目を再度選択します。 ### 除外値を選択 指定した項目で、除外されている値をすべて選択します。オプションで、ロックされた選択を上書きできます。 ### 項目で可能な値を選択 指定した項目で、すべての可能な値を選択します。オプションで、ロックされた選択を上書きできます。 ### 項目選択の切り替え 現在の選択と、検索文字列で定義された選択を追加する選択とを切り替えるようにボタンを設定できます。検索文字列内のワイルドカードを使用することができます。値のリストを定義する場合は、形式(A|B)を使用する必要があります。AとBは選択する値です。 ### 変数値の設定 変数に値を割り当てることができます。 ### データのリロード ロード スクリプトを実行して、データをリロードできます。 [部分的なリロード] を選択することもできます。詳しくは「[部分的なリロード](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptPrefixes/PartialReload.htm)」を参照してください。 ### ダイナミック ビューを更新 現在の選択条件に基づいて、シート上のすべての動的オブジェクトの表示を更新します。 ### オートメーションの実行 シート上のボタンから、Qlik Automate で作成したオートメーションを実行できます。アプリケーション内で行った選択内容を含めたり、追加の入力値をオートメーションに渡したりできます。詳細については、「[Qlik Automate](https://alphahelp.qliktech.com/ld/en-US/cloud-services/Subsystems/Hub/Content/Sense_QlikAutomation/introduction/home-automation.htm)」を参照してください。 #### 推奨されるアプローチ: 共有スペース オートメーションを共有スペースに配置し、ユーザーに [編集可能] アクセス権を付与します。[編集可能] アクセス権を持つユーザーは、オートメーションを変更することなく実行できます。 このアプローチには、次のような重要な利点があります。 * ユーザーは、静的な実行トークンではなく、自身のトークンを使用して認証します。そのため、Qlik Cloud にサインインしている必要があります。 * オートメーションはユーザーの ID で実行されるため、実行したユーザーを監査できます。 * スペース ロールに関係なく、オートメーションの所有者のみが編集できます。 次も可能です。 * 現在のアプリの選択をオートメーションに渡すには、 [選択を含める] を選択します。 * 各パラメーターのキーと値を定義して、オートメーション固有の値の入力パラメーターを追加します。 * [入力ブロックをコピー] をクリックして、生成された入力構造をオートメーションにコピーします。 #### 代替アプローチ: トリガー モード 共有スペースの設定がユース ケースに合わない場合は、代わりに [実行モード: トリガー] を使用できます。このモードを使用すると、シートへのアクセス権を持つすべてのユーザーが、オートメーションに直接アクセスできるかどうかに関係なく、オートメーションを実行できます。 次の制限事項とリスクに注意してください。 * シートとボタンへのアクセス権を持つユーザーは、誰でもオートメーションを実行できます。 * ボタンがクリックされると、ブラウザのネットワーク トラフィックに実行トークンが表示されます。 * オートメーションは、ユーザーの資格情報ではなく、所有者の資格情報を使用して実行されます。 * セクション アクセスを使用しているアプリでは、この機能によって、クリックしたユーザーがセクション アクセスのルール上は通常アクセスできないデータにアクセスできるようになる可能性があります。 * トークンを使用すると、Qlik Cloud の外部からオートメーションを呼び出すことができます。 * ボタン オブジェクト定義内の実行トークンを更新するには、エディターでの対話型ユーザー セッションが必要となるため、変数オートメーション ID は使用できません。 #### オートメーションの実行の構成 次の手順を実行します。 1. プロパティ パネルの [アクションとナビゲーション] で、[アクションの追加] をクリックします。 2. [アクション] で [オートメーションの実行] を選択します。 3. [オートメーション] で、アクションとしてトリガーするオートメーションを選択します。 利用可能なオートメーションはドロップダウン メニューに表示されます。 4. [選択を含む] ボックスを選択します。 このオプションを選択すると、現在選択されている項目にブックマークが作成されます。次の入力が含まれます。 * アプリ ID * ブックマーク ID * シート ID * ユーザー ID * スペース ID * テナント ID * 時間 アプリケーション ID とブックマーク ID はオートメーションの入力として使用され、オートメーションの実行時にデータ選択を適用するために使用されます。 5. オプションとして、共有スペースが適しておらず、シートへのアクセス権を持つすべてのユーザーがオートメーションを実行できるようにする場合は、 [実行モード: トリガー済み] を選択します。 このオプションを設定するには、そのオートメーションの所有者でもある必要があります。このモードを使用する前に、上記のセキュリティに関する注意事項を参照してください。 6. オートメーションの実行にパラメータが必要な場合は、次の操作を実行します。 1. [入力パラメータの追加] をクリックします。 2. [キー] の下にパラメータ ID を入力します。 3. [値] の下に、使用する値を入力します。 4. 必要なパラメータがあれば繰り返します。 7. オートメーションのボタンに入力ブロックを貼り付けるには、[入力ブロックをコピー] をクリックします。 オートメーションに貼り付けると、ボタン情報が入力ブロックとして渡されます。 [[アクティブ インテリジェンス チュートリアル](https://help.qlik.com/en-US/cloud-services/Subsystems/ApplicationAutomation/Content/tutorials/active-intelligence.htm) (英語のみ)] を使用して、ボタンをオートメーションに接続する方法を学びます。 #### オートメーションの実行 の制限 オートメーションの実行 には、次のような制限があります。 * [オートメーション] の下には、選択肢として最大 100 件のオートメーションを表示できます。100 件以上のオートメーションにアクセスしても、目的のオートメーションが見つからない場合は、オートメーション ID を使用することができます。オートメーション ID は、 URL の /edit または /history の前、/editor/ の後のセグメントです。 例えば、qlik.com/automations/editor/6c201b49-cz2e-00dc-8040-464ca41457b0/edit?resourceName=Active%20Intelligence では、オートメーション ID が 6c201b49-cz2e-00dc-8040-464ca41457b0 となっています。 * [オートメーションの実行] を使用したボタンは、Qlik Sense Mobile でサポートされていません。 * [オートメーションの実行] を使用して Qlik レポート ブロックを含むオートメーションを実行した場合、選択項目がオートメーションのレポートに渡されません。セッション状態 Qlik Automate は、Qlik レポート サービス に渡されるレポート構成の定義に転送できません。その結果、レポート構成とデータは選択項目を反映しません。 警告メモセクション アクセスを使用するアプリの場合、自動化されたレポートは、レポートをトリガーするユーザーではなく、オートメーションの所有者の資格情報を使用して実行されます。これにより、アプリケーション セクション アクセス ルールではユーザーにアクセス権がないデータが公開される可能性があります。 * [オートメーションの実行] は、埋め込まれたボタンについてサポートされていません。 * ボタンによってトリガーされたオートメーションの実行に 10 分以上かかる場合、オートメーションが終了しても通知は送信されません。 ## ナビゲーション ボタンをクリックすると、別のシート、ストーリー、または Web サイトにナビゲートすることを選択できます。単純なナビゲーションボタンを作成する場合、アクションを指定する必要はありません。ボタンは、一度に 1 つのナビゲーション オプションしか持つことができません。 情報メモストーリーでは、ナビゲーションに対応していません。 ### 次のシートの表示 次のシートに順番に移動します。 ### 前のシートの表示 前のシートに順番に移動します。 ### 最後のシートの表示 最後のシートに移動します。 ### 最初のシートの表示 最初のシートに移動します。 ### シートの表示 特定のシートに移動し、必要に応じてシート上の特定のチャートを強調表示します。 [シート]で、目的のシートの名前を入力するか、一覧から選択します。[チャート ID] で、チャートのオブジェクト ID を入力するか、リストから目的のチャートを選択します。 ヒント メモ オブジェクト ID は、次のいずれかの方法で取得できます。 * 分析モードで、ビジュアライゼーションまたはシートを右クリックし、次に、the 共有 icon > the 埋め込み icon をクリックします。その後、ダイアログでオブジェクト ID を確認できます。 * 特定のチャートの種類では、ObjectId チャート関数を使用できます。たとえば、任意のメジャーとともに `=ObjectId()` を軸として追加します。チャート ID が表示されるので、後で参照できるように書き留めます。詳しくは「[ObjectId - チャート関数](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/SystemFunctions/ObjectId.htm)」を参照してください。 情報メモ数式を使用している場合、数式はシート ID に解決される必要があります。 ### シート ID で定義されたシートの表示 特定のシートに移動します。目的のシートのシート ID を入力します。 シートを開いた状態のブラウザのURLでシートのIDを見つけることができます。シート ID は、`/sheet/` の後に `/` が続きます。 シートの URL ``` qlik.com/sense/app/8f8ffa0e-3fde-48a5-a127-59645923a1fc/sheet/7300b241-f221-43db-bb8b-8c8cc1887531/state/analysis ``` この例では、シートの ID は `7300b241-f221-43db-bb8b-8c8cc1887531` です。 情報メモ数式を使用している場合、数式はシート ID に解決される必要があります。 ### ストーリーの表示 特定のストーリーに移動します。目的のストーリーの名前を入力するか、一覧から選択します。 ### ウェブサイトまたはメールを開く 指定されたウェブサイトまたはメールクライアントを開きます。URL を入力して 移動します。必要に応じて、[同じウィンドウで開く]を選択し、ウェブサイトまたはメールクライアントを同じウィンドウで開きます。 ### On-demand アプリを生成する 現在の選択条件に基づいてオンデマンド アプリケーションを作成します。オンデマンド アプリケーションのナビゲーション リンクを選択する必要があります ([オンデマンド アプリケーションの構築](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/creating-OnDemand-app.htm) を参照)。アプリケーションが作成されると、アプリケーションのステータスが表示されます。 ### アプリケーションのチェーン 現在の選択を適用した状態で別の既存のアプリケーションを開くことができます。開くアプリをアプリケーション ID で指定します。オプションとして、シート ID でシートを指定し、新しいアプリケーションを同じウィンドウ内に開くかどうかを指定できます。 情報メモアプリケーションは、必ず Qlik Analytics モバイル アプリケーションの同じウィンドウで開きます。 ## ボタンのスタイリング プロパティ パネルの [スタイル] には、さまざまなスタイル オプションが用意されています。 チャートのスタイル指定をさらにカスタマイズするには、[スタイル] > [プレゼンテーション] で [the スタイル指定 icon] をクリックします。スタイル指定パネルの [基本設定] および [チャート] タブには、さまざまなセクションがあります。 各セクションの横にある ![リセット](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/Icons/reset.svg) をクリックすると、スタイルをリセットできます。![リセット](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/Icons/reset.svg) [すべてをリセット] をクリックすると、スタイル指定パネルで使用可能なすべてのタブのスタイルがリセットされます。 個々のビジュアライゼーションのスタイル指定に関する一般的な情報については、「 [ビジュアライゼーションへのカスタム スタイル指定の適用](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/style-visualization.htm)」を参照してください。 ### アイコンの追加 [スタイル] > [アイコン] でボタンにアイコンを追加できます。事前設定された多数のオプションから選択します。 ### テキストのカスタマイズ [スタイル] > [基本設定] で、タイトル、サブタイトル、脚注のテキストを設定できます。これらの要素を非表示にするには、[タイトルの表示] 設定をオフにします。 さらに、ボタンのラベルのテキストを設定できます。 チャートに表示されるテキストのスタイルを指定できます。 次の手順を実行します。 1. [スタイル] > [プレゼンテーション] で、the スタイル指定 icon[] をクリックします。 2. [基本設定] タブで、次のテキスト要素のフォント、強調スタイル、フォント サイズ、色を設定します。 * タイトル * サブタイトル * 脚注 3. [チャート] タブで、ボタン ラベルのテキスト プロパティを設定します。フォント、強調スタイル、テキスト配置、フォント サイズ、色を設定します。 [レイアウト動作] では、このラベルに対して多数のテキスト レイアウト オプションから選択できます。 オプションは次のとおりです。 * 応答性が高い: ボタンのサイズやテキストの長さに応じてテキスト サイズの調整を適用しながら、ラベルのフォント サイズを調整できます。調整は、すべてのテキスト コンテンツがボタンに収まるように行われます。 * 流動: 追加のテキスト サイズ調整をボタン サイズのみに基づいて適用し、ラベルのフォント サイズを調整できます。このテキストの再スケールは、テキストの長さに関係ありません。テキストが長すぎる場合、最後に省略記号が挿入されます。 * 固定: ラベルのフォント サイズはピクセル単位で調整できます。テキストが長すぎる場合、最後に省略記号が挿入されます。 ### 背景のカスタマイズ ボタン自体の背景だけでなく、一般的な背景もカスタマイズできます。それぞれの背景は、色と画像で設定できます。背景オプションは、プロパティ パネルの [スタイル] > [プレゼンテーション] を展開してから、the スタイル指定 icon [] をクリックすることで構成できます。 #### 一般的な背景の設定 ボタンの一般的な背景には、タイトル エリアと、ボタン自体で部分的に覆われているチャートそのものが含まれます。 次の手順を実行します。 1. プロパティ パネルで、 [スタイル] セクションを展開します。 2. [スタイル] > [プレゼンテーション] で、the スタイル指定 icon[] をクリックします。 3. スタイル指定パネルの [一般] タブでは、背景色 (単一色または数式) を選択できます。メディア ライブラリまたは URL から画像を背景に設定することもできます。 情報メモ URL から背景画像を追加するには、URL のオリジンをテナントのコンテンツ セキュリティ ポリシーの許可リストに追加する必要があります。img-src の [ディレクティブ] を使用してオリジンを追加する必要があります。これはテナント管理者によって実行されます。 詳細については、「[CSP エントリの作成](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-content-security-policy.htm#AddEntry)」を参照してください。 背景色を使用する場合は、スライダーを使用して背景の不透明度を調整します。 背景画像を使用する際、画像のサイズや位置を調整できます。 #### ボタンの背景の設定 ボタンの背景には、ユーザーがクリックしてアクションを実行できる部分が含まれます。 次の手順を実行します。 1. プロパティ パネルで、 [スタイル] セクションを展開します。 2. [スタイル] > [プレゼンテーション] で、the スタイル指定 icon[] をクリックします。 3. スタイル指定パネルの [チャート] タブでは、背景色 (単一色または数式) を選択でき、メディア ライブラリの画像を背景に設定することもできます。 背景画像を使用する際、画像のサイズや位置を調整できます。 ### ボタンのインタラクティブ部分の境界線を調整する ユーザーが意図したアクションを実行できるように、操作するボタン部分の境界線を調整できます。 次の手順を実行します。 1. [外観] > [プレゼンテーション] で、the スタイル指定 icon[] をクリックします。 2. [チャート] タブの、[境界線] で、境界線をオンにしてボタンに表示します。 3. コーナーの半径と幅を調整します。 4. 境界線の色を単色またはカラー表現で設定します。 ### オブジェクト全体の境界線と影のカスタマイズ ボタンが配置されているオブジェクト全体の境界線と影をカスタマイズできます。クリック可能なボタン自体の境界線も調整できます。 次の手順を実行します。 1. プロパティ パネルで、 [スタイル] セクションを展開します。 2. [外観] > [プレゼンテーション] で、the スタイル指定 icon[] をクリックします。 3. スタイル パネルの [一般] タブの [境界線] で、 [枠線] のサイズを調整してチャートの周囲の境界線を増減します。 4. 境界線の色を選択します。 5. [角の半径] を調整して、境界線の丸みを制御します。 6. [一般] タブの [影] で、影のサイズと色を選択します。 影を消す場合は、 [None] (なし) を選択します。 ## ボタンの無効化と有効化 [チャートの有効化] でチャートを有効にする演算実行条件を設定できます。条件が0と評価されると、ボタンは無効になります。 ## Dashboard bundle で [Button for navigation] から変換 既存の [Button for navigation] コントロールをボタンに変換できます。変換する際には、いくつかの制限があります。 * ナビゲーション オプションによる編集モードへの切り替え ([Switch to edit mode]) はサポートされていません。 * アクションによる値の選択とその後の項目の固定 ([Select a value and lock field]) はサポートされていません。[項目で値を選択する] と [特定の項目を固定する] の連続した 2 つのアクションに変換されます。