Bổ sung tài liệu RESTful API Alfresco 4.0.2

Comments:
http://docs.alfresco.com/4.0/index.jsp?topic=%2Fcom.alfresco.enterprise.doc%2Freferences%2FRESTful-Comments.html

Archive:
http://docs.alfresco.com/4.0/index.jsp?topic=%2Fcom.alfresco.enterprise.doc%2Freferences%2FRESTful-Archive.html

Rating:
http://docs.alfresco.com/4.0/index.jsp?topic=%2Fcom.alfresco.enterprise.doc%2Freferences%2FRESTful-Rating.html

Version:
http://docs.alfresco.com/4.0/index.jsp?topic=%2Fcom.alfresco.enterprise.doc%2Freferences%2FRESTful-Version.html

Workflow:
http://docs.alfresco.com/4.0/index.jsp?topic=%2Fcom.alfresco.enterprise.doc%2Freferences%2FRESTful-Workflow.html

Vai trò của chuẩn mở trong phát triển phần mềm

Chúng ta sẽ nghiên cứu chi tiết tầm quan trọng và vai trò của các chuẩn mở trong phát triển phần mềm qua bài viết sau đây.

Vai trò chung của việc sử dụng các chuẩn mở

Chúng ta có thể thu được rất nhiều lợi ích nếu một tổ chức thực hiện việc mua và triển khai các chuẩn mở. Trước hết, chúng ta sẽ giảm thiểu được khả năng bị "độc quyền hóa" hay lệ thuộc vào một công nghệ đặc biệt hoặc các nhà cung cấp. Các tiêu chuẩn đã được định sẵn và được cộng đồng hóa, vì thế nên các hãng thứ ba hoàn toàn có thể triển khai các giải pháp, miễn là tuân thủ theo các tiêu chuẩn được định ra ban đầu.

Một lợi ích chính nữa mà ta có thể nhận thấy đó là mọi thứ sẽ trở nên dễ dàng hơn khi các hệ thống của các hãng khác nhau sử dụng các công nghệ khác nhau muốn tương thích hay giao tiếp với nhau. Kết quả là, việc chuyển đổi và trao đổi dữ liệu sẽ được cải thiện đáng kể. Không cần thiết phải sử dụng cùng một phần mềm hoặc cùng một phần mềm từ một nhà cung cấp để đọc hoặc viết dữ liệu. Ví dụ, một tổ chức đa quốc gia đòi hỏi tất cả các văn phòng sử dụng các phần mềm văn phòng có thể đọc và viết dữ liệu sử dụng định dạng Open Document, một định dạng chuẩn, mở, nền tảng XML từ OASIS ( Organization for the Advancement of Structured Information Standards).

Sử dụng các chuẩn mở cũng sẽ mang đến một sự bảo vệ tốt hơn cho các tập tin dữ liệu được tạo ra bởi một ứng dụng, mà ít bị lệ thuộc bởi sự lỗi thời của các ứng dụng. Nếu định dạng của tập tin được sử dụng là độc quyền rồi sau đó ứng dụng trở nên lỗi thời, người dùng sẽ gặp phải khó khăn khi chuyển đổi các tập tin dữ liệu sang định dạng khác cần thiết cho ứng dụng mới. Tuy nhiên, nếu định dạng dữ liệu tuân theo một chuẩn mở, hoặc ứng dụng mới sẽ có thể sử dụng nó hoặc sẽ dễ dàng hơn để chuyển đổi dữ liệu để ứng dụng mới có thể sử dụng nó.

Nếu các chuẩn mở được tuân thủ, các ứng dụng sẽ dễ dàng hơn để chuyển từ một nền tảng sang một nền tảng khác bởi vì việc triển khai kỹ thuật theo các hướng dẫn và quy tắc đã biết, và các giao diện, cả trong nội bộ và bên ngoài, đã biết. Thêm vào đó, các kỹ năng học được từ một nền tảng hoặc ứng dụng có thể được sử dụng.

Vai trò cụ thể của việc sử dụng các chuẩn mở

Các chuẩn mở đem lại rất nhiều lợi ích cho các hoạt động hoặc dịch vụ IT. Theo dõi chi tiết ở duới đây.

Các định dạng file

