【ServiceNow】Utah新機能「文書の有効期限フィールドの取得と利用」


UtahバージョンのEmployee Document Managementの新機能である「文書の有効期限フィールドの取得と利用」について、使用してみた結果をまとめます。

https://docs.servicenow.com/ja-JP/bundle/utah-employee-service-management/page/product/human-resources/concept/hr-doc-management-config.html#title_create-modify-hr-doc-types

どんな新機能が増えたか簡単に言うと、、、
ドキュメントタイプのポリシーの定義で、ドキュメントタイプの設定として **「有効期限フィールド」と「有効期限ポリシー」タブが増えました。** 
また、有効期限が切れたとき、または有効期限が近づいたときに、ドキュメントの所有者やマネージャー、HR担当者にメール **（有効期限通知）** が送信されるよう設定が可能になりました。

本稿をお読みいただき、是非Employee Document Managementを使いこなしていただければと思います！

:::note info
目次
1\. Employee Document Managementとは
2. 事前準備
3. 設定方法
　3-1. ドキュメントタイプの設定
　3-2.保存期間の設定
　3-3.有効期限ポリシーの設定
　3-4.ドキュメントにドキュメントタイプを紐づける
4. 動作確認
5. おわりに
:::

１．Employee Document Managementとは
---
https://docs.servicenow.com/ja-JP/bundle/tokyo-employee-service-management/page/product/human-resources/concept/hr-employee-doc-management.html

Employee Document Managementは、HR Service Deliveryの機能の１つで、
従業員に関する多数のドキュメントを効率的に管理することができます。

また、従業員ドキュメントの定義を行うことで、ドキュメントの保存期間やセキュリティ方針を決めることができます。

従業員ドキュメントの定義は以下の４つです。
・ドキュメントタイプ
・保存期間
・保持ポリシー
・セキュリティ方針

本稿では、新機能である有効期限の設定について紹介するため、「ドキュメントタイプ」と「保存期間」の定義方法について説明していきます。

続いて、Employee Document Managementを利用するために必要な事前準備について説明していきます。

２．事前準備
---
HRプラグインとロールが必要になります。

##### プラグインのインストール

https://docs.servicenow.com/ja-JP/bundle/utah-employee-service-management/page/product/human-resources/task/activate-employee-doc-mgmnt.html

Employee Document Management [com.sn_employee_document_management] プラグインをアクティブ化します。

**手順１** ：アプリケーションメニューから、[すべて] > [システムアプリケーション] > [利用可能なすべてのアプリケーション] > [すべて]に移動します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/92b4f066-01bf-a182-4dac-dc6eb2aedc39.png)
**手順２** ：検索バーで”com.sn_employee_document_management”と検索し、「インストール」ボタンをクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/9dc7e0b0-7902-6fbc-398a-2f158af8fa2d.png)
**手順３** ：プラグインのテーブルに移動し、プラグインがインストールされていることを確認します。
※フィルターナビゲーターに”sys_plugins.list”を入力し、Enterキー押下。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/828ec195-125b-3c8f-e6b9-4f271cd3e6bc.png)

##### ロール付与
プラグインをインストールすると、adminユーザにsn_hr_ef.managerが自動で付与されています。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/46964dee-6ef5-1e9f-c47f-aac029355755.png)

Employee Document Managementを利用するために必要な事前準備は以上です。
続いては、この記事の本題である従業員ドキュメントの有効期限の設定と、有効期限通知メールの送信設定の方法について説明していきます。

３．設定方法
---
##### 3-1. ドキュメントタイプの設定

**手順１** ：[すべて] > [HR 管理] > [従業員ドキュメント] > [ドキュメントタイプ] に移動します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/7f80e267-b8e2-f15a-8f83-ef76c3263360.png)
**手順２** ：[新規] または編集する既存のドキュメントタイプをクリックし、必要な項目を入力後、保存します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/eb3341a1-dd5a-a13b-ddf1-c49cadb87d42.png)
保存後はこのような画面になります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/71446b4d-cc15-0d36-a44f-09eb8453f4cc.png)

以上でドキュメントタイプの設定は完了です。

##### 3-2.保存期間の設定
保持ポリシーにて、ドキュメントの有効期限を設定します。

