Acts of accomplished works

The Act of accomplished works section is used to create act forms for tasks.
Acts of accomplished works
A completed act can be:
An act may include task data, fields to be completed, photos, and signatures
This article explains how to create and configure an act. You will learn how to:
 

Creating an act

1. Open the Templates tab
2. Select the required template
3. Open the Act of accomplished works section
Acts of accomplished works
4. Add a new act
Acts of accomplished works
5. Enter the act name
6. Select a creation method
  • create the act in the HTML editor
Acts of accomplished works
  • or upload an existing Excel file
Acts of accomplished works
7. Add the required fields to the act
8. Check the result in the Preview tab
9. Click Save
To use the act by default for the selected template, select Is default
All created acts are stored in the Act of accomplished works section of the corresponding template.
 

Parameters for act

The Parameters for act panel is located on the right side of the act settings. Its fields are divided into three groups:
  • Bases — data that PTM receives from the task
  • Executor — information that the driver enters in the act in the mobile application. Executor fields should be displayed after the base data in the act text
  • Template — fields specific to the selected template

Base fields

The Bases tab contains standard data, such as:
  • task number
  • completion date
  • executor
  • driver
  • begin and end time
  • service vehicle
  • service vehicle number
  • other materials
  • driver phone
  • template
  • task
  • duration
  • mileage
  • return to base
  • last route address
  • accept time
These values are inserted into the act automatically.

Executor fields

The Executor tab contains fields that the user fills in manually. For example:
  • text field
  • number
  • checkbox
  • list
  • multi-line field
  • date and time
  • time period
  • location
  • signature
These fields are used to create the act form in the mobile application.

Creating an executor field

To add a field, open the Executor tab and click the Add button .
In the Parameter information form, specify:
  • Field position — where the field is displayed: in the header, center, or footer
  • Type — field or fieldset
  • Group name — the group containing the field
  • Field — the type of input value
  • Name — the field label displayed to the user
  • Key — the unique field name written in Latin characters
  • Function — the function used to fill in the value automatically
  • Description — an explanation of the field
Field types
PTM supports, for example:
  • number — number
  • text — short text
  • checkbox — checkbox
  • combobox — selection from a list
  • textarea — multi-line text
  • signature — signature. Use this type when the act must be signed by the driver, client, or another participant
  • datetime — date and time
  • timeperiod — time period
  • combocount — quantity selection
  • location — location
Add a separate field for each required signature. The number of these fields determines how many signatures will be included in the act form.
Select the required type in the Field field and complete the remaining parameters.
Field settings
You can configure additional settings for each field:
  • Field is allow blank — the user can save the act without completing the field
  • Field is active — the field is available for use in the act
  • Enable add photos — allows photos to be added
  • Required photo — makes a photo mandatory
  • Maximum photo number — specifies the maximum number of photos
If photo upload is enabled, the user can attach photos to this field in the mobile application.
If Required photo is enabled, the field cannot be completed without a photo.
After configuring the field, click Save.
The field will appear on the Executor tab.
To edit the field settings, select the field and click Edit .
To delete the field, select it and click Remove .
In the mobile application, users see only the act fields that:
  • were created on the Executor tab
  • are marked as active
  • were added to the act
The user fills in these fields, adds photos, and signs the act if necessary. After completion, the data is saved in the act and displayed in PTM.
 

Creating an act in the HTML editor

The HTML editor allows you to build an act from text and task fields. You can configure the document structure, specify which data is displayed and in what order, and define the appearance of the completed act.
In the editor, you can:
  • add text and headings
  • select fonts and formatting
  • create tables and lists
  • insert images
  • add task fields and executor fields
  • place fields in the required locations in the document
In other words, you create the completed act form in the editor by adding labels and inserting fields whose values PTM will fill in automatically.
Acts of accomplished works
To add a field to the act form:
1. Create and save the field
2. Open the act
3. Place the cursor in the required location in the HTML editor
4. Find the field in the Parameters for act panel
5. Double-click the field or drag it to the editor with the right mouse button
6. Make sure that the field key appears in the act text
7. Save the act
When generating the act, PTM replaces the keys with actual data or values.
Open the Preview tab to check how the completed act will look.
 

Creating an act from an Excel file

Use an Excel template when the act must preserve complex formatting, tables, formulas, or an existing document structure.
In this case, PTM inserts task data into the specified Excel cells.

Uploading an Excel template

1. Upload the prepared Excel file in the File field
Acts of accomplished works
2. Open the File configuration tab
3. Create links between Excel cells and PTM parameters
In the File configuration table, specify:
  • Cell link — the Excel cell address
  • Parameter key — the PTM value key
  • Render function — the method used to process the value
For example:
  Cell link
 Parameter key
 Render function
  SH0:A1
  end_time
  parseDate
In this example, the task end time is written to cell A1 of the first Excel sheet. The parseDate function converts the date and time into a readable format.
If no additional processing is required, leave none in the Render function field.
4. Save the configuration
5. Open the Preview tab to check the result
6. Save the act

Adding a Cell link

1. Click the button for adding a row
2. Enter the sheet and cell in the Cell link field
3. Enter the parameter key
4. Select a processing function if necessary
5. Save the configuration by clicking Update
These links tell PTM which data must be inserted into which cells. For example, you can place the task number in one cell, the date in another, and driver information in a third cell.
If no key is specified, PTM displays an error and does not save the configuration row