「HRMOS CORE カスタムCSVインポート」とAmazon S3を連携する

ここでは、「HRMOS CORE カスタムCSVインポート」と、Amazon Simple Storage Service（Amazon S3）との連携方法について、説明します。
Amazon S3と連携することによって、Amazon S3を経由してCSVファイルを自動で受け渡しするといった運用が可能となりますので、必要に応じて活用をご検討ください。

Amazon S3とは？
Amazon Web Services（AWS）が提供するオブジェクトストレージサービスです。
Amazon S3について詳しくは、公式ページをご参照ください。

Amazon S3との連携には、別途、AWSのアカウント契約が必要となります。
AWSのアカウント契約は、お客様自身で行なっていただくようお願いします。

目次

・Amazon S3で連携に必要な事前設定を行う
・サービスとAmazon S3を接続する（連携設定）
・Amazon S3からCSVを取得してインポートする（自動実行）
・インポートの結果を確認する（連携ログ）
・S3にCSVファイルをアップロードする（Amazon S3）
・補足説明・注意点

Amazon S3で連携に必要な事前設定を行う

はじめに、Amazon S3側で、カスタムCSVインポートと連携するための設定を行います。
Amazon S3のバケットポリシーとユーザーポリシーに対して、アクセス許可の権限を付与します。
以下が設定例となります。

S3バケットポリシーの設定例

※連携先となるバケットに対して設定します。

{
   "Version": "2012-10-17",
   "Statement": [
       {
           "Effect": "Allow"
           },
           "Action": [
               "s3:PutObject",
               "s3:GetObject",
               "s3:ListBucket",
               "s3:GetBucketPolicy"
           ],
           "Resource": [
               "arn:aws:s3:::YOUR_BUCKET_NAME",
               "arn:aws:s3:::YOUR_BUCKET_NAME/*"
           ]
       }
   ]
}

ユーザーポリシーの設定例

※インラインポリシーを一例としています。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "s3:ListBucket",
                "s3:GetBucketPolicy"
            ],
            "Resource": [
                "arn:aws:s3:::BUCKET/*",
                "arn:aws:s3:::BUCKET"
            ]
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:GetObject",
                "s3:HeadObject"
            ],
            "Resource": [
                "arn:aws:s3:::BUCKET/*",
                "arn:aws:s3:::BUCKET"
            ]
        }
    ]
}

設定ポリシーについて詳しくは、＜S3のユーザガイド＞をご参考ください。

サービスとAmazon S3を接続する（連携設定）

続いて、カスタムCSVインポート側で、Amazon S3との連携設定を行います。

1. 「連携設定」よりAmazon S3との連携設定を行う
「連携設定」タブ ＞ 「他サービスとの連携 - S3」の「設定」を選択してください。

2. インポート元となるAmazon S3の連携情報を入力する
連携先となるAmazon S3のアクセスキー、シークレットキー、リージョン、バケット名、プレフィックス（任意）を入力してください。
Amazon S3上での設定方法は、＜こちら＞を参考にしてください。
※プレフィックスは、バケット内のフォルダパスになります。設定しない場合は、所定したバケットのトップにあるCSVファイルをインポートします。

3. 「接続」を行う
入力が完了したら、「接続」を選択してください。

「S3の連携に成功しました」と表示されれば、連携設定は完了です。
「完了」を選択して、連携設定が「連携済み」となっていることを確認してください。

「S3の連携に失敗しました」と表示された場合は、接続未完了となります。
入力内容やAmazon S3側の設定に誤りがないかをご確認のうえ、再度、接続してください。

Amazon S3との連携を解除する
S3との連携が不要になったり、S3の連携先を変更する場合は、「連携解除」を行なってください。
※プレフィックスの変更も、一度連携解除を行う必要があります。

内容を確認のうえ、「解除」を選択します。

！Amazon S3との連携を解除した場合は、Amazon S3への定期実行設定も削除するようにしてください。
Amazon S3への定期実行が残っていると、連携ログで「失敗」となるタスクが残り続けてしまいます。

Amazon S3からCSVを取得してインポートする（自動実行）

Amazon S3との連携が連携済みの場合、CSVインポートの取得先として、Amazon S3を指定することができるようになります。
自動インポートのインポート元で、Amazon S3を指定できます。

「定期実行設定」タブ ＞ 「インポート元」で、「S3」を選択します。

「S3」を選択した状態で「編集」を選択すると、次回インポート実行時より、Amazon S3からファイルを取得して、HRMOS COREへインポートされます。

インポートの結果を確認する（連携ログ）

Amazon S3からのインポートの結果は、「連携ログ」で確認することができます。
取得先が「S3」になっているログをご確認ください。

ステータスが「失敗」「一部失敗」「スキップ」「重複スキップ」の場合は、HRMOS COREへのインポートができておりません。
「結果詳細」からログをご確認のうえ、修正・見直しを行い、再度インポートを実行してください。

S3にCSVファイルをアップロードする（Amazon S3）

S3からの自動インポートを行うためには、事前にS3にCSVファイルがアップロードされている必要があります。
S3へのファイルアップロードは、本アプリケーションでは対応しておりませんので、お客様の方でアップロードをお願いします。

補足説明・注意点

仕様

• Amazon S3から取得するCSVファイルは、自動では削除されません。不要となったファイルは、お客様側で削除する必要があります。
• カスタムCSVインポートと連携する取得元（バケット・プレフィックス）は1箇所のみとなります。インポートごとに取得元を分けるといったことはできません。
• 定期実行するインポート処理（マッピング）とS3にアップロードされているCSVファイルに不整合がある場合、結果として「スキップ」または「重複スキップ」となる場合があります。
  「スキップ」「重複スキップ」の原因については、＜こちら＞をご確認ください。
• 定期実行時間にS3にCSVファイルがアップロードされていない場合は、定期実行はスキップされ、連携ログにもログが残りません。

Amazon S3の連携情報

「連携設定」で入力する連携情報の設定方法になります。ご参考ください。