Mit Deeplinks können Sie vordefinierte Aktionen in einem PARTcommunity Portal ausführen, wie z.B. einen Benutzer anmelden oder bestimmte Teile und Baugruppen konfigurieren.

Deeplinks werden häufig benutzt, um Produkte in anderen Seiten direkt zu verlinken und den Benutzer über diesen Link auf ein spezielles Teil oder eine Teilefamilie auf einem PARTcommunity Portal zu leiten.

Deeplinks werden über sogenannte HTTP Request Parameter realisiert. Ein http Link besteht normalerweise aus einem Domainnamen und einer Domainendung, z.B. https://www.google.de.

Um nun an diesen Link Request Parameter zu übergeben, muss nach dem eigentlichen Link als erstes Zeichen ein „?“ gehängt werden. Nach dem Fragezeichen folgt nun eine Liste von Parametern, die durch das "&" Zeichen getrennt werden.

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

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

Der Link für Ihr PARTcommunity Portal wird Ihnen von CADENAS mitgeteilt. Normalerweise besteht er aus Ihrem Firmen- oder Katalognamen plus partcommunity.com:

https://[portalname].partcommunity.com

	Hinweis
	Alle Werte müssen UTF-8 kodiert übergeben werden. Bitte achten Sie darauf, dass die Seite, die die Deeplinks aufruft diese Kodierung verwendet, ansonsten müssen die Links gesondert UTF-8 kodiert werden. Besondere Vorsicht ist beim + Zeichen geboten, da dieses Zeichen in URLs als Leerzeichen interpretiert wird. Im Zweifelsfall muss ein + Zeichen als %2B übergeben werden.

Die folgenden Parameter können als Deeplinks an das Portal übergeben werden:

Um in PARTcommunity eine bestimmte Portalseite direkt aufzurufen, muss der Name der Seite als Parameter page übergeben werden.

page=[seitenname]

Zusammen mit der Adresse des Portals sieht es folgendermaßen aus:

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

Der Name der Portalseite ist der Name, der beim Anlegen der Seite im Administrations-Tool von PARTcommunity angegeben wurde. Alle Leerzeichen müssen durch ein + ersetzt werden.

Die aktuelle Sprache spielt dabei keine Rolle, d.h. es darf keinesfalls der übersetzte Seitenname angegeben werden.

Beispiel 1: Aufruf der Seite "CAD models":

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

Beispiel 2: Aufruf der Seite "Welcome":

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

	Hinweis
	Sie müssen keine Portalseite angeben, wenn der Aufruf mit dem info-Parameter erfolgt. Durch diesen Parameter wird automatisch auf die Seite gewechselt, auf der die Katalogdaten dargestellt werden.

Um beim Aufruf eines Deeplinks sofort eine Benutzeranmeldung zu erzwingen, muss anstatt der normalen Portaladresse die Authentifizierungsadresse verwendet werden:

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

Diese Adresse kann mit allen bisher aufgeführten Deeplinks verwendet werden.

Die Authentifizierungsadresse muss z.B. bei geschützten QA-Portalen verwendet werden.

Um bestimmte Portlets beim Aufruf der Seite aus- oder einzublenden können die beiden Parameter hidePortlets und showPortlets benutzt werden. Die folgenden Werte können für diese Parameter angegeben werden:

Die beiden Parameter können in einem Link mehrfach verwendet werden. Um Portlets nach dem Aufruf mit hidePortles wieder anzuzeigen, muss dies zwingend mit showPortlets erfolgen. Ansonsten behalten alle Portlets ihren aktuellen Sichtbarkeitsstatus.

Beispiel:

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

=> Nur die Voransicht ist sichtbar

Embedded Portale ermöglichen einen vereinfachten Download von CAD-Daten und bieten zusätzliche Deeplink-Parameter zur Steuerung an.

email

Mit dem Parameter email kann zusätzlich zu einem info und varset Parameter die E-Mail Adresse eines Benutzers übergeben werden. Der Benutzer selbst kann diese E-Mail Adresse nicht mehr ändern.

	Hinweis
	Beim Aufruf mit dem Parameter email können keine weiteren Benutzerdaten übergeben werden. Eine Auswertung des Downloadverhaltens über das Statistiktool ist damit nicht möglich. Das ist nur mit der Loginübergabe möglich

Ein embedded Portal kann direkt in die Herstellerseite eingebunden werden. Die gebräuchlichste Technik dafür sind sogenannte IFrames, mit denen Fremdinhalte nahtlos in eine Seite eingebunden werden können.

Beispiel:

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

Ein Sonderfall ist der Browser Safari, der auf den Mobilgeräten von Apple zum Einsatz kommt. Dieser Browser unterstützt keine Cookies von Drittanbietern, das embedded Portal gilt in diesem Fall aber als Drittanbieter. Um auch im Safari Browser eine korrekte Darstellung in IFrames zu gewährleisten, muss die Einbindung folgendermaßen erfolgen:

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