alfresco-ng2-components/docs/process-services/components/task-attachment-list.component.md

Title, Added, Status, Last reviewed

Title	Added	Status	Last reviewed
Task Attachment List Component	v2.0.0	Active	2019-01-14

Task Attachment List Component

Displays documents attached to a specified task.

Contents

• Basic Usage
  • Transclusions
• Class members
  • Properties
  • Events
• Details
  • How to Add Drag and Drop Functionality
• See also

Basic Usage

<adf-task-attachment-list 
    [taskId]="YOUR_TASK_ID" 
    (attachmentClick)="YOUR_HANDLER">
</adf-task-attachment-list>

Transclusions

Any content inside the <adf-task-attachment-list> element will be displayed when the list is empty:

<adf-task-attachment-list ...>
    <div><!-- Custom empty list message goes here --></div>
</adf-task-attachment-list>

A default "no content" template is displayed if you don't supply one to override it:

Class members

Properties

Name	Type	Default value	Description
disabled	boolean	false	Disable/Enable read only mode for attachment list.
taskId	string		(required) The ID of the task to display.

Events

Name	Type	Description
attachmentClick	EventEmitter<any>	Emitted when the attachment is double-clicked or a view option is selected from the context menu by the user from within the component. Returns a Blob representing the clicked object.
error	EventEmitter<any>	Emitted when an error occurs while fetching the attachments.
success	EventEmitter<any>	Emitted when the attachment list has fetched all the attachments. Returns a list of attachments.

Details

How to Add Drag and Drop Functionality

You can wrap the component with an Upload Drag Area component to enable the user to upload attachments for empty lists. When you do this, you can also pass a custom no content template as shown below. The component invites the user to drag files to upload whenever the list is empty.

<adf-upload-drag-area
    [rootFolderId]="YOUR_TASK_ID"
    [showNotificationBar]="BOOLEAN">
    <adf-task-attachment-list  
        [taskId]="YOUR_TASK_ID"
        (attachmentClick)="YOUR_HANDLER">
        <adf-empty-list>
            <div adf-empty-list-header>{{This List is empty}}</div>
            <div adf-empty-list-body>{{Drag and drop to upload}}</div>
            <div adf-empty-list-footer>
                <img [src]="Your custom image URL"></div> 
        </adf-empty-list>
    </adf-task-attachment-list>
</adf-upload-drag-area>

import { UploadService } from '@alfresco/adf-core';
import { TaskUploadService } from '@alfresco/adf-process-services';

Make sure you override the UploadService with the TaskUploadService

@Component({
    selector: 'my-custom-task-attachment',
    providers: [
        { provide: UploadService, useClass: TaskUploadService }
    ]
})
export class MyCustomTaskAttachmentComponent {
    constructor() {}
}

See also

• Upload Drag Area Component