CADSのファイルやラベルの変更通知

SPSS Collaboration And Deployment Servicesのレポジトリには変更通知機能があります。

重要なオブジェクトの変更やラベルの変更などの変更をメールやJMSで通知することが可能です。

* テスト環境
    * SPSS CADS 8.4
    * Windows Server 2019 std.
 
# ファイルの変更
ファイルが更新された場合にメッセージを送ります。
更新を検知したいファイルを選び、右クリックで「通知」を選びます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/d898cb66-b1bd-d85a-44b7-ef866ba3bf8d.png)

通知対象者を設定します。ここではEメールアドレスを入力します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/c2e41812-869b-62cf-2ef7-07bcb4ec52d9.png)

タイトルや本文のデフォルトは以下のようになっています。変数やif文も使えるようになっています。

```html:タイトル
IBM SPSS Collaboration and Deployment Services: New version of ${ResourceName} created
```

```html:本文
<html> <head> <meta http-equiv="Content-Type" content="text/html;charset=utf-8"/> </head> 
<body> <p>A new version of the file <b>${ResourceName}</b> has been created.<br/>  #if($Attachments)   See attachment. #else   <p>To review the content of the file, go to <a href='${ResourceHttpUrl}'>${ResourceHttpUrl}</a>.</p> #end  <hr><p>This is a machine-generated message. Please do not reply directly. If you do not wish to receive this notification, unsubscribe or contact your Repository administrator.</p> </body> </html> 
```

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/d852bc6d-1b4c-d876-d4a4-ac40857ac41c.png)

プレビューで確認してみます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/ced232d9-9745-b4a3-2b5e-f249b98524cc.png)

以下のメッセージが送られます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/77c8e491-5403-f454-00cc-c15258113235.png)

これはカスタマイズ可能です。以下のようにカスタマイズしてみます。

```html:タイトル
IBM SPSS Collaboration and Deployment Services:${ResourceName} の新しいバージョンが作られました。
```

```html:本文
<html> <head> <meta http-equiv="Content-Type" content="text/html;charset=utf-8"/> </head> 
<body> <p> <b>${ResourcePath}</b> の新しいバージョンが作られました。<br/>  #if($Attachments)   See attachment. #else   <p>To review the content of the file, go to <a href='${ResourceHttpUrl}'>${ResourceHttpUrl}</a>.</p> #end  <hr><p>This is a machine-generated message. Please do not reply directly. If you do not wish to receive this notification, unsubscribe or contact your Repository administrator.</p> </body> </html> 
```
カスタマイズされています。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/35866ff7-b1bd-6788-7bb5-2352006f66d7.png)

更新したストリーム・ファイルを保存してみます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/73367c0a-437a-2359-d07e-dd0d64c258eb.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/d75021aa-f7f5-2c86-00bc-5271c7717b08.png)

以下のようなメールが届きます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/588fb80f-79a7-832b-b782-0b060da11d2d.png)

# ラベルの変更
特定のラベルが変更された場合にメッセージを送ります。
ルートフォルダを選び、右クリックで「通知」の「ラベルイベント」を選びます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/f74078fc-0d7d-ac65-631d-dd0a8fb6906e.png)

プラスボタンでラベルイベントを追加します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/ae0575d1-a038-4573-9c6a-c4ae7c8aff93.png)

Eメールのアドレスを入力し、ラベルを選びます。ここでは「Production」というラベルを選んでいます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/bd083a30-ea0e-ed18-7977-65bb24d83bb8.png)


タイトルや本文のデフォルトは以下のようになっています。変数やif文も使えるようになっています。

```html:タイトル
IBM SPSS Collaboration and Deployment Services: The label ${VersionLabelName} was#if( $ActionType=="VersionLabelApplied" ) applied to a version of#else removed from#end ${ResourceName}. 
```

```html:本文
<html> <head> <meta http-equiv="Content-Type" content="text/html;charset=utf-8"/> </head> 
<body>  <p>The label ${VersionLabelName} was   #if( $ActionType=="VersionLabelApplied" )    applied to a version of   #else    removed from   #end   ${ResourcePath}. <br/>   <p>To review the content of the file, go to <a href='${ResourceHttpUrl}'>${ResourceHttpUrl}</a>.</p>  <hr><p>This is a machine-generated message. Please do not reply directly. If you do not wish to receive this notification, unsubscribe or contact your Repository administrator.</p> </body> </html> 
```

ラベルを変更してみます。
ストリームを右クリックして、プロパティを開きます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/f6b0d613-f77b-e79a-e44d-c774ec08403a.png)

ラベルをつけたいバージョンを選び、「編集」ボタンをクリックします。この例ではバージョン15に「Production」ラベルを付けようとしています。


![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/76aad0b9-d476-a0a0-528e-da27f1a9b91a.png)


![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/601128d2-f1f5-1cda-22bc-e96637f006b7.png)

「使用可能なラベル」から「Production」ラベルを選び、矢印で「適用済みラベル」欄に移し、「OK」で閉じます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/131a0564-4280-86d4-da53-63ea905f7057.png)


