目的

従業員データに基づいて、従業員データを最新の状態に保つための自動化されたプロセスを作成します。 人事システムやITシステムで利用可能なすべてのデータをアクティモで利用することができます。

この統合は、従業員とのつながりに集中できるよう、データの副操縦士として機能する。

必要条件

CSV統合を使用するには、以下の要件が整っている必要があります。

• 統合オプションの購入（不明な場合はサポートにお問い合わせください）

• ベーシック認証による sftp サーバまたは Web サーバへのアクセス

• 従業員データのcsvファイルをサーバーにダンプできる。

• アクティモの管理者アクセス

• CSVの統合は1クライアントにつき1回までです。

• ファイル名は同じでなければならず、日付などを含んではならない。

• このファイルには全従業員が含まれていなければならない。 作成、削除、更新は弊社が行います。

• 最初の行は、各カラムを説明するヘッダー行とする。

• 従業員の役職、名前、Eメールなどが変わっても変わらないユニークなIDが必要だ。 通常はソース・システムのプライマリID。

• 名前は姓と名を分けてください。

• 国番号は携帯電話番号の一部でも、別の列でもよいが、電話番号を正しく解析するために必要である。

• 一意のIDを使用して従業員リレーションを作成できます。通常、マネージャーの一意のIDを持つmanager_idカラムを使用します。

• カラムの種類に応じて、バリデーションを追加することができます。 バリデーションに失敗した場合、従業員はActimoに転送されず、以前に転送された場合は削除されます。

• 文字列"等しい"、"空"、"空ではない"

• 番号： ">", ">=", "<" and "<="

• 日付：「今より前か空か」と「今より後か空か」。

事例

このシナリオでは、ケースを使って統合のセットアップ方法を説明します。 私たちが小売業で、異なる地域、機能、部門に所属する500人の従業員向けに従業員アプリを運営したいとします。 また、ネイティブアプリを使うにしても、SMSやEメールを送れるようにしたいという要望があることも知っています。 従業員のデータを統合し、自動的に処理することが私たちの任務です。 現在、以下の仕事がある：

• 関連データをインポートすることで、コミュニケーション部門が従業員とつながり、利用することができます。 スマートグループ と フィード従業員同士を区別することができます。

• 会社で働くのをやめた人が削除されていることを確認する。

• 新入社員が自動的に追加されるようにする

• 追加です：アクティモの従業員への直接の管理を、統合を経由して行うことができるかどうかも試してほしいと言われています。

立ち上げまでのステップ

ステップ1：どのデータが必要か？

チームと話し合い、達成しようとしている目標に関連するデータを入手できるようにする必要がある。 ここでは、以下のデータを取得する：

• ファーストネーム

• ラストネーム

• 従業員ID (または、従業員に対する他の一意の識別子)

• タイトル

• 職能

• 店舗

• 地域

• 国コード

• 携帯電話番号

• 電子メール

• manager employee id (従業員のマネージャーのIDを示す列)

ヒント人事／IT部門に、sftpサーバーに挿入するCSVファイルの例を問い合わせてください。 このファイルは、後でActimoの連絡先のフィールドにさまざまな列をマッピングするときにも必要になります。 

また、Actimoのサンプルデータで統合を初めてテストする際にも、カラム名を確認することができます。

ステップ 2: 従業員データを受信するようにアクティモを設定します。

撮影したいデータが決まったら、アクティモでデータを取得するための適切なフィールドを用意する必要があります。 この目的のために、私たちはコンタクトフィールドを使用しています。

管理画面右上に移動 --> 連絡先をクリック

アクティモには、国、従業員ID、氏名などのデフォルトフィールドが用意されています。 現在の設定に合わないデータがあるかどうかを確認する必要がある。 この例では、StoreとFunctionの新しいカスタムフィールドを作成しました。 保存をクリックすると、すぐに使用できるようになります。

Actimoプラットフォームを準備するもう一つの重要なステップは、複製キーの設定を選択することです。 こうすることで、あなたのプラットフォームで従業員が重複しないようにすることができる。 100％その従業員独自のものでなければならない。

