How to construct a Deep link URL for C4C Business Objects using Business object ID?

[arun02_12]

In this blog post, you will learn How to construct deep link URL for C4C business Objects.

Deep link URL  is a predetermined URL through which a specific business object instance can be opened by clicking it directly without any manual navigation inside the system. For the user, this saves the time taken to navigate to a specific business object instance by simplifying the process to a Single click.

The Deep link for a specific  Business Object can be Included in the content/template of a Mail based Workflow for Approvers/Reviewers/Managers. With the help of the Workflow placeholders, it will be possible to send out a link that will direct to the business object instance which triggered the workflow.

How to construct a Deep link URL?

You can consider the below URL  as a template which can be used to deep link any Business Object

https://myNNNNNN.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_GENERIC&node=Root&operation=OnExtInspect&param.InternalID=[x]&param.Type=[y]&sapbyd-agent=TAB

where,

NNNNNN - Tenant ID in the URL of your C4C system
[X]            - ID of the business object instance that is expected to be opened on click of                     the URL
[Y]            - Technical name of each business Object

Note:

In case if you are using SSO based log on, Append the parameter "&OBNRedirect=X" to the above URL.

Let's construct an URL for Tickets object

Replace the [X]  and  [Y] in the above URL with the Placeholder #ID#  and the  Technical name of the Ticket "COD_SRQ_AGENT_TT"   as below

https://myNNNNNN.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_GENERIC&node=Root&operation=OnExtInspect&param.InternalID=#ID#&param.Type=COD_SRQ_AGENT_TT&sapbyd-agent=TAB

The snip "sapbyd-agent=TAB" is not needed if you intend to use the Deeplink for a Browser-based usage.

