Choose output parameters for a model

  • Release version: Zurich
  • Updated March 12, 2026
  • 3 minutes to read

    • Specify output parameters for a read or update operation in Zero Copy Connector for ERP 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.

    Before you begin

    Role required: sn_erp_integration.erp_admin

    About this task

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

    Procedure

    1. Navigate to All > Zero Copy Connector for ERP > Zero Copy Connector for ERP Home.
    2. Open the model page by selecting the models icon in the side panel.
    3. Select the model that you want to add a read operation to.
    4. Select the Manage model button.
    5. Open a model operation.
      If you don't have a model operation, add one to the model. For more information, see Add an operation to a model in Zero Copy Connector for ERP.
    6. Open an entity.
      If you don't have an entity, add one to the operation. For more information, see Add an entity to a model.
    7. Select the Choose outputs tab.
    8. If your instance uses the Zurich Patch 1 release, review the existing outputs to see if you must add any additional parameters.

      If your instance uses the Zurich Patch 4 release, skip to the next step.

      Choose outputs page.

      The Prepopulated outputs section lists any fields that were added to the inputs. The fields are read-only on the output page, but can be edited and removed on the input page.
      Note:
      Prepopulated output applies only to table and OData entities.

      Choose output page with outputs highlighted.

      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 Zero Copy Connector for ERP.
    9. If your instance uses the Zurich Patch 4 release, review the existing outputs to see if you must add any additional parameters.

      Choose outputs page.

      The Required outputs section lists any fields that were added to the inputs. The fields are read-only on the output page, but can be edited and removed on the input page.
      Note:
      Required output applies only to table and OData entities.

      In the Table/Functioncall section, define the parameters the operation uses. The Table section appears for read operations, and the Functioncall section appears for BAPI operations.

      Starting with the Zurich Patch 4 release, Zero Copy Connector for ERP automatically suggests mappings between table fields in source systems and target models. This reduces the amount of manual work to do, while still giving you control to edit the mappings as needed.

      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 Zero Copy Connector for ERP.
    10. Add a new output field or parameter.
      1. Select the add icon (+) next to the last-defined parameter.
        If you're adding a mapped field for a table read operation, make sure to add the field to the applicable table section.
      2. Search for and select the Field name for table reads or Parameter name for BAPI (Business Application Programming Interface) operations.
        The Data type field is automatically updated with the applicable values for your selection.
      3. Enter the corresponding value in the Mapped value field.
      If you're adding a complex, nested parameter, such as an address that includes other parameters (for street, for city, etc.), Zero Copy Connector for ERP automatically identifies that it needs additional related parameters. Zero Copy Connector for ERP 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.

      Table expanded to show outputs with a nested output highlighted.

    11. Optional: Add any nested output fields or parameters to choose what data to include from a complex parameter.
      For example, you may have a full billing address in the object parameters but only need the city and postal code as output.
      1. Specify the parent output field or parameter.
      2. Select the settings icon or add icon + for the parent row.
      3. In the modal that appears, select any additional, related fields or parameters to include.
      The parent automatically updates with the related, nested fields or parameters you selected.
    12. Select Save.

    Result

    When you add mapped fields or parameters as outputs and successfully read or update the ERP system, each parameter appears as a field. You can then add the field to a remote table or an extraction table. Manage the fields for the remote table or extraction table to add the retrieved parameters. For more information, see the following topics: