HELiOS-URL für Objekttypen
Beim Verwenden des HELiOS-Protokolls, um z. B. von einer externen Software aus HELiOS-Objekte aufzurufen, können anstelle der Kopf-IDs auch Objekttyp-spezifisch
- Dokumentnummer
- Artikelnummer
- Projektnummer
- Mappennummer
- Rohrklassenname
- Benutzerdefinierte Typen (wie z. B. Kundennummer und Werkstoffbezeichnung)
verwendet werden.
Die URL setzt sich in dem Fall aus dem Aufruf des HELIOS-Protokolls ("helios://") dem Anzeige-Befehl für einen bestimmten Objekttyp ("SHOWDOCUMENT", "SHOWARTICLE" oder "SHOWPROJECT"), getrennt durch ein "?" dem entsprechenden HELiOS-Attributtyp ("HEL_DOKUMENTNUMMER", "HEL_SACHNUMMER" oder "HEL_PROJEKTNUMMER) , einem = und der individuellen Objekt-Nummer zusammen.
Beispiele:
- helios://SHOWDOCUMENT?HEL_DOKUNUMMER=ZN-00001 (Aufruf eines Dokumentes mit der Dokumentnummer "ZN-00001")
- helios://SHOWARTICLE?HEL_SACHNUMMER=SN-000001 (Aufruf eines Artikels mit der Artikelnummer "SN-000001")
- helios://SHOWPROJECT?HEL_PROJNUMMER=PN-01-06-K (Aufruf eines Projekts mit der Nummer "PN-01-06-K" )
- helios://SHOWFOLDER?HEL_MAPNUMMER=Mappe1 (Aufruf einer Mappe mit der Mappennummer "Mappe1")
-
helios://SHOWUTO?HEL_SAMMEL=Werkstoff&BZ=S355J2G4 (Aufruf eines Werkstoff mit der Bezeichnung "S355J2G4 ")
-
helios://SHOWUTO?HEL_SAMMEL=Kunde&KUNDENNUMMER=1000 (Aufruf von Kundendaten mit der Kundennummer "1000")
-
helios://SHOWPIPECLASS?HEL_RKLNAME=RN-00008 (Aufruf einer Rohrklasse mit dem Klassennamen "RN-00008")
Zusätzlich können Suchkriterien mittels "&" verbunden werden, z. B.:
-
helios://SHOWARTICLE/?HEL_SACHNUMMER=SN-030569&BENENNUNG=Quader
Dabei können Strings auch in Hochkommata gesetzt werden, z. B.:
-
helios://SHOWARTICLE/?HEL_SACHNUMMER=SN-030569&BENENNUNG='Quader'
Nach Aufruf einer URL wird die entsprechend HELiOS-Objektdetailmaske geöffnet.
Kann eine URL nicht aufgerufen werden erscheint eine entsprechende Fehlermeldung.
Dabei wird zur genaueren Information unterschieden zwischen Nicht-Eindeutigkeit einer eingegeben URL (Fehlermeldung "Die angewählte HELiOS-URL beschreibt mehr als ein Objekt.") und der Nicht-Exiztent einer URL (Fehlermeldung: "Zu der angewählten HELiOS-URL wurde kein Objekt gefunden.")
Im letztgenannten Fall kann z. B.auch ein Syntaxfehler vorliegen.
Hinweise:Als möglicher Anwendungsfall ist z. B. denkbar, dass in einer Excel-Tabelle HELiOS-Dokumente und oder -Artikel mit diversen Attributen wie eben der Dokumentnummer bzw. der Artikelnummer aufgelistet sind. Es ließe sich ein Makro erstellen, der über Formeln zu jedem dieser HELiOS-Objekte den Link entsprechend "zusammensetzt" und zum Direktzugriff per Mausklick einer Tabellenspalte hinzufügt.
Achtung: Leerzeichen in Attributwerten werden beim URL-Aufruf nicht unterstützt.