Now all you have to do is create a Workflow with the above link as a part of the mail Template and maintain the Placeholder (#ID# = Ticket ID).

In a similar way use the below available URLs for the respective business objects

For Leads:

https://myNNNNNN.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_GENERIC&node=Root&operation=OnExtInspect&param.InternalID=#ID#&param.Type=COD_MKT_PROSPECT&sapbyd-agent=TAB

Maintain the Placeholder (#ID# = Lead ID)

For Opportunities:

https://myNNNNNN.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_GENERIC&node=Root&operation=OnExtInspect&param.InternalID=#ID#&param.Type=COD_OPPORTUNITY_THINGTYPE&sapbyd-agent=TAB

Maintain the Placeholder (#ID# = Opportunity ID)

For Sales Quotes:

https://myNNNNNN.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_GENERIC&node=Root&operation=OnExtInspect&param.InternalID=#ID#&param.Type=COD_QUOTE_TT&sapbyd-agent=TAB

Maintain the Placeholder (#ID# = Sales Quote ID)

For Sales Orders:

https://myNNNNNN.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_GENERIC&node=Root&operation=OnExtInspect&param.InternalID=#ID#&param.Type=COD_SALESORDER_TT&sapbyd-agent=TAB

Maintain the Placeholder (#ID# = Sales Order ID)

For Accounts:

https://myNNNNNN.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_GENERIC&node=Root&operation=OnExtInspect&param.InternalID=#ID#&param.Type=COD_ACCOUNT_TT&sapbyd-agent=TAB

Maintain the Placeholder (#ID# = Account ID)

For Contact:

https://myNNNNNN.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_GENERIC&node=Root&operation=OnExtInspect&param.InternalID=#ID#&param.Type=COD_CONTACT_TT&sapbyd-agent=TAB

Maintain the Placeholder (#ID# = Contact ID)

For Products:

https://myNNNNNN.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_GENERIC&node=Root&operation=OnExtInspect&param.InternalID=#ID#&param.Type=COD_MATERIAL&sapbyd-agent=TAB

Maintain the Placeholder (#ID# = Product ID)

For Tasks:

https://myNNNNNN.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_GENERIC&node=Root&operation=OnExtInspect&param.InternalID=#ID#&param.Type=COD_TASK&sapbyd-agent=TAB

Maintain the Placeholder (#ID# = Task ID)

For Appointments:

https://myNNNNNN.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_GENERIC&node=Root&operation=OnExtInspect&param.InternalID=#ID#&param.Type=COD_APPOINTMENT&sapbyd-agent=TAB

Maintain the Placeholder (#ID# = Appointment ID)

You can also use the UUID of the business objects instead of the BO ID but the URL has to be constructed in a different format for that. You can add the above links directly to your template by adding your tenant ID and the corresponding placeholders.

You can also refer this SAP Help Center document link for additional info regarding this feature.

I hope this helps in simplifying the navigation and reduces the time taken for the Approvers/Managers to review the Business Objects.

Best Regards,

Arun

[former_member564242]

Awesome blog 🙂 good job! kudos!

[former_member190150]

Great blog Arun.

I have one query here, if we want to use this link in SSO (single sign on) then what additional info need to add in this URL? for example Opportunity we want to add SSO, so that User no need to sign in to open C4C through using this existing link.

Thanks in advance.

Regards,

Murugesan.

 

[former_member190150]

Hello Arun,

I have added SSO details after tenant ID and it works. But the link is not landing on the BO directly, its landed in Home page. Please note I maintained correct Placeholder.Can you please suggest am I missing something here in the below URL.

https://myXXXXXX-sso.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_...

Thanks in Advance.

Regards,

Murugesan.

[arun02_12]

Hello Murugesan,

Can you try

https://myXXXXXX-sso.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_...&OBNRedirect=X

I have just appended “&OBNRedirect=X” to your link.

I hope it works.

Best Regards,

Arun

[former_member190150]

Hello Arun,

I have tried this new link, but still landing in Home page. I received the below link as email workflow.



https://myNNNNNN-sso.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_...

 

[arun02_12]

Hello Murugesan,

The link that I gave should work fine. Somehow in your case, the workflow is messing with your Link and changes "&para" to "¶" .

Check if this is caused by your Mail template or if you think workflow is causing it, raise an Incident with SAP to determine at what point the link gets messed up.

Best Regards
Arun

[former_member190150]

Hello Arun,

Thanks for your time and suggestion. I have raised an incident and awaiting for SAP reply.

Once again thanks a lot for your support.

Regards,

Murugesan.

 

 

 

[MG-Moen]

Would anyone happen to know the parameters for a deep link to an Incident?

We have a workflow rule setup to email us when there is an update to an Incident.  We would like to include a link to the Incident directly in the email to make for easy navigation to the Incident.

Regards.

Mike

[former_member480211]

Hello Arun,

great blog!

Is it also possible for leads?

Regards, Sabrina

[arun02_12]

Hello Sabrina,

I have Updated the Blog with the Deep link URL for leads as well. You can check now. 🙂

Best Regards,Arun

[former_member480211]

Thanks a lot Arun, it is working 🙂

 

[Tina_Bednar]

For Visits:

 

https://XXXXXXXX.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_GENE...

 

#VISITID# - is the "short" Visit ID, not the "long" Technical ID

XXXXXXXX - is your Tenant ID

[sybitrfh]

Hello Murugesan,

 

Any news regarding your problem? The URL with identical structure isn't working for us either.

 

Kind regards,

Raphael

[former_member555862]

Hello Arun,

Maybe you can help me. We need to create a link to a document in the library. For example in form of a scoreboard on homepage.

 

Any idea how to achieve this with deeplink.

 

Thanks in advance,

 

Pankaj

[arun02_12]

Dear Michael,

There is a way to deeplink Incident, but it can't be used in Workflow.

https://myNNNNNN.crm.ondemand.com/sap/ap/ui/clogin?bo_ns=http://sap.com/xi/AP/CRM/Global&bo=SAPSuppo...

I think this might help.

Best Regards,

Arun

[arun02_12]

Hello Pankaj,

I don’t think it is possible. Even if you are able to navigate to the Library WCV somehow, it will not e possible to  uniquely identify the documents using the parameters available in URL. Also the line items themselves do not have a View.

Do comment if you are able to figure out any alternative way.

Best Regards,

Arun

[former_member555862]

Hi Arun,

Thanks for the reply. I don't have any solution as of now, but will do share if something comes up in the near future.

 

Pankaj

[arun02_12]

Hi pankajsg,

 

With the New Library Workcenter view, It is now possible to get a deeplink for each library document.

Click on one of the document entry => More ( 3dots at bottom right) => Share

You will get a pop up with the deeplink which points to the respective library entry.

Best Regards,

Arun

 

 

[former_member555862]

Hello Arun,

Thanks for your help. Its really great, but the best would be if I could download the document directly. Right now I takes my to the folder where the document is located.

 

Thanks again, its better than nothing.

 

Pankaj

[former_member555862]

I am also getting an error message when I click on the document, that I otherwise don't get while passing through the library workcenter.

 

Its in german though.

Service nicht erreichbar

Was ist passiert ?

Der Aufruf der URL wurde abgebrochen, da der entsprechende Service nicht verfügbar ist.

[former_member190150]

Hello Arun,

SAP suggested to using the <a href> tag before the URL to avoid this behavior like “&para” to “¶”

We tried and the issue resolved.

Now we want this functionality in Mobile App. Like users using outlook app in their mobile device and received email notification for Opportunity or Lead with deep link URL. If they click that URL then it should open in Mobile C4C App and should land in relevant BO. But it is not opening through C4C Mobile App.

So in the above case I think the deep link URL is different than the existing one. Can you please provide the if the URL is different for Mobile App? or suggest your views.

Thanks in advance.

Regards,

Murugesan.

 

 

 

[former_member190150]

Hello Raphael,

Yes, it is resolved and it is working fine. As per SAP we need to add <a href> tag before the URL.

Regards,

Murugesan.

[arun02_12]

Hello Murugesan,

I am not sure if the navigation  to app on click of a link is possible. 

I am checking on this. I will update as soon as i have a response.

[former_member188834]

Hello Murugesan,

 

it would be great if you pls share the url which is working for you ,

 

regards ,

sudha

[sybitrfh]

Hey Murugesan,

it works for us now.

Thank you.

Regards,
Raphael

[chrigu1]

Hi Arun,

exactly what I was looking for! Thanks. I was able to use this link in a workflow email template successfully.

Regards Christopher.

[former_member207903]

Hello Colleagues,

Is it possible to retrieve via deep links the activities e-mails and phone calls?

Thanks!
Ígor

EDIT: Also, is it possible to go to the screen which shows all information? For instance, navigate to the screen of All Tickets or All Sales Quotes.

[arun02_12]

Parameter types for Email and Phone call are

COD_Email_TT & COD_PhoneCall

 

With deeplink, you can only navigate to the respective TIs. Further navigations can't be controlled.

 

Best Regards,

Arun

 

[former_member574801]

Very good and useful blog!

[tokgozatakan]

Does anyone know how to create deep links for campaigns?

[arun02_12]

Hi Kemal,

I can see that your query is answered.

Updating it here for future reference of others.

https://answers.sap.com/questions/12889388/c4c-how-to-create-deep-links-predetermined-url-for.html

[former_member232768]

Hello Arun,

I am also interested in the topic if a link to mobile app or to windows app is possible. Do you have already an information about it?

Many thanks, Best Regards

Jasmin

[arun02_12]

Hello Jasmin,

 

The link to the mobile app is possible.

If you click on the link, the app should open with the relevant BO instance.

 

Best Regards,

Arun

[prat2]

Hello Everyone,

 

These links just work fine. I have a similar requirement , I want to navigate to C4C Account TI screen form SCP application. Where SCP  application is working as a mashup in C4C.

 

Just for the prototype , i created a HTML mashup with the HTML code.

<html>
<head>
<title>HTML Links</title>
</head>

<body>
<h1>OPEN ACCOUNT</h1>
<a href="https://myXXXXXX.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_GENERIC&node=Root&operation=OnExtInspect&param.InternalID=10022&param.Type=COD_ACCOUNT_TT&sapbyd-agent=TAB">Account</a>
</body>
</html>

 

Mashup View

 

When Click on Account

 

What I am looking for is to navigate to C4C Account TI Screen not to Open. If anybody has any Idea please share.

 

Thank you

[former_member689152]

Useful blog!

[arun02_12]

Thanks. Glad that this helped!!   🙂

[Ankit]

Very Informative Blog Arun, Good Job!!

[hansgrohe_sm]

Great Blog Arun, many thanks!

For standard objects this works perfectly. I’ve tried this for an custom object I created. Unfortunately it does not work properly. The TI opens, but without data. Is there something special I have to consider? Maybe an specific InPort within the TI or TT of the custom object?

Many thanks in advance

[arun02_12]

HI hansgrohe_sm

This feature is not released for Custom BO's as of now.

It is only meant for standard business objects.

However, you can try this once using UUID based URL.

 

Best Regard,

Arun

 

 

[hansgrohe_sm]

Hi Arun,

I was able to access my Custom BO with UUID:

https://myXXXXXX.crm.ondemand.com/sap/byd/nav?bo=YXXXXXX_CUSTOM_TT&nav_mode=TI&param.Key=00163E7A9E7...

Thanks!

Now I am struggling with the standard business object "Promotion":

https://myXXXXXX.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_GENE...

The TI opens but without data. Do you know how to solve it?

Many thanks and regards,

Steven

[wakky]

Does anyone know how to create deep links for InstalledBase?

[wakky]

Hi all,

I asked SAP Product Support and it was resolved.

The format is given in the Help Center Documentation:

https://help.sap.com/viewer/5d3ae4aa1f174b2cb6ec625c93ef8884/LATEST/en-US/186e89d9763d1014b759b19d50...

InstalledBase is "COD_IBASE_TT"

Best Regards.

[mromerocarranz1]

Hi Arun and thanks for sharing! Is there any deeplink to open a C4C Service Ticket in Successfactors App - AskHR ?

Kind regards and thanks

Matías

[thorstenp]

Thanks for the tip. Is it possible to find a customer also with a phone number?

[BenMcGuire]

Excellent blog post. Still useful in 2023!

[praveen_nagaraj]

Hi Arun,

 

My Requirements here it is,

We have created a HTML Mashup in C4C to display some kind of information from external sources under Home section. In that, there will be some hyperlink once user click on that link, it will redirected to Individual Customer in C4C screen as expected but it will be opening the screen in different browser not in the same browser in C4C as per the requirement.

Could you please help me out through mashup in C4C to navigating via Deep link to open Individual customer screen in same browser?

 

Thanks in Advance

 

Regards,

Praveen N

[claudeericlesel]

Hi Arun,

 

Is it planned to enable this feature for "Contracts"?

 

BR,

Claude-Eric Lesellier

[aelghannam]

Hello Arun,

 

Great blog. Are we able to open the link without closing out ALL the other tabs there were already open in the user c4c session ?

 

Thanks

[kai_o]

Hi ,

The deep link should open in a new tab without closing any other open windows .

Reagrds,

Kai

[preethi_bukke]

Hello All,

For your reference, this is how you can add the a href tag in case you are getting special characters in the url when converting to html

<a href="https://myNNNNN.crm.ondemand.com/sap/public/ap/ui/repository/SAP_UI/HTML5/client.html?bo_ns=http://sap.com/thingTypes&bo=COD_GENERIC&node=Root&operation=OnExtInspect&param.InternalID=#ID#&param.Type=COD_SRQ_AGENT_TT&sapbyd-agent=TAB&OBNRedirect=X">link</a>