Skip to Content
Author's profile photo Horst Schaude

How to easily add an address to your Custom Business Object

You all know the AddressInformation nodes in the SAP Business Objects which hosts detailed address information, especially country and language dependent.

This can also be achieved in a very easy way with a Custom Business Object.

All you need is an association to the SAP Business Object AddressSnapshot and the Embedded Component Public_Address.

No further definitions in the BODL of your Custom Business Object, no ABSL coding.
The complete data handling is covered by the Embedded Component!!!

The only disadvantage is that the Embedded Component is also the only way to maintain the data.

Let me show you the single steps.

Step 1: Association to AddressSnapshot

Add an association like this to your Custom Business Object in any node.
This is not restricted to the Root node.

association Address to AP.FO.Address.Global:AddressSnapshot;

You can have even more than one:

association DeliveryAddress to AP.FO.Address.Global:AddressSnapshot;
association BillingAddress to AP.FO.Address.Global:AddressSnapshot;
association MainContact to AP.FO.Address.Global:AddressSnapshot;

Step 2: Add the Embedded Component Public_Address

After you have created your UI open it in the UI Designer.

Make sure that the NodeID of the node(s) in which you have defined your association(s) is/are part of the UI Model.
Let’s call this node the HostNode and the resp. NodeID the HostNodeID.

Add the Embedded Component “/SAP_BYD_APPLICATION_UI/Reuse/Address/Public_Address_EC.EC.uicomponent” to your UI.

Maintain the Binding

Click on the “Bind” button inside the Embedded Component.
In the “Embedded component binding” window select the HostNodeID from your Data Model on the left and the AddressSnapshotHostNodeID from the interface on the right and bind them together.

Maintain the Parameters

Mark the Embedded Component and have a look at the Parameters in the Properties tab.

You need to provide these parameters:

Parameter Value

Internal name of the element which defines the association.

You need to prefix the name of the association with “SAP_” and – as the GDT is structured – suffix it with “/content”.

• SAP_Address/content
• SAP_DeliveryAddress/content”
• SAP_MainContact/content

 AddressSnapshotHostBOName The name of your Custom Business Object

The namespace of your solution.

You may copy it from the Properties window of the
SDK after selection the solution

AddressSnapshotHostNodeName The name of the HostNode.


The other parameter describe the look-and-feel of the Embedded Component, like the title, visibility, and edit mode.

Step 3:Use it

You can now enter any address data in the Embedded Component.
The Embedded Component itself takes care that this data is persisted and updated on save.

Even more: It takes also care that the association is set in the HostNode of your Custom Business Object.
This means you can access the address data also via ABSL.

That’s all, folks.

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Stefan Barsuhn
      Stefan Barsuhn

      Hi Horst,

      thank you for this very interesting blog post.

      One follow-up question regarding "AddressSnapshotHostBONamespace" with respect to patches. Is the system intelligent enough to convert the namespace during assembly or do I need to change it to the original solution's namespace before assembly?

      Thank you

      Author's profile photo Horst Schaude
      Horst Schaude
      Blog Post Author


      Hello Stefan,

      As in other places where you also need to supply the namespace of the solution the framework takes care to perform that aliasing step. 🙂