kintone PLC connector
ユーザーズマニュアル (抜粋版)

形名コードKCN001-M-J

作成日

2023 年 12 月

目次
はじめに ..................................................................................................................................1
ソフトウェアのインストール..................................................................................................2
ソフトウェアの起動と終了 .....................................................................................................6
ライセンス認証と解除 (移行) ................................................................................................8
ソフトウェアの設定方法 .......................................................................................................10
ネットワーク接続方法...........................................................................................................13
ＰＬＣからのコマンド送信方法 ............................................................................................15
コマンドリファレンス...........................................................................................................16GETS ..................................................................................................................................17
GETM .................................................................................................................................18
POST ..................................................................................................................................21
PUT ....................................................................................................................................22
操作できるフィールドの種類................................................................................................23
kintone の制限 .......................................................................................................................24
アプリ数 .............................................................................................................................24
レコード数 .........................................................................................................................24一覧 ....................................................................................................................................24グラフ ................................................................................................................................24
プラグイン .........................................................................................................................24
フィールド .........................................................................................................................25
フィールド名 .....................................................................................................................25
フィールドコード ..............................................................................................................25
REST API...........................................................................................................................26
製品に関するお問い合わせ先................................................................................................27

はじめにkintone PLC connector は、Windows 上で動作するソフトウェアです。
Windows PC で本ソフトウェアを動作させることにより、PLC から送信されるコマンドに対応し、インターネット上の kintone WEB API を操作し、kintone アプリに対して、レコードの追加、更新、取得を行い、PLC にレスポンスデータを送信することができます。

動作環境
本ソフトウェアを使用するには以下の環境が必要です。
項目

仕様

対応 OS

Windows10、Windows11 (64bit) ※日本語版

CPU

各 OS が推奨する仕様に準拠

メモリ容量

各 OS が推奨する容量に準拠

必要ハードディスク空き容量

約 10MB 程度

ディスプレイ

解像度 1024×768 ドット、High Color 以上

Ethernet ポート

1 ポート以上 (インターネット接続環境必須)※使用上の注意点
kintone はサイボウズ株式会社が提供するクラウドサービスです。本サービスには定期メンテナンスがあり、その間サービスの提供が停止されます。その間 PLC 等のシステム側で処理をバッファするなどの迂回処理が可能なよう設計してください。

※登録商標について・Windows は米国 Microsoft Corporation の登録商標です。
・kintone はサイボウズ株式会社の登録商標です。

1

ソフトウェアのインストール
以下の手順に従って、本ソフトウェアをインストールしてください。
インストールは Administrator 権限を持つユーザーでログインし行ってください。
インストール中にユーザーアカウント制御の確認が表示された場合は「はい」をクリックして処理を続行してください。
[インストール手順]
１．CD-ROM 内の setup.exe をダブルクリックするとインストーラが実行されます。
２．セットアップ ウィザードが表示されたら「次へ(N)>」をクリックします。

2

３．インストールフォルダを選択し、「次へ(N)>」をクリックします。

４．インストールの確認が表示されたら、「次へ(N)>」をクリックします。

3５．インストールが開始されます。完了するまでお待ちください。

６．インストールが完了したら。
「閉じる(C)」をクリックしてください。

4７．インストールが正常に完了するとデスクトップとスタートメニューにショートカットが作成されます。

本ソフトウェアを使用する前に、readme ファイルをご一読ください。また本ソフトウェアを利用する目的でインストール操作を行った時点で、ラインセンス使用許諾に承諾されたものとなります。

5ソフトウェアの起動と終了[起動方法]
デスクトップ上のショートカットをダブルクリックするか、スタートメニューのショートカットをクリックすることで、本ソフトウェアが起動します。
[スタートアップ登録手順]
Windows の起動時に自動的に本ソフトウェアを起動させたい場合は、スタートメニューを開くか、Windows キー + R を押して「実行」ダイアログを開き、「shell:startup」と入力し、Enter キーを押します。
これにより、現在のユーザーアカウントのスタートアップフォルダが開かれます。
開いたフォルダに、本ソフトウェアのショートカットのコピーを貼り付けます。
以降、Windows が起動するたびに、本ソフトウェアが自動的に起動します。

