XML ファイルのサンプルを確認してみましょう。

Anaplan XL Web エディションでは、ウェブ サーバーに公開されるレポートの接続の再ターゲティングがサポートされています。

この機能を有効にするには、Anaplan XL Web インストール フォルダーの Xml サブフォルダーに ConnectionMapping.xml ファイルを作成する必要があります。

ConnectionMapping.xml ファイルには以下を含めることができます。

  • 一つ以上の connectionmap (キューブ接続用)。各ノードには from 接続定義と to 接続定義が含まれている必要があります。
    • connectionmap では、公開済み接続ファイルにある適切な XL3_CONNECTION_TYPE プロパティと XL3_WEB_CONNECTION... プロパティを設定することで、公開済み接続をマッピングできます。これらはサーバー/データベース/キューブにおける標準的な照合よりも優先されます。
  • 一つ以上の sqlconnectionmap ノード (リレーショナル接続用)。各ノードには、match 正規表現要素と、それを置き換える connectionstring が含まれている必要があります。
    • match は正規表現であるため、\ は \\ を使用してエスケープする必要があることに注意してください。多くの場合、これらは名前付きインスタンスで発生します。
    • 複数の match 要素を設定できます。その場合、接続をマッピングするにはすべての要素が一致している必要があります。
    • sqlconnectionmap ノードには、match ではなく equals 要素が含まれる場合があります。

このファイルを変更した後は IIS を再起動する必要があります。

  • バージョン 9: connectionmap と sqlconnectionmap に必要に応じて path 属性を含めることで、接続マッピングを指定されたパスにのみ適用できます。同じパスのマッピングが存在しない限り、このマッピングはサブフォルダーに適用されます。

 <connectionmap path="Folder\Sub Folder">

  • バージョン 2307: sqlconnectionmap に必要に応じて requirespassword 属性を含めることで、接続マッピングを更新してユーザーに認証情報の入力を求めることができます。

 <connectionmap requirespassword="False">

ユーザーがレポートを読み込んで表示すると、Anaplan XL Web エディションでは、from または match 定義に一致する接続を自動的に検索し、対応する定義に置き換えます。キューブ接続の場合、照合は from 接続の Type、Server、Database、Cube を使用して行われます。

接続の ID 番号と名前は変更されません。

  • バージョン 2312: connectionmap の <to> セクションで Server、Database、Cube を * に設定できます。これは、元の値が更新されないことを意味します。

これにより、すべてのサーバーを更新しながらデータベース/キューブは変更しない接続マッピング ファイルを作成できます。その結果、接続マッピング ファイルに一つのエントリを追加するだけで、すべてのキューブがサーバー間でマッピングされます。

  • バージョン 2404: sqlconnectionmap 要素に connectionstring 要素の代わりに webconfigconnectionstring 要素を追加し、web.config から名前付き接続文字列を指定できます。必要に応じて、Microsoft のこちらのページに記載されている方法でこの接続文字列を暗号化できます。

 aspnet_regiis -pe "connectionStrings" -app "/AnplanXLWeb" -prov "RsaProtectedConfigurationProvider"

サンプル XML ファイル

    • キューブ接続を「Development」サーバーと照合し、「Production」サーバーへの接続に置き換えます。
    • AdventureWorksDW SQL 接続を「WSAMZN-RI8SHC08」サーバーと照合し、それをローカルホスト サーバー上の AdventureWorksDW SQL 接続に置き換えます。
        • SQL 接続には複数の照合要素を含めることができます。その場合はすべてが一致している必要があります。
    • マッピングするデータベース名とキューブ名では大文字と小文字が区別されることに注意してください。

<?xml version="1.0" encoding="utf-8"?>
<connectionmapper>
<connectionmap>
<from>
<connection id="0" name="">
<type>AnalysisServices</type>
<variable type="String" name="server"><value>DEVELOPMENT</value></variable>
<variable type="String" name="database"><value>Demo Database</value></variable>
<variable type="String" name="cube"><value>Demo Cube</value></variable>
</connection>
</from>
<to>
<connection id="0" name="">
<type>AnalysisServices</type>
<variable type="String" name="server"><value>PRODUCTION</value></variable>
<variable type="String" name="database"><value>Demo Database</value></variable>
<variable type="String" name="cube"><value>Demo Cube</value></variable>
<variable type="Boolean" name="requirespassword"><value>0</value></variable>
<props/>
</connection>
</to>
</connectionmap>
<sqlconnectionmap>
<match>.*Data Source=WSAMZN-RI8SHC08.*</match>
<match>.*Initial Catalog=AdventureWorksDW.*</match>
<connectionstring>Provider=SQLOLEDB;Data Source=localhost\MSSQLSERVER02;Initial Catalog=AdventureWorksDW;Trusted_Connection=Yes</connectionstring>
</sqlconnectionmap>
</connectionmapper>

ウェブからのダウンロード

web.config ファイル内の設定 UnmapConnectionsOnExport を使用して、ライブとしてダウンロードされたときに接続マッピングを元に戻すかどうかを制御できます。true の場合、接続は元の値に復元されます。false の場合、接続マッピングはダウンロードされたファイルに保存されます。

詳細については、「ウェブ構成のカスタマイズ」を参照してください。