Các hệ thống thông tin hiện đại tạo ra dữ liệu phải được lưu trữ trong một hình thức nào đó của các định dạng tập tin điện tử để lưu trữ hiệu quả, có thể thu hồi và trao đổi. Nếu thông số kỹ thuật của chúng không được công khai, chỉ có phần mềm và các hệ thống của chủ sở hữu của các định dạng độc quyền mới có thể dễ dàng truy cập chúng. Ngoài ra, việc trao đổi thông tin là điều cần thiết cho các chức năng của xã hội hiện đại. Việc trao đổi này sẽ bị cản trở nghiêm trọng nếu các định dạng tập tin không mở được sử dụng như các sản phẩm từ một nhà cung cấp không thể lấy, truy cập hoặc lưu trữ các thông tin từ các sản phẩm của các nhà cung cấp khác. 
Chúng ta có thể thấy một điều vô cùng quan trọng là các định dạng tập tin điện tử phải tuân theo một số chi tiết kỹ thuật để có thể truy cập đuợc bởi tất cả các bên quan tâ. Nói cách khác, chúng cần phải được triển khai bằng cách sử dụng các chuẩn mở.

Các ứng dụng văn phòng

Chúng ta có thể thấy sự thiếu tương thích rõ rệt giữa các tài liệu được tạo ra bởi MS Office và các hãng khác đã cản trở người dùng khá nhiều trong việc sử dụng như thế nào. Ví dụ này đã minh họa cho chúng ta thấy được các định dạng tệp tin mở và chuẩn hóa là thật sự cần thiết để cung cấp cho người dùng sự tự do và linh động trong việc lựa chọn và sử dụng các sản phẩm  từ các nhà cung cấp khác nhau, qua đó ngăn chặn chúng khỏi bị "khóa" bởi một sản phẩm hay nhà cung cấp nào đó.

Các dịch vụ Internet và các ứng dụng

Có lẽ Internet chính là một ví dụ điển hình nhất chỉ ra cho chúng ta thấy được khi các công nghệ sử dụng phần lớn các chuẩn mở, chúng ta sẽ có được những lợi ích và khả năng tiếp cận dễ dàng đến mức nào. Phần lớn cơ sở hạ tầng mạng của internet được triển khai dựa trên các chuẩn mở được xây dựng bởi IETF. Ngoài ra, nhiều dịch vụ và ứng dụng đang chạy cũng như đang được lên kế hoạch cho tương lai đang được triển khai dựa trên các chuẩn mở và khuyến nghị từ các cơ quan đáng chú ý: IETF, W3C và OASIS. Kết quả là, ngày nay, một dịch vụ có thể truy cập vào các dịch vụ chính được cung cấp trên Internet bằng cách sử dụng vô số các môi trường khác nhau, từ máy tính hàng hóa, PDAs và các thiết bị di động cho đến các TV sets,... Nếu không tuân thủ các chuẩn mở, Internet sẽ khó có thể được phổ biến như ngày nay.

====================== Hết =======================

Tuesday, August 07, 2012 - Meeting minutes

1. Chức năng Upload File:

    - Tiến độ hiện tại: 60%
    - Max file size: Cho setting preferences (user tự setting)
        Default 10MB.
    - Hỗ trợ những file type: All


2. Chức năng Edit File:

    - API diff: Node version information
            GET /alfresco/service/api/version


3. Chức năng Favorite File:

    - API:
        + POST /alfresco/service/api/people/{userid}/preferences ?
            (Cần a Linh confirm lại)


4. Contact Alfresco Community: (Bách take care)

    - Document
    - Làm 2 task:
        + Project master schedule
        + Project goal statements


5. Bổ sung WBS:

    - Break nhỏ task UT:
        + Create script
        + Execute script
    - Thêm task "Create Demo using API" cho mỗi function.

Quan trọng hàng đầu hiện tại vẫn là Tạo được demo sử dụng các API

Alfresco Tech Talk Live on Alfresco's SDKs for Android and iOS

Alfresco's SDK cho Android và iOS sẽ sớm được phát hành đến tay lập trình viên.
Thời gian cụ thể chưa được công bố

Link tham khảo: http://www.slideshare.net/alfresco/alfresco-tech-talk-live-mobile-sd-ks

Link video xem toàn bộ hội thảo: http://www2.alfresco.com/TTL_Episode_56

Tổng hợp tài liệu Alfresco API

Danh sách tham khảo các API cần dùng cho dự án:

- Pro Alfresco Appendix A

- Alfresco API Refenrece

- Repository RESTful API Reference

