Download as PDF, PPTX
![SlackUserNotifierクラスの作成
• Eメール通知用の org.alfresco.repo.activities.feed.EmailUserNotifier をコ
ピーして SlackUserNotifier クラスを作成し、#notifyUser の内容を書き換
える。
10
protected void notifyUser(NodeRef personNodeRef, String subjectText, Object[] subjectParams, Map<String, Object>
model, String templateNodeRef)
{
Gson gson = new Gson();
try {
JSONArray activitiesArray = new JSONArray(gson.toJson(model.get("activities")));
String botName = "Alfresco";
for (int i = 0; i < activitiesArray.length(); i++) {
// アクティビティの内容からSlackに送信する要素を抽出
JSONObject activity = activitiesArray.getJSONObject(i);
String target = "@" + activity.getString("feedUserId");
… … …
// 抽出した要素でSlackのIncoming WebHookに送るpayloadを作成
StringBuilder payload = new StringBuilder();
payload.append("payload={¥"channel¥":¥"");
… … …
// SlackのIncoming WebHookにPOST
HttpClient httpClient = HttpClientBuilder.create().build();
HttpPost request = new HttpPost(this.slackWebhookUrl);
… … …
}
… … …
}](https://image.slidesharecdn.com/alfresco20160928-160929064333/85/Alfresco-35-Alfresco-Slack-9-320.jpg)
Alfresco勉強会#35 AlfrescoのアクティビティフィードをSlackに送るカスタマイズ
- 1.
- 2.
- 3. 今回使用する環境 • Alfresco CommunityEdition 201605 GA ⁃ 2016.09.28現在の最新版のGA 4
- 4.
- 5.
- 6.
- 7. RSSフィードをSlackで受け取ればいいのでは？ • 要件次第ではその選択肢もあり得る。 • コンテンツに対するアクセス権の問題があるため、アクティビティフィードの 内容はユーザ毎に異なる。そのためRSSフィードのURLもユーザ毎に違うし認 証も必要になる。 •Slackでユーザ毎にRSS購読の設定をすれば（そのようなことができるかどう かは未確認）実現できるかもしれないし、もしかしたらSlack側にちょうどよ いアプリがあるかもしれないが今回はAlfresco側をカスタマイズして実現して みる。 8
- 8. カスタマイズの方針 • できるだけ簡単に実装するため、Eメール通知でメールを送信している部分の み置き換える。 • Slack側ではIncomingWebHookを使って通知を受け取る。 9
- 9. SlackUserNotifierクラスの作成 • Eメール通知用の org.alfresco.repo.activities.feed.EmailUserNotifierをコ ピーして SlackUserNotifier クラスを作成し、#notifyUser の内容を書き換 える。 10 protected void notifyUser(NodeRef personNodeRef, String subjectText, Object[] subjectParams, Map<String, Object> model, String templateNodeRef) { Gson gson = new Gson(); try { JSONArray activitiesArray = new JSONArray(gson.toJson(model.get("activities"))); String botName = "Alfresco"; for (int i = 0; i < activitiesArray.length(); i++) { // アクティビティの内容からSlackに送信する要素を抽出 JSONObject activity = activitiesArray.getJSONObject(i); String target = "@" + activity.getString("feedUserId"); … … … // 抽出した要素でSlackのIncoming WebHookに送るpayloadを作成 StringBuilder payload = new StringBuilder(); payload.append("payload={¥"channel¥":¥""); … … … // SlackのIncoming WebHookにPOST HttpClient httpClient = HttpClientBuilder.create().build(); HttpPost request = new HttpPost(this.slackWebhookUrl); … … … } … … … }
- 10. Beanの差し替え • Bean定義を上書きするために以下の内容を custom-activity-feed- context.xmlとして作成し、以下の場所に配置する。 tomcat/shared/classes/alfresco/extension/subsystems/ActivitiesFeed/d efault/default 11 <?xml version='1.0' encoding='UTF-8'?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd"> <bean id="feedNotifier" class="org.alfresco.repo.activities.feed.FeedNotifierImpl"> … … … <property name="searchService" ref="SearchService"/> <!-- <property name="userNotifier" ref="emailUserNotifier"/> --> <property name="userNotifier" ref="slackUserNotifier"/> <property name="numThreads" value="${activities.feedNotifier.numThreads}"/> <property name="batchSize" value="${activities.feedNotifier.batchSize}"/> </bean> <bean id="slackUserNotifier" class="jp.aegif.alfresco.repo.activities.feed.SlackUserNotifier"> <property name="activitiesFeedModelBuilderFactory" ref="feedModelBuilderFactory"/> <property name="activityService" ref="activityService"/> … … …
- 11. （補足）Beanの差し替え • Bean定義を上書きするために以下の内容を custom-activity-feed- context.xmlとして作成し、以下の場所に配置する。 tomcat/shared/classes/alfresco/extension/subsystems/ActivitiesFeed/d efault/default 12 これは誤植ではなくdefaultを2回重ねる必要があり ます。けっこうハマるポイントなので要注意。 詳しくはこちらを参照してください。 https://community.alfresco.com/docs/DOC-5777- alfresco-subsystems#w_extensionclasspath
- 12. alfresco-global.properties に設定値を追記 • SlackのIncomingWebHook用のURLをプロパティとして設定し、通知を送 る頻度を10秒に1回に変更する。 13 activities.feedNotifier.slackWebhookUrl=https://hooks.slack.com/services/XXXXXXXX activities.feed.notifier.cronExpression=0/10 * * * * ?
- 13.
- 14. 改善すべき点 • 配信するメッセージのフォーマットを整える。Eメール通知やRSSフィードの 仕組みを応用すれば多言語対応もできるはず。 • Eメールで1日1回送りつつ、今回のようにリアルタイムに近い形での配信も行 う場合は送信済みのアクティビティの管理方法を考える必要がある。 ※デフォルトのEメール通知では一度送ったアクティビティには送信済みのフ ラグが付けられ、何度も送信されない仕組みがある。今回もEメールによる通 知をSlackに置き換えているだけなので同じ仕組みで動いている。両方を併用 する場合はSlackには送ったがEメールでは送っていないといったステータス の管理が必要になる。 •今回はAlfresco上のユーザ名とSlack上のユーザ名が同じであるという前提で 作ったが、両者が異なる場合には変換する仕組みが必要。 15
- 15. （参考） • Alfresco addonsにSlack連携のアドオンがありました。 https://addons.alfresco.com/addons/alfresco-slack-plugin • SOURCE SENSEという会社が作っているようで、設定用のUIもあるようで す。興味のある方は使ってみるとよいかもしれません（紹介しておいて申し訳 ありませんが動作確認はしてません・・・）。 16