2022 April Release

Customization Point FSCVENVUI@1.1001:CPMobileActionMapping Permanent link for this heading

This customization point is used to support mobile task pane menus.
When a menu is implemented by a virtual application, it can not be executed regularly.
This customization point can provide a mapping for an action or a virtual application.
Only simple vApps can be re-implemented using this technique.
The customization point can define a MobileActionMapping which will be evaluated by GetMobileTaskPaneMenus.
A mapping contains two attributes:
  • mamaction: the action the client should perform in place of an action or virtual application.
  • mamparams: optional, parameters or data which may be used by the client when performing the specified action.
The Fabasoft Apps (Fabasoft Cloud, Fabasoft) currently support these actions:
  • OpenObject
    The document of the object may be opened in another app on the device.
    mamparams are not supported for this action.
    There is a default configuration available for ReadObjectContent and ReadSelectedObjects.
  • EditObject
    The document of the object may be opened in edit mode in-place or in another app on the device.
    mamparams are not supported for this action.
    There is a default configuration available for EditObjectContent and EditSelectedObjects.
  • ViewAsPDF
    The PDF content/overview of the object may be opened in another app on the device.
    mamparams are not supported for this action.
    There is a default configuration available for ViewContentAsPDF and ViewContentAsPDFSelectedObjects.
  • CopyLink
    A link to the object is copied to the device's clipboard.
    The mobile apps adapt the action according to the configuration values from IsDelegationActive.
    mamparams are not supported for this action.
    There is a default configuration available for CopyToClipboard and CopySelectedToClipboard.
  • SendLink
    An email containing a link to the object is generated and shown in a send mail view.
    mamparams are not supported for this action.
    There is a default configuration available for SendAsShare, SendObjectAsShare and SendAsPointerDirect.
  • SendLinkDelegated
    An email containing a link with the delegation token to the object is generated and shown in a send mail view.
    mamparams are not supported for this action.
    There is a default configuration available for SendAsToken and SendObjectAsToken.
  • UploadFiles
    A file upload view will be shown.
    mamparams are supported and may contain the following values:
    • sys_object: optional, if not specified the current object will be used for performing the upload.
    • sys_view: optional, if not specified the default view of the current object according to CMIS implementation will be used for performing the upload.
      Only relevant when object for which the upload will be performed is an instance of CompoundObject.
    Depending on the object class of the current object or the specified sys_object either a single file or multiple files can be uploaded.
    The following actions may be available:
    • Browse local files
    • Take photo by camera
    • Take video by camera
    • Paste from clipboard
    • Create textfile
    When the current object or the specified sys_object is an instance of
    • CompoundObject the selected files will be uploaded as new files.
    • ContentObject the selected file will be uploaded as new content for the current object (attribute content).
    There is a default configuration available for ImportObject, ImportObjectReadOnly, OverwriteContent and OverwriteContentSelected.
  • DeleteObject
    The object will be deleted or moved to the wastebasket.
    The mobile apps adapt the action according to the configuration values from GetDeleteAction.
    mamparams are not supported for this action.
    There is a default configuration available for DeleteSelectedObjects, ObjectDeleteReadOnly and ObjectDeleteReadOnlySelected.
The local scope may contain the following values:
  • this.sys_dynkey: the dynkey of the current menu entry.

MobileActionMapping FSCVENVUI@1.1001:CPMobileActionMapping(
  key ObjectClass objclass,
  key ComponentObject actionorapplication,
  out retval MobileActionMapping mapping)

Name

Description

objclass

The object class of the targetobject, see GetTaskPaneMenuStructList.

actionorapplication

Can be an action (to override all mapped virtual applications, e.g.: ReadObjectContent) or the direct application which should be implemented.

mapping

The MobileActionMapping for an action or a virtual application.
The mamaction of the mapping can contain one of the following values:
  • OpenObject: the document of the object may be opened in another app on the device.
  • EditObject: the document of the object may be opened in edit mode in-place or in another app on the device.
  • ViewAsPDF: the PDF content/overview of the object may be opened in another app on the device.
  • CopyLink: a link to the object is copied to the device's clipboard.
  • SendLink: an email containing a link to the object is generated and shown in a send mail view.
  • UploadFiles: a file upload view will be shown.
  • DeleteObject: the object will be deleted or moved to the wastebasket.
The mamparams may contain parameters or data for the client.
Either return some global configurations or access data through transaction variables. @see GetTaskPaneMenuStructList @see GetMobileTaskPaneMenus @see MobileTaskPaneMenu @see MobileActionMapping

Additional Information