ATTAZoo U について

製品説明

ATTAZoo Uは、一つのkintone環境内では実現が難しい「kintone環境を超えたデータ連携」を行うための機能をプラグイン形式でご利用することができるサービスです。

プラグイン形式のため、JavaScriptやCSSによるカスタマイズは不要で、誰でもかんたんに「kintone環境を超えたデータ連携」を行うことができ、kintoneを用いた更なる業務改善、効率化を実現できます。

製品の概要は以下の「ATTAZoo U」製品ホームページをご確認ください。

https://www.jbat.co.jp/lp/attazoou/

動作環境

プラグインの導入にはkintone スタンダードコースが必要です。 提供するプラグインは以下Webブラウザ・アプリを動作環境としております。

Windows

- Internet Explorer 11（2022年6月まで）

• Microsoft Edge 最新版
• Mozilla Firefox 最新版
• Google Chrome 最新版

Android 11

- Android Chrome 最新版

• kintoneモバイルアプリ

iOS 13, 14, 15

- Safari 13 / 14 / 15

• kintoneモバイルアプリ

併せてkintoneの動作環境に準じる必要があります。詳しくは以下のURLからご確認ください。 https://www.cybozu.com/jp/service/requirements.html

※上記Webブラウザ以外の動作に関しては対応検討中となります。

※モバイル端末のブラウザにてPC版の画面を利用した場合の動作はサポート対象外となります。

※webStorage機能が有効なブラウザのみ動作いたします。

※kintoneアプリの設定「言語ごとの設定」がされているアプリには対応しておりません。

プラグイン共通のご利用時注意事項

1. kintoneプラグインはWebブラウザ上で動作するプログラムを動かすことによって様々な機能を提供いたします。本製品はkintoneプラグインの基盤を利用しているため、他のシステムからAPIを通してレコードを登録するなどを実施した場合は、機能は動作せずプラグインに設定した内容は保証されません。
2. 複数のプラグインやカスタマイズと組み合わせることによって、プラグインの機能が制限され、正しく動作しなくなることがあります。プラグインを組み合わせてご利用いただく際は、必ず動作確認をしてからご利用ください。
3. 動作環境にないブラウザをご利用の場合はプラグインが正常に動作しない場合があります。
4. 必ず各プラグインの注意事項・制限事項をご確認の上ご利用ください。
5. プラグインが参照しているフィールド情報を変更した場合は、プラグインが保持しているフィールドコード設定情報を更新する必要があります。プラグインの設定画面を再度開き、設定内容を確認・修正後、設定を保存してアプリの更新をしてください。
6. 無料体験版から製品版へ切り替える際は、プラグインを上書きアップデートしてください。無料体験版で設定された内容は製品版にも引き継がれます。
7. 無料体験版と製品版を併用しないようにしてください。エラーなど警告が表示されなくなるなど、動作が不安定になることがあります。
8. 製品ご購入時に登録いただいたドメイン以外のご利用や、契約期限を超えた場合のご利用はできません。ドメインを変更される場合は、速やかにサポートサイトより変更日をご連絡ください。ご登録いただいていない環境でご利用いただいている場合、プラグインのご利用をリモートで停止させていただくことがあります。
9. アプリ設定の「アプリの動作テスト」は動作保証外となります。また、「アプリの動作テスト」時にも本番アプリの情報が利用・適用されます。アプリの動作テスト時にレコード追加・更新を実施するようなプラグインを利用しないようにしてください。プラグインの動作テストはテスト用のアプリにて実施し適用してください。
10. 本製品の表示言語はcybozu.comに設定した個人設定の表示言語によって切り替わります。また、現在は表示言語が日本語以外のユーザーに対しては英語表記で提供されます。
11. 一部のプラグインでは、ブラウザが参照するシステム時間や設定されたタイムゾーンを利用して日付の更新を実施します。
12. プラグインが参照するアプリ名を変更した場合、プラグイン動作として引き続きの利用は可能ですが、画面上に表記されるアプリ名が変更前の状態となる場合があります。これを変更後のアプリ名に変更するにはプラグインの設定画面を再度開き、設定内容を確認・修正後、設定を保存してアプリの更新をしてください。
13. kintoneアプリのその他設定、「言語ごとの設定」に関しては動作を保証しておりません。また、この機能と同様な、明示的に英語と日本語との表示を切り替えるような設定は準備しておりません。
14. レコード件数が10万レコードを超えるアプリに対してプラグインを利用する際や、そのアプリを参照する際に、REST APIの制約によりレコードの取得ができずにエラーとなる場合があります。その際は、レコードのアクセス権を設定することや、一覧の絞り込み条件を足すなど10万件未満のレコード取得となるような設定を追加する必要があります。
15. kintoneプラグイン設定は256KB以上の設定を保管することはできません。そのため、フォーム情報や設定する条件値の内容によっては設定が保存できず、ご利用いただけない場合があります。

