Skip to Content
Technical Articles

Cloud For Customer Utilities – Extend Utilities Collections

Any coding or configuration examples provided in this document are only examples and are NOT intended for use in a productive system. The example is only done to better explain and visualize the topic.

The objective of this blog is to share the details required to extend C4C Utilities Online UIs. Specifically in this blog,we will focus on UIs and scenario related to Utilities Collections.

Please refer the following blogs to know the steps involved for extensibility

Scope of this Blog is to give required details for extending Utilities Collection’s Scenarios & UIs-:-

  1. Customer Overview
  2. Returns
  3. Credit Worthiness
  4. Security Deposit
  5. Write Off
  6. Dunning History
  7. Correspondence History
  8. Account History

1. Extending Utilities Collections (Customer Overview)

Utilities Collections (Customer Overview) is available in below places.

  • Customer / Account (TI) – Utilities Collections (Facet)

For Extending “Customer Overview in Utilities Collections” following nodes need to be extended.

  • Customer Financial Overview – CustomerFinancialOverview
  • Contract Account Info – CollectionContractAccount

You can refer below code snippet for reference.

import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
      node CustomerFinancialOverview{
 	[Label("Financial Overview Custom Field")] element Ext_Cust_Fin_Custom_Field:Indicator;
    }
      node CollectionContractAccount{
 	[Label("CA Custom Field")] element Ext_CA_Custom_Field:Indicator;
    }

} 

Targeted UI Details –

Utilities Collections UI – /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_CUSTOMER_OVERVIEW_EC.EC.uicomponent

C4C Enhancement Implementation Details-

Read – UtilitiesCollectionCustomerOverview

ISU Side Web Service Details – 

Read Service – COD_UTILITIES_ACCOUNT_OVERVIEW (ECC)/ ISU_C4C_ACCOUNT_OVERVIEW (S/4 HANA)

2. Extending Returns

Returns is available in below place.

  • Customer / Account (TI) – Utilities Collections(Facet) – Returns (Table)

For Extending “Utilities Collections – Returns” following node needs to be extended.

  • Returns – UtilitiesReturns

You can refer below code snippet for reference.

import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
      node UtilitiesReturns{
                          [Label("Returns Custom Field")] element Ext_Returns_Field: Indicator;
             }
} 

Targeted UI Details –

Returns UI – /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_UTILITIES_RETURNS_EC.EC.uicomponent

C4C Enhancement Implementation Details-

Read – UtilitiesReturns

ISU Side Web Service Details – 

Read Service – COD_UTIL_RET_HIST_GET (ECC) / ISU_C4C_RET_HIST_GET (S/4 HANA)

3. Extending Credit Worthiness

Credit Worthiness is available in below place.

  • Customer / Account (TI) – Utilities Collections(Facet) – Credit Worthiness (Details)

For Extending “Utilities Collections – Credit Worthiness” following nodes need to be extended.

  • Credit Worthiness Details – UtilitiesCreditWorthinessDetails
  • Credit Worthiness Record (Table) – UtilitiesCreditWorthinessRecords
  • Credit Worthiness Record History (Table) – UtilitiesCreditWorthinessRecordHistory

You can refer below code snippet for reference.

import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
     node UtilitiesCreditWorthinessDetails{
      [Label("CW Details Custom Field")] element Ext_CW_Details_Field:Indicator;
    }
    node UtilitiesCreditWorthinessRecords{
      [Label("CW Records Custom Field")] element Ext_CW_Records_Field: Indicator;
    }
    node UtilitiesCreditWorthinessRecordHistory{
      [Label("CW History Custom Field")] element Ext_CW_History_Field: Indicator;
    }
} 

Targeted UI Details –

Credit Worthiness UI – /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_UTILITIES_CREDIT_WORTHINESS_EC.EC.uicomponent

C4C Enhancement Implementation Details-

Read – UtilitiesCreditWorthiness

ISU Side Web Service Details – 

Read Service – COD_ERP_UTIL_CW_GET (ECC) / ISU_C4C_BP_CW_GET (S/4 HANA)

4. Extending Security Deposit

Security Deposit is available in below place.

  • Customer / Account (TI) – Utilities Collections(Facet) – Security Deposit (Table)

For Extending “Utilities Collections – Security Deposit” following node needs to be extended.

  • Security Deposit – SecurityDeposit

You can refer below code snippet for reference.

