ServiceNowでインシデントエントリーポイントを構成してみた

# メールによるインシデント起票

ServiceNowが受信したメールを処理し、インシデントレコードの作成または更新を行うよう、受信アクションの設定を追加してみます。

[System Policy]->[Email]->[Inbound Action]を選択し、[Create incident]受信アクションを開きます。
![1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/50a7ba64-cb6d-42e7-0fc8-4124956421c1.png)

"Action"タブを確認すると、スクリプトコードが記述されております。
![2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/8eb6c7ed-3521-48d4-fdde-9c6640b530ec.png)

```
///	Note: current.opened_by is already set to the first UserID that matches the From: email address

current.caller_id = gs.getUserID();
current.comments = "received from: " + email.origemail + "\n\n" + email.body_text;
current.short_description = email.subject;

current.category = "request";
current.incident_state = IncidentState.NEW;
current.notify = 2;
current.contact_type = "email";

if (email.body.assign != undefined)
   current.assigned_to = email.body.assign;

if (email.importance != undefined) {
   if (email.importance.toLowerCase() == "high") {
		current.impact = 1;
		current.urgency = 1;
   }
}

current.insert();
```
メール受信時に新しく作成されるインシデントで、設定されるのは以下の10種類。
  ・Caller             : ユーザリストから送信元E-mailアドレスとマッチングをかけて情報を取得
  ・Comments           : メール本文を投入
  ・Short discription  : Subjectを投入
  ・Category           : "request"に指定
  ・State              : "New"に指定
  ・Notify             : 2
  ・Contact Type       : "email"に指定
  ・Assigned to        : 指定があれば投入
  ・Impact             : highと指定があれば1
  ・Urgency            : highと指定があれば1


メール本文でテンプレートが指定されている場合、作成するインシデントにもテンプレートを適応するよう、下記コードをcurrent.insert();の直前に追加する。

```
if (email.body.template != undefined)
   current.applyTemplate(email.body.template);
```

ServiceNow上からメールを送信して機能しているかを確認する。インスタンス名@service-now.comにメールを送信すればチケットが起票される。
※ developerインスタンスだとdev*****@service-now.comになっている。

自分が参加している研修ではdeveloperインスタンスではない特殊なインスタンスだったのでテストができなかった。何だよちゃんと準備してｙｈぬｊみｋ、おｌ。


# レコードプロデューサーの追加

これまでは、ServiceNowのインスタンス上にアカウントがあり、かつインシデントテーブルを閲覧・編集できる人のみインシデントレコードを作成または更新することができた。
そのような権限が無い人でもインシデントレコードの作成もしくは更新を行うことができるようにするには、レコードプロデューサーを利用する必要がある。
レコードプロデューサーを介して、ユーザがポータル側で情報を投入した情報をインシデントレコードの各フォームに投入する、そんなイメージです。

実際はインシデントレコードをサービスカタログとして公開し、ポータル側のレイアウト公開しなければならないのですが、ここではレコードプロデューサーの簡単な作り方として、既存のレコードプロデューサーを複製して編集する方法をまとめます。

[Service Catalog]->[Catalog Definitions]->[Record Producer]を選択し、[Create incident]という名前のレコードプロデューサーを開きます。
![a.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/a2a19ea1-b0b6-cd7c-0627-b78aa744a4ee.png)
これは基本設定(いわゆるベースライン)の一部で、今回はあるデバイス固有のインシデントについてのレコードプロデューサーを別途作成するという要件で変更させます。

[Action]チェックボックスにある[Preview Items]をクリックすると、仮にサービスとして公開された場合、ポータル側で表示される事項(ワイヤーフレーム)が表示されます。
![b.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/920fcaeb-3587-723b-3baa-367133703d90.png)

完成イメージはこんな感じです。
![03.01.03 - Record Producer.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/1e09aaaa-2f38-d2f5-ad6d-4d0618a84ecd.png)


早速[Copy]ボタンでコピーをして、NameとShort descriptionを"Report Issue with HHD Device"に変えてみます。"What it will contain"タブの[Description]フィールドにをIf you experience...を入れることで見出しを編集できます。

Item Affectedに関するワイヤーフレームを作成するには、下部"Variables"関連リストで[New]をクリックし必要な情報を入力します。
![d.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/7d5c4e16-f5fd-e061-fdf6-1c97f7e3adc8.png)
![r.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/75c7522e-ed41-e42e-f456-3de3ea0f8cb5.png)
![f.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/313bafaa-4f72-1fe7-d3cd-730fdbbde755.png)
ここまで作成して[Submit]します。

レイアウト変更も"Variables"関連リストで[New]をクリックし必要な情報を入力します。
![i.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/27b52d70-67f5-ceac-1c1a-54c6084d92bd.png)
![h.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/2628f4e4-8e50-8f01-1763-f9f4dbe18f08.png)
ここまで作成して[Submit]します。

"Variables"関連リストの[Order]列を編集します。
![j.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/c20ef800-83e3-605c-598e-c3a9f44aeba9.png)

ここまで作成して[Preview Items]をクリックすると、目的のものに近づいてきました。
![キャプチャ.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/6ef63a2f-ea40-f2bb-2480-fb9415919f28.png)

同じように、"Variables"関連リストで[New]をクリックし、ラベルとチェックボックス2つを作成します。
![1.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/67921119-2961-fb03-026a-2e62c61ff064.png)
![2.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/210f0db2-8437-d241-e884-98ae4361ddc3.png)
![3.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/d146a227-b0ac-bf4d-0304-ea13a8fbfb0c.png)

あとContainer Startを指定しているので、Container Endも新規で作成します。(キャプチャは省略)最後に"Variables"関連リストの[Order]列も編集します。
![5.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/ca4d8a4d-cf0e-a093-d2ee-fa83c11239d0.png)

[Preview Items]をクリックすると、イメージにマッチしたものが出来上がりました。
![6.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/2bea20c0-afcc-970f-5599-d811d36472e4.png)

ここまではデザインの設定で、インシデントレコードに反映させるべき情報を指定する必要があります。今回は[Create incident]という名前のレコードプロデューサーの設定をそのまま利用します。

■ ワイヤーフレームから抜き取る情報
・Urgency --> Urgency
・Item Affected --> Configuration Item
・Please Describe the Issue below --> Short description (短縮)
・Please Describe the Issue below --> Description (短縮なし)
■ 自動的に投入されるべき情報
・Caller --> レコードプロデューサーを介して情報投入を行った人
・Contact Type --> Self-Service

[Try It]ボタンを押して、情報を投入してみます。
![7.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/3cbf0242-ac6f-ae3a-7eee-1ad60226cca0.png)

[Submit]すれば、インシデントレコードが作成された…のですが…
![8.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/f19457db-415c-901c-ef04-684ab1233674.png)
今回新たに作成したチェックボックスの情報を格納するフィールドがない…

レコードプロデューサーによって生成されたインシデントとして表示させることが可能とのことで、[incident Variable Formatter]を使用します。

フォームデザイナーを起動すべく、[Incident]->[Create Now]から[Configure]->[Form Design]を選択します。
![a.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/8a68ada7-160f-8da7-8b21-74ac97706b92.png)

Formattersにincident Variable Formatterがあるので、２列目に表示させるようにします。
![b.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/7d569c8a-e21d-0f62-b6ff-adbbcc63dad9.png)
Saveを忘れずに。

これで、先ほど起票したインシデントレコードの２列目に下記のような情報が格納されることを確認できます。
![11.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/567289/1d09b732-21d5-8825-1497-f5c2959b13a0.png)