Configure App Action Sub-Mappings
NIM Apps · Structured input
Pass structured data from an App to a target-system function by configuring a JSON value source.
Some target-system functions accept a structured value within an input attribute. In mappings, NIM can use a sub-mapping for this. In an App action, provide the structure directly as JSON instead. For example, a Google phones input can accept a phone number and its type together.
Add a target-system action
- Add an action to a Button or Grid event in your App.
- Select Target system function execution for Action type.
- Select the target system and the function that accepts the structured input.
The available input attributes are defined by the selected system function. Use this pattern only for an attribute that expects a structured JSON value.
Set the input value source
- Find the input attribute that accepts the structured value, such as
phones. - Change its Value source from none to json.
- Click in the Constant value / Variable / JSON column to open the JSON editor.
- Enter valid JSON that matches the format required by the target system.
For a phone number, the structure can include both the value and its type:
{
"value": "string_value",
"type": "string_type"
}
Insert a dynamic App value
Use the green arrow beside an available App variable to insert it into the JSON editor. This lets the App pass a value entered or selected by the user.
{
"value": "{vPhoneNumber}",
"type": "work"
}
Save the JSON editor. NIM displays the JSON value in the action input row.
Confirm the action
- Verify that the correct attribute shows json as its value source.
- Confirm that variable names and literal values match the target system's required schema.
- Save the App action.
- Run the App with a representative value and verify the target-system result before publishing the action for general use.
Start with the minimum fields required by the target system. Add optional fields only after confirming the base request works, and use the target system's connector documentation to verify supported field names and values.