alfresco-ng2-components/docs/content-services/upload-version-button.component.md

Added, Status, Last reviewed

Added	Status	Last reviewed
v2.3.0	Experimental	2018-03-23

Upload Version Button Component (Workaround)

Activates a file version upload.

Until further backend API improvements are implemented, this component is meant to be used to enrich the features and decrease the restrictions currently applied to node version uploading.

Basic usage

<adf-upload-version-button
    staticTitle="Upload new version"
    [node]="node"
    [rootFolderId]="node.parentId"
    [versioning]="true"
    (success)="onUploadSuccess($event)"
    (error)="onUploadError($event)">
</adf-upload-version-button>

This component extends the Upload Button component. The properties and events are the same except for the node property that specifies the node to be versioned (this is a required input parameter). However, some properties don't make sense when applied to the Upload Version Button component, so they are simply ignored.

Class members

Properties

Name	Type	Default value	Description
acceptedFilesType	string	"*"	Filter for accepted file types.
comment	string		When you overwrite existing content, you can use the comment field to add a version comment that appears in the version history
disabled	boolean	false	Toggles component disabled state (if there is no node permission checking).
majorVersion	boolean	false	majorVersion boolean field to true to indicate a major version should be created.
maxFilesSize	number		Sets a limit on the maximum size (in bytes) of a file to be uploaded. Has no effect if undefined.
multipleFiles	boolean	false	Allows/disallows multiple files
node	MinimalNodeEntryEntity		(Required) The node to be versioned.
nodeType	string	"cm:content"	Custom node type for uploaded file
rootFolderId	string	"-root-"	The ID of the root. Use the nodeId for Content Services or the taskId/processId for Process Services.
staticTitle	string		Defines the text of the upload button.
tooltip	string	null	Custom tooltip text.
uploadFolders	boolean	false	Allows/disallows upload folders (only for Chrome).
versioning	boolean	false	Toggles versioning.

Events

Name	Type	Description
createFolder	EventEmitter<Object>	Emitted when a folder is created.
error	EventEmitter<Object>	Emitted when an error occurs.
permissionEvent	EventEmitter<PermissionModel>	Emitted when create permission is missing.
success	EventEmitter<Object>	Emitted when the file is uploaded successfully.

Details

Restrictions

Currently, the API only allows new version uploads for a node where the name (and most importantly the extension) of the new version is exactly the same as the old version. As a result, this workaround component uploads the chosen file with the same name that the original file had. This is the reason why the node is a mandatory dependency for this component.

So, to sum up, this component:

• Can upload a new version from the same file extension regardless of the file name.
• Cannot upload a new version that has a different file extension, to the file that was originally uploaded (an error message will be emitted by the error EventEmitter of the component.

See also

• Upload Button component