mirror of
https://github.com/Alfresco/alfresco-ng2-components.git
synced 2025-07-24 17:32:15 +00:00
* ADF-1453: Restructured Activiti Analytics readme * ADF-1453: Restructured Activiti Diagrams readme * ADF-1453: Restructured Activiti Form readme * ADF-1453: Restructured Activiti Process List readme * ADF-1453: Restructured Activiti Task List readme * ADF-1453: Restructured Alfresco Core readme * [ADF-1453] Restructured DataTable readme * [ADF-1453] Restructured Document List readme * [ADF-1453] Restructured Login readme * [ADF-1453] Restructured Alfresco Search readme * [ADF-1453] Restructured Alfresco Social readme * [ADF-1453] Restructured Alfresco Tag readme * [ADF-1453] Restructured Alfresco User Info readme * [ADF-1453] Restructured Alfresco Viewer readme * [ADF-1453] Restructured Alfresco Webscript readme * [ADF-1453] Fixed table display glitch * [ADF-1453] Fixed Markdown lint errors in readme files * [ADF-1453] Adding missing fileUploadDelete event to table in Upload readme * [ADF-1453] Resolved merge conflict with Upload readme * [ADF-1453] Changes from npm run doc
179 lines
4.6 KiB
Markdown
179 lines
4.6 KiB
Markdown
# Activiti Analytics library
|
|
|
|
Contains the Activiti Analytics component and other related components.
|
|
|
|
<!-- markdown-toc start - Don't edit this section. npm run toc to generate it-->
|
|
|
|
<!-- toc -->
|
|
|
|
- [Activiti Analytics Component](#activiti-analytics-component)
|
|
* [Basic Usage](#basic-usage)
|
|
+ [Properties](#properties)
|
|
+ [Events](#events)
|
|
- [Activiti Analytics List Component](#activiti-analytics-list-component)
|
|
* [Basic Usage](#basic-usage-1)
|
|
+ [Properties](#properties-1)
|
|
+ [Events](#events-1)
|
|
- [Analytics Generator Component](#analytics-generator-component)
|
|
* [Basic Usage](#basic-usage-2)
|
|
+ [Properties](#properties-2)
|
|
+ [Events](#events-2)
|
|
- [Project Information](#project-information)
|
|
* [Prerequisites](#prerequisites)
|
|
* [Install](#install)
|
|
* [Build from sources](#build-from-sources)
|
|
* [NPM scripts](#npm-scripts)
|
|
* [Demo](#demo)
|
|
* [License](#license)
|
|
|
|
<!-- tocstop -->
|
|
|
|
<!-- markdown-toc end -->
|
|
|
|
## Activiti Analytics Component
|
|
|
|
The component shows the charts related to the reportId passed as input
|
|
|
|
### Basic Usage
|
|
|
|
```html
|
|
<adf-analytics
|
|
[appId]="1001"
|
|
[reportId]="2006">
|
|
</adf-analytics>
|
|
```
|
|
|
|
#### Properties
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| appId | string | The application id |
|
|
| reportId | string | The report id |
|
|
| hideParameters | boolean | Toggle the analytics parameters |
|
|
|
|
You can also hide chart parameters UI by setting the `hideParameters` to `true`:
|
|
|
|
```html
|
|
<adf-analytics
|
|
[appId]="appId"
|
|
[reportId]="reportId"
|
|
[hideParameters]="true">
|
|
</adf-analytics>
|
|
```
|
|
|
|

|
|
|
|
#### Events
|
|
|
|
| Name | Description |
|
|
| --- | --- |
|
|
| onSuccess | The event is emitted when the report parameters are loaded |
|
|
| onError | The event is emitted when an error occurs during the loading |
|
|
| reportSaved | The event is emitted when a report is saved |
|
|
| reportDeleted | The event is emitted when a report is deleted |
|
|
|
|
## Activiti Analytics List Component
|
|
|
|
The component shows the list of all the available reports
|
|
|
|
### Basic Usage
|
|
|
|
```html
|
|
<analytics-report-list
|
|
[layoutType]="'LIST'">
|
|
</analytics-report-list>
|
|
```
|
|
|
|
#### Properties
|
|
|
|
| Name | Type | Required | Default | Description |
|
|
| --- | --- | --- | --- | --- |
|
|
| appId | string | optional | | The application id |
|
|
| layoutType | string | required | | Define the layout of the apps. There are two possible values: GRID or LIST. LIST is the default value|
|
|
| selectFirst | boolean | optional | false | Change the value to true if you want to select the first item in the list as default|
|
|
|
|
#### Events
|
|
|
|
| Name | Description |
|
|
| --- | --- |
|
|
| onSuccess | The event is emitted when the report list is loaded |
|
|
| onError | The event is emitted when an error occurs during the loading |
|
|
| reportClick | The event is emitted when the report in the list is selected |
|
|
|
|
## Analytics Generator Component
|
|
|
|
The component generates and shows the charts
|
|
|
|
### Basic Usage
|
|
|
|
```html
|
|
<adf-analytics-generator
|
|
[reportId]="reportId"
|
|
[reportParamQuery]="reportParamQuery">
|
|
</adf-analytics>
|
|
```
|
|
|
|
#### Properties
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | -- |
|
|
| reportId | string | The report id |
|
|
| reportParamQuery | ReportQuery | The object contains all the parameters that the report needs |
|
|
|
|
#### Events
|
|
|
|
| Name | Description |
|
|
| --- | --- |
|
|
| onSuccess | Raised when the charts are loaded |
|
|
| onError | Raised when an error occurs during the loading |
|
|
|
|
## Project Information
|
|
|
|
### Prerequisites
|
|
|
|
Before you start using this development framework, make sure you have installed all required software and done all the
|
|
necessary configurations, see this [page](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md).
|
|
|
|
> If you plan to use this component with projects generated by Angular CLI, you can read more in [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI)
|
|
|
|
### Install
|
|
|
|
```sh
|
|
npm install ng2-activiti-analytics
|
|
```
|
|
|
|
### Build from sources
|
|
|
|
You can build the component from sources with the following commands:
|
|
|
|
```sh
|
|
npm install
|
|
npm run build
|
|
```
|
|
|
|
> The `build` task rebuilds all the code, runs tslint, license checks
|
|
> and other quality check tools before performing unit testing.
|
|
|
|
### NPM scripts
|
|
|
|
| Command | Description |
|
|
| --- | --- |
|
|
| npm run build | Build component |
|
|
| npm run test | Run unit tests in the console |
|
|
| npm run test-browser | Run unit tests in the browser
|
|
| npm run coverage | Run unit tests and display code coverage report |
|
|
|
|
### Demo
|
|
|
|
Please check the demo folder for a demo project
|
|
|
|
```sh
|
|
cd demo
|
|
npm install
|
|
npm start
|
|
```
|
|
|
|
### License
|
|
|
|
[Apache Version 2.0](https://github.com/Alfresco/alfresco-ng2-components/blob/master/LICENSE)
|