「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をエクスポートする（手動実行、定期実行）
・エクスポートの結果を確認する（連携ログ）
・エクスポートファイルを取得する（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」を選択した状態で「実行」を選択すると、エクスポートが開始されます。

自動エクスポートの場合

「定期実行設定」タブ ＞ 「エクスポート先」で、「S3」を選択します。

「S3」を選択した状態で「保存」を選択すると、次回エクスポート実行時より、Amazon S3にファイルをエクスポートされます。

エクスポートの結果を確認する（連携ログ）

Amazon S3へのエクスポートの結果は、「連携ログ」で確認することができます。
保存先が「S3」になっているログをご確認ください。

保存先が「S3」の場合、連携ログからCSVファイルをダウンロードすることができません。

また、ステータスが「失敗」の場合は、Amazon S3にファイルがエクスポートできておりません。
「結果詳細」からログをご確認のうえ、修正・見直しを行い、再度エクスポートを実行してください。

エクスポートファイルを取得する（Amazon S3）

Amazon S3から、エクスポートしたCSVファイルをダウンロードできます。
ダウンロードしたいファイルを選択し、ダウンロードしてください。

補足説明・注意点

仕様

• Amazon S3にエクスポートされるCSVファイルは、自動では削除されません。不要となったファイルは、お客様側で削除する必要があります。
• Amazon S3にエクスポートされるCSVファイルは、ダウンロード期限はありません。
• カスタムCSVエクスポートから出力できる出力先（バケット・プレフィックス）は1箇所のみとなります。エクスポートごとに出力を分けるといったことはできません。

Amazon S3の連携情報

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