Overview
The ProcessMaker Mobile app has a Video control that records live video footage. This control can also upload a video file from the gallery and record a new video, both of which can be stored in the mobile application.
Video Properties
The properties of the Video control can be found under the Mobile Controls tab. To use it simply drag and drop the control into the form. Click on the blank space of the control field in the Dynaform to display its properties, which are shown in the image below.
The Type property is displayed first, and it only shows the name of the field, in this case "videoMobile". The ID and Name properties are filled in by default and don't need to be changed unless programming code is going to be used. Next, the Label property allows the user to change the label of the control field displayed on the Dynaform. In this case the label was changed to "Video".
It is possible to associate an input document with a video control through the Input Document property.
This means that the video recorded or uploaded can be displayed at a later point in an input document. One advantage of associating a video file with an input document is that the input document interface can be used to view all the videos uploaded in the case, as well as delete files and add new versions if the user has the correct Process Permissions and versioning is enabled.
Note that the file size, extension and other properties configured in the input document won't apply to the video file recorded or uploaded to the video control.
There are two more properties to configure. The Hint property has a small blank box where a description can be written to guide the user, usually a description of what the field does. The last property of the Video control is Required, which is a checkbox that can be clicked if the field is going to be necessary for the process to continue. Remember, when Required is checked, the form won't go to the next task unless the field is filled in.
The application uses webkit tools exclusively for Android and iOS to display the form fields, thus forms are not rendered the same way as in the web edition (in the preview of the designer or when running cases). The screenshot below shows the Video control running on the mobile app.
Now see what the Video control looks like when opening a case in the web edition after using the mobile application.
Note: The ProcessMaker Mobile application is always being tested, therefore, the Video control crashes sometimes and the user has to enter the app and fill in the fields again. The Video control will be improved in future versions of ProcessMaker Mobile.
Finally, the table below shows the property specifications mentioned before.
| Property | Description |
|---|---|
| Type | videoMobile (read only) |
| ID | [Required] HTML unique identifier. |
| Name | HTML unique identifier, set by default. |
| Label | The label of the control displayed on the Dynaform, can be changed. |
| Input Document | Used to link an Input Document to the control. |
| Hint | Used to show a help message when the field is rendered. It is shown when the pointer of the mouse is hovered over the ? icon. |
| Required | By checking this option, a red asterisk is added next to the label to indicate that the field is required. It means that an option must be selected in the control field or the end user will not be able to submit the Dynaform and continue the process. |
Known Issues
The Video Attachment control has some issues on certain devices. Please read the following known issues before using this control:
- In Sony Xperia XA with Android 6.1.1 devices, the video control has some issues when trying to play the video attached.
