PowerBuilder から JDBC 経由で Smartsheet のデータ に接続
CData JDBC ドライバー for Smartsheet は、 PowerBuilder を含む、JDBC をサポートするあらゆるプラットフォームや開発技術から使用できる標準ベースのコントロールです。 この記事では、PowerBuilder で CData JDBC Driver for Smartsheet を使用する方法について説明します。
ここでは、CData JDBC Driver for Smartsheet を使用してデータの読み取りと書き込みを実行する基本的な PowerBuilder アプリケーションの作成方法を説明します。
Smartsheet データ連携について
CData は、Smartsheet のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています:
- 添付ファイル、カラム、コメント、ディスカッションの読み取りと書き込みができます。
- 個々のセルのデータを表示したり、セルの履歴をレポートしたりできます。
- 添付ファイルの削除やダウンロード、シートの作成・コピー・削除・移動、行の別のシートへの移動やコピーなど、Smartsheet 固有のアクションを実行できます。
ユーザーは、Tableau、Crystal Reports、Excel などの分析ツールと Smartsheet を統合しています。また、当社のツールを活用して Smartsheet データをデータベースやデータウェアハウスにレプリケートしているお客様もいます。
はじめに
PowerBuilder から Smartsheet のデータ に接続
以下の手順に従って、Database Painter ツールを使用し、Smartsheet 用の JDBC URL に基づくデータベースプロファイルを作成します。データベースプロファイルを使用して接続プロパティを保存できます。Database Painter では、データをグラフィカルに操作したり、SQL クエリを実行したりできます。
ドライバーの JAR ファイルを PowerBuilder のクラスパスに追加します。CLASSPATH システム環境変数を、インストールディレクトリの lib サブフォルダにあるドライバー JAR へのパスに設定します。
Note: PowerBuilder Classic を使用している場合は、Tools -> System Options -> Java をクリックしてドライバー JAR へのパスを追加することもできます。
- Tools -> Database Painter をクリックします。
- JDBC ノードを右クリックし、New Profile をクリックします。
- Database Profile Setup ダイアログで、以下の情報を入力します。
- Profile Name: プロファイルのわかりやすい名前を入力します。
- Driver Name: ドライバーのクラス名を入力します: cdata.jdbc.smartsheet.SmartsheetDriver
- URL: JDBC URL を入力します。
個人用トークンを使用して、自分のデータをテストし、アクセスします。個人用トークンを取得する方法は次のとおりです。
- Smartsheet にログインします。
- 「アカウント」をクリックして「個人用の設定」を選択します。
- 「API アクセス」をクリックし、フォームを使用して新しいアクセストークンを生成するか、既存のアクセストークンを管理します。
その後、OAuthAccessToken を生成したトークンに設定します。
組み込みの接続文字列デザイナー
JDBC URL の構築には、Smartsheet JDBC Driver に組み込まれている接続文字列デザイナーが便利です。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
java -jar cdata.jdbc.smartsheet.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。一般的な JDBC URL は以下のとおりです。
jdbc:smartsheet:OAuthClientId=MyOauthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;
- テーブルを表示および編集するには、テーブルを右クリックして Edit Data -> Grid をクリックします。
PowerBuilder コントロールで Smartsheet のデータ を使用
標準の PowerBuilder オブジェクトを使用して JDBC データソースに接続し、クエリを実行できます。以下の例では、Smartsheet のデータ を DataWindow に取得する方法を示します。以下のコードを open メソッドに追加できます。
SQLCA.DBMS = "JDBC" SQLCA.AutoCommit = False SQLCA.DBParm = "Driver='cdata.jdbc.smartsheet.SmartsheetDriver',URL='jdbc:smartsheet:OAuthClientId=MyOauthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;"; CONNECT USING SQLCA; dw_sheet_event_plan_budget.SetTransObject(SQLCA); dw_sheet_event_plan_budget.Retrieve();