![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/348e015b-358b-8250-e84d-93e1ae3f8190.png)

１オブジェクトに１ラベルしか適用できないので、バージョン10から15にラベルが移動するという確認のメッセージが出ますので、OKで閉じます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/b8654895-db74-f9c4-ce15-6403a62b2f5f.png)

「Production」ラベルがバージョン15に移っていることを確認し、「OK]で閉じます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/11ada621-2bda-62cb-b809-4e94fc525820.png)

ラベルが変更された旨のメールが届きます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/e8c9bbba-2b29-e278-80b3-5217505f9898.png)

# フォルダの変更
フォルダ内に新しいフォルダが追加された場合にメッセージを送ります。
変更を検知したいフォルダを選び、右クリックで「通知」の「フォルダイベント」を選びます。この例では「creditdemo2」を選びます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/f1828a58-7eef-374e-0a1e-5599e985c447.png)



Eメールのアドレスを入力します。
その他のオプションには以下があります。
「サブフォルダに適用」：さらに下の階層のフォルダの変更も検知します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/17692645-330e-da28-df11-738ec0b3a5d4.png)



タイトルや本文のデフォルトは以下のようになっています。変数やif文も使えるようになっています。

```html:タイトル
IBM SPSS Collaboration and Deployment Services: Subfolder created in ${ResourcePath}
```

```html:本文
<html> <head> <meta http-equiv="Content-Type" content="text/html;charset=utf-8"/> </head> 
<body> <p>The #if ( $ActionType == "FolderCreated" ) folder #end ${ChildName} has been created in folder ${ResourcePath}.<br/>  <p>To review the content, go to <a href='${ChildHttpUrl}'>${ChildHttpUrl}</a>.</p> <hr><p>This is a machine-generated message. Please do not reply directly. If you do not wish to receive this notification, unsubscribe or contact your Repository administrator.</p> </body> </html> 

```


新しいフォルダを作ります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/01d0d109-6b24-3955-d8e6-6d0e3166b4f5.png)



フォルダが作られたというメッセージが届きます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/1fd574fd-aa70-bc30-7efc-bf91bbab0d14.png)

# フォルダコンテンツの変更
フォルダ内に新しいオブジェクトが追加されたり、既存のオブジェクトが変更された場合にメッセージを送ります。
変更を検知したいフォルダを選び、右クリックで「通知」の「フォルダコンテンツイベント」を選びます。この例では「creditdemo2」を選びます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/5b8c3dc9-1966-f8ef-624d-cff1b76944a4.png)


Eメールのアドレスを入力します。
その他のオプションには以下があります。
「サブフォルダに適用」：さらに下の階層のフォルダの変更も検知します。
「次のファイル・タイプが変更された時だけ通知する」：例えばストリームファイルの変更だけを検知することができます。
ここでは「サブフォルダに適用」にチェックを付けました。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/23e83de4-8bc3-4123-ad98-6a06edff51c2.png)


タイトルや本文のデフォルトは以下のようになっています。変数やif文も使えるようになっています。

```html:タイトル
IBM SPSS Collaboration and Deployment Services:#if( $ActionType=="FileVersionCreated" ) New version of ${ChildName} has been created in#else ${ChildName} has been added to#end ${ResourcePath}
```

```html:本文
<html> <head> <meta http-equiv="Content-Type" content="text/html;charset=utf-8"/> </head> 
<body> <p>#if( $ActionType=="FileVersionCreated" ) A new version of file <b>${ChildName}</b> has been created in  #else The file <b>${ChildName}</b> has been added to #end folder <b>${ResourcePath}</b>.</p>  #if($Attachments)   See attachment. #else   <p>To review the content of the file, go to <a href='${ChildHttpUrl}'>${ChildHttpUrl}</a>. </br></p> #end  <hr><p>This is a machine-generated message. Please do not reply directly. If you do not wish to receive this notification, unsubscribe or contact your Repository administrator.</p> </body> </html> 
```
更新したストリーム・ファイルを保存してみます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/55bc993e-d3da-77e6-7d60-915bf30ef6f7.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/c4bde29a-bb3f-82bf-d8de-62378eca9c08.png)

ファイルが更新されたというメールが届きます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/09ca1b69-7593-9984-9b20-110ed5fe9a02.png)

別の新規ファイルを保存してみます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/d532c281-d398-c946-cd90-4c7bdea549f8.png)


「creditdemo2」のもう一つ下のフォルダの「credit2」にストリームを保存します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/c90dbcb7-fcc7-30cd-9467-a90b67359b05.png)


ストリームが保存されたというメッセージが届きます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/223763/f3af7e07-0c45-e571-3780-8c489a020731.png)

# 検知できるもの

|検知対象|ファイル|ラベル|フォルダ|フォルダコンテンツ|
|---|---|---|---|---|
|ファイル変更|〇|||〇|
|ファイル追加||||〇|
|フォルダ追加|||〇||
|ラベル追加||〇|||
|ラベル移動||〇|||

### 参考：コンテンツに関する通知 - IBM Documentation 

https://www.ibm.com/docs/ja/sc-and-ds/8.4.0?topic=notifications-content