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 Financials.
Please refer the following blogs to know the steps involved for extensibility –
Scope of this Blog is to give required details for extending Utilities Financial’s Scenarios & UIs-:-
- Extending Utilities Financial
- Invoices
- Payments
- Open Items
- Installment Plan
- Payment Plan
- Promise To Pay
1. Extending Utilities Financial
Utilities Financial is available in below places.
- Customer / Account (TI) - Utilities Financial(Facet)
For Extending “Utilities Financial” following node needs to be extended.
- Header Area – OverviewAccountBalance
You can refer below code snippet for reference.
import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
node OverviewAccountBalance{
[Label("Financial Header Info")] element Ext_Fin_Header_Info :LANGUAGEINDEPENDENT_EXTENDED_Text;
}
}
Targeted UI Details -
Exceptions UI - /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_UTILITIES_FINANCIAL_OVERVIEW_EXTENSIBILITY_EC.EC.uicomponent
C4C Enhancement Implementation Details-
Read - UtilitiesFinancialAccountOverview
ISU Side Web Service Details -
Read Service - COD_UTILITIES_ACCOUNT_OVERVIEW(ECC) / ISU_C4C_ACCOUNT_OVERVIEW(S/4 HANA)
1.1 Invoices
Invoices is available in below place.
- Customer / Account (TI) - Utilities Financial(Facet) - Invoices (Table)
For Extending “Utilities Financial - Invoices” following nodes need to be extended.
- Invoices -:- Invoices
- Billing Documents -:- Invoices-UtilitiesFinancialBillingDocuments
- Contract Overview -:- Invoices-FinancialContractOverview
- Simulated Document -:- Invoices-SimulatedFinancialDocument
You can refer below code snippet for reference.
import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
node Invoices{
[Label("Invoices Additional Info")] element Ext_Invoices_Info :LANGUAGEINDEPENDENT_EXTENDED_Text;
node FinancialContractOverview {
[Label("Financial Contract Overview ")] element Ext_FinConOverview_Info :LANGUAGEINDEPENDENT_EXTENDED_Text;
}
node UtilitiesFinancialBillingDocuments {
[Label("Billing Documents Info")] element Ext_Bill_Doc_Info:LANGUAGEINDEPENDENT_EXTENDED_Text;
}
node SimulatedFinancialDocument {
[Label("Simulated Document Info")] element Ext_Sim_Doc_Info:LANGUAGEINDEPENDENT_EXTENDED_Text;
}
}
}
Targeted UI Details -
Invoices UI - /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_UTILITIES_FINANCIAL_OVERVIEW_EXTENSIBILITY_EC.EC.uicomponent
C4C Enhancement Implementation Details-
Read - UtilitiesFinancialAccountOverview
Actions -
- Full Reversal -:- UtilitiesFullReversal
- Adjustment Reversal -:- UtilitiesAdjustmentReversal
- Rebill -:- UtilitiesFinancialRebill
- One Time Payment -:- UtilitiesFinancialActionsBADI
- Invoice Now, Bill Now, Invoice Simulation, Bill and Invoice, Submit MR -:- UtilitiesCreateBillingActions
ISU Side Web Service Details -
Read Service - COD_UTILITIES_ACCOUNT_OVERVIEW(ECC) / ISU_C4C_ACCOUNT_OVERVIEW(S/4 HANA)
Action Services -:-
- Invoice Now, Bill Now, Invoice Simulation, Bill and Invoice, Submit MR - COD_UTILITIES_CR_BILL_ACTION(ECC) / ISU_C4C_CR_BILL_ACTION(S/4 HANA)
- Full Reversal - COD_UTILITIES_BICO_REVERSE(ECC) / ISU_C4C_BICO_REVERSE(S/4 HANA)
- Adjustment Reversal - COD_UTILITIES_BICO_REVERSE_ADJ(ECC)/ ISU_C4C_BICO_REVERSE_ADJ(S/4 HANA)
- Rebill - COD_UTILITIES_BICO_REBILL(ECC)/ ISU_C4C_BICO_REBILL(S/4 HANA)
- OneTimePayment –
- New Bank Save - COD_UTIL_BANK_PAYMENT_METHOD(ECC)/ ISU_C4C_BANK_PAYMENT_METHOD(S/4 HANA)
- Submit Onetime Payment - COD_UTIL_ONETIMEPAY_MODIFY(ECC) / ISU_C4C_UTIL_ONETIMEPAY_MODIFY(S/4 HANA)
1.2 Payments
Payments is available in below place.
- Customer / Account (TI) - Utilities Financial(Facet) - Payments(Table)
For Extending “Utilities Financial - Payments” following node needs to be extended.
You can refer below code snippet for reference.
import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
node Payments{
[Label("Payment Additional Info")] element Ext_Payment_Info :LANGUAGEINDEPENDENT_EXTENDED_Text;
}
}
Targeted UI Details -
Payments UI - /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_UTILITIES_FINANCIAL_OVERVIEW_EXTENSIBILITY_EC.EC.uicomponent
C4C Enhancement Implementation Details-
Read - UtilitiesFinancialAccountOverview
Action(Cancel Payment) - UtilitiesFinancialActionsBADI
ISU Side Web Service Details -
Read Service - COD_UTILITIES_ACCOUNT_OVERVIEW(ECC) / ISU_C4C_ACCOUNT_OVERVIEW(S/4 HANA)
Action(Cancel Payment) Service - COD_UTIL_SCHED_PAYMENTS_MODIFY(ECC) / ISU_C4C_SCHED_PAYMENTS_MODIFY(S/4 HANA)
1.3 Open Items
Open Items is available in below place.
- Customer / Account (TI) - Utilities Financial(Facet) - Open Items (Table)
For Extending “Utilities Financial - Open Items” following nodes need to be extended.
- Open Items – OpenItems
- Document Lock - OpenItems-FinancialDocumentLocks
You can refer below code snippet for reference.
import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
node OpenItems {
[Label("Open Item Additional Info")] element Ext_OpenItems_Info :LANGUAGEINDEPENDENT_EXTENDED_Text;
node FinancialDocumentLocks{
[Label("Financial Doc Additional Info")] element Ext_Fin_Doc_Info:LANGUAGEINDEPENDENT_EXTENDED_Text;
}
}
}
Targeted UI Details -
Open Items UI - /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_UTILITIES_FINANCIAL_OVERVIEW_EXTENSIBILITY_EC.EC.uicomponent
C4C Enhancement Implementation Details-
Read - UtilitiesFinancialAccountOverview
Actions
- Create Locks – UtilitiesFinancialCreateLocks
- Edit Locks – UtilitiesFinancialEditLocks
- Delete Locks - UtilitiesFinancialDeleteLocks
- Manual Posting and Deferral – UtilitiesFinancialActionsBADI
ISU Side Web Service Details -
Read Service - COD_UTILITIES_ACCOUNT_OVERVIEW(ECC) / ISU_C4C_ACCOUNT_OVERVIEW(S/4 HANA)
Action Services -:-
- Create, Edit and Delete Locks – COD_UTILITIES_LOCKS(ECC) / ISU_C4C_LOCKS(S/4 HANA)
- Manual Posting – COD_UTILITIES_MANUAL_POSTING(ECC) / ISU_C4C_MANUAL_POSTING(S/4 HANA)
- Deferral - COD_UTIL_ACC_OVERVIEW_MODIFY(ECC) / ISU_C4C_ACC_OVERVIEW_MODIFY(S/4 HANA)
1.4 Installment Plan
Installment Plan is available in below place.
- Customer / Account (TI) - Utilities Financial(Facet) - Installment Plan (Table)
For Extending “Utilities Financial - Installment Plan” following nodes need to be extended.
- Installment Plan -:- InstallmentPlan
- Installments -:- InstallmentPlan-FinancialInstallments
You can refer below code snippet for reference.
import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
node InstallmentPlan{
[Label("Installment Plan Additional Info")] element Ext_InstallmentPlan_Info :LANGUAGEINDEPENDENT_EXTENDED_Text;
node FinancialInstallments{
[Label("Installments Additional Info")] element Ext_Installments_Info:LANGUAGEINDEPENDENT_EXTENDED_Text;
}
}
}
Targeted UI Details -
Installment Plan UI - /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_UTILITIES_FINANCIAL_OVERVIEW_EXTENSIBILITY_EC.EC.uicomponent
C4C Enhancement Implementation Details-
Read - UtilitiesFinancialAccountOverview
Action - UtilitiesInstallmentPlan
ISU Side Web Service Details -
Read Service - COD_UTILITIES_ACCOUNT_OVERVIEW(ECC) / ISU_C4C_ACCOUNT_OVERVIEW(S/4 HANA)
Action Service - COD_UTILITIES_INSTALLMENT_PLAN(ECC)/ ISU_C4C_INSTALLMENT_PLAN(S/4 HANA)
1.5 Payment Plan
Payment Plan is available in below place.
- Customer / Account (TI) - Utilities Financial(Facet) - Payment Plan (Table)
For Extending “Utilities Financial - Payment Plan” following nodes need to be extended.
- Contract Details-:- BudgetBillingContracts (Table during Create Action)
- Payment Plan -:- BudgetBillingContracts-BudgetBillingPaymentPlan
- Payment Plan Item -:- BudgetBillingContracts-BudgetBillingPaymentPlan-BudgetBillingPaymentPlanItem
You can refer below code snippet for reference.
import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
node BudgetBillingContracts {
[Label("BB Contract Info")] element Ext_BB_Contract_Info :LANGUAGEINDEPENDENT_EXTENDED_Text;
node BudgetBillingPaymentPlan{
[Label("BB Plan Info")] element Ext_BB_Plan_Info:LANGUAGEINDEPENDENT_EXTENDED_Text;
node BudgetBillingPaymentPlanItem{
[Label("BB Plan Item Info")] element Ext_BB_Plan_Item_Info:LANGUAGEINDEPENDENT_EXTENDED_Text;
}
}
}
}
Targeted UI Details -
Payment Plan UI - /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_UTILITIES_BUDGET_BILLING_EC.EC.uicomponent
C4C Enhancement Implementation Details-
Read -:- UtilitiesBudgetBillingOverview
Action -:- UtilitiesBudgetBillingActions
ISU Side Web Service Details -
Read Service - COD_UTILITIES_BUDGET_BILLING(ECC)/ ISU_C4C_BUDGET_BILLING(S/4 HANA)
Action Service - COD_UTILITIES_BUDGET_BILLING(ECC)/ ISU_C4C_BUDGET_BILLING(S/4 HANA)
1.6 Promise To Pay
Promise To Pay is available in below place.
- Customer / Account (TI) - Utilities Financial(Facet) - Promise To Pay(Table)
For Extending “Utilities Financial - Promise To Pay” following nodes need to be extended.
- Promise To Pay – PromisetoPay
- P2P Payment Deadline- PromisetoPay-P2PPaymentDeadlines
You can refer below code snippet for reference.
import AP.Common.GDT;
import AP.CRM.Global;
[Extension] businessobject AP.CRM.Global:UtilitiesExtensibility {
node PromisetoPay{
[Label("Promise to Pay Additional Info")] element Ext_P2P_Info :LANGUAGEINDEPENDENT_EXTENDED_Text;
node P2PPaymentDeadlines{
[Label("P2P Payment Info")] element Ext_P2P_Deadline_Info:LANGUAGEINDEPENDENT_EXTENDED_Text;
}
}
}
Targeted UI Details -
Promise To Pay UI - /BYD_COD/IndustrySolution/Utilities/UI/Extensibility/COD_UTILITIES_PROMISE_PAY_EC.EC.uicomponent
C4C Enhancement Implementation Details-
Read - UtilitiesP2PGet
Action - UtilitiesP2PModify
ISU Side Web Service Details -
Read Service - ISU_C4C_PROMISE2PAY_GET(S/4 HANA)
Action Service - ISU_C4C_PROMISE2PAY_MODIFY(S/4 HANA)