Skip to Content
Product Information

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

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

42 Comments
You must be Logged on to comment or reply to a post.
  • 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&param.InternalID=#ID#&param.Type=COD_OPPORTUNITY_THINGTYPE&sapbyd-agent=TAB

    Thanks in Advance.

    Regards,

    Murugesan.

  • /
    • 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

      • 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.

         

         

         

        • 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

  • 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

  • For Visits:

     

    https://XXXXXXXX.crm.ondemand.com/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&bo=COD_GENERIC&node=Root&operation=OnExtInspect&param.InternalID=#VISITID#&param.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

       

  • 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

  • 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 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=00163E7A9E771ED9BDE4BF472FEA9260
      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_GENERIC&node=Root&operation=OnExtInspect&param.InternalID=1180&param.Type=COD_PROMOTION_TT&sapbyd-agent=TAB
      The TI opens but without data. Do you know how to solve it?
      Many thanks and regards,
      Steven
    • 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.