本製品の導入方法

プラグインのインストール方法、アンインストール方法、アップデート方法に関しては以下のマニュアルをご参照ください。

https://docs.jbat.co.jp/attazoo/install/installv1.0/ja/index.html

プラグインの利用方法

ATTAZoo 共通機能について

プラグイン設定画面の共通機能

Webマニュアルの閲覧機能

ボタンを押下することで現在開いているプラグインのマニュアルを開きます。

プラグイン設定の書き出し機能・読み込み機能について

一部のプラグインはプラグインの書き出し、読み込み機能があります。対応状況は以下対応表の通りです。

プラグイン設定の書き出し・読み込み対応表　◯：対応済み △：一部対応 ✕：未対応 ー：対応予定なし

※１　他ドメインへの読み込みが未対応の場合、他ドメインのアプリに読み込むとアプリIDが見つからず、プラグイン動作時にエラーとなったり、設定画面が開かないなど、動作が不安定となる可能性があります。

プラグイン設定の書き出し機能

保存されたプラグイン設定をファイルに書き出します。

この機能はプラグイン設定が存在する場合のみ表示されます。

書き出しの際、現在の画面に設定されている内容ではなく保存された内容にて書き出します。現在の画面に設定されている内容を保存する場合は一度保存してから再度画面を開いて書き出しを実施してください。

また、書き出される内容にはAPIトークンなどの情報が含まれる場合があります。ファイルの取り扱いには十分にご配慮ください。

プラグイン設定の読み込み機能

書き出されたプラグイン設定ファイルを読み込みます。

この機能はプラグイン設定が存在する場合のみ表示されます。また、一部のプラグインは設定の内容上ご利用ができないため表示されません。

読み込むファイルについて、以下ファイルの場合は正しく動作しない場合があります。必ずご確認の上ご利用ください。 また、動作しない場合はプラグイン設定も開かなくなる可能性があります。その場合は一度アプリからこのプラグインの利用を解除し再度設定してください。

・書き出しを実施したアプリと同様のアプリでないアプリに読み込みを実施した場合 　書き出しを実施した時点のアプリ情報と、読み込んだアプリのアプリ情報が一致している必要があります。フィールドコードが存在しない場合や変更している場合などは正しく動作せず動作が不安定となる可能性があります。

・他アプリを設定しているプラグインつ、他ドメインにて書き出さされたファイルではない場合 　関連レコード一覧集計＋、ルックアップ＋、テーブルデータ転送＋、アプリ間レコード更新＋など他アプリの情報を含む場合、他ドメイン上ではアプリIDが一致せず、正しく読み込むことができません。他アプリやIDを設定していない場合は正しく読み込むことが可能です。

・より新しいバージョンにて書き出したファイルを読み込んだ場合 　ATTAZoo では後方互換性を有しておりますが、先方互換性は有しておりません。そのため、新しいバージョンの設定内容を古いバージョンに読み込むことができない場合があります。そのような場合はプラグインを再度開いて保存するなどして動作をご確認ください。

・アプリ固有の情報を持っている書き出した他アプリに読み込む場合 　自動採番＋V2プラグインにて書き出したファイルを他のアプリに対して読み込む場合は、APIトークンを再度取得して再入力してください。

ATTAZoo U アプリ間レコード更新

機能紹介

レコード追加・編集保存時に他アプリのレコードを更新することで、編集された情報をリアルタイムに反映することができるプラグインです。レコード追加画面、編集画面、およびレコード一覧のインライン編集保存時に動作します。

