連携コネクタには、「繰り返し」や「条件分岐」をはじめ、データの変換や整形など、連携を便利にする機能があります。
それらを使いこなすことで、より高度な連携を実現できます。

変換テーブルは、連携元の値を、連携先で使える値へ置き換える機能です。
たとえば、kintoneのユーザー選択フィールドのログイン名を、Outlookでメールを送るためのメールアドレスに置き換えられます。
シナリオの中で作った値を、一時的に保存する場所としてもよく使われます。

本記事では、変換テーブルのしくみと使い所を紹介します。
後半では、kintoneのユーザーをメールアドレスへ変換するシナリオを例に、設定方法を紹介します。

変換テーブルは、キーと変換後の値の対応表を作成し、シナリオの中で利用できる機能です。
シナリオでキーを指定すると、対応する値を取り出せます。

変換テーブルは、1つの「キー列」と、最大4つの「変換バリュー列」で構成されます。
キー列には検索に使う値を、変換バリュー列にはそのキーに対応する変換後の値を登録します。
たとえば、商品コードをキー列にして、商品名と単価を変換バリュー列にすると、商品コードから商品名と単価を取り出せます。

変換テーブルには、次の仕様があります。

項目	内容
作成単位	プロジェクトごとに作成します。別のプロジェクトの変換テーブルは参照できません。
変換バリュー列の数	最大4つです。
レコード数	最大1,000件です。
キー列の値	同じ値を重複して登録できません。 レコードを追加したあとは変更できません。変更できるのは変換バリュー列の値だけです。
編集権限	「所有者と管理者のみ」または「プロジェクト内全員」から選択します。

変換テーブルの概要は、次のページを参照してください。
変換テーブル

変換テーブルは、連携コネクタの画面で作成します。

シナリオの中では、アクションを使って変換テーブルを操作します。

シナリオで使える変換テーブルのアクションは、次の5つです。

アクション	説明	主な用途
レコードの取得	キーを指定して、1件のレコードを取得します。 該当するレコードがない場合はエラーになります。	値の変換、保存した値の読み出し
複数レコードの取得	変換バリュー列の値を条件に、複数件のレコードを取得します。 条件は「完全一致」か「部分一致」から選択します。 該当するレコードがない場合は、エラーにはならず、取得したレコードが0件という結果になります。	保存した値をまとめて読み出す
レコードの追加	キー列と変換バリュー列の値を指定して、レコードを追加します。	値の保存
レコードの更新	キー列の値を指定して、レコードを更新します。	保存した値の書き換え
レコードの削除	キー列の値を指定して、レコードを削除します。	使い終わった値の削除

各アクションの設定方法は、次のページを参照してください。
変換テーブル コネクタ

変換テーブルは、大きく分けて次の2つの使い方があります。

使い方	こんなとき
値の変換	連携元の値を、連携先で使える値に置き換えたい
値の一時的な保存	繰り返しの中で作った値をあとで使いたい、前回の実行日時を次回に使いたい

値の変換に変換テーブルを使うのは、連携元と連携先のどちらのサービスにも、値を変換するしくみがないときです。

たとえば、商品コードから商品名と単価を取り出すだけなら、kintoneのルックアップで済みます。
しかし、ユーザー選択フィールドで選んだユーザーのメールアドレスを取り出すしくみは、kintoneのアプリの機能にはありません。
このような場合に、変換テーブルが役立ちます。

変換テーブルが向いているのは、次のような場合です。

こんなとき	キー列	変換バリュー列
kintoneのユーザーにメールを送りたい	ログイン名	メールアドレス
取引先ごとに書類の保存先を変えたい	取引先コード	保存先フォルダー名
問い合わせの分類ごとに通知先を変えたい	分類	通知先の担当者
数件の商品について、商品コードから商品名と単価を補いたい	商品コード	商品名、単価

一方で、変換テーブルが向いていないのは、次のような場合です。

こんなとき	向かない理由	代わりの方法
変換後の値を5つ以上取り出したい	変換バリュー列は最大4つです。	kintoneのマスターアプリで管理する
1,000件を超えるマスターを使いたい	変換テーブルのレコード数の上限は1,000件です。	kintoneのマスターアプリで管理する
マスターを頻繁に更新したい	変換テーブルのレコードは、画面から1件ずつ追加・編集します。	kintoneのマスターアプリで管理する

変換テーブルのレコードは、シナリオの中でアクションを使って追加・更新・削除できます。
そのため、シナリオの中で作った値を一時的に保存する場所としても使えます。

