Automate Kintone Integration Tasks from PowerShell

The CData Cmdlets for Kintone are standard PowerShell cmdlets that make it easy to accomplish data cleansing, normalization, backup, and other integration tasks by enabling real-time and bidirectional access to Kintone.

PowerShell Cmdlets or ADO.NET Provider?

The Cmdlets are not only a PowerShell interface to Kintone, but also an SQL interface; this tutorial shows how to use both to create, retrieve, update, and delete Kintone data. We also show examples of the ADO.NET equivalent, which is possible with the CData ADO.NET Provider for Kintone. To access Kintone data from other .NET applications, like LINQPad, use the CData ADO.NET Provider for Kintone.

Once you have acquired the necessary connection properties, accessing Kintone data in PowerShell can be enabled in three steps.

In addition to the authentication values, set the following parameters to connect to and retrieve data from Kintone:

• Url: The URL of your account.
• GuestSpaceId: Optional. Set this when using a guest space.

Authenticating with Kintone

Kintone supports the following authentication methods.

Using Password Authentication

You must set the following to authenticate:

• User: The username of your account.
• Password: The password of your account.

Using Basic Authentication

If the basic authentication security feature is set on the domain, supply the additional login credentials with BasicAuthUser and BasicAuthPassword. Basic authentication requires these credentials in addition to User and Password.

Using Client SSL

Instead of basic authentication, you can specify a client certificate to authenticate. Set SSLClientCert, SSLClientCertType, SSLClientCertSubject, and SSLClientCertPassword. Additionally, set User and Password to your login credentials.

PowerShell

1. Install the module:

   Install-Module KintoneCmdlets

2. Connect:

   $kintone = Connect-Kintone -User "$User" -Password "$Password" -Url "$Url" -GuestSpaceId "$GuestSpaceId"

3. Search for and retrieve data:

   $appid = "1354841" $comments = Select-Kintone -Connection $kintone -Table "Comments" -Where "AppId = `'$AppId`'" $comments

   You can also use the Invoke-Kintone cmdlet to execute SQL commands:

   $comments = Invoke-Kintone -Connection $kintone -Query 'SELECT * FROM Comments WHERE AppId = @AppId' -Params @{'@AppId'='1354841'}

ADO.NET

1. Load the provider's assembly:

   [Reflection.Assembly]::LoadFile("C:\Program Files\CData\CData ADO.NET Provider for Kintone\lib\System.Data.CData.Kintone.dll")

2. Connect to Kintone:

   $conn= New-Object System.Data.CData.Kintone.KintoneConnection("User=myuseraccount;Password=mypassword;Url=http://subdomain.domain.com;GuestSpaceId=myspaceid") $conn.Open()

3. Instantiate the KintoneDataAdapter, execute an SQL query, and output the results:

   $sql="SELECT CreatorName, Text from Comments" $da= New-Object System.Data.CData.Kintone.KintoneDataAdapter($sql, $conn) $dt= New-Object System.Data.DataTable $da.Fill($dt) $dt.Rows | foreach { Write-Host $_.creatorname $_.text }

Update Kintone Data

PowerShell

ADO.NET

Insert Kintone Data

PowerShell

ADO.NET

Delete Kintone Data

PowerShell

ADO.NET