alfresco-ng2-components/docs/content-services/document-list.service.md

Added, Status, Last reviewed

Added	Status	Last reviewed
v2.0.0	Active	2018-04-16

Document List service

Implements node operations used by the Document List component.

Class members

Methods

• copyNode(nodeId: string = null, targetParentId: string = null): Observable<any>
  Copy a node to destination node

  • nodeId: string = null - The id of the node to be copied
  • targetParentId: string = null - The id of the folder where the node will be copied
  • Returns Observable<any> - NodeEntry for the copied node

• createFolder(name: string = null, parentId: string = null): Observable<MinimalNodeEntity>
  Creates a new folder in the path.

  • name: string = null - Folder name
  • parentId: string = null - Parent folder ID
  • Returns Observable<MinimalNodeEntity> - Details of the created folder node

• deleteNode(nodeId: string = null): Observable<any>
  Deletes a node.

  • nodeId: string = null - ID of the node to delete
  • Returns Observable<any> - Empty response when the operation is complete

• getDefaultMimeTypeIcon(): string
  Gets a default icon for MIME types with no specific icon.

  • Returns string - Path to the icon file

• getDocumentThumbnailUrl(node: MinimalNodeEntity = null): string
  Get thumbnail URL for the given document node.

  • node: MinimalNodeEntity = null - Node to get URL for.
  • Returns string - Thumbnail URL string

• getFolder(folder: string = null, opts?: any = null, includeFields: string[] = []): Observable<NodePaging>
  Gets the folder node with the specified relative name path below the root node.

  • folder: string = null - Path to folder.
  • opts?: any = null - (Optional) Options.
  • includeFields: string[] = [] - Extra information to include (available options are "aspectNames", "isLink" and "association")
  • Returns Observable<NodePaging> - Details of the folder

• getFolderNode(nodeId: string = null, includeFields: string[] = []): Observable<MinimalNodeEntryEntity>
  

  • nodeId: string = null - ID of the folder node
  • includeFields: string[] = [] - Extra information to include (available options are "aspectNames", "isLink" and "association")
  • Returns Observable<MinimalNodeEntryEntity> - Details of the folder

• getMimeTypeIcon(mimeType: string = null): string
  Gets the icon that represents a MIME type.

  • mimeType: string = null - MIME type to get the icon for
  • Returns string - Path to the icon file

• getNode(nodeId: string = null, includeFields: string[] = []): Observable<NodeEntry>
  Gets a node via its node ID.

  • nodeId: string = null - ID of the target node
  • includeFields: string[] = [] - Extra information to include (available options are "aspectNames", "isLink" and "association")
  • Returns Observable<NodeEntry> - Details of the folder

• hasPermission(node: any = null, permission: PermissionsEnum | string = null): boolean
  

  • node: any = null - Target node
  • permission: PermissionsEnum | string = null - Permission level to query
  • Returns boolean - True if the node has the permission, false otherwise

• moveNode(nodeId: string = null, targetParentId: string = null): Observable<any>
  Moves a node to destination node.

  • nodeId: string = null - The id of the node to be moved
  • targetParentId: string = null - The id of the folder where the node will be moved
  • Returns Observable<any> - NodeEntry for the moved node

Details

This service makes extensive use of the Alfresco JS API. In particular, see the Nodes API for further details of the types, options and the underlying REST architecture.

Also, the Document Library model in the ADF docs has more information about related classes.

Moving, copying and deleting nodes

Both moveNode and copyNode create a copy of the existing node under a new parent, but moveNode also deletes the original. The new node has the same name as the original and if it is a folder then all its contents will be copied in-place.

Use deleteNode to move a node from its original location into the trash (from where it can be restored if necessary). If the deleted node is a folder then its child items will also be moved to the trash.

Folder operations

Use getFolderNode to get a folder node by its node ID and getFolder to access the folder via its pathname from the root folder. Also, getFolder allows you to specify extra options in the opts parameter; see the getNodeChildren method in the Alfresco JS API for more information about the available options.

Use createFolder to add a new folder in a given parent folder node. You can specify the well-known names "-my-" , "-shared-" and "-root-" as shortcuts for the parentId.

Permissions

The hasPermission method reports whether or not the user has the specified permission for the node. The Permissions enum contains the values DELETE, UPDATE, CREATE, UPDATEPERMISSIONS, NOT_DELETE, NOT_UPDATE, NOT_CREATE and NOT_UPDATEPERMISSIONS but you can also supply these values via their string equivalents.

See also

• Document list component