Configuring a predefined list of funding codes to use in RONIN

Parice Brandies -

When creating projects in RONIN, you can specify two types of funding codes that are applied to all associated project resources: a billing code and a purchase order number. These codes help reconcile financial records and allow projects to be grouped under the same department, grant, invoice, or other financial classification. While these values have typically been entered in a custom text field, some institutions prefer to configure a predefined list of valid codes in RONIN to ensure accuracy and alignment with internal financial procedures. This blog post will teach you how to create and edit predefined lists for allowed billing codes and purchase order numbers in RONIN using the Systems Manager Parameter Store.

  1. In your AWS account, navigate to Systems Manager, then Parameter Store.
  2. RONIN looks for specific parameters to configure the list of allowed funding codes named /ronin-allowed-funding-codes/billing_code and /ronin-allowed-funding-codes/purchase_order for the billing_code and purchase_order fields respectively. So, you must create these parameters if you wish to specify a list of allowed funding codes.
💡
If these parameters are not found in the AWS account, RONIN will default to a custom text input.
  1. To create the billing_code list, click "Create Parameter" and fill out the form as follows, replacing any strings in the "Value" field with the list of billing codes you would like to make available in RONIN, then click "Create parameter":
💡
Please Note:
The values can only be alphanumeric with the following special characters allowed: . : + = @ _ / -
If you add a string with any other special characters, you will get an error in RONIN when trying to create/save the project.
  1. To create the purchase_order list, click "Create Parameter" and fill out the form as follows, replacing any strings in the "Value" field with the list of purchase order numbers you would like to make available in RONIN, then click "Create parameter":
  1. When creating a new project in RONIN, you should now see a dropdown of available options from this parameter store list to select from:
💡
You can edit the Parameter values at any time to update this list in RONIN.

That’s it! A quick and easy way to configure custom funding codes in RONIN.

via GIPHY