第32回のAlfresco勉強会で発表した、Alfrescoに同梱されている「Bulk Import tool」のご紹介資料です。 「Bulk Import tool」は文字通りインポート用ツールなのですが、手軽で便利な割にあまり知られていないように感じますので、利用上の注意点を含めご紹介させていただきました。 インポート時にファイルの複数バージョンを与える方法、メタデータを与える方法についても説明しています。 これからAlfrescoを使い始めようと考えていて既存コンテンツのインポート方法を知りたい方、既に利用しているが大量コンテンツの追加を手軽に行いたいと考えている方等の参考になるかと思います。

1. 第32回 Alfresco勉強会
Bulk Import toolのご紹介
2016年3月23日
Moritaka Soma

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

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

4. Bulk Import tool
Alfresco Bulk Import tool

5. Bulk Import tool
Alfresco Bulk Import tool
元はAdd onとして提供されていたが、
Alfresco 4.0以降製品に同梱されるように
Alfrescoをインストールしてすぐに使えます！

6. Bulk Import tool
Alfresco Bulk Import tool
他の手段に比べてのメリット:
• Alfresco4.0以降ならデフォルトで利用可能
• ファイルツリー構造をインポート可能
• ファイルサーバ機能を利用するより高速
• インポートと同時にメタデータ、
ファイルの履歴情報を付加可能
（但し、準備が必要）
• インポート状況を確認可能

7. Bulk Import tool
ファイルメタデータ
ファイルの末尾に” .metadata.properties.xml”を付加した
メタデータファイル(例: sample.txt.metadata.properties.xml)を
作成することでメタデータを与えることができます
メタデータファイル例: (sample.txt.metadata.properties.xml)
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<entry key="type">cm:content</entry>
<entry key="aspects">cm:versionable,cm:dublincore</entry>
<entry key="cm:title">A Sample Text File.</entry>
<entry key="cm:description">A Sample Text file for Alfresco Study #32.</entry>
<entry key="cm:created">2016-01-01T12:34:56.789+09:00</entry>
<!-- cm:dublincore properties -->
<entry key="cm:author">admin</entry>
</properties>

8. Bulk Import tool
ファイルメタデータ
フォルダにもメタデータを与えることができます
メタデータファイル例: (SubFolder.metadata.properties.xml)
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<entry key="cm:title">A Sample Folder.</entry>
<entry key="cm:description">A Sample Folder for Alfresco Study #32.</entry>
<entry key="cm:created">2016-01-01T12:34:56.789+09:00</entry>
</properties>

9. Bulk Import tool
ファイル履歴情報
ファイルの末尾に”.v<バージョン番号>”を付加する(例: sample.txt.v2)ことで、
ファイルに履歴情報を与えることができます
例:
以下のファイルがインポート元の同一フォルダにある場合
• Sample.txt
• Sample.txt.v1
• Sample.txt.v2
末尾に何も付かないファイル(Sample.txt)が最新バージョン
Sample.txt.v2がひとつ前のバージョン
Sample.txt.v1が一番古いバージョン
としてインポートされます。

10. Bulk Import tool
ファイル履歴をインポートする際の注意点：
• 指定したバージョン番号のファイルとして
インポートされるわけではない
末尾に付加した番号は履歴順の特定のみに使われる
例:
• Sample.txt
• Sample.txt.v1
• Sample.txt.v3
Sample.txtが最新バージョン(ver. 3.0)
Sample.txt.v3がひとつ前のバージョン
Sample.txt.v1が一番古いバージョン

11. Bulk Import tool
ファイル履歴をインポートする際の注意点：
• 最新バージョンの番号は同一ファイルの数で決まる
• Sample.txt
• Sample.txt.v1
• Sample.txt.v3
と3ファイルある場合、
Sample.txtのバージョンは3.0 (4.0ではない）
• バージョン番号指定に使えるのは整数のみ
Sample.txt.v1.5等の小数点を持つバージョン番号は使えない

12. Bulk Import tool
インポート状況の確認：
http://<alfresco host>/alfresco/service/bulkfsimport/status で確認可能
WebUIからキックした場合は自動で遷移します

13. Bulk Import tool
2種類のインポート方法を提供
Streaming Import:
• ファイルシステムから、コンテンツストアへファイルを
コピーしてインポート
• Community版でも利用可能
In-place Import:
• Enterprise版のみ利用可能
• 事前にコンテンツストア内にあるファイルをコピーせずに
登録（ファイルコピー無し、高速）
• コンテンツストア内にmountされたファイルでもOK
但し、Alfrescoから常にアクセス可能な必要がある

14. Bulk Import tool (Streaming Import)
Alfresco Bulk Import tool(Streaming Import)
http://<alfrescohost>/alfresco/service/bulkimport でWebUIにアクセスできます

15. Bulk Import tool (Streaming Import)
Alfresco Bulk Import tool(Streaming Import)
設定項目
• Import directory:
ファイルシステム上のImport元ディレクトリ
• Target space(Path or NodeRef):
Alfresco内のImport先を、
Path(例: /Company Home/ImportTest)か
NodeRef（例: workspace://SpacesStore/6e32e892-c5dd-47e6-90fe-
bce0e7f509c6）
で指定
• Disable rules:
Import作業中にImport先フォルダのRuleの実行を無効化
• Replace existing files:
Import作業中に同名のファイルが存在した場合に上書きを行う

16. Bulk Import tool (Streaming Import)
Alfresco Bulk Import tool(Streaming Import)
設定項目 (つづき)
• Batch Size:
一度にImportするファイル/フォルダ数
設定しない場合はデフォルト値(Alfresco One 5.1の場合20)を使用
• Number of Thread:
Importに利用するThread数
設定しない場合はデフォルト値(Alfresco One 5.1の場合4)を使用

17. Bulk Import tool (Streaming Import)
Alfresco Bulk Import tool(Streaming Import)
デモ:

18. Bulk Import tool (In-place Import)
Alfresco Bulk Import tool(In-place Import)
http://<alfresco host>/alfresco/service/bulkfsimport/inplaceで
WebUIにアクセスできます

19. Bulk Import tool (In-place Import)
Alfresco Bulk Import tool(In-place Import)
設定項目
• Store-relative import directory path(インポートディレクトリパス):
Alfrescoコンテンツストア内のインポート元ディレクトリの相対パス
• Content Store(コンテンツストア):
インポート元フォルダのあるコンテンツストアの指定
• Target repository path(ターゲットリポジトリパス):
Alfresco内のインポート先のリポジトリパス
• Disable rules:
• Batch Size:
• Number of Thread:
Streaming Importと同じ

20. Bulk Import tool (In-place Import)
In-place Importの際の注意点:
In-place Importではインポート元のフォルダ構造がそのまま利用されるため、
効率のために1フォルダ内に大量のコンテンツが存在することを避けることが
推奨されています
最大でも1フォルダ内に子コンテンツが数1000以下であることが推奨されます
Alfrescoデフォルトのコンテンツストアでは、コンテンツが
/年/月/日/時/分/ のフォルダ構造の下に置かれ、1フォルダ以下に
大量のコンテンツが置かれることのないようになっています
インポート元フォルダがAlfrescoリポジトリと同期する機能ではありません
あくまでインポートであり、Alfresco上に登録されるのはインポート時に存在した
ファイル/フォルダのみです

21. Bulk Import tool (Streaming Import)
Alfresco Bulk Import tool(In-place Import)
デモ:

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