6

[終了方法]メニューバーの「ファイル(F)」→「終了(X)」をクリックするか、右上隅のウインドウコントロールボタンの「閉じるボタン」をクリックすることで、本ソフトウェアを終了することが出来ます。ただし、PLC と通信中や、kintone の WEB API の操作中にソフトウェアを終了すると、処理が中断されますので、処理が完了していることを確認し、ソフトウェアを終了してください。

7

ライセンス認証と解除 (移行)[ライセンス認証方法]
メニューバーの「ライセンス」→「認証」をクリックし、ライセンス認証ウインドウを表示させます。

「取得」ボタンをクリックするとシリアル番号が表示されますので、そのシリアル番号と購入時に同封されているユーザーID を記入したライセンス認証依頼という件名のメールを以下のメールアドレスまで送信します。
メールアドレス： kintonePLCconnector@mina-tech.com

3 営業日以内にパスワードが返信されますので、そのパスワードを入力し、「認証」ボタンをクリックするとアクティベーションが完了します。

8

[ライセンス解除 (移行) 方法]
メニューバーの「ライセンス」→「認証」をクリックし、ライセンス認証ウインドウを表示させます。表示されているシリアル番号を控えます。次にメニューバーの「ライセンス」→「解除」をクリックしライセンス解除ウインドウを表示させます。

「解除」ボタンをクリックすると解除コードが表示されますので、控えたシリアル番号と解除コード、購入時に同封されているユーザーID を記入した、ライセンス解除依頼という件名のメールを以下のメールアドレスまで送信します。
メールアドレス： kintonePLCconnector@mina-tech.com

3 営業日以内に解除完了メールが返信されます。解除完了メールが届くと、再度「認証」手続きが可能になるので、ライセンスを移行することができます。

9ソフトウェアの設定方法① Ethernet 接続設定
IP アドレス：本ソフトウェアをインストールした PC の IP アドレスを入力します。
ポート No.：PLC の取扱い説明書を参照し、ソケット通信で使用できるポート No.を入力します。
最後に「書込」ボタンをクリックします。
② 起動設定本ソフトウェアを起動時に PLC からコマンドを受付可能状態にする場合は、「起動時接続開始」のチェックボックスにチェックを入れます。次回起動時より、接続開始状態で起動されます。

10

③ kintone 接続設定登録
登録 No. 0～99 に kintone の接続設定を登録します。
アプリ名称：登録するアプリの名称を入力します。(※接続には直接使用しません。)
kintone URL：https://temporary.cybozu.com/k/v1/※temporary の部分はユーザー毎に違います。kintone ログイン画面の以下塗りつぶし部分をご参照ください。

アプリ ID：kintone のアプリ管理画面にある対象アプリの ID を入力します。

API トークン：kintone のアプリ管理画面から対象アプリの設定→API トークンの画面に行き、API トークンがある場合はその文字列を控え入力します。
表示されていない場合は「生成する」をクリックし、生成します。

11

これらの内容を入力したら、「登録」ボタンをクリックし、設定を登録します。
最後に メニューバーの「ファイル(F)」→「名前を付けて保存」で、設定内容を保存します。保存されると、使用中設定ファイルの項目にファイルパスが表示されます。

12

ネットワーク接続方法[接続図]
インターネット
本ソフトウェアをインストールした PC

スイッチング HUB

LAN ケーブル

ソケット通信が可能な PLC

本ソフトウェアをインストールした PC の Ethernet ポートと、ソケット通信が可能なPLC の Ethernet ポートと、インターネットを接続図のように LAN ケーブル、スイッチン
グ HUB を使用し接続します。
IP アドレスは固定とし、PLC と PC は同一のセグメントである必要があります。
例えば PC の IP アドレスが 192.168.1.2 である場合、PLC の IP アドレスは 192.168.1.*（*は 2 以外の 0 から 255 までの数字で選択できる）である必要があります。
PC の IP アドレスを DHCP サーバー等で自動的に割り当てるようにすると、PC の IP アドレスが変化することがあり、その場合、本ソフトウェア上で設定する IP アドレスも変更する必要があるので、推奨しません。

