To take advantage of all record type features, functionality, and components available in the latest Appian release, you should update existing record types created with previous versions. Some new features affect how record types are referenced in expressions or how dependent interfaces display your record data. To ensure you are able to verify the impact of these features on your application, you won't be able to use the new features until you manually update the record type.
An existing record type that has not been updated is referred to as a legacy record type. The latest version of Appian is backward compatible with legacy record types, so your applications will continue to work normally.
This page explains the record type features added for specific versions and shows how to update your legacy record type objects to the latest version.
The following table lists the record type features you will be able to use once you update a record type to the corresponding Appian version.
||Check record views and other interfaces that reference the record type to see if the design needs to be updated to accommodate a greater number of related records.|
|See the troubleshooting section for help resolving issues after updating.|
All legacy record type objects include the following update alert at the top of the page. You'll need to update your legacy record types in order to take advantage of any new features, functionality, or components included in the latest Appian release.
To update a legacy record type, open the record type and click Update Now at the top of the page. Appian will automatically update your record type to the latest version.
Appian recommends exporting a copy of your record type before clicking Update Now in case you need to roll back the record type to the previous version.
After your record type successfully updates, the UI displays a green message banner to indicate that new record type features and functionality are available for use. Be sure to save your record type to capture all of these updates and any additional changes you made.
There may be other design objects, including interfaces and expression rules, that support or reference the updated record type. After saving the updated record type, you'll need to review and update these design objects to ensure they are correctly referencing the record type.
If you need to roll back the record type to the previous version, close the record type object without saving your changes. If you have already saved your record type, you can import the version you exported prior to updating the record type into your application and delete the updated version.
The Update Now feature does not convert legacy expression-backed record types created before Appian 20.3 into updated service-backed record types that have all of the new record features and functionalities.
To access these new record type features on your legacy expression-backed record types, you must recreate them using the latest Appian version.
In some instances, after updating your legacy record type, you may need to manually configure part of your record list or manually update expressions that support your record type.
The guidance provided in this section will help you identify configuration settings in your record list or parameters in your expressions that you need to manually reconfigure following a record type update.
After updating your record type, you may encounter a yellow message banner in the UI, which indicates that one or more configuration issues were detected in the record list.
To resolve this:
The record list for a legacy record type may have component and parameter settings that did not convert to the new setting options when you updated the record type. As such, we recommend that you review your record list and configuration settings after updating your record type to the latest version.
If your record list met any of the following conditions prior to updating, you will need to manually reconfigure the parameter settings to ensure the list displays properly:
rf!to define the align parameter of a column component.
To reconfigure your record list:
See Configure a record list for more information.
After updating a legacy record type, you may also need to update the expression rules used within the record type or in other objects that support the record type.
Manually reconfigure any expression rules that support your record type if any of the following conditions apply:
rf!variables. To resolve this, reconfigure your expression rule within record titles, record views, and related actions to use
rv!recordto reference a record field in the record type.
Update a Legacy Record Type