URLパラメータを使用したレポートの表示

SAS Visual Analytics Viewerでゲストアクセスが利用できるように設定されている場合、http://host/SASVisualAnalyticsViewer/VisualAnalyticsViewer/guest.jspというURLを使用できます。ただし、ゲストアクセスを使用してログオンし、単一のレポートを表示する場合、レポートの名前や場所を指定するパラメータを含んでいる、http://host/SASVisualAnalyticsViewer/VisualAnalyticsViewer_guest.jsp?reportName=My+Report&reportPath=/Shared+Data/VA+Reports/&appSwitcherDisabled=trueのようなURLを使用できます。この2番目のURLは、<iframe>タグを使用して別のWebアプリケーション内に単一のレポートを取り込むようなタスクの場合に便利です。そのようなタスクでは、SAS Visual Analyticsのアプリケーションバー、メニューバー、ツールバーを使用する必要がないためです。

2番目のURLに含めることができるパラメータを次の表に示します。

パラメータ	説明
reportName	表示したいレポートの名前を指定します。このパラメータは、URLを通じて特定のレポートにアクセスする場合に必要となります。
reportPath	表示したいレポートのパスを指定します。このパラメータは、URLを通じて特定のレポートにアクセスする場合に必要となります。
appSwitcherDisabled	アプリケーションバーを無効にします。このパラメータをtrueに設定すると、ホームページに戻るか、またはSAS Visual Analyticsやその他のSASアプリケーションの別の部分にアクセスできるようになります。デフォルト値はfalseです。注: <iframe>タグを使用してレポートを表示する場合、`appSwitcherDisabled=true`を指定してアプリケーションバーを無効にする必要があります。
commentsEnabled	右ペインのコメントタブを有効にします。デフォルト値はtrueです。propertiesEnabledとcommentsEnabledが両方ともfalseである場合、右ペインはビューアに追加されません。
propertiesEnabled	右ペインのプロパティタブを有効にします。デフォルト値はtrueです。propertiesEnabledとcommentsEnabledが両方ともfalseである場合、右ペインはビューアに追加されません。
reportViewOnly	SAS Visual Analyticsのバナー(すべてのメニューを含む)を非表示にします。
reportContextBar	レポートのメニューオプションをすべて有効にします。デフォルト値はtrueです。reportContextBarがfalseであり、propertiesEnabledとcommentsEnabledが両方ともfalseであることが示されている場合、右ペインはビューアに追加されません。このパラメータはモダンビューアでのみ使用できます。注: reportContextBarがfalseの場合、セクションリンキングやレポートリンキングの正しい動作が許可されない戻るリンクも非表示にします。

パラメータをURL内で指定するには、クエリ文字列構文に従って名前と値のペアの並びを記述します。URLには、お使いのサーバー、SAS Visual Analyticsのパス、クエリ文字列を指定できます(疑問符文字の後に続いて指定)。クエリ文字列内の各パラメータ名とその値は、等号(=)で区切ります。複数の名前と値のペアを指定する場合、それらをアンパサンド文字(&)で区切ります。この例では、reportName=My+Reportがレポートの名前を指定するパラメータです。2番目の名前と値のペア(reportPath=/Shared+Data/VA+Reports/)は、レポートのパスを指定するパラメータです。3番目の名前と値のペア(appSwitcherDisabled=true)は、アプリケーションバーを無効にするパラメータです。<iframe>タグを使用してレポートを表示する場合、このパラメータを指定する必要があります。

URL内における名前と値のペアのフォーマット化に関しては特別なルールが存在します。値の中の特殊文字(空白を含む、多くの区切り文字など)は、URLエンコードする必要があります。空白はプラス記号(+)または%20としてエンコードされます。その他の文字は、%nn規則を使用してエンコードされます。ここで、nnはASCII文字セットにおけるその文字の16進表現です。先の例では、値/Shared+Data/VA+Reports/は、実際には/Shared Data/VA Reports/というレポートパスを指定しています。名前に含まれる空白はプラス記号(+)としてエンコードされます。

reportNameとreportPathの両パラメータは、URLにおける必須パラメータです。reportNameパラメータには、表示したいレポートの名前を指定します(My Reportなど)。reportPathパラメータには、そのレポートのパスを指定します(/Shared Data/VA Reports/など)。

注: これらのパラメータは、ログイン認証情報を必要とする標準的なビューアのURL (http://host/SASVisualAnalyticsViewer/VisualAnalyticsViewer.jsp)で使用できます。たとえば、http://host/SASVisualAnalyticsViewer/VisualAnalyticsViewer.jsp?reportViewOnly=trueを使用してバナーを非表示にすることができます。

URLパラメータを使用すると、表示ルール、フィルタ、ランク、集計メジャーなどのレポートパラメータを指定できます。

注: パラメータをURLに含めるか、その値を変更する場合は、正確なパラメータ名とそのパラメータの有効な値を知っている必要があります。