Job Card - Start of Work Feature
Require a start-of-work feature before recording normal features.
Overview
A 'job card' is a name for the start-of-work feature for a location. It is used when a workflow needs one required feature to exist before users can create or edit the rest of the location's features.
The job card feature can capture values that later features read from the cache or use as shared context. Because of that, Soarvo Mobile blocks the normal workflow until the required job card feature exists for the current location.
Three things job card enables
- Start-of-work capture – users are guided to create the job card before adding normal project features.
- Workflow locking – normal feature creation and editing are blocked until the job card requirement is complete.
- Single-entry control – when configured as
single, users can create one job card feature for the location and cannot create a second one from the normal create flow.
How the app finds the job card feature type
Soarvo Mobile treats a feature type as the job card feature type when it has an attribute named JOBCARD_TYPE.
The attribute name is matched case-insensitively, so JOBCARD_TYPE, jobcard_type, and JobCard_Type are equivalent.
The configured value for the attribute must be:
single– one job card feature is required for the location.
The value is trimmed and matched case-insensitively, so Single and single are valid.
Note: Only single is currently supported. If the value is blank, missing, or set to anything else, the app ignores the attribute and job card mode is not enabled for that feature type.
Configure a job card feature type
- Open the project in the Soarvo web portal.
- Create or edit the feature type that should be used as the job card.
- Add an attribute named
JOBCARD_TYPE. - Set the attribute's default value, placeholder, or default text to
single. - Add any fields that users must complete at the start of work.
- Save the feature type and refresh feature types in Soarvo Mobile.
Recommended setup
| Setting | Value |
|---|---|
| Feature type name | JobCard or another clear start-of-work name |
| Attribute name | JOBCARD_TYPE |
| Attribute type | Short text or another text field that supports a default/placeholder value |
| Attribute value | single |
Supported job card types
| Value | Behavior |
|---|---|
single |
Requires exactly one start-of-work job card feature before normal work can continue. After one exists, users cannot create another from the normal create flow. |
Additional job card types can be added in the app in future versions by extending the supported values for JOBCARD_TYPE.
Troubleshooting
| Issue | Check |
|---|---|
| Job card mode does not enable | Confirm the attribute is named JOBCARD_TYPE and its value is single. |
| Normal features are still available before the job card is created | Confirm the app has refreshed feature types and the configured job card feature type belongs to the same project. |
| The job card cannot be created | Check HIDE_FROM_MOBILE tags and group-based form access for the job card feature type. |
| Normal features stay locked after creating the job card | Confirm the job card feature was saved in the current location and synced into the local feature list. |
| Users can create another job card | Confirm the configured JOBCARD_TYPE value is single and the existing job card uses the same feature type. |
What's Next?