Deactivating extensions and migrating components with deprecated API name notations
Frequently Asked Questions
- Why am I receiving this email or notification?
There are one or more extensions and components (listed in your CRM login at Setup > Marketplace > All > Deprecated) in your Zoho CRM Organisation, which currently use the deprecated notations. These extensions will be deactivated and all components with deprecated API name notations will be migrated to the new notations on April 6, 2022.
- How would this change impact my Zoho CRM usage after April 6, 2022?
If the affected extensions are not updated, all their features will stop functioning and their components' API names will be automatically changed to the new notation.
If the standalone components' API names are not updated, they will be automatically changed to the new notation.
- Will there be any data loss when an extension is deactivated?
The data processed using the extensions and its components may be affected in future transactions. However, there won't be any loss of existing data which is already stored in Zoho CRM modules, fields, or org variables.
- What action is required from my end?
You can find the affected extensions and components in your Zoho CRM account by going to Set up > Marketplace > All > Installed.
For extensions:
Check if there are any updates pending. If there are no updates available, get in touch with the developer of the extension or uninstall the extensions.
Check if you have used the API names of any of the extension's components in any part of your CRM account.
For standalone components:
Update all the component's API names and ensure you have updated them everywhere you have used them.
I have not used the affected extensions components and standalone components' API names anywhere, What do I do now?
The API names will be changed automatically after the specified date. Your usage will only be disrupted if you have used the API names with deprecated notations. Therefore if you have not used them anywhere, you may ignore the warning about the usage of API names.
- What will happen if I uninstall the extension?
All the components created via the extensions will be removed along with all data that is associated with them. To see a list of the affected components, log in to your Zoho CRM account and navigate to Setup > Marketplace > All > Installed, where you will find a list of installed components.
- How can I contact the extension developer?
Navigate to Zoho CRM > Setup > Marketplace > All > Installed and click the Configure option for the relevant extension. Click Get Support in the top-right corner.
- What will happen if I do not take any action?
All the components introduced via the extension will be removed from your Zoho CRM Organization, except : modules, fields (in both CRM default modules and custom modules), and CRM Organization variables. From April 07, 2022, the API name notation for these unremoved components will be changed from the deprecated notation "ExtensionNamespaceName.ComponentName" to the new notation "ExtensionNamespaceName__ComponentName". If you are using the API names of these components in custom functions, widgets, or server side APIs to perform actions on extension components, you will therefore need to check your code and update the API names to the new notations.
- How do I back up my data?
There are several options to back up the data in your Zoho CRM Account. To learn more about these options, refer to our help documentation.
- How do I find alternative extensions?
We have a large range of extensions available in our Marketplace, which you can explore by visiting https://marketplace.zoho.com/app/crm. If you cannot find suitable alternative extensions, please write to support@zohomarketplace.com.
- I have overwritten some custom functions, widgets, and APIs over the extension's modules and fields. Can I get a sample code on the revisions to be made?
Yes, please find the code examples below.
Custom Functions:
Old Notation:
newRecordInfo = Map(); newRecordInfo.put("Name","Property One"); newRecordInfo.put("sample.Apartment_Name",property.get("sample.Apartment_Name")); newRecordInfo.put("sample.Email",property.get("sample.Email")); newRecordInfo.put("sample__Secondary_Email",property.get("sample__Secondary_Email")); response = zoho.crm.create("sample.Properties",newRecordInfo); info response;
New Notation:
newRecordInfo = Map(); newRecordInfo.put("Name","Property One"); newRecordInfo.put("sample__Apartment_Name", property.get("sample__Apartment_Name")); newRecordInfo.put("Email",property.get("Email")); newRecordInfo.put("Secondary_Email",property.get("Secondary_Email")); response = zoho.crm.create("sample__Properties", newRecordInfo); info response; |
Widgets:
Old Notation:
ZOHO.CRM.CONFIG.getOrgVariable("sample.oauthtoken").then(function(data){ console.log(data); }); var recordData = { "sample.Apartment_Name": "Skyline", "Name": "Property One" } ZOHO.CRM.API.insertRecord({Entity:"sample.Properties", APIData:recordData}) .then(function(data){ console.log(data); });
New Notation: ZOHO.CRM.CONFIG.getOrgVariable("sample__oauthtoken").then(function(data){ console.log(data); }); var recordData = { "sample__Apartment_Name": "Skyline", "Name": "Property One" } ZOHO.CRM.API.insertRecord({Entity:"sample__Properties",APIData:recordData}).then(function(data){ console.log(data); }); |