alfresco-ng2-components/docs/tutorials/README.md

ADF Tutorials

Learn about ADF step-by-step with the tutorials listed below. You may find it helpful to follow them in sequence because some of the later tutorials build on knowledge introduced in the earlier ones.

The tutorials are graded as follows:

• Beginner: Suitable for users with no previous knowledge of ADF.
• Intermediate: For users who want to add to their knowledge of the basics.
• Advanced: For experienced users who want to learn about features in depth.

Tutorials

Name	Level	Abstract
Preparing the development environment	Beginner	This tutorial explains how to get set up to use ADF so you can tackle the other tutorials. It covers the basic development environment with suggested versions for each tool, library and module.
Creating your ADF application using Yeoman	Basic	Learn how to create an ADF application from scratch, using the Yeoman scaffolding tool. This task is recommended to get started before developing your ADF application.
Creating your JavaScript application using alfresco-js-api	Basic	Learn how to create from scratch an application in JavaScript to interact with Alfresco Content Services. This task is recommended to get started before developing your JavaScript application using the alfresco-js-api library.
Adding a new component	Basic	By definition, a component controls a patch of screen called a view. For example, individual components define and control menus, tabs, forms, buttons and every simple or complex portion ofan application's layout. In this tutorial, you will learn how to create a component using Angular CLI within an existing application.
Adding a new view	Beginner	Every application developed in Angular is a single page application where the concepts of view and routing play a key role in the user experience. Being a single page application, the navigation between the different layouts (called views) is enabled through the routing. In this tutorial you will learn how to create a new view in your application and how to access it using a defined endpoint.
Using components	Beginner	There are three different ways to use, extend and configure an ADF component: configuration properties, event listeners, and content projection / HTML extensions. In this tutorial you will see a practical example of each approach using the Login component.
Basic theming	Beginner	In this tutorial you will see how to change the colours of your ADF application using a set of palettes. You will be introduced to the basics around palettes in Material Design and you will customise your own ADF application generated using Yeoman.
Customizing the Login component	Intermediate	In this tutorial you will learn how to customize the `Login` component following the technical documentation. The task will be very simple. See the documentation for further details about customizing this component, along with examples.
Working with a Data Table	Intermediate	In this tutorial you will learn how to populate a `DataTable` component with custom data from a generic back-end service or third party API. As an example we are going to use data from one of the available services on Alfresco Content Services. However, the procedure is much the same if want to use an Alfresco Process Services endpoint or a third party API.
Working with the Nodes API Service	Intermediate	In this tutorial you will learn how to use the NodesApiService into an Angular application, to interact with your instance of Alfresco Content Services without consuming directly the REST endpoints.
Working with the Nodes using the JS API	Intermediate	In this tutorial you will learn how to use the AlfrescoCoreRestApi into a JavaScript application, to interact with your instance of Alfresco Content Services without consuming directly the REST endpoints.
Content metadata component	Advanced	In this tutorial you will learn how to work with the ContentMetadataComponent, used to render the standard and custom metadata of a content (called node) stored into Alfresco Content Services.