Nội dung cuộc họp ngày 31/07

a Hưng, Nam

Fixx Cafe 

18:00 - 19:00h

1. Update WBS do nhanh hơn tiến độ

- Thêm tasK: nghiên cứu API, deploy (#Rank 1):

+ Tìm được API support chức năng cần làm

+ Tạo demo chạy được API đó

+ Merge code vào Freshdocs

- Điều chỉnh time , content của 1 vài task

- Thêm task phát sinh

2. Chọn APi

- Chốt: Kết hợp CMIS và RESTful

- Lý do:

+ CMIS: tương thích cao, cách dùng đơn giản.

+ RESTful: thích hợp mô hình client-server

- Lý do phối hợp 2 API

+ Link hỏi trên SO: http://stackoverflow.com/questions/11717308/alfresco-api-for-android

=> Task: tìm hiểu tổng quan về http://chemistry.apache.org/.

+ BẢn 0.7.0 , chưa support Android

+ Bản 0.8 (Beta): đã support Android, tuy nhiên chưa có Document

=> hỏi trên mailinglist: http://mail-archives.apache.org/mod_mbox/chemistry-dev/201207.mbox/browser

3. Tìm hiểu sự hỗ trợ của RESTfull API với các version của Alfresco

 

 

4. Tương tác với Alfresco:

 

Link user trên forum : https://forums.alfresco.com/en/memberlist.php?mode=viewprofile&u=57549

5. Contact 

// TODO: liên lạc trực tiếp qua email 

6, Mô tả các làm Unit test, report qua group mail, blog

7 . Upload:

Tìm hiểu xem có show dc diff khi update file (text) không?

Báo cáo tuần (23-27/07)

Dear mentor và các bạn

Em xin báo cáo công việc của tuần qua như sau:

I - Các công việc đã hoàn thành

- Hoàn thành update GUI và fix các bug liên quan đến GUI

- Fix all bug chức năng duyệt file từ điện thoại để upload lên server.

- Sửa lại giao diện "View File / Folder Information"

- Tạo mới folder / file trên Repositoty

II - Khó khăn, giải pháp

- Do Freshdocs được phát triển và bỏ dở từ lâu, nên hiện tại source đang xử lý các công việc thủ công, chậm chạp (tự parse xml .......) và chưa support hết các version của Alfresco.

= > Nghiên cứu sử dụng Apache Chemistry library  để dùng CMIS API (Tuy nhiên chưa hỗ trợ chính thức cho Android)

- API của Alfresco chia làm 3 loại: CMIS, RESTful API, Web Services . Mỗi loại đều cung cấp các API để thực hiện các chức năng khác nhau. Tuy nhiên có những api ko dùng được với 1 số version của Afresco

=> Hiện team đang sử dụng kết hợp CMIS và RESTfull để tận dụng ưu điểm của mỗi loại

- Source code của Freshdocs không có comment, tốn effort để tìm hiểu các method

=> Team phân chia nghiên cứu source code và comment các function chính

- Liên lạc với owner của Freshdocs, nhưng chưa có hồi âm
=> Hiện tại chỉ liên lạc qua github, team sẽ tìm hiểu profile của owner và tìm các cách liên hệ khác

III - Question
- Em không dùng Alfresco từ trước, nên cũng không rõ sự khác nhau giữa các phiên bản của Alfresco. Anh Hưng và anh Linh support em được không ạ

Rất mong mọi người góp ý

Regards

Vũ Hải Nam

Tiến độ công việc 24/07/2012

Theo Nội dung cuộc họp ngày 17/07/2012 và WBS update, hiện tại team đã hoàn thành tương đối những việc sau:

1. Update giao diện mới cho Repository (Thêm, sửa thông tin kết nối). 


2. Update giao diện mới cho chức năng duyệt tài liệu (trên server).


3. Cải tiến chức năng View File / Folder Information (hiển thị nhiều thông tin hơn).


4. Thêm chức năng duyệt file từ điện thoại để upload lên server.

Một việc nữa là team đã liên hệ với người quản lý của upstream nhưng vẫn chưa có hồi âm.Mong là sẽ sớm contact được với anh Jeff Simpson này :)

Work Breakdown Structure (WBS) update 20/07/2012

Theo như nội dung cuộc họp ngày 17/07/2012, WBS đã được update như sau:

File OpenProj (.POD) gốc: Tại đây

