Business Details
This feature enables buyers to customize the contract ID prefix in SAP Ariba Contracts by replacing the default value (CW) with their preferred value.
Buyers can create a site-level configuration to automatically generate a custom prefix value and assign it to the contract ID when creating contract workspaces in SAP Ariba Contracts.
Implementation Details
General Prerequisites
To create a site-level configuration to automatically generate a custom prefix value for the contract ID, you must be a member of the Customer Administrator group.
Note
Configuration
Use this procedure to create a configuration to derive the custom contract ID prefix for contract workspaces.
Prerequisites
You must be a member of the Advanced Configuration Access group.
Note
Context
The process to automatically derive a custom contract ID prefix for replacing the default contract ID prefix (CW) involves two steps:
- Create a custom field with the configuration to evaluate the custom contract ID prefix.
- Assign the field to a self-service parameter in the Intelligent Configuration Manager workspace.
Hint
Procedure
- Sign in to the application and select Manage→Administration.
- Select Customization Manager→Field Configuration.
- In the Browse Classes text box, search for Contracts.
- Under the Contracts class, choose ContractWorkspace and then select Create Field→Computed Field.
Note
You can choose to create a Normal Field if you don’t have complex business logic to evaluate the contract ID prefix. - Under the General tab, specify the field label.
- Select the field type as Text.
- Add an expression to specify the logic to evaluate the custom contract ID prefix based on your business requirement.
Hint
Example 1: In this example, the contract ID prefix is evaluated based on whether the user is creating a contract request or a contract workspace. The contract ID prefix value is returned as JCR in case of a contract request and JCW in case of a contract workspace.
Sample code:
Code Snippet12StringUtil.startsWithIgnoreCase(Title.getStringForDefaultLocale(),"CR") ? "JCR" : "JCW"Example 2: In this example, the contract ID prefix is evaluated based on the value of another field. If the value of cus_isContractRequest is true, then the contract ID prefix value is returned as JCR, else the value returned is JCW.
Sample code:
Code Snippet12cus_isContractRequest == true ?'JCR':'JCW'
Note
It is recommended that you create a custom contract ID prefix in a format that is similar to the default contract ID prefix (CW). - Confirm the changes and publish the field configuration. The field configuration is created.
Next Steps
Assign the field to the Field Name to Identify Custom Contract ID Prefix (Application.ACM.FieldNameToIdentifyCustomContractIDPrefix) ICM parameter. Once assigned, the custom contract ID prefix is applicable to all the contract workspaces created in SAP Ariba Contracts. For more information about the parameter, refer to Field Name to Identify Custom Contract ID Prefix.
Note
Create a contract workspace in SAP Ariba Contracts to test the configuration. For more information about creating contract workspaces, refer to Creating Contract Projects.
Migrate the field configuration and the parameter to your production site. For more information, refer to Field Migration in Intelligent Configuration Manager and Package Deployments in Intelligent Configuration Manager.
Technical Details
| Product | SAP Ariba Contracts SAP Ariba Strategic Sourcing Suite SAP Strategic Procurement |
| Enablement | Customer-managed |
| Category | Configuration |
| Reference Number | SCONTR-1280 |
| User Type | Buyer Administrator |