CData ADO.NET Provider for Sage Intacct はじめに：インストールから接続まで

CData ADO.NET Provider for Sage Intacct のインストール、ライセンス認証、接続設定の完全ガイドです。

このガイドでは、CData ADO.NET Provider for Sage Intacct の使い方を詳しく解説します。プロバイダーのインストール、Sage Intacct のデータへの接続設定、そして .NET アプリケーションで ADO.NET パターンを使用した簡単なコマンドの実行方法を学べます。

デスクトップアプリ、Web アプリ、バックグラウンドサービスなど、どのような用途でも、このプロバイダーを使えば API の詳細を手動で管理することなく、ライブの Sage Intacct のデータに安全かつ高パフォーマンスで接続できます。

Sage Intacct データ連携について

CData は、Sage Intacct のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています：

API の更新や変更を気にすることなく、Sage Intacct にアクセスできます。
追加の構成手順なしで、Sage Intacct のカスタムオブジェクトやフィールドにアクセスできます。
Basic 認証による組み込み Web サービス認証情報を使用して、Sage Intacct にデータを書き戻すことができます。
SQL ストアドプロシージャを使用して、ベンダーの承認・却下、エンゲージメントの挿入、カスタムオブジェクトやフィールドの作成・削除などの機能的な操作を実行できます。

ユーザーは、Tableau、Power BI、Excel などの分析ツールと Sage Intacct を統合し、当社のツールを活用して Sage Intacct データをデータベースやデータウェアハウスにレプリケートしています。

他のお客様が CData の Sage Intacct ソリューションをどのように使用しているかについては、ブログをご覧ください：Drivers in Focus: Accounting Connectivity

はじめに

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

システム要件

Windows： Windows 10/11 または Windows Server 2016 以降
.NET バージョン： .NET Framework 4.0 以降、.NET 6 以降、.NET Standard アセンブリ
IDE： Visual Studio 2017 以降

ADO.NET Provider のインストール

Windows でのインストール

CData アカウントまたは評価版ダウンロードページから ADO.NET Provider インストーラーをダウンロードします。
インストーラーを実行し、ウィザードに従ってインストールを完了します。
インストーラーがプロバイダーを登録し、すべてのアセンブリを適切な CData インストールフォルダに配置します。
インストール中にライセンスキーの入力を求められます：
XXXX-XXXX-XXXX-XXXX-XXXX
- Note： 試用版を使用する場合は、代わりにTrial Key を選択してください。

ライセンスの認証

ライセンスの動作は、.NET Framework と .NET Standard のどちらを使用しているかによって異なります。以下の手順で、お使いの環境でプロバイダーを認証してください。

.NET Framework（Windows）

Windows で .NET Framework を使用する場合、追加の操作は必要ありません。インストーラーまたは NuGet パッケージが開発ライセンスを自動的にインストールします。

.NET Standard（Windows/Mac/Linux）

.NET Core、Mono、Xamarin などの .NET Standard プラットフォームでは、プロバイダーを使用する前に手動でライセンスをインストールする必要があります。

Install-License ツールの使用

ツールキットには、試用版または正規ライセンスを適用するための install-license ユーティリティが

lib/netstandard2.0

フォルダに含まれています。

試用版ライセンスをインストールする場合：


dotnet ./install-license.dll

正規版ライセンスを認証する場合：


dotnet ./install-license.dll

ツールを実行すると、開発マシンがライセンス認証され、.NET アプリケーションでプロバイダーを使用できるようになります。

ランタイムライセンス

アプリケーションをデプロイする際は、接続文字列でランタイムキー（RTK）を指定して再配布を有効にします。

プロパティ	説明
RTK	デプロイされた ADO.NET アプリケーション用のランタイムキーです。

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

ライセンスは複数のマシンで使用できますか？
はい、サブスクリプションプランによります。不明な場合は、注文確認メールを確認するか、[email protected] までお問い合わせください。

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

ライセンスを別のマシンに移行できますか？
ライセンス移行リクエストを送信してください：
https://www.cdata.com/lic/transfer/

承認されると、プロダクトキーにアクティベーションが追加され、以前のインストールは無効になります。

ライセンスサポートの詳細については、portal.cdata.com にアクセスするか、[email protected] までお問い合わせください。

接続設定

インストールが完了したら、次のステップとして Sage Intacct への接続を設定します。接続は、.NET アプリケーションのコードまたは構成ファイルで ADO.NET 接続文字列を使用して作成します。

接続マネージャーの作成

Visual Studio を開きます。
表示メニューからサーバーエクスプローラーを選択します。
左サイドバーからデータベースへの接続をクリックします。
接続の追加ダイアログで、変更をクリックします。
CData Sage Intacct のデータ source を選択し、OK をクリックします。

接続プロパティの設定

Sage Intacct 接続プロパティの取得・設定方法

独自のWeb サービスクレデンシャル、埋め込みクレデンシャル（Basic 認証）、またはOkta クレデンシャルのいずれかを使用して、Sage Intacct への接続を確立できます。

Sage Intacct への認証

Sage Intacct は2種類の認証をサポートします。Basic およびOkta です。選択した認証方法に関連するプロパティを設定して、接続を構成します。