利用方法

一つのレコードの編集を行うことにより、同時に他アプリのレコード更新を行うことが可能となります。これにより、同じステータスを管理するようなアプリが点在しているものや、日付を利用しているアプリに対して設定することが可能になります。

こちらの例でいうと、出荷管理アプリに本プラグインを設定することで、出荷管理アプリのレコードを変更した際に案件管理アプリ、受注管理アプリ上にある出荷管理アプリに関連するフィールドを更新することが可能になります。

・プラグイン利用時の内容について

プラグイン設定にて更新対象となるフィールドを設定し、レコード追加画面、レコード編集画面、インライン編集画面から保存した際に、以下のようなダイアログが表示されます。こちらのダイアログにて更新結果が表示されます。

更新結果を通知するダイアログ

更新元フィールドに変更がない場合や、キーの値が空欄の場合は更新されず更新のダイアログは表示されません。

設定方法

プラグインをインストール後、設定画面を開きます。設定画面を開いて保存ボタンを押し、アプリを更新するまでプラグインは有効になりません。

・更新先アプリの設定

① アプリ検索の入力欄

テキストボックスにアプリ検索に使用したいワード(アプリ名の一部など)を入力してください。

② アプリ検索ボタン

ボタンを押して、アプリ検索してください。アプリは「①アプリ検索の入力欄」の入力で検索されます。検索されたアプリは、「③アプリの指定」のドロップダウンに表示されます。

③ アプリの指定

ドロップダウンからデータ転送先に指定したいアプリを選択してください。

・APIトークンの設定

① APIトークン設定画面リンク

更新先アプリの設定をすることで表示されます。リンクを押下することで更新先アプリのAPIトークン設定画面が別ウィンドウで表示されます。

② APIトークンの入力

更新先のレコード閲覧とレコード編集が可能なAPIトークンを設定します。APIトークンは、①の画面にて表示されるランダムな文字列を指します。詳しくは以下のkintoneヘルプをご確認ください。

https://jp.cybozu.help/k/ja/user/app_settings/api_token.html

・更新先アプリの設定(他ドメインのkintoneに対して更新する)

① 他ドメインのkintoneに対して更新する

他ドメインのkintoneアプリに対して更新したい場合、チェックを入れてください。

② サブドメイン名

更新したいアプリがあるkintoneのサブドメイン名を入力してください。

XXXXX.cybozu.com

③ アプリID

更新したいアプリのアプリIDを入力してください。アプリIDはアプリ管理画面のアプリの一覧表、もしくはアプリを開いた際のURLに記載されています。以下の例の場合、アプリIDは279です。

https://example.cybozu.com/k/279/

④ APIトークン

更新先アプリのレコード閲覧とレコード編集が可能なAPIトークンを設定します。

詳しくは以下のkintoneヘルプをご確認ください。

https://jp.cybozu.help/k/ja/user/app_settings/api_token.html

⑤ ゲストスペースID

更新したいアプリがゲストスペースにある場合、ゲストスペースIDを入力してください。ゲストスペースIDはkintoneシステム管理にあるスペース管理画面のスペースの一覧表、もしくはアプリを開いた際のURLに記載されています。以下の例の場合、ゲストスペースIDは2です。

https://example.cybozu.com/k/guest/2/<アプリID>/

⑥ フィールド取得

②～⑤の入力情報を利用して、他ドメインのkintoneアプリのフィールド情報を取得します。取得に成功すると「更新キーの設定」以降の設定を行うことができるようになります。

・更新キーの設定

① 更新元のキーフィールド

更新元キーフィールドをこのアプリのフィールドから選択します。

② 更新先のキーフィールド

更新先フィールドを更新先アプリに指定したアプリのフィールドから選択します。

キー参照先フィールドは「値の重複を禁止する」にチェックを入れたフィールドである必要があります。

・更新対象フィールドの設定

① 更新元フィールド

更新元フィールドを選択します。更新元フィールドを選択すると、更新先フィールドのドロップダウンが選択できるようになります。

② 更新先フィールド

更新先フィールドを選択します。更新先フィールドは以下の表に対応する転送先フィールドが選択可能です。