import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
     node SecurityDeposit{
 	[Label("Security Deposit Custom Field")] element Ext_Security_Deposit_Field:Indicator;
    }
} 

Targeted UI Details –

Security Deposit UI – /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_SEC_DEPOSIT_EC.EC.uicomponent

C4C Enhancement Implementation Details-

Read  – UtilitiesSecurityDeposit

Action – UtilitiesSecurityDepositActions

ISU Side Web Service Details – 

Read Service – COD_ERP_UTIL_BP_SEC_DP_GET (ECC) / ISU_C4C_BP_SEC_DEP_GET (S/4 HANA)

Action Service – COD_ERP_UTIL_BP_SEC_DEP_MODIFY (ECC)/  ISU_C4C_BP_SEC_DEP_MODIFY (S/4 HANA)

5. Extending Write Off

Write Off is available in below place.

  • Customer / Account (TI) – Utilities Collections(Facet) – Write Off (Table)

For Extending “Utilities Collections – Write Off” following node needs to be extended.

  • Write Offs – WriteOffs

You can refer below code snippet for reference.

import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
     node WriteOffs{
 	[Label("Write Offs Custom Field")] element Ext_Write_Offs_Field:Indicator;
    }
} 

Targeted UI Details –

Write Off UI – /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_UTILITIES_WRITEOFFS_EC.EC.uicomponent

C4C Enhancement Implementation Details-

Read  – UtilitiesWriteOffs

ISU Side Web Service Details – 

Read Service – COD_UTIL_WRITOFF_HIST_GET (ECC) / ISU_C4C_WRITOFF_HIST (S/4 HANA)

6. Extending Dunning History

Dunning History is available in below place.

  • Customer / Account (TI) – Utilities Collections(Facet) – Dunning History (Table)

For Extending “Utilities Collections – Dunning History” following node needs to be extended.

  • Dunning History – UtilitiesDunningHistory

You can refer below code snippet for reference.

import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
     node UtilitiesDunningHistory {
 	[Label("Dunning History Custom Field")] element Ext_Dunning_Hist_Field:Indicator;
    }
} 

Targeted UI Details –

Dunning History UI : /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_DUNNING_HISTORY_EC.EC.uicomponent

C4C Enhancement Implementation Details-

Read  – UtilitiesDunningHistory

ISU Side Web Service Details – 

Read Service : COD_UTILITIES_DUNNING_HIST_GET(ECC)/ ISU_C4C_UTIL_DUNNING_HIST_GET(S/4 HANA)

7. Extending Correspondence History

Correspondence history is available in below place.

  • Customer / Account (TI) – Utilities Collections(Facet) – Correspondence History (Table)

For Extending “Utilities Collections – Correspondence history” following node needs to be extended.

  • Correspondence history – UtilitiesCorrespondenceHistory

You can refer below code snippet for reference.

import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
     node UtilitiesCorrespondenceHistory{
 	[Label("Corr History Custom Field")] element Ext_Corr_Hist_Field:Indicator;
    }
} 

Targeted UI Details –

Correspondence History UI : /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_CORRESPONDENCE_HISTORY_EC.EC.uicomponent

C4C Enhancement Implementation Details-

Read  – UtilitiesCorrespondenceHistory

ISU Side Web Service Details – 

Read Service : COD_ERP_UTIL_CORRESP_HIST_GET (ECC)/ ISU_C4C_CORRESP_HIST_GET(S/4 HANA)

8. Extending Account History

Account history is available in below place.

  • Customer / Account (TI) – Utilities Collections(Facet) – Account history (Table)

For Extending “Utilities Collections – Account history” following node needs to be extended.

  • Account history – UtilitiesAccountHistory

You can refer below code snippet for reference.

import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
     node UtilitiesAccountHistory{
 	[Label("Account History Custom Field")] element Ext_Account_Hist_Field:Indicator;
    }
} 

Targeted UI Details –

Account history UI – /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_ACCOUNT_HISTORY_EC.EC.uicomponent

C4C Enhancement Implementation Details-

Read  – UtilitiesAccountHistory

ISU Side Web Service Details – 

Read Service : COD_ERP_UTIL_ACCOUNT_HIST_GET (ECC)/ ISU_C4C_ACCOUNT_HIST_GET (S/4 HANA)

Be the first to leave a comment
You must be Logged on to comment or reply to a post.