ノーコードでクラウド上のデータとの連携を実現。
詳細はこちら →無償トライアル:
無償トライアルへ製品の情報と無償トライアルへ:
DocuSign データにリアルタイム連携を実現するPowerShell Cmdlets。Cmdlets を使って、SQL Server と同感覚で多様なデータにリアルタイムアクセス。
古川えりか
コンテンツスペシャリスト
Cmdlets
CData Cmdlets Module for DocuSign は、直感的なDocuSign データ連携を提供する標準cmdlet です。 本記事では、DocuSign Cmdlets を使ったサンプルを提供します。
DocuSign への接続には以下の接続プロパティを設定します:
DocuSign はOAuth 認証標準を利用しています。OAuth を使って認証するには、アプリケーションを作成してOAuthClientId、OAuthClientSecret、およびCallbackURL 接続プロパティを取得しなければなりません。認証方法については、ヘルプドキュメントの「OAuth 認証の使用」を参照してください。
$conn = Connect-DocuSign -OAuthClientId "$OAuthClientId" -OAuthClientSecret "$OAuthClientSecret" -CallbackURL "$CallbackURL"
次の手順で、Documents テーブルデータを取得して、結果をCSV ファイルにエクスポートします:
Select-DocuSign -Connection $conn -Table Documents | Select -Property * -ExcludeProperty Connection,Table,Columns | Export-Csv -Path c:\myDocumentsData.csv -NoTypeInformation
このように、Select-DocuSign から取得した結果を、Select-Object cmdlet に流し、Export-Csv cmdlet に渡す前にいくつかのプロパティを除外しています。これは、CData Cmdlets が接続情報、テーブル、およびカラム情報が結果セットのそれぞれの"行"に挿入されるためです。それらの情報を表示したくない場合に、Export-Csv cmdlet に渡す前に除外を先に行い、それからCSV ファイルにエクスポートします。。
CData Cmdlets から、次のCmdlets にデータをパイプラインするところでは、接続、テーブル、カラムの情報が必要です。以下のように、指定に合致するレコードを削除することができます:
Select-DocuSign -Connection $conn -Table Documents -Where "DocumentName = TPSReport" | Remove-DocuSign
CData Cmdlets は、データの加工やクレンジングを行うことができます。以下の手順では、CSV ファイルのデータを、挿入対象のオブジェクトに同じレコードが存在するかを確認した上で、存在する場合にはデータの更新、存在しない場合にはデータの挿入を行います。
Import-Csv -Path C:\MyDocumentsUpdates.csv | %{ $record = Select-DocuSign -Connection $DocuSign -Table Documents -Where ("Id = `'"+$_.Id+"`'") if($record){ Update-DocuSign -Connection $docusign -Table Documents -Columns ("DocumentId","DocumentName") -Values ($_.DocumentId, $_.DocumentName) -Where ("Id = `'"+$_.Id+"`'") }else{ Add-DocuSign -Connection $docusign -Table Documents -Columns ("DocumentId","DocumentName") -Values ($_.DocumentId, $_.DocumentName) } }
このように、CData Cmdlets でデータ連携をシンプルに構成できます。Cmdlets では、モジュールのインストール、接続プロパティの設定だけで、データ連携の構築を始めることができます。是非、CData PowerShell Cmdlets の無償試用版をダウンロードして、シンプルかつパワフルなデータ連携を体感してください。