13

[接続開始方法]
ライセンス認証状態で、本ソフトウェアの設定が完了し、接続図のように LAN ケーブルが接続されている状態で、メニューバーの「接続(W)」→「開始(S)」をクリックすると接続が開始されます。

接続が開始されると、通信状況の項目に「サーバーが待機中...」と表示されます。
[接続停止方法]
メニューバーの「接続(W)」→「停止(D)」をクリックすると接続が停止します。

14

ＰＬＣからのコマンド送信方法
本ソフトウェアをインストールした PC と PLC は TCP ソケット通信でデータ送受信を行います。PC 側がサーバーとなり、PLC 側がクライアントとなります。PC 側が接続開始操作を行うと「接続待ち」状態となり、PLC 側からの接続を待ち受けます。PLC 側の処理は以下のフローとなります。

PLC はクライアントとして、PC の IP アドレス、ポート No.を指定して「connect」操作を行います。接続が確立されたら、コマンドを「送信」します。コマンド送信後レスポンスを「受信」し、「接続を終了」します。これらが一連のフローとなります。
PLC のメーカーごとに、具体的な手法は異なりますが、TCP ソケット通信自体の内容は同一となります。

15

コマンドリファレンス
PLC から送信するコマンドは、レコード１件取得の「GETS」、レコード複数件取得の「GETM」、レコード１件登録の「POST」、レコード１件更新の「PUT」の４種類があります。それぞれ、本ソフトウェアがインストールされた PC がコマンドを受信後、kintone のWEB API を操作し、対応するレスポンスを PLC へ返信します。

16

GETS
アプリ ID、レコード ID、フィールド名*を指定し、レスポンスによりそのフィールド値を取得します。
[フォーマット]
GETS,{S1},{S2},fldname,{S3},{S4}フォーマット説明資料削除※フィールド名は kintone のアプリ管理上はフィールドコードを指します。
[正常時レスポンス]
ans,{フィールド値}
例：GETS,64,25,fldname,3,装置名,確認内容,確認結果 で指定した kintone アプリ上のフィールド値が、A 装置、ワーク寸法、OK の時、ans,A 装置,ワーク寸法,OK というレスポンスが返信される。フィールド値は指定したフィールド名の数だけ返信されます。
[異常時レスポンス]
指定した内容のフィールドが存在しない時、NotFound がレスポンスで返信されます。
間違った構文でコマンドを送信した時、error がレスポンスで返信されます。

17

GETM
アプリ ID、フィールド名*、検索条件を指定し、複数のレコードからレスポンスによりそのフィールド値を取得します。
[フォーマット]
GETM,{S1},fldname,{S2},{S3},condition,{S4},{S5},contents,{S6},{S7},operator,{S8},{S9},logic,{S10},{S11}フォーマット説明資料削除※フィールド名は kintone のアプリ管理上はフィールドコードを指します。
[正常時レスポンス]
ans,{フィールド値}[異常時レスポンス]
指定した内容のフィールドが存在しない時、NotFound がレスポンスで返信されます。
間違った構文でコマンドを送信した時、error がレスポンスで返信されます。

18

フォーマット説明資料削除
取得条件フィールド名に対し、取得条件フィールド値が、演算子=、!=、>、<、>=、<=、in、not in などの条件に合致するかを判定します。論理で複数ある条件を or、又は and で繋ぎます。
[演算子説明]フォーマット説明資料削除[論理説明]
フォーマット説明資料削除19

[フィールド、システム識別子ごとの利用可能な演算子一覧]
フォーマット説明資料削除

20

POST
アプリ ID、フィールド名*、フィールド値を指定し、レコードを１件登録します。レスポンスによりその成否を取得します。
[フォーマット]
POST,{S1},fldname,{S2},{S3},fldvalue,{S4},{S5}フォーマット説明資料削除※フィールド名は kintone のアプリ管理上はフィールドコードを指します。
[正常時レスポンス]
ans,{“id”:”レコード ID”,”revision”:”リビジョン番号”}[異常時レスポンス]
間違った構文でコマンドを送信した時、error がレスポンスで返信されます。