繰り返しブロックの中で作った値は、ブロックの外のステップから参照できません。
また、前回の実行で作った値は、次回の実行では使えません。
このような値を受け渡したいときは、変換テーブルに保存しておきます。

こんなとき	保存する値	例
繰り返しで1件ずつ取り出した値を、繰り返しのあとでまとめて使いたい	繰り返しの中で取り出した値	kintoneのテーブルに入力した複数の出席者のメールアドレスを、Outlookの予定にまとめて設定する
前回の実行以降のデータだけを取得したい	前回の実行日時	スケジュール実行で、前回の実行日時から今回の実行日時までのGaroonの予定をkintoneに登録する

繰り返しブロックの中で作った値を、ブロックの外で使う

繰り返しブロックの中で作った値を、変換テーブルを経由してブロックの外のステップへ受け渡します。
流れは次のとおりです。

1. 繰り返しブロックの中で、値を1件ずつ変換テーブルの「レコードの追加」で保存します。
2. 繰り返しのあとで、変換テーブルの「複数レコードの取得」を使って保存した値をまとめて取得します。
3. 繰り返しアクションや表データのアクションで値を取り出し、後続のステップで使います。
4. 使い終わったレコードを、繰り返しの中で変換テーブルの「レコードの削除」を使って削除します。

繰り返しブロックの中と外で参照できる値は、次の記事で説明しています。
連携コネクタ「繰り返し」アクションの使い方

前回の実行日時を保存して、次回の実行で使う

スケジュール実行のシナリオで、前回の実行以降に追加されたデータだけを取得したい場合があります。
このようなときは、固定のキーで1件のレコードを変換テーブルに登録しておきます。
流れは次のとおりです。

1. 変換テーブルに、固定のキー（例：time）で初期値の日時を手動で登録しておきます。
2. シナリオの最初に、変換テーブルの「レコードの取得」で前回の日時を取得し、データを取得するときの条件に使います。
3. シナリオの最後に、変換テーブルの「レコードの更新」で今回の実行日時を書き込みます。

変換テーブルを使ったシナリオは、次の記事で紹介しています。
各記事では、設定手順をステップごとに説明しています。
シナリオを作成する際の参考にしてください。

記事	使い方	変換テーブルで行っていること
kintoneのスケジュールをOutlookに登録する方法【複数出席者を1本のシナリオでまとめて連携】	値の一時的な保存	出席者のメールアドレスを繰り返しの中で1件ずつ保存し、繰り返しのあとでまとめて取得して、予定の出席者に設定します。 最後に、保存したレコードを削除します。
Garoonのスケジュールを定期取得してkintoneに自動連携する方法【先月の予定を月初にまとめて工数管理に活用】	値の一時的な保存	2つの変換テーブルを使います。 1つ目には検索開始日時を保存し、実行ごとに更新します。 2つ目には取得した予定を一時的に保存し、kintoneへ登録したあとで削除します。

変換テーブルを使うときに、つまずきやすいポイントをまとめます。

起きること	原因	対処
変換テーブルの「レコードの取得」で、レコードが存在しませんというエラーになる	キーと一致するレコードが変換テーブルにありません。	変換テーブルにレコードを登録します。 ユーザーや取引先が増えたときは、変換テーブルへの登録も忘れずに行います。
変換テーブルの「レコードの削除」で、レコードが存在しませんというエラーになる	削除しようとしたキーのレコードが、変換テーブルにありません。	削除するキーに、追加したときと同じ値を指定しているか確認します。
ユーザー選択フィールドの値で検索しても、レコードを取得できない	シナリオで指定したキーと、変換テーブルのキー列に登録した値の種類が違います。 たとえば、キー列にはログイン名を登録しているのに、キーに表示名（name）を指定しています。	キーに指定する値と、キー列に登録する値をそろえます。 表示名は変更されたり、ほかのユーザーと重複したりするため、ログイン名（code）でそろえるのがおすすめです。
ユーザーが複数いても、1人分しか変換されない	出力データで0（1人目）の値を選んでいます。	全員分を変換する場合は、繰り返しアクションを使います。
キー列の値を修正できない	キー列の値は、レコードを追加したあとに変更できません。	レコードを削除してから追加し直します。
変換テーブルの「複数レコードの取得」で、キー列の値を条件に指定できない	条件に指定できるのは、変換バリュー列の値だけです。	条件に使う値（kintoneのレコード番号など）を、変換バリュー列にも登録します。
変換テーブルの「複数レコードの取得」で取得した値を、後続のステップでそのまま使えない	取得したレコードは、表データ（content）として出力されます。 contentをそのまま選ぶと、値ではなくランダムな文字列が入ります。	繰り返しアクションや表データのアクションで、値を取り出してから使います。 繰り返しのitemの中では、キー列はランダムな文字列、変換バリュー列は0から始まる番号で表示されるので、横に表示される値を見て選択します。
一時保存に使っていたら、変換テーブルにレコードを追加できなくなった	変換テーブルのレコード数の上限は1,000件です。 使い終わったレコードを削除しないと、上限に達します。	シナリオの最後に「レコードの削除」で、使い終わったレコードを削除します。
変換テーブルの「レコードの追加」で、（キーの値）は既に登録されていますというエラーになる	同じキーのレコードが、すでに変換テーブルにあります。 キー列には、同じ値を登録できません。	一時保存に使う場合は、フィールド関数でkintoneのレコード番号とメールアドレスを連結するなどして、重複しない値をキーにします。
別のプロジェクトのシナリオで、変換テーブルを選択できない	変換テーブルは、プロジェクトごとに作成します。	シナリオと同じプロジェクトに変換テーブルを作成します。
連携先の設定を変えたら、変換後の値が古いままになる	変換テーブルの値は自動では更新されません。	連携先でメールアドレスやフォルダーを変えたときは、変換テーブルも更新します。

