PowerBuilder からShort.io のデータに接続してみた

この記事では、CData API Driver for ADO.NET をPowerBuilder で使う方法を紹介します。これらの標準準拠コントロールは扱いやすく、Appeon PowerBuilder をはじめ、Microsoft .NET に対応したさまざまなプラットフォームや開発テクノロジーで利用できます。

この記事では、CData API Driver for ADO.NET を使って PowerBuilder からデータを取得する基本的なアプリケーションを作成する方法を紹介します。

1. 新規WPF Window Application ソリューションで、接続プロパティに必要なすべてのビジュアルコントロールを追加します。一般的な接続文字列は次のとおりです：

   Profile=C:\profiles\ShortIo.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_key';

   API キー認証の設定

   Short.io は API キー認証を使用します。API キーを取得するには、以下のステップで進めます：

   1. Short.io アカウントにログインします
   2. Settings > Integrations & API > API に移動します
   3. Create API Key をクリックして API キーをコピーします

   API キーを取得したら、接続を確立できます：

   • AuthScheme：APIKey に設定します。
   • APIKey：Settings > Integrations & API > API から取得した Short.io の API キーに設定します。

   接続文字列の例：

   Profile=C:\profiles\ShortIo.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_key';
   

   利用可能なテーブル

   Short.io プロファイルでは、以下のテーブルにアクセスできます：

   • Domains - 認証済みアカウントに関連付けられた Short.io ドメイン
   • Links - ドメインの短縮リンク
   • LinkExpand - ドメインとパスから短縮リンクを展開
   • LinksByOriginalUrl - 指定した元の宛先 URL に一致する複数の短縮リンクを取得
   • Folders - 特定のドメイン内のリンクフォルダー
   • LinkPermissions - ドメイン内の特定のリンクの権限レコード
   • CountryTargeting - 特定の短縮リンクの国別リダイレクトターゲティングルール
   • RegionTargeting - 特定の短縮リンクの地域別リダイレクトターゲティングルール
   • Regions - 指定した国コードに対する利用可能な地域／州の一覧
   • DomainStatistics - Short.io ドメインのクリック数とトラフィックの集計統計
   • LinkStatistics - 特定の Short.io リンクのクリック数とトラフィックの集計統計
2. .NET コントロールからDataGrid コントロールを追加します。
3. DataGrid コントロールのカラムを設定します。Account テーブルからいくつかのカラムを以下に示します：

   
   <DataGrid AutoGenerateColumns="False" Margin="13,249,12,14" Name="datagrid1" TabIndex="70" ItemsSource="{Binding}">
   <DataGrid.Columns>
       <DataGridTextColumn x:Name="idColumn" Binding="{Binding Path=Id}" Header="Id" Width="SizeToHeader" />
       <DataGridTextColumn x:Name="nameColumn" Binding="{Binding Path=}" Header="" Width="SizeToHeader" />
   		...
   	</DataGrid.Columns>
   </DataGrid>
   

4. CData API Driver for ADO.NET アセンブリへの参照を追加します。

DataGrid 接続

ビジュアルエレメントが設定されたら、Connection、Command、およびDataAdapter のような標準のADO.NET オブジェクトを使ってSQL クエリの結果をDataTable に表示することができます：

System.Data.CData.API.APIConnection conn
conn = create System.Data.CData.API.APIConnection(connectionString)

System.Data.CData.API.APICommand comm
comm = create System.Data.CData.API.APICommand(command, conn)

System.Data.DataTable table
table = create System.Data.DataTable

System.Data.CData.API.APIDataAdapter dataAdapter
dataAdapter = create System.Data.CData.API.APIDataAdapter(comm)
dataAdapter.Fill(table)
datagrid1.ItemsSource=table.DefaultView

上のコードは、指定したクエリからDataGrid にデータをバインドできます。