統合を使用する場合は、ドロップダウンを「ソースデータ」にする必要があります。

右上のAdminに移動 --> Contactsをクリック --> ページの一番下までスクロールダウンする。

ヒント：従業員IDを持っていない場合があります。 下記までご連絡ください。support@actimo.com までご連絡ください。

ステップ 3: アクティモとSFTPサーバーを接続します。

すべてのデータを同期させる前に、2つのシステムを互いに接続する必要がある。

管理画面右上に移動 --> [統合] をクリック --> [外部CSVの追加] をクリック

IT部門やSFTPサーバーをセットアップした担当者から多くの情報を得る必要がある。 赤で示されたフィールドは必須です。 以下のフィールドの説明を参照のこと。

• CSVファイルへの完全なURIスキーマ：sftp:// または https:// 実際のファイルへのフルパス。 ポートが標準と異なる場合（sftp 22、https 443）、その旨を含める必要がある。

• フィールド区切り文字：通常はセミコロンかカンマ、または ; - のいずれかですが、他の区切り文字を使用することもできます。

• エンコーディング：通常はutf8またはlatin1 - デフォルトはutf8

• ファイルにはヘッダー行がありません：CSVでは通常、カラム名が定義された最初の行がある。 ファイルに定義行がない場合は、このチェックボックスをオンにしなければならない。

• 認証情報（ユーザー名、パスワード、パスフレーズ、秘密鍵）：

• プロトコルがhttpsの場合、常にユーザー名とパスワード

• プロトコルがsftpの場合、ユーザー名とパスワード、またはユーザー名と秘密鍵、またはユーザー名と秘密鍵とパスフレーズ、またはユーザー名とパスワードと秘密鍵とパスフレーズとすることができる。

> 下の「保存」をクリック --> 「テスト」をクリック

緑色の確認メッセージが表示され、接続が完了したことと、CSVファイルのデータの例が表示されます。

ステップ 4: CSVデータをActimoの連絡先にマップする

アクティモの連絡先の正しいフィールドに正しいデータがマッピングされていることを確認することが重要です。 これにより、スマートグループを使用して、特定の店舗、地域、機能などの全従業員を自動的にグループ化することができます。

管理画面右上に移動 --> 「統合」をクリック --> スクロールダウンして、「広告カスタムフィールド」をクリックします。

ここでの目標は、従業員データがActimoのコンタクトフィールドに正しく挿入されていることを確認することです。 これは、カラムヘッダー用のフィールドを作成し、それをActimoの正しいフィールドにマッピングすることで行います。 

クリック + カスタムフィールドを追加 --> CSVのヘッダタイトルと同じ名前を書く --> 保存 --> Actimoのフィールドにマップする。

あとは、このガイドのステップ1に従って、CSVのカラムをすべてActimoのフィールドにマッピングするだけです。

最後に、どのワークスペースにデータを挿入するかを選択できます。 特別な必要性がない限り、プライマリ・ワークスペースにインポートし、アカウント上で1つだけ実行することをお勧めします。 必要であれば、サポートまでご連絡ください。

データのマッピングが完了したらSaveをクリックします。

ステップ 5: アクティモに同期

上記の手順がすべて完了したら、あとは統合を開始するだけだ。

右上のAdminに移動 --> Integrationをクリック --> 今すぐ同期をクリック

すべての従業員がActimoの連絡先に挿入されることを体験してください。 連絡先をクリックするとデータが表示されます。 こんな感じだ。

sFTPが使用できる暗号は以下のとおりである：

Chacha20-poly1305@openssh.com、

aes128-ctr、

aes192-ctr、

aes256-ctr、

aes128-gcm@openssh.com、

aes256-gcm@openssh.com

IP ホワイトリストについては、必要に応じて support@actimo.com までお問い合わせいただくか、担当のインテグレーションスペシャリストにご相談ください。

タグ: カスタム, フィールド, コンタクト, 統合, SFTP, CSV, URI, 暗号化