ここでは、「問い合わせが登録されたら、対応担当者にOutlookでメールを送る」シナリオを例に、値を変換する設定方法を紹介します。

kintoneのユーザー選択フィールドから取得できるのは、ユーザーのログイン名（code）と表示名（name）です。
一方、Outlookでメールを送るには、宛先のメールアドレスが必要です。
そこで、ログイン名をキーにメールアドレスを登録した変換テーブルを用意し、ログイン名からメールアドレスへ変換します。

シナリオは、次の3つのステップで構成されます。

順番	種類	ステップ	内容
1	イベント	kintoneの「レコード追加/編集の検知」	問い合わせ管理アプリへのレコード追加を検知する
2	アクション	変換テーブルの「レコードの取得」	対応担当者のログイン名から、メールアドレスを取得する
3	アクション	Outlookの「メールの送信」	対応担当者に通知メールを送信する

ステップ2の変換テーブルの「レコードの取得」では、①対応担当者のログイン名をキーにして変換テーブルを検索し、②キーに対応するメールアドレスを取得します。
取得したメールアドレスを、ステップ3の「メールの送信」の宛先に使います。

kintoneのアプリストアから「問い合わせ管理」アプリを作成します。
問い合わせ管理

作成したら、「対応担当者」フィールド（ユーザー選択）を必須項目にします。
対応担当者が空のまま登録されると、変換テーブルのキーが空になり、ステップ2の「レコードの取得」がエラーになるためです。

1. 「問い合わせ管理」アプリのフォームの設定で、「対応担当者」フィールドの設定を開きます。
2. 「必須項目にする」のチェックボックスを選択し、設定を保存します。
3. アプリを更新します。

連携コネクタの出力データには、フィールド名ではなくフィールドコードが表示されます。
今回のシナリオで使うフィールドのフィールドコードは、次のとおりです。

フィールド名	フィールドコード
対応担当者	Person
顧客名	Customer
詳細	Detail

kintoneのログイン名とメールアドレスの対応表を、変換テーブルとして作成します。
変換テーブルは、シナリオを作成するプロジェクトに作成します。

1. 連携コネクタの画面上部のメニューで[プロジェクト]をクリックし、シナリオを作成するプロジェクトを選択します。

2. サイドメニューの[変換テーブル]をクリックし、[新規作成]をクリックします。

   

3. [基本設定]タブで、次のとおりに設定し、[保存する]をクリックします。

   設定項目	設定内容
   テーブル名	ユーザーメールアドレス
   キー列名	ログイン名
   編集権限	所有者と管理者のみ

   

4. [変換テーブル一覧]に、作成した「ユーザーメールアドレス」が表示されます。
   「ユーザーメールアドレス」をクリックして開きます。

   

5. [変換バリュー列設定]タブで、[変換バリュー列を追加（最大4つ）]をクリックします。

   

6. [変換バリュー列を追加]で、[変換バリュー列名]に「メールアドレス」と入力し、[保存する]をクリックします。

   

7. 変換バリュー列「メールアドレス」が追加されたことを確認します。

   

8. [変換テーブル]タブで[レコードを追加]をクリックします。

   

