Equipment Screen – Add Sub Equipment

PALFINGER

Equipment Screen

Add Additional
Sub Equipment

Add Sub Equipment to Equipment

Feature #252014 · Epic #251995
Alexander Gell · March 2026

Feature Overview & Click Prototype

Link sub-equipment to a carrier after initial registration – either by searching for an existing unlinked device or by registering a brand new one.

PALFINGER

Background & Problem

Why do we need this feature?

🔗

Missing Link

Sub-equipment (e.g. stabiliser extensions) can only be registered at the initial carrier setup. There is currently no way to add sub-equipment afterwards in the Equipment Screen.

🛻

Real-World Requirement

Technicians retrofit vehicles in the field. New sub-equipment gets mounted but is never linked to the carrier in the system – leaving the device list incomplete.

⚙️

SAP Integration Required

All device links live in SAP. New devices must be created and linked there. The Equipment Screen must trigger this process and reflect the result in real time.

Context: Equipment Screen

The Equipment Screen displays all devices linked to a carrier – both main equipment and sub-equipment. Until now, sub-equipment could only be linked during the initial registration wizard.

This new feature adds an "+ Add Equipment" button directly on the Equipment Screen. A technician can either find an already existing (but unlinked) sub-equipment in SAP and link it — or create a completely new device and assign it at the same time.

PALFINGER

Solution – Two Paths

Entry point: "Add Equipment" button on the Equipment Screen

PATH A – Link Existing Sub-Equipment

Device already exists in SAP but is not yet linked

1

Click "Add Equipment" → search dialog opens

2

Enter S/N or Equipment Number (min. 3 characters)

3

Only unlinked sub-equipment type devices are shown

4

Select device → choose parent device (carrier or equipment)

5

Confirm → SAP link created → device appears in list

or

PATH B – Create New Sub-Equipment

Device does not yet exist in SAP (Truck carriers only)

1

In search dialog: click "+ Specific Equipment"

2

Fill in form: S/N, Equipment Type, Manufacturer, Details

3

Select mounting position via truck diagram or dropdown

4

Choose parent device

5

Confirm → SAP create + link → device appears in list

PALFINGER

Path A – Link an Existing Sub-Equipment

User Journey: Search → Select Parent → SAP Link

➕

Add Equipment

Button on Equipment Screen (only active if device is registered and carrier is assigned)

▶

🔍

Search

Enter S/N or Equipment No. – min. 3 characters. Only unlinked sub-equipment types are returned.

▶

☑️

Select Device

Click row arrow (→). Shows: Equipment Type, Manufacturer, Details.

▶

🔗

Select Parent

Choose carrier vehicle or one of the registered devices (e.g. PK 16000L) as the parent.

▶

✅

Done!

SAP link created via event callback. New device appears immediately in the Equipment List.

SAP Integration Details (PBI #252023)

SAP Call

Only a parent-child relationship is created. The device record itself is not modified.

Event Callback

SAP fires an event back to our system. We consume it and refresh the Equipment Screen – no polling.

Error Handling

On SAP error or timeout: user-friendly error message is shown, no partial changes persisted.

Parent Options

Carrier vehicle + all equipment registered under that carrier. Scoped to current carrier context only.

PALFINGER

Path B – Create a New Sub-Equipment

User Journey: Fill Form → Select Parent → SAP Create & Link

🚛

Truck Carrier

"+ Specific Equipment" only enabled when carrier type = Truck

▶

📋

Fill Form

Enter S/N*, Equipment Type*, Manufacturer*, Details*. Interactive truck diagram for type selection.

▶

📍

Mounting Position

Click a marker (red dot) in the SVG diagram → Equipment Type pre-selected (or vice versa).

▶

🔗

Select Parent

Choose carrier or registered device as parent. Form data preserved when navigating back.

▶

✅

Done!

SAP create + link. On partial failure (create ok, link fails): retry linking only – no re-creation needed.

Path B Specifics

Truck Diagram (Interactive SVG)

Click a Marker

Pre-selects Equipment Type in dropdown (e.g. Stabiliser Extension)

Dropdown Selection

Highlights the corresponding marker on the diagram

Types (extendable)

Stabiliser Extension · Shaped-Part Gripper · Container Emptying Device · Stone Stacking Clamp · Earth Drill

Mandatory Fields

All 4 fields (S/N, Type, Manufacturer, Details) required – Send button disabled until valid

▶

SAP Integration (Two Steps)

Step 1 – Create

Create new device record in SAP (S/N, Type, Manufacturer, Details). Material number derived by SAP.

Step 2 – Link

Create parent-child link in SAP

Partial Failure

Create ok but link fails: user informed, retry for link step only (no re-creation of device)

Event Callback

SAP event drives the UI refresh – no polling

PALFINGER

Click Prototype

Interactive Prototype – Add Additional Sub Equipment

🔗 Open Prototype in New Tab

PALFINGER

Next Steps – Open PBIs

Feature #252014 · 6 Product Backlog Items · Total Effort: 27 SP

#252015

3 SP

Filter Sub-Equipment Search to Show Only Unlinked Devices

Search dialog: min. 3 characters, only unlinked sub-equipment type devices shown. Button only active when equipment is fully registered with a carrier.

#252022

3 SP

Select Parent Mount-Point After Choosing an Existing Sub-Equipment

Path A: Parent selection after device pick. Dropdown lists carrier vehicle + all devices registered under that carrier.

#252023

5 SP

SAP Integration – Link Existing Sub-Equipment to Selected Parent

Path A: Create SAP link, consume event callback, update Equipment Screen. Error and timeout handling.

#252024

5 SP

New Sub-Equipment Form with Visual Truck Diagram and Equipment Type Selection

Path B: Form with interactive SVG truck diagram. Bidirectional sync between dropdown and diagram markers.

#252025

3 SP

Select Parent Mount-Point for Newly Created Sub-Equipment

Path B: Parent selection after form submit. Form data preserved on back navigation. Shared component with PBI #252022.

#252026

8 SP

SAP Integration – Create New Sub-Equipment and Link to Selected Parent

Path B: Two sequential SAP calls (Create + Link). Partial failure handling: link retry without re-creating the device. Event callback for UI refresh.