第35回のAlfresco勉強会で発表した、Alfresco ShareのAdd-on「Javascript Console」のご紹介資料です。 「Javascript Console」はShare Extrasが配布する、Alfresco Shareの管理者ツールにShare上でjavascriptを実行するためのコンソールを追加するアドオンです。Share上でjavascriptを実行できるとAlfrescoの開発者がテストや検証を行う際、管理者が非定型的な管理業務を行う際などに便利に利用することができます。 また、コード補完や繰り返し実行、出力の整形機能など便利な機能を備えていますので、Alfresco Shareのjavascript APIを使用したスクリプト作成の際に非常に役立ちます。 Alfrescoを既に使用していている管理者や開発者で、Shareのjavascript APIを利用したスクリプトの作成を行いたい方の参考になるかと思います。

1. 第35回 Alfresco勉強会
Javascript Consoleのご紹介
2016年9月28日
Moritaka Soma

2. 自己紹介
相馬 盛孝
オープンソースコンサルティングチーム所属
Alfrescoのカスタマイズやサポートをしています

3. 発表内容
本日の発表内容:
便利なAlfrescoのShare拡張
Javascript Console について紹介
• 具体的にどんなことができるのか？
• 実際の画面・操作 デモ

4. Javascript Console
Javascript Consoleとは
Alfesco Shareの管理画面上で、JavaScriptを
作成、実行し結果を確認できるAdd-on

5. Javascript Console
JavaScriptを実行できると何が嬉しいか？
• テスト、検証
• 大量のファイルを自動作成して負荷テスト
• フォルダのルール用スクリプトの作成、テスト
• Share UIからは直接実行出来ない機能の実行
• (JavaScript APIとして公開されている）APIを直に実行
• 管理業務
• ファイルの簡易バックアップ
• ファイル一覧の作成
• Etc…
カスタマイズを作成して検証したり、
手作業で行うには大変な作業を手軽に実行可能

6. Javascript Console
配布元
Share Extras

7. Javascript Console
Share Extras:
オープンソースでAlfresco Shareの拡張機能を
公開しているプロジェクト
Share Extrasプロジェクトで公開されている拡張機能は
Apache License 2.0で公開されています

8. Alfresco用とShare用、以下の2つのAMPファイルのインストールを行います。
• javascript-console-repo-<version>.amp
• javascript-console-share-<version>.amp
Alfrescoがインストールされているサーバ上で、以下のように
Alfresco Module Management Tool(alfresco-mmt.jar)を使用してAMPをwarファイル
にインストールします。
java -jar alfresco-mmt.jar install javascript-console-repo-<version>.amp
<alfrescoインストールフォルダ>/tomcat/webapps/alfresco.war
java -jar alfresco-mmt.jar install javascript-console-share-<version>.amp
<alfrescoインストールフォルダ>/tomcat/webapps/share.war
<alfrescoインストールフォルダ>/tomcat/webapps/以下に展開済みのalfresco/、
share/フォルダがある場合は削除し、AMPの適用されたwarをデプロイします。
Javascript Console
インストール方法:
GitHub上で、AMP形式とソースコードで配布されています。
https://github.com/share-extras/js-console
ソースコードからインストールする場合、MavenでAMPファイルをビルドします

9. Javascript Console
利用方法:
AMPのインストールを行いAlfrescoを起動すると「管理ツール」の「ツール」に
Javascript Consoleが現れます。

10. Javascript Console
利用方法:
JavaScriptコードをjavascript inputタブに入力し、Executeボタンを押すか、
Ctrl+Enterキーを押すと実行され結果が下部に表示されます。

11. Javascript Console
利用方法:
JavaScriptコードをjavascript inputタブに入力し、Executeボタンを押すか、
Ctrl+Enterキーを押すと実行され結果が下部に表示されます。

12. Javascript Console
利用方法(メニュー）:
ファイル/フォルダ一覧画面のメニューに
• Use in javascript Console
• Dump in javascript Console
メニュー項目が追加されます

13. Javascript Console
利用方法(Use in javascript Consoleメニュー）:
クリックすると”document”変数に指定のファイル/フォルダが格納された状態で
javascript Console画面が開かれます。

14. Javascript Console
利用方法(Dump in javascript Consoleメニュー）:
クリックすると指定のファイル/フォルダのノード情報がDumpされた状態で
javascript Console画面が開かれます。

15. Javascript Console
利用方法(その他）:
• Save/Load Script:
作成したスクリプトはSave/Loadが可能
最初から基本的なタスクのサンプルが幾つか登録されているの
で
スクリプト作成する際の参考にすると便利です。
• Docs: AlfrescoのJavaScript APIドキュメントへのショートカット
• Editor Theme: EditorのカラーThemeを変更可能

16. Javascript Console
他にも便利な機能が…
• コード補完機能
Alfresco Share用スクリプトを書く上で非常に便利な一押し機能です！
• Freemakerテンプレートを使用した、出力の整形機能
• Script実行環境の指定
（引数、実行ユーザー、トランザクション分離レベル、繰り返し実行)
うまく利用してAlfrecoをもっと活用しましょう！

17. Javascript Console
注意点:
本来であればスクリプトを実行するフォルダを選択できるはずなのですが、
現状、選択ダイアログが正常に動作しません…
（現時点のCommunityの最新GA版201605 GAで発生します）

18. Javascript Console
デモ:

19. ありがとうございました。