HypUIConnect

Cloudデータ・プロバイダ・タイプ: Oracle Analytics Cloud - Essbase、Oracle Planning and Budgeting Cloud

オンプレミス・データ・プロバイダ・タイプ: Oracle Essbase、Oracle Hyperion Planning、Oracle Hyperion Financial Management、Oracle Business Intelligence Enterprise Edition

説明

オンプレミス・データ・ソース: オンプレミス・データ・ソースの場合で、HypUIConnect()は、ユーザー名とパスワードが指定されていない場合に、ユーザーに対して「データ・ソースに接続」ダイアログ・ボックスを表示します。すでに指定されている場合は表示しません。

Cloudデータ・ソースおよびオンプレミス・フォーム・ベース認証: フォーム・ベース認証を使用しているCloudデータ・ソースおよびオンプレミス・ソースの場合は、HypUIConnect VBA関数を使用して、既存のプライベート接続に接続する必要があります。HypUIConnect()では、ユーザーがログインする際に、ユーザー名、パスワードおよびドメインを入力する必要がある場合は常に、認証用のプロンプトが表示されます。

次の2つの方法でHypUIConnect()を使用できます。

• わかりやすい接続名を使用する。

  わかりやすい接続名は、先にHypCreateConnectionを使用して作成します。

• わかりやすい名前のかわりに、URL、サーバー、アプリケーション、データベース名で構成される接続文字列を使用する。

構文

HypUIConnect (vtSheetName, vtUserName, vtPassword, vtFriendlyName)

ByVal vtSheetName As Variant

ByVal vtUserName As Variant

ByVal vtPassword As Variant

ByVal vtFriendlyName As Variant

パラメータ

vtSheetName: 関数を実行するワークシートの名前。vtSheetNameがNullまたはEmptyの場合、アクティブなワークシートが使用されます。

vtUserName: 有効なユーザー名

vtPassword: このユーザーのパスワード

vtFriendlyName: データ・プロバイダの接続名わかりやすい名前のパラメータでは、次のいずれかを使用できます。

• HypCreateConnectionを使用して作成した接続名

• URL、サーバー名、アプリケーション名およびデータベース名で構成されるURL|server|app|db形式の接続文字列。

  接続文字列のURLコンポーネントは、『Oracle Smart View for Officeユーザーズ・ガイド』のプライベート接続URLの構文のガイドラインに準拠します。

戻り値

正常に終了した場合は0を戻し、それ以外の場合は該当するエラー・コードを戻します。

例

この例では、"My Sample Basic"というわかりやすい名前を使用して、Oracle Analytics Cloud - Essbase Sampleアプリケーション、Basicデータベースに接続します。

Public Declare PtrSafe Function HypUIConnect Lib "HsAddin" (ByVal vtSheetName As Variant, ByVal vtUserName As Variant, ByVal vtPassword As Variant, ByVal vtFriendlyName As Variant) As Long

HypUIConnect("Empty", "UserName", "Password", "My Sample Basic")

Essbaseの接続文字列の使用例

この例では、Oracle Analytics Cloud - Essbase Sampleアプリケーション、Basicデータベースに接続します。

HypUIConnect("Sheet1", "UserName", "Password", "http://hostname:19000/aps/SmartView|servername|Sample|Basic")

Oracle Planning and Budgeting Cloudの接続文字列の使用例

この例では、Oracle Planning and Budgeting Cloud Visionアプリケーション、Plan1データベースに接続します。

HypUIConnect("Sheet1", "UserName", "Password", "http://hostname.com:9000/HyperionPlanning/SmartView|servername|Vision|Plan1")

Financial Managementの接続文字列の使用例

この例では、Financial Management STATJP4アプリケーションに接続します。

HypUIConnect("Sheet1", "UserName", "Password", "http://hostname.com:19000/hfmadf/officeprovider|<servername>|STATJP4|STATJP4")

Financial Managementの場合、dbコンポーネントは空でもかまいません。次に例を示します。

HypUIConnect("Sheet1", "UserName", "Password", "http://hostname.com:19000/hfmadf/officeprovider|<servername>|STATJP4|")