更新元フィールドと更新先フィールドで選択できるフィールドタイプ一覧

③ 設定の追加ボタン

複数の更新フィールドを設定したい場合、ボタンを押すと設定行を追加できます。

ATTAZoo Uでは50フィールドまで追加することが可能です。

④ 設定の削除ボタン

設定を削除したい場合、ボタンを押すとその設定行を削除できます。

・新規レコードの追加設定

① 新規レコードの追加機能を有効にする

この設定を有効にすると更新先アプリに更新キーと合致するレコードが存在しない場合に、更新先アプリに新規レコードを追加します。追加の際は[更新キー]と[更新対象フィールド]に設定されたフィールドの値を用いて追加します。この設定を有効にする場合はAPIトークンにレコード追加の権限を設定してください。

入力必須のフィールドがある場合など、データ制約を満たしていない場合は追加時にエラーとなります。

この設定はプラグインが動作したタイミングにおいてそのレコードに対する動作となりますので、有効にしたことでレコードが一括追加されるなどということはありません。

本機能はAPIを利用したレコード追加となります。新規レコードが追加されるアプリ（更新先アプリ）にてレコード追加時に動作するプラグイン（ATTAZoo＋自動採番＋等）を設定していても該当プラグイン機能は動作されません。その際は追加されたアプリにて一括採番するなどの運用をご検討ください。

・タブの設定

① 新しいタブの追加ボタン

新しいタブを追加したい場合、ボタンを押すと新しいタブを追加できます。新しいタブを設定することにより、複数のアプリに対してレコードを更新することが可能となります。ATTAZoo Uでは20タブ（20アプリ）まで設定することが可能です。

② タブの削除ボタン

タブを削除したい場合、ボタンを押すと押したタブの設定を削除することができます。削除するときに確認ダイアログが表示されます。

注意事項

1. ATTAZoo ルックアップ＋プッシュ更新と同アプリでご利用いただくことはできません。正しく更新できないことがあります。
2. フィールドコードを変更した場合、正しく処理できずエラーとなって正常に動作しなくなることがあります。変更された場合、プラグインを再設定してください。
3. kintoneのCSV読み込みや、他プラグイン上からのAPIによってレコードが更新された場合は動作対象外となります。
4. 更新対象となるレコードの編集画面を開いていた際にプラグインによってレコード更新が実行された場合、その編集画面のレコード編集は保存できません。画面を再描画する必要があります。
5. 更新先のレコードの内容にて入力必須の項目が存在しない場合や、文字列1行及び数値の制限値に不備がある場合など、レコードを更新するための要件に一致しない場合はエラーとなります。プラグインを設定する際は、更新先のフォーム設定内容とレコードの入力内容を確認するなど、レコード更新が可能な状況であることご確認の上ご利用ください。
6. 更新先のフィールドにドロップダウンを選んでいる場合、選択肢にない値で更新しようとするとエラーとなります。ドロップダウンを選択する際はお互いに同一の選択肢を持つように設定するようにしてください。
7. 更新先フィールドにルックアップフィールドを指定することはできません。
8. 更新元キーの値が空欄の場合は更新されず更新のダイアログは表示されません。
9. ルックアップ元からコピーされるフィールドに設定されているフィールドや、自動計算が設定されている文字列1行フィールドを更新先フィールドに指定しても更新することはできません。
10. 更新先キーのフィールドを更新先フィールドに設定することはできません。更新時にエラーとなります。
11. 更新元フィールドに設定可能な計算フィールドに対して、更新先フィールドに数値フィールドを指定している場合、計算結果として「数値」を選択している場合のみ利用可能です。
12. ゲストアプリから通常アプリに設定するなど、更新先の環境に同一ユーザーが存在しない状況下でユーザーに関連する作成者、更新者、ユーザー選択フィールドを設定しないようにしてください。該当ユーザーが含まれた場合、レコード更新実行時にエラーとなります。
13. リンクフィールドを設定する際、更新元と更新先は同一の入力値の種類を設定してください。
14. プラグイン実行時の更新処理に失敗した場合を想定し、アプリの更新は2段階で実施されます。 ① 外部サーバーからAPIトークン認証を用いて更新処理を実施します。 ② ①が失敗した場合、セッション認証を利用して更新処理を実施します。 ①に関しては、APIトークンを使うためアクセス権のないレコードに対しても更新処理が実施されます。この際は、IPアドレス制限の設定をしている環境の場合更新に失敗します。 ①の更新処理に失敗した場合、そのユーザーのセッション認証にて再実行を行います。その際、APIトークンは利用されず、アクセス権のないレコードに対して更新はされません。他ドメインのアプリを更新先に設定している場合は②の更新処理は実行されません。
15. IPアドレス制限を設定している環境において、ゲストスペース内のアプリから通常のアプリに対して更新する設定をすると、ゲストユーザーの更新によって動作した場合は権限エラーとなります。

