---
sourceDocument: Yokohama Build or modify applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/application-development

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# Manage input parameters for an ERP Canvas model operation

# Manage input parameters for an ERP Canvas model operation {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read

Specify how fields on the ERP (Enterprise Resource Planning) system map to input parameters and their values to define the inputs for an operation that reads or updates the system of record from ERP Canvas.

## Before you begin

Role required: sn_erp_integration.erp_admin, sn_erp_integration.erp_user

## About this task

If you're already in the process of managing a model and ready to specify inputs, you can skip to step 5.

## Procedure

1. Navigate to AllERP CanvasERP Canvas Home.
2. Open the ERP model page by selecting the ERP model icon (![ERP model icon]()) in the side panel.
3. Select the model with the operation that you want to add inputs to.
4. Select the Manage model button.
5. Open a model operation.  
   If you do not have a model operation, add one to the model. For more information, see [Add an operation to a model in ERP Canvas](https://servicenow-prod.fluidtopics.net/saZrY7JVkAiS~AmNV8z3rw "Add an operation to an ERP (Enterprise Resource Planning) model in ERP Canvas to define how it retrieves data from or writes data to the ERP system, or creates a new instance of the business object.").
6. Open an entity.  
   If you do not have an entity, add one to the operation. For more information, see [Add a read, update, or create entity to a model in ERP Canvas](https://servicenow-prod.fluidtopics.net/D95uvrIJ22NNM_wEBVYGew "Specify the operation entity, which is the table or BAPI (Business Application Programming Interface) that ERP Canvas uses for read, update, or create operations.")
7. Select Specify inputs.  
   The required parameters for the operation appear in both of the following places:
   * The Operation parameters section, where you define any default values to use if the operation fails.
   * The Tables/Function call section, where you define the parameters the operation uses. The Table section appears for read operations, and the Function call section appears for BAPI (Business Application Programming Interface) operations.  
     Note:  
     Mapped value names in inputs and outputs are generated automatically, but you can edit the names manually. For more information, see [Edit input and output mapped value name in ERP Canvas](https://servicenow-prod.fluidtopics.net/f8xszOo0F8x1HCNdkJ3qHQ "Manually edit mapped value field names for input and output when managing models.").

   {#erpc-manage-model-inputs__ul_jrh_k4w_2bc}

8. Define whether the operation inputs are required in the Query validation rule field.
   * All inputs are mandatory
   * At least one input is mandatory
   * No inputs are mandatory
   {#erpc-manage-model-inputs__choices_vkn_xq3_1bc}
9. Review the required and optional parameters that are already defined for the operation to understand what you must add.
10. Define a new input parameter to be sent when querying the ERP system.  
    For table read operations, a Tables section appears in the mapped table fields section for each defined table entity. Make sure that you're adding the parameter for the correct table.  
    Note:  
    It doesn't matter what order you define parameters in. ERP Canvas displays optional parameters in alphabetical order when you save.
    1. Select + New input below the last-defined parameter in the table.  
       Note:  
       When you add an input field, the field is automatically added as a field in the output. The field is listed and is read only in the Prepopulated outputs section on the output page.
    2. Fill in the fields to define the parameter.  
       {#erpc-manage-model-inputs__table_jp5_t43_1bc__entry__2}

       | Field | Description |
       |-|-|
       | Field name | Name of the field from the ERP system that you're defining as a parameter. ERP Canvas automatically retrieves fields from the table defined in the operation entity. |
       | Data type | (Read-only) Automatically populated value that specifies the type of data the parameter contains. |
       | Type | Definition of how the parameter is sent. * Input parameters have their Mapped value automatically populated. * Constant defines a parameter whose value never changes, for example, to use as filter criteria. You must specify the value in the parameter's Mapped value field. * Join (Table read operations only) indicates that you're creating a table join. For more information, see [Add joins between ERP tables](https://servicenow-prod.fluidtopics.net/me_GHTwh2hAXP29LafJT7A "Link multiple ERP (Enterprise Resource Planning) tables from the system of record to build an ERP model in ERP Canvas using table joins."). {#erpc-manage-model-inputs__ul_nnc_rp3_1bc} |
       | Mapped value | Specific value of the parameter. * For Input parameters, accept the system-generated name or edit the name. For more information about editing mapped values, see [Edit input and output mapped value name in ERP Canvas](https://servicenow-prod.fluidtopics.net/f8xszOo0F8x1HCNdkJ3qHQ "Manually edit mapped value field names for input and output when managing models."). * For Constant parameters, enter a set value that's always sent for the parameter. * For Join parameters, select the field to join the parameter with. For details on creating joins, see [Add joins between ERP tables](https://servicenow-prod.fluidtopics.net/me_GHTwh2hAXP29LafJT7A "Link multiple ERP (Enterprise Resource Planning) tables from the system of record to build an ERP model in ERP Canvas using table joins."). {#erpc-manage-model-inputs__ul_ald_y3p_1bc} |
       [Table 1. Fields to define an input parameter]

       {#erpc-manage-model-inputs__table_jp5_t43_1bc}

    {#erpc-manage-model-inputs__substeps_wmm_ym3_1bc}  
    If you're adding a complex, nested parameter, such as an address that includes several other parameters (one for street, one for city, one for country), ERP Canvas automatically identifies that it needs additional related parameters and creates new, nested parameter rows that you must then populate with the related values. You can nest only parameters with Object or Array as the Data type.
11. **Optional:** Specify a Default value to be used for the parameter in the newly added Optional parameter row in the Output parameters section.  
    The Default value is used when the input parameter isn't specified in the query.
12. **Optional:** Remove any optional parameters that you don't need when querying the ERP system by selecting the remove (-) icon.  
    You can't remove any Required parameters.
13. Make any additional edits to existing parameters.  
    The following example shows inputs and nested inputs for a BAPI.

14. Select Save.

## What to do next

Next, check the output parameters for the operation and update as needed. For more information, see [Choose output parameters for an ERP model](https://servicenow-prod.fluidtopics.net/OX_LJNB6x0Te4D7FgWIe_g "Specify output parameters for an ERP (Enterprise Resource Planning) system read or update operation in ERP Canvas to define how fields and parameters are mapped from the ERP system to the ServiceNow AI Platform. Output parameters also define how returned data is stored on the ServiceNow AI Platform.").

*[\>]: and then