21

PUT
アプリ ID、レコード ID、フィールド名*、フィールド値を指定し、既に登録されているレコードの内容を更新します。レスポンスによりその成否を取得します。
[フォーマット]
PUT,{S1},{S2},fldname,{S3},{S4},fldvalue,{S5},{S6}フォーマット説明資料削除※フィールド名は kintone のアプリ管理上はフィールドコードを指します。
[正常時レスポンス]
ans,{”revision”:”リビジョン番号”}[異常時レスポンス]
間違った構文でコマンドを送信した時、error がレスポンスで返信されます。

22

操作できるフィールドの種類
本ソフトウェアで操作可能なフィールドの種類には制限があります。一部のフィールド種については、取得、登録、更新が出来ません。PLC から操作するフィールドに関しては以下リストにあるフィールド種を使用してアプリの設計を行ってください。
[操作可能なフィールド種類リスト]
フィールドの種類

取得

登録／更新

取得条件の指定

文字列(1 行)○○○

文字列(複数行)○○△

リッチエディター

××

×

数値

○

○

○

計算

○

－

○

チェックボックス

××○

ラジオボタン

○

○

○

複数選択

××

○

ドロップダウン○○○

ユーザー選択

××

×

組織選択

××

×

グループ選択

××

×

日付

○

○

○

時刻

○

○

○

日時

○

○

○

リンク

○

○

○

添付ファイル××

×

ルックアップ

××

×

テーブル

××

×

関連レコード一覧－－－カテゴリー

×××

ステータス

×××

作業者

×××

23

kintone の制限
kintone には各種の制限があります。その制限内でシステムを設計して頂きますよう、お願い致します。
アプリ数
スタンダードコースは 1000 個まで、ライトコースは 200 個までアプリが作成できますが、kintone PLC connector は 100 個まで接続の設定が出来ます。
レコード数
登録レコード数が多くなると、アプリの動作が遅くなる場合があります。表示やデータ処理の速度はアクセス権、絞り込み条件、フィールド数などの利用条件によって異なります。
レコードの登録や閲覧に関しては、アクセス権や絞り込みの設定を行っていない 1 つのア
プリに、100 万件を登録した状態で快適に使用できることを確認しています。

一覧
1 つのアプリにつき 1,000 件まで設定できます。
グラフ
集計の結果や項目数（小、中、大項目の合計項目数）が 500 件を越える場合は、先頭 500項目までのデータでグラフを表示します。
ただし、表の場合は先頭 1 万件までのデータで表示します。
プラグイン1 つのアプリにつき 20 個まで利用できます。

24

フィールド
1 つのアプリにつき 500 個まで設定できます。
次のフィールドは、500 個の上限に含まれません。
•ラベル

•罫線•

スペース

•

レコード番号

•

作成者

•

作成日時

•

更新者

•更新日時

フィールド名
全角または半角で 128 文字まで設定できます。
フィールドコード
全角または半角で 128 文字まで設定できます。
ただし、PLC から PC へ送受信できるバイト数が 100 バイトまでですので、出来るだけ簡潔なフィールド名にすることを推奨いたします。

25

REST API
① 同時アクセス数
・１つのドメインにつき 100 件
同時アクセス数が上限を超えると、REST API の実行時に HTTP ステータスコードが429 のレスポンスが返ります。
② 1 日に実行できる API リクエスト数
・１つのアプリにつき、10,000 件
API リクエスト数を超過した場合、翌日の日本時刻午前 9:00 頃にサイボウズドットコ
ム ストアの管理者のメールアドレスに警告メールが送信されます。
その他制限事項は kintone の WEB サイトでご確認ください。

26

製品に関するお問い合わせ先
株式会社ミナテック
kintone PLC connector 販売係■営業時間 9:00 ～ 17:00■営業日 平日

電話 ０７４８－６４－９０４５
FAX ０７４８－６４－９０４６
営業時間外のお問い合わせはｅメールまで
kintonePLCconnector@mina-tech.com

27