Connection-Parameter mapping Anaplan XL Reporting Web 拡張機能を使用すると、Anaplan XL レポート デザイナーは、特定の接続の詳細を制御するウェブ パラメーターをレポートに組み込むことができます。

インストール

  1. ConnectionParameterExtension.dll ファイルを Anaplan XL Web インストールの Extensions フォルダー (通常は C:\inetpub\wwwroot\AnaplanXLWeb\Extensions) に配置します。
  2. Anaplan XL Web に拡張機能を読み込むように指示するには、次の内容を含む InstalledExtensions.xml ファイルを同じフォルダーに作成します。
    <?xml version="1.0" encoding="utf-8" ?> <installation> <extensions> <extension source="RelativeFile" location="ConnectionParameterExtension.dll" /> </extensions> </installation>.
  3. mapping.xml 構成ファイルを同じフォルダーに配置します。
  4. IIS 又はアプリケーション プールを再起動します (構成の変更後にも必要です)。

構成

mapping.xml ファイルには、マッピングをアクティブ化する ウェブ パラメーターの詳細と、その結果としてワークブック内の接続に適用するサーバー、データベース、キューブの詳細が含まれています。空白の詳細は変更されません。構成の変更後に再読み込みするには、IISRESET 又はアプリケーション プールのリサイクルが必要です。

例 1:シンプルなマッピング

最もシンプルな例は、ウェブ パラメーター (ここでは「connection」) が値 (ここでは「mapped」) に設定された状態でワークブックが読み込まれているのを確認することです。

<parameterMappings> <parameter name="connection"> <mapping value="mapped" server="AlternativeServer" database="" cube="" /> </parameter> </parameterMappings>

通常どおり読み込まれたときに公開される接続の詳細をワークブックでは使用しますが、ウェブ パラメーターを使用してロード読み込まれたときはキューブ接続のために AlternativeServer に接続します。次に例を示します。

https://MyServer/AnaplanXLWeb/WebForm/ShowReport.aspx?rep=673dad1d-e406-4493-8ee3-6afdc9ec4f7f.wbsql&connection=mapped

例 2:複数のマッピング

複数のウェブ パラメーター値に応答するように mapping.xml ファイルを構成できます。こちらの例では、一つのキューブに接続するために role パラメーターを「managers」に設定しており、別のキューブに接続するために「users」に設定しています。

<parameterMappings> <parameter name="role"> <mapping value="managers" server="" database="ManagerDatabase" cube="FullCube" /> <mapping value="users" server="" database="UserDatabase" cube="RestrictedCube" /> </parameter> </parameterMappings>

例 3:マッピングの強制

デフォルトでは、パラメーターが使用されていないか、存在しないマッピング値が選択されている場合、マッピングは無視されて元の接続の詳細が使用されます。次の二つの属性を使用して、拡張機能にマッピングを強制させることができます。

allowMissingParameter - 0 or 1 (default)

  • 0 に設定すると、公開されているレポートに一致する名前のパラメーターがある場合、パラメーターの値を指定する必要があります。

allowUnknownParameterValue - 0 or 1 (default)

  • 0 に設定すると、指定したパラメーター値がマッピングのリストに存在している必要があります。

<parameterMappings> <parameter name="role" allowMissingParameter="0" allowUnknownParameterValue="0"> <mapping value="managers" server="" database="ManagerDatabase" cube="FullCube" /> <mapping value="users" server="" database="UserDatabase" cube="RestrictedCube" /> </parameter> </parameterMappings>

これらの検証ルールが失敗した場合、レポートへのアクセスは拒否されます。