CData Excel Add-In for HubDB はじめに：インストールから接続まで

CData Excel Add-In for HubDB のインストール、ライセンス認証、接続設定の完全ガイドです。

このガイドでは、CData Excel Add-In for HubDB の使い方を詳しく解説します。アドインのインストール、ライセンスの仕組み、初回接続の設定、そしてリアルタイムの HubDB のデータ を Excel に直接インポートして分析、レポート作成、自動化を行う方法を学べます。

インストールとライセンス認証

システム要件

  • Windows： Windows 10/11 または Windows Server 2016 以降
  • Microsoft Excel： Excel 2016 以降、Excel for Microsoft 365
  • .NET Framework： .NET Framework 4.0 以降

Excel Add-In のインストール

CData Web サイトの Excel Add-In ダウンロードページから Excel Add-In をダウンロードしてインストールします。プロンプトが表示されたら、必要な連絡先情報を入力してください。

Note：ライセンス版のインストーラーをダウンロードする場合は、会社のメールアドレスとライセンスキーを使用してください。

  1. インストーラーを実行し、セットアップウィザードに従います
  2. インストールが完了したら、Excel を開き、Excel リボンに CData タブが表示されていることを確認します

Excel Add-In のライセンス認証

Excel Add-In はインストール時にライセンス認証を処理します。インストーラーの実行時に以下を選択できます：

  • 試用版ライセンスを使用する、または
  • CData から提供されたライセンス版ビルドをインストールする

サブスクリプションライセンスが必要な場合は、CData Orders チーム（[email protected]）にお問い合わせいただき、ライセンスキーを取得してください。アドインがインストールされると、すぐに使用できる状態になります。

ライセンスに関するよくある質問

アドインを複数のマシンにインストールできますか？
サブスクリプションプランによって、含まれるアクティベーション数が決まります。詳細については [email protected] までお問い合わせください。

ライセンスキーを紛失しました。どうすれば取得できますか？
注文番号を添えて [email protected] までメールでお問い合わせいただければ、ライセンスキーを再送いたします。

ライセンスを移行するにはどうすればよいですか？
ライセンスを別のマシンに移行するには、以下のリンクからライセンス移行リクエストを送信する必要があります：

https://www.cdata.com/lic/transfer/

ライセンス移行リクエストが送信され、正常に処理されると、プロダクトキーにアクティベーションが追加され、別のマシンで正規ライセンスを認証できるようになります。このプロセスが完了すると、以前のマシンのライセンスは無効になります。

ライセンスに関するその他のご質問は、[email protected] までお問い合わせください。ライセンスの確認とアップグレードは、セルフサービスポータル portal.cdata.com から行えます。

接続設定

アドインがインストールされたら、Excel リボンから直接 HubDB へのセキュアな接続を設定できます。アドインは接続設定を Excel 環境内に保存し、それを使用してライブの HubDB のデータ を取得します。

新しい接続の作成

  1. Excel を開き、リボンの CData タブに移動します
  2. データの取得 > From HubDB をクリックします。次に、 New HubDB Connection をクリックして新しい接続を作成します
  3. 接続に名前を付け、必要に応じて Update、Insert、Delete 操作を有効にします
  4. CData 接続ダイアログが開きます。HubDB に必要な認証情報（OAuth、API トークン、資格情報など）を入力します

接続プロパティの設定

HubDBデータソースへの接続には、パブリックHubSpotアプリケーションを使用したOAuth認証とプライベートアプリケーショントークンを使用した認証の2つの方法があります。

カスタムOAuthアプリを使用する

すべてのOAuthフローでAuthSchemeを"OAuth"に設定する必要があります。特定の認証ニーズ（デスクトップアプリケーション、Webアプリケーション、ヘッドレスマシン）に必要な接続プロパティについては、ヘルプドキュメントを確認してください。

アプリケーションを登録し、OAuthクライアント認証情報を取得するには、以下の手順を実行してください。

  1. HubSpotアプリ開発者アカウントにログインします。
    • アプリ開発者アカウントである必要があります。標準のHubSpotアカウントではパブリックアプリを作成できません。
  2. 開発者アカウントのホームページで、アプリタブをクリックします。
  3. アプリを作成をクリックします。
  4. アプリ情報タブで、ユーザーが接続する際に表示される値を入力し、必要に応じて変更します。これらの値には、パブリックアプリケーション名、アプリケーションロゴ、アプリケーションの説明が含まれます。
  5. 認証タブで、「リダイレクトURL」ボックスにコールバックURLを入力します。
    • デスクトップアプリケーションを作成する場合は、http://localhost:33333のようなローカルにアクセス可能なURLに設定します。
    • Webアプリケーションを作成する場合は、ユーザーがアプリケーションを承認した際にリダイレクトされる信頼できるURLに設定します。
  6. アプリを作成をクリックします。HubSpotがアプリケーションとそれに関連する認証情報を生成します。
  7. 認証タブで、クライアントIDとクライアントシークレットを確認します。これらは後でドライバーを設定する際に使用します。

  8. スコープの下で、アプリケーションの意図する機能に必要なスコープを選択します。

    テーブルにアクセスするには、最低限以下のスコープが必要です：

    • hubdb
    • oauth
    • crm.objects.owners.read
  9. 変更を保存をクリックします。
  10. 統合に必要な機能にアクセスできる本番ポータルにアプリケーションをインストールします。
    • 「インストールURL（OAuth）」の下で、完全なURLをコピーをクリックして、アプリケーションのインストールURLをコピーします。
    • コピーしたリンクをブラウザで開きます。アプリケーションをインストールする標準アカウントを選択します。
    • アプリを接続をクリックします。結果のタブは閉じて構いません。