Basic 認証

Basic 認証スキームでは、埋め込みクレデンシャルを使用してデータの読み書きが可能です。オプションとして、独自のWeb サービスクレデンシャルを指定することもできます。

Basic 認証を使用して認証を行うには、以下のプロパティを設定します。

AuthScheme：Basic。
CompanyID：Sage Intacct にログインする際に会社を識別するために使用するID。
User：Sage Intacct へのログインに使用するログイン名。
Password：ログインクレデンシャル用のパスワード。
（オプション）SenderID およびSenderPassword：Web サービスのSender ID およびパスワード（独自のWeb サービスクレデンシャルを使用している場合のみ）。

独自のWeb サービスクレデンシャルではなく、埋め込みクレデンシャルを使用する場合は、以下を実行する必要があります：

Web サービスダッシュボードで、会社 -> 会社情報 -> セキュリティタブに移動します。
Web サービス認証に"CData" を追加します。これは大文字・小文字が区別されます。これを行うには、会社 -> 会社情報（新しいUI では、設定 -> 会社）-> セキュリティ -> Web サービス認証 / 編集に移動します。

Okta 認証についてはヘルプドキュメントを参照してください。接続の追加

接続テスト

接続テストをクリックします。

接続に成功すると、Visual Studio 内でデータを確認できます。

よくある接続の問題

認証エラー

解決策： Sage Intacct の OAuth 設定、クライアント ID、シークレット、またはトークンの権限を確認してください。サポートが必要な場合は [email protected] までお問い合わせください。

サーバーに接続できない

解決策： ファイアウォール、プロキシ、VPN の設定を確認してください。必要なポート情報については [email protected] までお問い合わせください。

テーブルが見つからない

解決策： Sage Intacct をクエリする際に、正しいスキーマまたはデータベースを選択しているか確認してください。

次のステップ

ADO.NET Provider のインストール、ライセンス認証、接続設定が完了しました。以下のシナリオを参考に、ADO.NET ツールをさらに活用してみてください：

ADO.NET Provider	記事タイトル
LINQPad	LINQPad でSage Intacct のデータを操作する方法
Microsoft SSAS	SSAS でSage Intacct のデータに連携するOLAP Cube を作成
SSRS Server	SSRS レポートサーバーにADO.NET Provider を配置してSage Intacct 連携
TIBCO Spotfire	ADO.NET 経由でTIBCO Spotfire でSage Intacct のデータに連携してをビジュアライズ
.NET Charts	Visual Studio でチャートコントロールと Sage Intacct をデータバインド
Blazor	Blazor でSage Intacct のデータにリアルタイムで連携するアプリを構築
DevExpress	Sage Intacct のデータをDevExpress Data Grid にデータバインドする。
EF - Code First	Entity Framework 6 からSage Intacct のデータに連携
EF - LINQ	LINQ を使ってSage Intacct のデータに連携する方法
EF - MVC	【徹底解説】Sage Intacct とのデータ連携ができるMVC アプリケーションの作り方
Flexsche	生産スケジューラFLEXSCHE へSage Intacct からデータを取り込む
Infragistics DataGrid	Infragistics XamDataGrid を使用してSage Intacct のダイナミックグリッドを作成
OD Server	WCF アプリケーションで Sage Intacct データのOData サービスを公開
Xamarin DataGrid	Infragistics WPF XamDataGrid と Sage Intacct をデータバインド
ADO.NET Setup	CData ADO.NET Provider for Sage Intacct はじめに：インストールから接続まで
SSIS Task	Sage Intacct をSSIS 経由でSQL サーバーにバックアップする

サポート

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

テクニカルサポート： [email protected]
コミュニティフォーラム： CData Community Site
ヘルプドキュメント： ローカルにインストールされているほか、オンラインでも参照可能です

FAQ

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

ADO.NET Provider のインストールには管理者権限が必要ですか？
はい、Visual Studio 全体で使用するコンポーネントをインストールするには管理者権限が必要です。
Azure Data Factory にデプロイする際に RTK は必要ですか？
はい。アプリケーションの接続文字列で RTK プロパティを設定してから公開してください。

接続

複数の Sage Intacct アカウントを使用できますか？
アカウントごとに個別の接続文字列を作成してください。
プロキシ経由で接続できますか？
はい。接続文字列でプロキシ設定を構成できます。
接続をテストするにはどうすればよいですか？
接続マネージャー UI で接続テストをクリックしてください。

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

クエリのパフォーマンスを改善するにはどうすればよいですか？
フィルターの適用、行数の制限、サーバー側のページングプロパティの活用をお試しください。
ログを有効にするにはどうすればよいですか？
接続マネージャーに以下を追加してください：
- Logfile: /path/to/logfile.log
- Verbosity: 3
トラブルシューティングの際は、[email protected] にご連絡の上、ログファイルを安全にアップロードしてください。

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

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

Sage Intacct Data Provider の無料トライアルをダウンロードしてお試しください：

ダウンロード

詳細：

Sage Intacct ADO.NET Provider お問い合わせ

.NET アプリケーションから、Intacct データへの双方向連携を実現し、Contacts、Invoices、Transactions、Vendors などの検索、Items、Customers などの更新が可能に。