Supporting Custom Functionality¶
Entities having an ObjKeyStyle codegen property other than "none" are by default enabled for framework functionality such as Custom Objects and Attributes. Entities with non-standard architectural design not compatible with these framework functionalities should be added to the Exclude Entities from having Custom Attributes list. Once an entity is excluded it is automatically disabled for use with Custom Objects and Fields.
Disabling Custom functionality for Logical Units¶
To exclude an entity from Custom functionality a call to the Custom_Field_Excludes_API.Register method may be added to the fndcob\source\fndcob\database\CustomFieldExcludedLogicalUnits.ins file, stating the reason for exclusion.
Custom_Field_Excludes_API.Register('[LU_NAME]', '[REASON]', '[REGISTER_DATE]');
Example:Custom_Field_Excludes_API.Register('PersonInfo', 'The LU cannot be extended', To_date('2015-02-10-00.00.00', Client_SYS.Date_Format_));
Moving Configurations from One Entity to Another¶
Handle Entity Modification (previously known as Handle LU Modification) is a functionality that supports moving configurations from one entity to another when an entity is renamed or replaced with another entity. The migration of the configuration types given below to a new entity is supported through this interface. * Custom Attributes * Custom Entities * Object Connections * History Logs
Database_SYS.Handle_Lu_Modification('[MODULE_NAME]', '[OLD_LU_NAME]', '[IN_NEW_LU_NAME]', '[IN_OLD_TABLE_NAME]', '[IN_NEW_TABLE_NAME]', '[IN_GENERATE_KEY_REF]', '[KEY_REF_MAP]', '[OPTIONS]')
Example:
Database_SYS.Handle_Lu_Modification('EMPPAY', 'IbanValidationInfoHr', ' IbanValidationInfoHcm', 'IBAN_VALIDATION_INFO_HR_TAB', 'IBAN_VALIDATION_INFO_HCM_TAB', TRUE, 'COUNTRY_CODE=COUNTRY_CODE')
Copy Custom Attribute Records between Standard Entities¶
Through the provided interface, it is possible to copy values of a custom attribute record instance that belong to a standard entity, to that of another standard entity.
Custom_Objects_SYS.Copy_Between_Lu_Cf_Instance('[FROM_LU_NAME]', '[FROM_ROW_KEY]', '[TO_LU]', '[TO_ROWKEY]')
Example:
Custom_Objects_SYS.Copy_Between_Lu_Cf_Instance('WorkOrderReturns', 'D4243BA254204305908B90842E8706BD', 'JtTaskReturn', '55A2ECF21AB6442DB4D884C1B796B631')
Copy Custom Attribute Records Within a Standard Entity¶
This function facilitates the copying of a custom attribute record value instance as another custom attribute instance in the standard entity.
Custom_Objects_SYS.Copy_Cf_Instance('[LU]', '[FROM_ROW_KEY]', '[TO_ROWKEY]')
Example:
Custom_Objects_SYS.Copy_Cf_Instance('WorkOrderReturns', 'D4243BA254204305908B90842E8706BD', '5E1C6376C9B54EBC9FA9B3431400BA62')
Copy Custom Attributes from Parent to Child Entity¶
This functionality facilitates the copying of all custom attributes from one (parent) entity to another (child) entity, provided both entities are modeled with either Generalization (basedon) or Model Inheritance. Custom attributes are typically linked to a standard base table of an entity. However, in certain scenarios, custom attributes may be linked to a standard table even outside the source (may be due to some refactoring in code layer). In such cases, it is possible to provide the source (standard) table name as a parameter. In addition, the interface itself accepts 'Objtype' as a parameter, to be set when it is different from the destination (child) entity name.
Custom_Objects_SYS.Copy_Custom_Attributes('[SOURCE_LU_NAME]', '[DESTINATION_LU_NAME]', '[SOURCE_TABLE_NAME]', '[OBJ_TYPE]')
Example:
Custom_Objects_SYS.Copy_Custom_Attributes('JtTask', 'RequestTask', 'WORK_TASK_TAB', 'RequestTask');