Product Information
How to construct a Deep link URL for C4C Business Objects using Business object ID?
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¶m.InternalID=[x]¶m.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¶m.InternalID=#ID#¶m.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¶m.InternalID=#ID#¶m.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¶m.InternalID=#ID#¶m.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¶m.InternalID=#ID#¶m.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¶m.InternalID=#ID#¶m.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¶m.InternalID=#ID#¶m.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¶m.InternalID=#ID#¶m.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¶m.InternalID=#ID#¶m.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¶m.InternalID=#ID#¶m.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¶m.InternalID=#ID#¶m.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
Awesome blog 🙂 good job! kudos!
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.
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_GENERIC&node=Root&operation=OnExtInspect¶m.InternalID=#ID#¶m.Type=COD_OPPORTUNITY_THINGTYPE&sapbyd-agent=TAB
Thanks in Advance.
Regards,
Murugesan.
Hello Murugesan,
Can you try
https://myXXXXXX-sso.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_GENERIC&node=Root&operation=OnExtInspect¶m.InternalID=#ID#¶m.Type=COD_OPPORTUNITY_THINGTYPE&sapbyd-agent=TAB&OBNRedirect=X
I have just appended “&OBNRedirect=X” to your link.
I hope it works.
Best Regards,
Arun
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_GENERIC&node=Root&operation=OnExtInspect¶m.InternalID=28686¶m.Type=COD_OPPORTUNITY_THINGTYPE&sapbyd-agent=TAB&OBNRedirect=X
Hello Murugesan,
The link that I gave should work fine. Somehow in your case, the workflow is messing with your Link and changes "¶" 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
Hello Arun,
SAP suggested to using the <a href> tag before the URL to avoid this behavior like “¶” 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.
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.
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
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
Hello Murugesan,
it would be great if you pls share the url which is working for you ,
regards ,
sudha
For your reference, this is how you can add the 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¶m.InternalID=#ID#¶m.Type=COD_SRQ_AGENT_TT&sapbyd-agent=TAB&OBNRedirect=X">link</a>
Hello Murugesan,
Any news regarding your problem? The URL with identical structure isn't working for us either.
Kind regards,
Raphael
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.
Hey Murugesan,
it works for us now.
Thank you.
Regards,
Raphael
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.
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
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=SAPSupportRequest&node=Root&operation=OpenKeyUserOIF&object_key=#IncidentID#&key_type=APC_S_BTD_ID&saml2=disabled&OBNRedirect=X
I think this might help.
Best Regards,
Arun
Hi Arun,
exactly what I was looking for! Thanks. I was able to use this link in a workflow email template successfully.
Regards Christopher.
Hello Arun,
great blog!
Is it also possible for leads?
Regards, Sabrina
Hello Sabrina,
I have Updated the Blog with the Deep link URL for leads as well. You can check now. 🙂
Best Regards,Arun
Thanks a lot Arun, it is working 🙂
For Visits:
https://XXXXXXXX.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_GENERIC&node=Root&operation=OnExtInspect¶m.InternalID=#VISITID#¶m.Type=COD_VISIT_TT&sapbyd-agent=TAB
#VISITID# - is the "short" Visit ID, not the "long" Technical ID
XXXXXXXX - is your Tenant ID
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
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
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
Hi Pankaj Sharma,
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
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
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.
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.
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
Very good and useful blog!
Does anyone know how to create deep links for campaigns?
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
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.
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
Useful blog!
Thanks. Glad that this helped!! 🙂
Very Informative Blog Arun, Good Job!!
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
HI Steven Montgomery ,
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
Hi Arun,
I was able to access my Custom BO with UUID:
Does anyone know how to create deep links for InstalledBase?
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/186e89d9763d1014b759b19d50be576b.html
InstalledBase is "COD_IBASE_TT"
Best Regards.
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
Thanks for the tip. Is it possible to find a customer also with a phone number?
Excellent blog post. Still useful in 2023!
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
Hi Arun,
Is it planned to enable this feature for "Contracts"?
BR,
Claude-Eric Lesellier
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
Hi ,
The deep link should open in a new tab without closing any other open windows .
Reagrds,
Kai
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¶m.InternalID=#ID#¶m.Type=COD_SRQ_AGENT_TT&sapbyd-agent=TAB&OBNRedirect=X">link</a>
Hi everyone,
I just tried to construct an URL for an employee-user. This seems not to work, I always get am "empty" employee-page in C4C when calling the URL, see screeenshot below.
Here is the URL I construct:
https://myXXXXXX.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_GENERIC&node=Root&operation=OnExtInspect¶m.InternalID=<EMPLOYEE-ID>¶m.Type=COD_EMPLOYEES
Am I doing something wrong? When I construct URLs for contacts (param.Type=COD_CONTACT_TT) or accounts (param.Type=COD_ACCOUNT_TT) this works as expected, just employees with param.Type=COD_EMPLOYEES seems not to work.
Does anyone have an idea about this?
Kind regards and thanks in advance!
Mirco