ATTAZoo U データ更新用二次元コード生成

機能紹介

kintoneのレコードを更新するための二次元コードを生成し、レコードに保存します。生成された二次元コードを読み込んで得られたURLにWebアクセスがあった場合、設定に従ってkintoneのレコードが更新されます。 kintoneの画面を開くことなく、またkintoneのアカウントを持たないユーザーにおいてもレコード更新をすることが可能です。

利用方法

kintoneの画面を開くことなく動作させることが可能なため、kintoneの使い方を知らないようなユーザーにおいてもご利用いただくことが可能です。

以下、このプラグインの利用例をご紹介します。

（利用例）製品の工程進捗管理

kintoneによって工程進捗を管理します。作業指示書に印刷されたQRコードを読み込むか、外部モニター上に表示されたQRコードを手持ちのスマートフォンで読み取ることでkintoneのフィールドが更新され、現場の作業状況をリアルタイムに知ることが可能になります。

はじめにkintoneに進捗管理アプリを作成します。ここではアプリストアの「製造業工程進捗管理」を利用します。

次に、アプリ内の工程がQRコードの読み取りによって進むようにプラグインを設定します。更新のリンクを作成する文字列（１行）フィールドとQRコードの画像を追加する添付ファイルフィールドを追加します。

プラグインの設定画面を開き、ATTAZoo データ更新用二次元コード生成プラグインを追加します。

プラグインの歯車アイコンを押下して設定画面を開きます。今回は読み込むことで工程が進捗するように「順序更新」の更新タイプを使いプラグインを設定します。このように更新する値の設定をすることで、[A工程]の内容をQRコードが読み込まれる度に進捗させることが可能になります。プラグインを保存し、アプリを更新します。

レコードを追加、編集するとプラグインが動作します。

動作すると以下のように指定したフィールドに対して自動的にQRコードとURLのリンクが生成されます。

このQRコードを読み込むか、URLを読み込むことでレコード更新がされます。

QRコードやURLリンクを読み込むと以下のような画面が表示され、レコード更新が正常に行われたことを確認可能です。

更新タイプが[順次更新]のため、二回目にQRコードやURLリンクを読み込むことで[着手中]の工程が[完]となることを確認します。

このようにQRコードやURLリンクを読み込むことでレコードを更新可能になり、運用の一部として機能させることで工程進捗をリアルタイムで確認することが可能になります。

※QRコードはデンソーウェーブ株式会社の登録商標です。

設定方法

プラグインをインストール後、設定画面を開きます。設定画面を開いて保存ボタンを押し、アプリを更新するまでプラグインは有効になりません。

・更新タイプの設定

QRコードやURLを読み込んだ際の更新タイプを設定します。

[一括置き換え]・・・更新する際に指定したすべての対象フィールドを一度に更新します。QRコードやURLリンクが読み込まれる度にこの値に変更されます。

[順序更新]・・・・・[更新後の値]の最終行から比較し、値が一致した行の次の行に指定された[更新後の値]でフィールドを更新します。いずれの行とも一致しない場合や最終行の値と一致した場合は更新されません。

[繰り返し]・・・・・最後の行の値と一致した場合に最初の行の値に更新します。（現在開発中の機能となりご利用いただけません。）

・更新する値の設定

更新する値を設定します。対象フィールドとしてご利用可能なフィールドは以下のとおりです。

更新値に指定可能な対象フィールド表

ドロップダウンとラジオボタンを更新する際は、項目の値と完全一致している必要があります。