Nội dung cuộc họp ngày 17/07/2012

2012/07/17 18:30 - 20:00
Nam, anh Linh
Ecoit

!- Các đầu mục công việc cần thực hiện (sắp xếp theo thứ tự ưu tiên)

1 Sửa GUI , theo style của mock up, android 4.0

2 Cải tiến chức năng View file information: Chức năng hiện tại cung cấp rất ít thông tin

3 Sửa file online / offline

4 Xóa file (folder) trên server

5 Upload file 

- Upload khi đang ở trong thư mục của repository Alfresco

- Upload khi duyệt các file trên client

6 Add Favorite trên server : hiện nay freshdocs mới cung cấp lưu ở client

7 Comment , rate file

8. Tạo mới folder trên alfresco

9. Cải tiến tính năng Search

=> Hoàn thiện 9 tính năng này sẽ ra version đầu tiên, test kỹ và commit trên upstream trước. 

10. Tất cả công việc của workflow như đã miêu tả ở WBS

II- Upsteam

- Team chủ động liên hệ với người quản lý của upsteam sớm.

Screens & Transitions

Ước tính app Alfresco Android sẽ có 10 màn hình chính, cụ thể:

Screen Name	Description
#1_Repository_Browsing	Màn hình duyệt những repository đã được lưu thông tin kết nối
#2_Repository_Adding_Editing	Màn hình thêm / sửa thông tin kết nối của 1 repository
#3_File_Browsing	Màn hình duyệt file trong 1 repository
#4_File_Information	Màn hình xem thông tin chi tiết của 1 file: permission, name, size, author …
#5_Download	Màn hình chọn nơi lưu file từ repository về phone
#6_Upload	Màn hình chọn file từ phone để tải lên repository
#7_Search	Màn hình nhập thông tin tìm kiếm và hiển thị kết quả
#8_Workflow_Browsing	Màn hình duyệt các workflow trong repository
#9_Workflow_Adding_Editing	Màn hình thêm / sửa 1 workflow
#10_Workflow_Details	Màn hình xem thông tin chi tiết của 1 workflow

Bên dưới là mock-up hiện thời của các màn hình đó:

Màn hình 1 - Repository Browsing

Màn hình 2 - Repository Adding/Editing

Màn hình 3 - File Browsing

Màn hình 4 - File Information

Màn hình 5 - Download

Màn hình 6 - Upload

Màn hình 7 - Search

Màn hình 8 - Workflow Browsing

Màn hình 9 - Workflow Adding/Editing

Màn hình 10 - Workflow Details

Transition cụ thể:

- Từ S1 (màn hình 1):

• Tap vào nút [Add new] -> S2.
• Tap và giữ vào 1 repository trong list, chọn [Edit] -> S2.
• Tap và giữ vào 1 repository trong list, chọn [Remove] -> Dialog confirm -> S1.
• Tap vào 1 repository trong list -> S3.

- Từ S2:

• Tap vào nút [Save] -> S1.
• Tap vào nút [Back] -> S1 (không lưu lại thay đổi).

- Từ S3:

• Tap vào 1 file trong list -> S4.
• Tap và giữ vào 1 file trong list, chọn [Download] -> S5.
• Tap và giữ vào 1 file trong list, chọn [Delete] -> Dialog confirm -> S3.
• Tick check box và tap vào nút [Download] -> S5.
• Tap vào nút [Upload] -> S6.
• Tap vào tab [Search] -> S7.
• Tap vào tab [Workflow] -> S8.
• Tap vào nút [Back] -> S1.

 - Từ S4:

• Tap vào nút [Download] -> S5.
• Tap vào tab [Search] -> S7.
• Tap vào tab [Workflow] -> S8.
• Tap vào nút [Back] -> S3.

 - Từ S5:

• Tap vào nút [Save] -> S3|S4 (tùy thuộc S trước đó).
• Tap vào nút [Back]|[Cancel] -> S3|S4 (tùy thuộc S trước đó) (không lưu file).

- Từ S6:

• Tap vào nút [Upload] -> Dialog confirm -> S3.
• Tap vào nút [Back]|[Cancel] -> S3.

- Từ S7:

• Tap vào nút [Search] -> S7 (hiện kết quả tìm kiếm).
• Tab vào 1 kết quả trong list -> S4.
• Tab và giữ vào 1 kết quả trong list, chọn [Download] -> S5.
• Tab và giữ vào 1 kết quả trong list , chọn [Delete] -> Dialog confirm -> S7.
• Tap vào tab [Document] -> S3.
• Tap vào tab [Workflow] -> S8.

 - Từ S8:

• Tap vào nút [Add workflow] -> S9.
• Tap và giữ vào 1 workflow trong list, chọn [Edit] -> S9.
• Tap và giữ vào 1 workflow trong list, chọn [Delete] -> Dialog confirm -> S8.
• Tick check box và tap vào nút [Delete workflow] -> Dialog confirm -> S8.
• Tap vào tab [Document] -> S3.
• Tap vào tab [Search] -> S7.

 - Từ S9:

• Tap vào nút [Clear All] -> Xóa thông tin đã nhập -> S9.
• Tap vào nút [Start workflow] -> S8.
• Tap vào tab [Document] -> S3.
• Tap vào tab [Search] -> S7.

 - Từ S10:

• Tap vào nút [Workflow Done] -> Dialog confirm -> S10.
• Tap vào nút [Back] -> S8.
• Tap vào tab [Document] -> S3.
• Tap vào tab [Search] -> S7.

File bảng tính (ods) gốc: Tại đây

Tuesday, July 10, 2012 - Meeting minutes

2012/07/10 18:30 - 19:40
Nguyễn Hưng, Vũ Hưng
Fixx Cafe

1. Cấu trúc thư mục:

Cấu trúc thu mục cũ:
https://github.com/ZuzooVn/cmsandroid

Cấu trúc thư mục mới
https://github.com/ZuzooVn/
- SourceCode
  Copy nguyên xi từ https://github.com/ZuzooVn/cmsandroid
- Document
  Trỏ đến Wiki của github -> https://github.com/ZuzooVn/cmsandroid
- Management
  WBS đưa lên đây
- QualityControl
  - Unit Test: Là 1 thư mục con trong code -> có pull lên github
  - Functional Test: Thư mục con, .ods (bảng tính)


2. WBS
- Đã có danh sách đầu công việc
- TODO: Assign người
- TODO: Ước tính thời gian cho từng task

3. Số lượng màn hình, screen transition
- Cần làm trong tuần này

4. Thiết kế giao diện, tích hợp graphics
- TODO: Cần bổ sung
- Là các task con của "Design GUI"
- Ở dạng XML

5. Mô tả một số use case điển hình?
- Làm sớm
- Bổ sung thêm các use case đã nộp cho Ban Giám Khảo (dự kiến: dựng từ
đầu, thực tế: base trên freshdoc)

6. Chức năng edit file
- Download ngầm về máy, sau đó dùng native app để chỉnh sửa.
- Save -> Upload ngược lên.

7. Kết quả tuần trước
- So sánh, phân tích chức năng freshdoc
  - Đọc tài liệu của freshdoc trên slideshare
- Tạo danh sách chức năng
- Chuẩn bị môi trường: blog, fork từ freshdoc -> androidcms, facebook


8. Các công nghệ sử dụng trong dự án
- RESTful API
        (Tham khảo trong slide design của bản iOS)
        Liệt kê những API mà mình sẽ sử dụng.
- CMIS
- SOAP (khả năng cao là ko dùng)
- JSON

9. Danh sách tài liệu tham khảo:
- http://wiki.alfresco.com/wiki/Developer_Guide
- http://wiki.alfresco.com/wiki/Repository_RESTful_API_Reference

Monday, July 2, 2012 - Meeting minutes

2012/07/02 8:00 pm - 9:30 pm
Skype
Nam, Hưng, Bách

Tổng kết lại tiến độ và các công việc của tuần

Tiến độ
- WBS (work breakdown structure) -> Cần làm sớm
- WBS dựa trên file "Existing Systems Comparison.xlsx"

=> Hưng phụ trách , dealine 2012/07/08 8:00 pm

Chức năng

- Liệt kê, so sánh các chức năng của Freshdocs và mục tiêu nhóm cần hoàn thành

- Định nghĩa lại cụ thế các chức năng

- Thiết lập độ ưu tiên phát triển các chức năng

=> Nam phụ trách , dealine 2012/07/08 8:00 pm

Tài liệu

- Thiết kế template tài liệu srs, sdd, testcase, user guideline

=> Bách phụ trách , dealine 2012/07/08 8:00 pm

<Vũ Hải Nam>