9. [レコード追加]で、ログイン名とメールアドレスを入力し、[決定]をクリックします。
   まずは、自分のkintoneのログイン名と、自分が受信できるメールアドレスを登録します。
   キー列には、kintoneのユーザー選択フィールドで取得できる値と同じ値（ログイン名）を入力します。

   

   

   警告

   画像のログイン名とメールアドレスは例です。
   自分の環境のkintoneのログイン名と、受信できるメールアドレスを登録してください。

10. ほかのユーザーも対応担当者にする場合は、手順8〜9を繰り返して追加します。
    動作を試すだけなら、自分の1件だけでかまいません。
    次の画像は、3人のユーザーを登録した例です。

    

変換テーブルの作成方法とレコードの登録方法の詳細は、次のページを参照してください。

• 変換テーブルを作成・編集・削除する
• 変換テーブルのレコードを追加・編集・削除する

シナリオを作成し、ステップ1に、kintoneの「レコード追加/編集の検知」を設定します。
[検知するイベントの種類]には「追加」を選択します。
設定方法は、次の記事を参照してください。
初めてのシナリオを作ろう

サンプルの取得では、変換テーブルに登録したユーザー（自分）を「対応担当者」に選んだレコードを「問い合わせ管理」アプリに追加します。
ステップ2のテスト実行で、このレコードの対応担当者が使われます。

ステップ2に、変換テーブルの「レコードの取得」を設定します。
対応担当者のログイン名をキーにして、メールアドレスを取得します。

1. [アプリ選択]で「変換テーブル」をクリックし、[次へ]をクリックします。

   

2. [アクション選択]で「レコードの取得」を選択し、[次へ]をクリックします。

   

3. [変換テーブル選択]で「ユーザーメールアドレス」を選択し、[次へ]をクリックします。

   

4. [基本設定]で、キー列「ログイン名」の入力欄をクリックし、画面右側の出力データから次の値を選択します。
   設定したら[次へ]をクリックします。

   設定項目	設定内容
   ログイン名	レコード追加/編集の検知 > record > Person > value > 0 > code

   

5. [出力確認]で[テスト実行]をクリックし、対応担当者のメールアドレスが取得できることを確認します。

   

6. [完了して次へ]をクリックします。

取得したメールアドレスは、後続のステップで出力データから選択できます。
ステップ3に、Outlookの「メールの送信」を設定し、宛先にステップ2で取得したメールアドレスを指定します。

1. [アプリ選択]で「Outlook」をクリックし、[次へ]をクリックします。

   

2. [アクション選択]で「メールの送信」を選択し、[次へ]をクリックします。

   

3. [認証コネクタ選択]で、メールを送信するMicrosoft 365アカウントの認証コネクタを選択し、[次へ]をクリックします。
   認証コネクタの作成方法は、次の記事を参照してください。
   Microsoft 365と連携しよう

   

4. [基本設定]で、次のとおりに設定し、[次へ]をクリックします。

   設定項目	設定内容
   宛先	レコードの取得 > メールアドレス
   件名	【問い合わせ対応のお願い】レコード追加/編集の検知 > record > Customer > value様
   本文の形式	テキスト
   本文	レコード追加/編集の検知 > record > Detail > value
   テスト実行時	下書き保存

   

   

   [テスト実行時]は、[テスト実行]のときの動作を選ぶ設定です。
   「下書き保存」を選ぶと、テスト実行ではメールは送信されず、送信元のアカウントのOutlookの下書きフォルダーに保存されます。
   「送信する」を選ぶと、テスト実行で実際にメールが送信されます。

5. [出力確認]で[テスト実行]をクリックします。
   送信元のアカウントのOutlookの下書きフォルダーに、宛先が対応担当者のメールアドレスになったメールが保存されることを確認します。

   

6. 画面右上の[保存]をクリックし、「シナリオ有効化」をONにします。

「メールの送信」アクションの詳細は、次のページを参照してください。
Outlook メールの送信

動作を確認するには、「問い合わせ管理」アプリで対応担当者を選んでレコードを追加します。
対応担当者のメールアドレスに通知メールが届けば完了です。

本記事では、変換テーブルのしくみと使い所、設定方法を紹介しました。
変換テーブルは、連携するサービスのどちらにも変換のしくみがない値を、シナリオの中で変換するときに役立ちます。
また、繰り返しの中で作った値や前回の実行日時など、シナリオの中で使う値を一時的に保存する場所としても活用できます。
変換テーブルを活用して、連携コネクタでできることの幅を広げてみてください。