https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71029001/customer/work_design/notice_design/index.html Recent content in 4.3.3 通知の設計 on JP1 Cloud Service 運用統合 利用ガイド Hugo -- gohugo.io ja https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71029001/customer/work_design/notice_design/notice_ex/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71029001/customer/work_design/notice_design/notice_ex/index.html スケジュール、作業項目を起点とした通知条件のユースケースを以下に示します。 各ユースケースの番号をクリックするとユースケースごとの説明に遷移します。 （表）スケジュール・作業項目の通知条件例 ユースケース 起点 通知条件 1 作業項目 作業項目の作成、更新内容を通知する。 ただし作業項目の表示順序のみが変更された場合、通知は行われない。 2 スケジュール スケジュールの担当者変更を通知する。 3 スケジュールの開始5分前と60分前にリマインダーを通知する。 4 定期的な作業にひもづく特定のスケジュールの変更を通知する。 注意事項 スケジュールを起点にする場合は以下に注意してください。 作業項目にひもづくスケジュールの「title」の値は常に空になります。スケジュールの名前を取得するには、「.Context.title」ではなく、「.Context.workitem.name」を参照してください。 作業項目にひもづくスケジュールの場合、担当者の情報は「assignedUsers」に設定されます。また、作業項目にひもづかないスケジュールの場合、担当者の情報は「assignedTo」に設定されます。 このため、通知の本文や宛先に担当者や名前を指定する場合、作業項目にひもづくスケジュールとひもづかないスケジュールで、 NotificationのYAML定義をそれぞれ別々に作成してください。 作業項目管理機能がサポートされる前から通知機能を利用している場合、作業項目管理機能を利用する前に登録済みのYAML定義の通知条件に次の内容を追加して、作業項目の作成や更新による意図しない通知が行われないようにしてください。 - resource: '{{ .GetValue ".Context.workitem" }}'   eq: "" 各ユースケースについての、NotificationのYAML定義例を以下に示します。YAML定義の詳細は「Notification、Notifier」を参照してください。 【ユースケース1：作業項目の作成、更新内容を通知する】 作業項目の作成と更新時に、作業項目名や担当者などの情報を通知します。 次に示す定義例では、開始日が空の作業項目の作成と更新時には通知が行われません。このため、次の操作を行った場合、作業項目は作成されますが、通知は行われません。 カレンダーのコピー 作業項目のコピー テンプレートを利用したカレンダーの作成 apiVersion: 1.0 kind: notification type: resource name: sample_notification_work-item label: Notification sample 1 description: Notification regarding create or update work-item  event:   resource: workitem   type: update conditions:   # 作業項目の開始日が設定されていることを確認します。   # neオペレータで空文字("")と比較することで値が設定されたことを確認できます。   # ".Context"のみを条件に使用しているため、   # 作業項目の新規作成時、更新時問わず通知の対象となります。   -      - resource: '{{ .GetValue ".Context.startDate" }}'       ne: "" notifications:   - message:       title: '[{{ .GetValue ".Context.name" }}] has been updated.'       body: |         The work-item {{ .GetValue ".Context.name" }} has been updated.         Information:           planned start time: "{{ .GetValue ".Context.plannedStart" }}"           assignedUsers: "{{ .GetValue ".Context.assignedUsers.name" }}"           assignedGroup: "{{ .GetValue ".Context.assignedGroup.name" }}"     destinations:       - type: groupMember         value: '{{ .GetValue ".Context.assignedGroup.id" }}' 【ユースケース2：スケジュールの担当者変更を通知する】 スケジュールの担当者変更を通知します。 作業項目にひもづくスケジュールと作業項目にひもづかないスケジュールで別々に定義を作成します。 ①作業項目にひもづくスケジュールの場合 apiVersion: 1.0 kind: notification type: resource https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71029001/customer/work_design/notice_design/notice_workflow_ex/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71029001/customer/work_design/notice_design/notice_workflow_ex/index.html ワークフローの任意のタイミングで通知を行う場合の定義例を示します。 通知の"type"が"onDemand"の場合、ワークフローで指定した任意のタイミングで通知を行えます。 通知の内容に、ワークフローのフィールドの値や、WorkflowのYAMLファイルで設定したパラメータを以下により埋め込むことができます。 .GetValueを使用 使用できる値は「（表）Notificationで使用可能なオブジェクト・フィールド」を参照してください。 Ops I提供部品「oi.notify」を使用 WorkflowのYAMLファイルで定義したパラメータを埋め込めます。メッセージ内容や宛先をワークフロー定義で動的に変更することができます。 WorkflowのYAMLファイルおよびNotificationのYAMLファイルの定義例を以下に示します。 WorkflowのYAML定義については「Workflow」を、Ops I提供部品「oi.notify」については「（表）actionのリスト（Ops I提供部品）」を参照してください。 NotificationとNotifierのYAML定義の詳細については「Notification、Notifier」を参照してください。 注意事項 WorkflowのYAMLファイルで定義したnotificationの値は、NotificationのYAMLファイルで定義したnameの値と一致する必要があります。また、Ops I提供部品「oi.notify」を使用する場合はNotificationのYAMLファイルに以下のように設定してください。 event.resourceは"workflow"に指定する。 event.typeは"onDemand"に指定する。 conditionsは指定しない。 WorkflowのYAMLファイルで定義した「oi.notify」のパラメータをNotificationのYAMLファイルに埋め込む場合、次のように指定する。 {{ .OINotify.params.key }} 【ユースケース：メッセージのタイトルおよび内容の一部をWorkflowのYAMLファイルに定義する】 再申請の通知内容を、WorkflowのYAMLファイルに定義し、その内容に基づいたNotificationのYAMLファイルを作成します。 ＜WorkflowのYAMLのtasks定義例＞  notify_vm_wf_02:    action: oi.notify    input:      notification: lend_request_notification      params:        type: 再申請        document: 申し送り事項    next:      - when: <% succeeded() %>        do: next_step      - when: <% failed() %>        do: fail ＜NotificationのYAMLの定義例＞ apiVersion: 1.0 kind: notification ## Meta data type: resource name: lend_request_notification label: 貸出申請通知 description: 担当者に貸出申請通知を行うYAML定義です