With deep links you can perform predefined actions on a PARTcommunity portal, such as for example sign up a user or configure specific parts and assemblies.

Deep links are often used to directly link to products from other pages and direct a user, with this link, to a specific part or part family in a PARTcommunity portal.

Deep links are realized via so-called HTTP request parameters. An HTTP link is usually made up of a domain name and a domain ending. For example: https://www.google.de.

In order to transfer this request parameter to the link, a "?" sign must be added to the link as the first symbol. After the question mark a list of parameters separated by the "&" symbol can follow.

https://www.google.de?param1=wert1

https://www.google.de?param1=wert1&param2=wert2

The link for your PARTcommunity portal will be assigned to you by CADENAS. Usually it is made up of your company or catalog name plus .partcommunity.com:

https://[portalname].partcommunity.com

	Note
	All values must be encoded using the UTF-8 character set. Please make sure, that the page embedding these deep links uses the UTF-8 character set, too. Otherwise you have to encode the links separately. Special care must be taken when using the + sign in your links. The + sign normally is a placeholder for the space sign, if you are not sure always use %2B instead of the + sign.

The following parameters can be transferred to your portal as deep links:

To directly open a defined portal page in PARTcommunity, the page's name has to be passed as parameter page.

page=[page name]

In combination with the portal’s address you will have this request address:

https://[portalname].partcommunity.com?page=[page]

The name of the portal page is the name entered during creation of the page using the PARTcommunity administration tool. All spaces have to be replaced with the + sign.

Do not use the page name translated by the current language, only the original page name will work

Example 1: Open the page „CAD models“:

https://<portalname>.partcommunity.com/?page=CAD+models

Example 2: Open the page „Welcome“:

https://<portalname>.partcommunity.com/?page=Welcome

	Note
	There is no need to add the page parameter in combination with the info parameter. When using the info parameter the portal switches automatically to the page presenting the catalog data.

To force the user to login when calling a deep link you have to use the authentication link of the portal instead of the standard link.

https://<portalname>.partcommunity.com/3d-cad-models/sso

This link can be combined with all previously mentioned parameters in this document.

This link has to be used for all protected QA portals.

To show or hide portlets when opening the portal page you can use the parameters showPortlets and hidePortlets. The following values are valid for these two parameters:

Multiple occurrences are allowed inside of a link for these parameters. To show the portlets after hiding them with the parameter hidePortlets, you must use showPortlets in the next call, otherwise the portlets will keep their current state.

Example:

http://[portalname].partcommunity.com?
 info=...&hidePortlets=navigation&hidePortlets=generation&showPortlets=preview

=> Only the preview is visible.

Embedded portals offer an easier way to get CAD data. There are some special deep links to control the behaviour of an embedded portal.

email

Using the parameter email it’s possible to directly set an email address for CAD download in addition to an info and varset parameter. The user is not able to change this mail address.

	Note
	When using the parameter email you can’t pass any additional user data. This will lead to a very poor tracking of downloads in the statistics tool. To pass user data you have to use the remote login transfer

An embedded portal can be directly integration into a supplier’s homepage or web shop. A widely used technique for is the usage if an Iframe, with the aid of which external contents can seamlessly be integrated in a page.

Example:

<iframe src="https://[portalname].partcommunity.com?
 info=...&varset=..." frameborder="0" height="800px" width="100%"></iframe>

To ensure a correct functionality for Apple’s Safari browser, which is used on all Apple mobile devices, you have to use the following code.Safari does not allow the usage of third-party cookies per default, but the embedded portal inside the Iframe acts like a third-party for Safari.

<iframe id="pcomiframe" width="100%" height="500px"></iframe>     <script>
    var sessionStatus = window.location.search.substring(13,15);
    if(sessionStatus == "OK"){
        document.getElementById("pcomiframe").src ="https://[portalname].partcommunity.com";
    } 
    else {
        window.location.replace("https://[portalname].partcommunity.com/3d-cad-models/iframe?
       return=https://[name-of-embedding-page]");
    }
</script>