更新タイプが[一括置き換え]の場合のみ、日付、時刻、日時フィールドに{{now}}という値を入力することで現在日本時間にて値が更新されます。その他の更新タイプやこれ以外のフィールドに対して{{now}}という値を更新後の値として利用することはできません。

日付タイプの固定値を入力したい場合は[YYYY-MM-DD]のフォーマットを入力します。

時刻タイプの固定値を入力したい場合は[HH:mm]のフォーマットを入力します。

日時タイプの固定値を入力したい場合は[YYYY-MM-DDTHH:mm:SSZ]のフォーマットを入力します。

例）2021年12月24日21時30分00秒の場合、[2021-12-24T21:30:00Z]と指定します。

文字列複数行フィールドに改行コードを含めることはできません。

数値フィールドに対しては数字を指定してください。

・APIトークンの設定

このアプリのアプリ設定から閲覧と編集権限のあるAPIトークンを設定してください。

表示されているリンクをクリックすることでこのアプリのAPIトークンの設定ページを開きます。APIトークンを生成しトークンの文字列をコピーし、そのトークン文字列をフィールドに入力します。

・QRコード画像を保存するフィールドの設定

QRコード画像を保存する添付ファイルフィールドを指定します。

指定したフィールドに対して生成されたQRコードの画像が保存されます。QRコードを生成する際にこの添付ファイルフィールドの内容はQRコード画像に置き換えられるため、QRコードを保存する用途としてのみ利用するようにしてください。

・URLを保存するフィールドの設定

URLを保存するフィールドを設定します。文字列1行フィールドが利用可能です。

指定したフィールドに保存されるURLにアクセスすることで本プラグインが動作し、レコードが更新されます。QRコードを読み込んだ際はこのURLにアクセスしたことと同等の動作になります。

・レコード詳細画面表示時にURLを生成する機能の設定

レコード詳細画面を表示した時、[URLを保存するフィールド]の値が空の場合、URLを生成してレコードを更新します。その際、QRコードを保存する設定をしていた場合は同時にQRコードを生成します。

・レコード更新時の表示内容の設定

URLにアクセスしてレコード更新する際に表示される内容を設定します。

更新された内容を表示する設定をしている場合、更新されたレコードの内容がテーブル形式で表示されます。

更新されたkintoneレコードへのリンクを表示する設定をしている場合、更新されたkintoneレコードへのURLリンクが表示されます。

注意事項

1. IPアドレス制限をしているドメインにおいて利用することはできません。
2. URLを保存するフィールドに入力があった場合、URLやQRコードは生成されません。生成する場合はフィールドを空にして保存してください。
3. QRコードを保存する添付ファイルフィールドに他の画像をファイルが保存されている際に本プラグインが動作すると、該当するフィールドの添付ファイルがクリアされてQRコード画像が生成されます。
4. このプラグインの設定を保存したあとはなるべく早くアプリの更新をするようにしてください。このプラグインはプラグインの設定を保存するタイミングにおいて弊社サーバーに対して設定内容と同等の内容を保管します。そのため、プラグインの設定を変更して保存している間にプラグインが動作するとフォーム編集中のフィールドコードや項目名にて動作してエラーとなることがあります。
5. プラグイン保存後にアプリの設定変更を中止するとkintone上のプラグインの設定と弊社サーバー上の設定に齟齬が発生し予期せぬエラーとなることがあります。アプリの設定変更を中止した場合は速やかにプラグイン設定から旧設定のプラグイン情報を設定し直してください。
6. プラグインの設定を変更した場合、それまでに作成されたQRコードの動作は新しく設定したプラグインの動作となります。
7. 評価版ご利用時にプラグインが設定した場合、プラグインを削除してからプラグインを再設定するとそれまでに設定されていたQRコードやURLリンクは旧設定にて動作し続けます。その際、旧設定のQRコードの設定変更はできません。また、新規に生成したQRコードは新規設定にて動作します。
8. 本プラグインはゲストスペースのアプリ、英語対応はしておりません。また、モバイルアプリには対応しておりません。（QRコードやURL読み込みによってレコードを更新することは可能です。）

© 2022 JB Advanced Technology Corporation , All Rights Reserved.