--- title: "Define an IQA configuration" slug: "define-an-iqa-configuration" description: "Follow these instructions to define one or more IQA Configurations that are used to configure an API call between Deal Manager and the Zilliant database." updated: 2024-08-28T17:35:42Z published: 2024-08-28T17:35:42Z canonical: "docs.zilliant.com/define-an-iqa-configuration" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.zilliant.com/llms.txt > Use this file to discover all available pages before exploring further. # Define an IQA Configuration ## To define an IQA configuration Use the **IQ Anywhere Configurations** tab to define one or more **IQA Configurations** that are used to configure an API call between Deal Manager and the Zilliant database. ### Add an IQA configuration record 1. In the Zilliant Administration application for Deal Manager, select the **IQ Anywhere Configuration** tab, and then select **New** to create a record. 2. Enter information or make selections: - **Configuration**—Enter a name for the **IQA Configuration**. - **Enable Logging**—Select to log the API request and its response to the browser console. See the [Troubleshooting IQA Configuration](/v1/docs/troubleshoot-iqa-configuration) section for more information. - **Error Field Name**—If you enter a value, the IQA calls that generate an error message will enter the error code in this field. The Deal Manager [Line objects](/v1/docs/deal-manager-objects-and-fields) have a field for this purpose: **zpl__Error__c**. - **Request Timeout**—Controls the timeout duration. Leave the default value unless the technical troubleshooting indicates otherwise. - **Source Object**—(Optional.) If set to the header-level Deal Manager [object](/v1/docs/deal-manager-objects-and-fields), it will designate this specific **IQA Configuration** as the default one to use when a line of that object is added. Tip We recommend leaving this field blank and instead using the **Add Lines IQA** option on the **Product Selector Configuration** to indicate which **IQA Configuration** to use for adding new lines to that object. In the configuration, define two related lists: - **IQA Formula Field Mapping**—Defines which formula's value(s) need to be returned, and which line field(s) will receive those formula values. - **IQA Input Parameter Mapping**—Defines parameters that are needed by the formulas in the **IQA Formula Field Mappings**. ### Create IQA Input Parameter Mapping record Create records for all parameters that are needed by the formulas that you will add to the [IQA Formula Field Mappings](/v1/docs/define-an-iqa-configuration#add-iqa-formula-field-mappings). 1. In the IQA **Input Parameter Mapping** related list for the added **IQA Configuration** record, select **New**. 2. Create a parameter record for all parameters needed for the formulas that you will add to the IQA **Formula Field Mappings**. 3. For each **Parameter** record, enter information or make selections: - **Input Parameter**—Enter the same value that you defined in the formula or **Remote Data Definition** that will use this value. - **Is Disabled**—If selected, this parameter is not sent in the API call. See the [Troubleshooting IQA Configuration](/v1/docs/troubleshoot-iqa-configuration) section for more information. - **Literal Data Type**—If using a **Literal Value**, select the correct data type for this parameter. - **Literal Value**—If entered, this value will be sent for this parameter with the API instead of the value of a mapped line field. See the [Troubleshooting IQA Configuration](/v1/docs/troubleshoot-iqa-configuration) section for more information. - **Parameter Field**—Enter the API name for the field on the line object whose value will be assigned to the parameter when the API is called. The field must have a data type corresponding to the parameter in the formulas and **Remote Data Definitions** in the Zilliant backend. - **Required for Call**—If selected, the API will not be called if the field mapped to this parameter is null. Tip This feature supports a use case where this IQA call only makes sense if the user has entered a specific set of fields. For example, the user has entered five fields. So, if all five fields do not have values, then do not call IQA. ### Add IQA Formula Field Mappings Add a formula field mapping to define which formula's value(s) need to be returned, and which line field(s) will receive those formula values. 1. In the IQA **Input Parameter Mapping** related list for the added **IQA Configuration** record, create a parameter record for all parameters needed for the formulas that you will add to the IQA **Formula Field Mappings**. 2. For each **Formula Field Mapping** record, enter information or make selections: - **Formula**—Enter the **Formula ID** of the Zilliant formula that needs to be returned. - **Field Name**—Enter the API name for the field on the line object that will be given the returned value for the formula. The returned value and mapped field must have the same data type. - **Is Disabled**—If selected, this formula is not calculated nor returned by the API call. See the [Troubleshooting IQA Configuration](/v1/docs/troubleshoot-iqa-configuration) section for more information. Note When a Salesforce organization has multiple currencies feature activated, it adds the **Currency** field to each Sobject record even if it does not apply to that field.