/alfresco-content-app

Alfresco Example Content Application

Primary LanguageTypeScriptGNU Lesser General Public License v3.0LGPL-3.0

Alfresco - make business flow

Alfresco Example Content Application

Introduction

The Alfresco Content Application is an example application built using Alfresco Application Development Framework (ADF) components and was generated with Angular CLI.

Who is this example application for

This project demonstrates how to construct an application for Alfresco Content Services using the Alfresco ADF and it represents a meaningful composition of ADF components that provide end users with a simple easy to use interface for working with files in the content repository.

Where to get help

There are a number of resources available to help get you started with the Content App and the ADF:

To get help on Angular CLI use ng help or read the Angular CLI README.

Raising issues and feature requests

Isuses can be raised in GitHub or in the Alfresco JIRA project. Please include a clear description, steps to reproduce and screenshots where appropriate.All issues will be reviewed; bugs will be categorized if reproducible and enhancement/feature suggestions will be considered against existing priorities if the use case serves a general-purpose need.

High level features planned for Q3 2018 (July - September)

  • Library Management - create, find, join and manage file libraries.
  • Commenting - View and add comments to files and folders
  • Sharing Files - activate and deactivate shared file both manually and automatically.
  • Permissions - update file and folder permissions.
  • Application Extensibility - Extension framework to provide simple ways to extend the application.

Want to help?

Want to file a bug, contribute some code, or improve documentation? Excellent! Read up on our guidelines for contributing and then check out one of our issues in the Jira or GitHub

Available Features

Feature Description
Document List Folder/File browsing of Personal Files, and File Libraries
Shared Files Lists all files that have shared.
Recent Files List files created and/or modified by the logged users within the last 30 days
Favorites Lists all favorited files for the user.
Trash Lists all deleted items stored in the trash can, users can restore or permanently remove. Admin user will see items deleted by all users.
Upload Files and folders can be uploaded through the New button or by dragging and dropping into the browser.
Search Quick search with live results, and full faceted search results page.
Actions A number of actions can be performed on files and/or folders, either individually or multiples at a time
Viewer Viewing files in natively in the browser, unsupported formats are transformed by the repository
Metadata The information drawer can be configured in the app.config.json to display metadata information, by default file the Properties Aspect is shown and images will also include EXIF information.
Versioning The version manager provides access and management of previous file versions, and the ability to upload new versions.

Development server

Run npm start for a dev server. Navigate to http://localhost:4200/ (opens by default). The app will automatically reload if you change any of the source files.

Build

Run npm run build to build the project in the production mode. The build artifacts will be stored in the dist/ directory.

Running unit tests

Run npm test to execute the unit tests via Karma.

Running end-to-end tests

Run the local instance of the application packaged into the docker image together with the ACS images:

npm run build
npm run start:docker

The ACA runs on port 4000 inside the docker container. Run npm run e2e to execute the end-to-end tests via Protractor.

npm run e2e

When testing is over you can stop all corresponding containers:

npm run stop:docker

Further help

To get more help on the Angular CLI use ng help or go check out the Angular CLI README.