プライベートアプリを使用する

HubSpotプライベートアプリケーショントークンを使用して接続するには、AuthSchemeプロパティを"PrivateApp"に設定します。

以下の手順に従ってプライベートアプリケーショントークンを生成できます：

  1. HubDBアカウントで、メインナビゲーションバーの設定アイコン（歯車）をクリックします。
  2. 左サイドバーメニューで、統合 > プライベートアプリに移動します。
  3. プライベートアプリを作成をクリックします。
  4. 基本情報タブで、アプリケーションの詳細（名前、ロゴ、説明）を設定します。
  5. スコープタブで、プライベートアプリケーションがアクセスできるようにしたい各スコープに対して読み取りまたは書き込みを選択します。
  6. テーブルにアクセスするには、最低限hubdbとcrm.objects.owners.readが必要です。
  7. アプリケーションの設定が完了したら、右上のアプリを作成をクリックします。
  8. アプリケーションのアクセストークンに関する情報を確認し、作成を続行をクリックし、その後トークンを表示をクリックします。
  9. コピーをクリックして、プライベートアプリケーショントークンをコピーします。

接続するには、PrivateAppTokenを取得したプライベートアプリケーショントークンに設定します。

接続テスト

  1. 接続テストをクリックして入力内容を検証します
  2. OK をクリックして接続を保存します

Excel へのデータインポート

接続を作成したら、組み込みのクエリインターフェースを使用して HubDB のデータ を Excel にインポートできます。

テーブルとビューの選択

  1. CData リボンから データの取得 > From HubDB をクリックし、作成した接続を選択します
  2. CData クエリウィンドウが開きます。選択をクリックしてテーブルまたはビューを選択します
  3. 目的のテーブルを選択し、OK をクリックします

クエリの実行

  1. 選択したテーブルに対して SQL クエリが自動的に生成されます
  2. クエリを確認し（任意）、OK をクリックして実行します
  3. 結果が Excel ワークシートに直接表示されます

これで、ピボットテーブルやグラフを作成したり、Excel の数式を使用して HubDB のデータ を分析できます。

よくある接続の問題

認証エラー

解決策： 資格情報または OAuth 設定を確認してください。HubDB アカウントに必要な API 権限があることを確認してください。

HubDB に接続できない

解決策： インターネット接続、ファイアウォール設定、またはプロキシ設定を確認してください。特定のポート要件については [email protected] までお問い合わせください。

テーブルが見つからない

解決策： アカウントが選択した HubDB のデータ オブジェクトにアクセスできることを確認してください。クエリウィンドウのテーブルセレクターを使用して、利用可能なリソースを参照してください。

クエリ結果が返されない

解決策： 生成された SQL のフィルターまたは WHERE 句を確認してください。フィルターを削除または調整して、クエリの範囲を広げてください。

次のステップ

Excel Add-In のインストール、ライセンス認証、接続設定が完了しました。次は、レポートの自動化、ライブダッシュボードの更新、SQL や Excel 関数を使用した高度なクエリの作成方法をご覧ください。

Excel Add-In記事タイトル

サポート

ご不明な点がございましたら、お気軽にお問い合わせください：

FAQ

インストールとライセンス

  • アドインのインストールには管理者権限が必要ですか？
    はい、インストールには管理者権限が必要です。
  • ライセンスを認証するにはどうすればよいですか？
    ライセンス認証はインストール時に行われます。ライセンス版のインストーラーはサブスクリプションキーを自動的に適用します。

接続

  • 複数の HubDB アカウントを使用できますか？
    データの取得をクリックするたびに、新しい接続を設定できます。
  • プロキシ経由で接続できますか？
    はい、接続ダイアログでプロキシ設定を構成できます。

パフォーマンスとトラブルシューティング

  • クエリが遅いのはなぜですか？
    クエリエディターでフィルターを追加するか、選択するフィールドを絞り込んでください。
  • ログを有効にするにはどうすればよいですか？

    接続マネージャーに以下を追加してください：

    • Logfile: /path/to/logfile.log
    • Verbosity: 3

    トラブルシューティングの際は、[email protected] にご連絡の上、ログファイルを安全にアップロードしてください。

  • データを更新するにはどうすればよいですか？
    インポートしたテーブルを選択し、CData リボンから更新をクリックしてください。

この FAQ で解決しない場合は、[email protected] までお問い合わせください。

はじめる準備はできましたか？

Excel Add-In for HubDB の無料トライアルをダウンロードしてお試しください：

 ダウンロード

詳細：

HubDB Icon Excel Add-In for HubDB お問い合わせ

Bitbucket Excel アドインは、Microsoft Excel からリアルタイムなHubDB データに直接接続できるパワフルなツールです。Excel を使用してHubDB データの読み、書き、更新を実行できます。一括インポート / エクスポート / 更新、データクレンジング、重複データの除外、Excel ベースのデータ分析などに最適です。

この記事の内容

関連記事