**手順１** ：[すべて] > [HR 管理 (HR Administration)] > [従業員ドキュメント (Employee Documents)] > [保持ポリシー] に移動し、[新規]ボタンをクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/12675923-9248-faa0-5376-2f1f09c8c6d0.png)
**手順２** ：項目を入力し、保存します。
ドキュメントタイプ →「3-1. ドキュメントタイプの設定」で作成したドキュメントタイプを設定
HR基準 →設定したい人事条件を選択
保存期間 →ドキュメントの保存期間を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/04fda751-6dae-ef8d-74a5-b0c238d3cfec.png)

以上で、保存期間の設定は完了です。

##### 3-3.有効期限ポリシーの設定
有効期限ポリシーにて、有効期限通知メールの送信設定を行います。

**手順１** ：[すべて] > [HR 管理] > [従業員ドキュメント] > [有効期限通知ポリシー] に移動し、[新規]ボタンをクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/2fa6fa8c-8056-d950-7c3f-15665f85c9ec.png)
**手順２** ：項目を入力し、保存します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/2c1c098a-76ff-5ce8-010e-dd1d6f478539.png)
**手順３** ：[有効期限通知の受信者] 関連リストが表示されるため、[新規]ボタンをクリックし受信者を追加します。
※「グループ」セクションでは、通知の送信先のグループを追加することができます。グループは受信者と同時に通知を受信します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/b59e63e4-0b0f-3de0-2027-7bca4d977d84.png)

以上で、有効期限ポリシーの設定は完了です。

##### 3-4.ドキュメントにドキュメントタイプを紐づける
ドキュメントとドキュメントタイプを紐づけることで、そのドキュメントに対して保存期間や有効期限通知メールの設定を行うことができます。

**手順１** ：[すべて] > [HR プロファイル] > [従業員ドキュメント] > [ドキュメントの新規作成] に移動し、従業員ドキュメントを作成します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/9f9464cd-017e-3e47-8adc-1cf84cc73abc.png)
**手順２** ：項目を入力し、保存します。
※ここで「ドキュメントタイプ」フィールドに作成したドキュメントタイプを入力することで、紐づけができます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/0d0238bb-0c48-73cd-f9e1-e436e15d7482.png)

以上で、ドキュメントタイプの紐づけは完了です。

ちなみに、、、
ドキュメントを作成すると画面下部に「従業員ドキュメント監査記録」が表示され、このドキュメントに対する操作履歴が表示されるようになります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/cbe3e972-367a-1bdb-582d-1e85b30eab32.png)

４．動作確認
---
「3-3.有効期限ポリシーの設定」で設定した通りにメールが送信され、ドキュメントが削除されるまでの流れを確認します。

まず、スケジュールジョブ（Send Expiration Notifications）が動き、メールが送信されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/d0187fc8-4de4-24d8-fed9-c09640b613ad.png)
＜メール本文＞
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/0f9b8e4f-8cd5-e250-2b6b-b4e48e29134f.png)
※メール本文に記載されているファイルのリンクをクリックすると、ドキュメントレコードに遷移します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/01058f2b-b648-838c-cd55-a4b44c8ca10f.png)

手動で「削除保留ステータス」を更新し、保存します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/9e061a9c-cc61-2bcf-d41b-30260b0e997c.png)

削除のスケジュールジョブ（Purge employee documents）が動きます。
※スケジュールジョブが動く条件は、「削除保留ステータス」が”消去承認” or NULL かつ「有効日」が今日以前
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/1fb8d674-9188-c831-da0b-a01ab89cf7c4.png)

以上で、ドキュメントの削除は完了されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/c4576384-8e9d-9ae6-db00-c79d2f60b591.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3335478/5cb0379b-a145-490e-91c1-eb8d417768b4.png)

５．おわりに
---
本稿では、UtahバージョンのEmployee Document Managementの新機能である「文書の有効期限フィールドの取得と利用」について紹介しました。

保持ポリシーで保存期間の設定は行いますが、実際に削除対象の条件となるのはドキュメントの「削除保留ステータス」と「有効日」のようです。
（保持ポリシーで設定した期間通りに自動でドキュメントが削除されるというわけではないようですね。）
そのため、もし「やっぱり削除したくない！」というドキュメントがあった場合、有効期限ポリシーを設定をしておくことで、メールで有効期限に気付き「削除保留ステータス」を”消去承認”以外のステータスに更新しておけば、ドキュメントが削除されません。

HRSDを利用している方は使う機能の１つかと思います。
是非ご活用ください。