Home

WCM Web Services Programmers Manual deutsch

Contents

1. Applikation Web Service Client Abb 3 Methodenaufruf eines Web Service Clients WCM WebServices Programmierhandbuch 25 Kapitel 2 2 2 WCM WebServices WCM WebServices ist eine Programmierschnittstelle die den Zugriff auf Funktionen bzw Methoden von Livelink WCM Server erm glicht Mithilfe von WCM WebServices kann von einem beliebigen Rechner ber das Internet auf einen Content Server und damit auf die WCM verwalteten Inhalte zugegriffen werden Die auf diese Weise verf gbaren Methoden k nnen in einer beliebigen Programmiersprache aufgerufen werden WCM WebServices bietet Ihnen folgende Leistungsmerkmale m Unterst tzung aller innerhalb von Livelink WCM Server verwendeten Datentypen m lesender und schreibender Zugriff auf den Inhalt der WCM Objekte Unterst tzung des Staging Konzepts von Livelink WCM Server Ausf hren komplexer Suchanfragen Bereitstellung von Content Workflow mit dem das dreistufige Staging Konzept um eigene Workflow Schritte erweitert werden kann Der Content Server der im Kontext einer JSP Engine bzw als Weban wendung in einem Application Server l uft stellt f r jede Website eine WSDL Datei bereit Diese enth lt alle unterst tzten Datentypen und Methoden Pro Website kann es individuell definierte Attributmengen geben Aus diesem Grund muss f r jede Website eine WSDL Datei zur Verf gung stehen 26 Livelink WCM Server Konzepte Das f r den Nachrichtenaustausch ver
2. frame boolean Dieser Wert ist genau dann wahr wenn der Objekttyp ein Frame ist imageURL String URL auf die Datei des Symbols das den Objekttyp repr sentiert Dabei ist die URL abh ngig von dem Deploy mentsystem das WCM WebServices zugeordnet ist Wenn kein Deploy mentsystem f r diese Website existiert wird hier null geliefert mimeType String Zum Objekttyp geh riger MIME Typ name String Name des Objekttyps template boolean Dieser Wert ist genau dann wahr wenn der Objekttyp eine Vorlage ist topic boolean Dieser Wert ist genau dann wahr wenn der Objekttyp ein Thema ist WCM WebServices Programmierhandbuch 85 Kapitel 5 Datentyp ObjectState Allgemeine Informationen zum Status von WCM Objekten erhalten Sie im Abschnitt Objektstatus auf Seite 30 Der Datentyp ObjectState reprasentiert den Status im Lebenszyklus eines WCM Objekts Tabelle 15 Die einzelnen Objektstatus Status Beschreibung checked_out Das WCM Objekt wurde ausgeliehen deleted Das WCM Objekt wurde gel scht edited Das WCM Objekt wurde ge ndert Metadaten oder Inhalt rejected Das WCM Objekt wurde abgelehnt released Das WCM Objekt wurde freigegeben release_at Das WCM Objekt wurde freigegeben wird jedoch erst sp ter ver ffentlicht submitted Das WCM Objekt wurde der Qualit tssicherung vorgelegt Die folgende T
3. auf Seite 92 remark String Zeichenkette die zum Protokoll s mt licher erzeugter WCM Objekte hinzugef gt wird oder null dplWaitInf DeploymentWait Liste der Deploymentsysteme oder Info null R ckgabe ObjectId objectId die OID des Startobjekts f r den Import Voraussetzungen Erforderliche Zugriffsrechte auf das bergeordnete Thema READ und CREATE m Objektstatus keine Einschr nkungen m Die ben tigten Funktionsbereiche h ngen von den zu erzeu genden Objekttypen ab Folge Nach dem Import haben s mtliche neu angelegten WCM Objekte den Status EDITED 144 Livelink WCM Server Objektverwaltung restoreVersion Stellt eine fr here Version des angegebenen WCM Objekts wieder her Parameter Tabelle 70 Parameter der Methode restoreVersion Parameter Datentyp Beschreibung oid ObjectId OID des betreffenden WCM Objekts version Version Gew nschte Version des WCM Objekts remark String Zeichenkette die zum Protokoll des WCM Objekts hinzugef gt wird oder null dplWaitInfo DeploymentWaitInfo Liste der Deploymentsysteme oder null R ckgabe keine Voraussetzungen Erforderliche Zugriffsrechte READ WRITE und WRITE_META m Objektstatus muss EDITED REJECTED RELEASED oder PENDING RELEASE sein Folge Nach der Wiederherstellung der angegebenen Version hat das WCM Objekt den Status EDITED WCM WebServices Programmierhandbuch 145 Kapitel 5 sortPa
4. members User Liste der Benutzer die zu dieser Gruppe bzw Rolle geh ren initially Permission Erlaubte Standard Objektrechte der Granted Gruppe bzw Rolle Diese Rechte Permissions werden als erlaubt eingetragen wenn die Gruppe bzw Rolle der Zugriffs steuerungsliste ACL eines WCM Objekts hinzugef gt wird initially Permission Verbotene Standard Objektrechte der Denied Gruppe bzw Rolle Diese Rechte Permissions werden als verboten eingetragen wenn die Gruppe bzw Rolle der Zugriffssteuerungsliste ACL eines WCM Objekts hinzugef gt wird Methoden zum Auslesen von Profilen Das Profil eines Benutzers einer Gruppe oder einer Rolle wird ber die Methoden getUserProfiles getGroupProfiles und getRoleProfiles ermittelt Diese Methoden liefern jeweils ein Array aus dem Datentyp User Group bzw Role zur ck Dieses Array enth lt genau die Principals die den bergebenen Filterbedingungen entsprechen Zur Festlegung der Filterbedingung werden Daten vom Typ Filter und den davon abgeleiteten Datentypen benutzt Diese Datentypen werden im Abschnitt 5 6 Suchen nach WCM Objekten ab Seite 147 beschrieben F r die Suche nach Benutzern Gruppen oder Rollen gelten die folgenden Einschr nkungen m Es k nnen nur EqualFilter LikeFilter und StringContainsFilter verwendet werden F r die logische Verkn pfung sind AndFilter OrFilter und NotFilter zugelassen WCM WebServices Programmierha
5. ZL gt B Ge gh Objects Members of YipwebService oy Group n Endrelease System IAsyncResult g GroupRole EndrestoreVersion System IAsyncResult g IntegerValue EndsortParentsFirst System IAsyncResult oy IsNullFilter Endsubmit System IAsyncResult bend JoinFilter EndsubstituteLogin System IAsyncResult oy Kernelyersion EndundoCheckOut System IAsyncResult bg Key filter Filter ObjectId Sort int int string oy LessFilter amp generatePage string ObjectId bool DeploymentWaitInFo LessOrEqualFilter get ObjectId Version string LikeFilter get ttributeSets Link getCheckOutContent ObjectId Version g LinkInfo getCchildren ObjectId int bed Locale getContent ObjectId Version oy Localeyalue getDeploymentJobs string ObjectId bed LogEntry getDeploymentSystemststring Longvalue getExternalLinkstObjectid oy MultilmportPart getFunctional reast oy NotEqualFilter getGroupProfiles Filter Sort int int 2 NotFilter getLanguagest oy ObjectCategory getLastLogEntries ObjectId int int F 2 ObjectData getObjectCategories 2 ObjectId getParent ObjectId int bool eg ObjectIdInList getRoleProfiles Filter Sort int int 92 ObjectState getRunlevel g ObjectType getUserProfiles Filter Sort int int OrFilter getVersionList ObjectId eg Permission getYIPYersion eg Permissio
6. title Der Titel des WCM Objekts attributeKeys Die Liste der Namen der gesetzten Attribute mindestens deploymentHint objectType title WCM WebServices Programmierhandbuch 93 Kapitel 5 Datentypen fur Workflow Aktionen In Livelink WCM Server k nnen die vordefinierten Staging Stufen Bear beitung Qualit tssicherung Ver ffentlichung im Produktionsbetrieb um eigene Workflow Schritte erweitert werden um z B eine Bearbeitung durch mehrere Redakteure oder eine mehrstufige Qualitatssicherung durchzuf hren Jede Workflow Definition besteht aus beliebig vielen Aktivit ten und ber g ngen Einer Aktivit t ist jeweils ein Principal Benutzer Gruppe oder Rolle zugeordnet der das Objekt bearbeiten und im Workflow weiter leiten darf Die drei Aktivit tstypen Bearbeiten QS und L schen repr sentieren die Aufgabe des zugeordneten Principals Mithilfe der berg nge wird das WCM Objekt von einer Aktivit t zur n chsten weiter geleitet Die notwendigen Staging berg nge werden dabei automatisch im Hintergrund ausgef hrt F r das Arbeiten mit Content Workflow stehen vier Datentypen zur Verf gung Workflow m Activity Transition WorkflowNavigationInfo Datentyp Workflow Ein Objekt vom Typ Workflow repr sentiert eine so genannte Workflow Definition in der die einzelnen Workflow Schritte festgelegt sind Work flow Definitionen werden ber den Content Workflow Modeler ange
7. 38 Livelink WCM Server KAPITEL 3 Einsatz von WCM WebServices Diese Kapitel beschreibt die erforderliche Konfiguration fur den Einsatz von WCM WebServices Au erdem behandelt es die WCM WebServices Beschreibung und die Meldungen in Fehlersituationen 3 1 Konfiguration Damit Benutzer Uber WCM WebServices auf Ihr WCM System zugreifen k nnen sind folgende Konfigurationsma nahmen erforderlich Einrichten eines Servlet Mappings Anpassungen in der Konfiguration von Livelink WCM Server Hinweise Wenn Sie zum Einbinden des Content Servers in einen Application Server eine Webanwendung WAR Datei Uber den Admin Client erzeugen dann erfolgt die notwendige Konfiguration automatisch Falls Sie mit dem MS Internet Information Server arbeiten schalten Sie aus Performance Gr nden den Cache f r die ISAPI Applikationen f r die Website ein WCM WebServices Programmierhandbuch 39 Kapitel 3 Servlet Mapping einrichten Richten Sie ein Servlet Mapping f r das WCM WebServices Servlet Klasse de gauss vip webservice transport WebServiceServlet in der Konfiguration des Application Servers bzw der JSP Engine ein Das Mapping f r Application Server die die Servlet Spezifikation 2 2 erf llen erfordert folgende Eintr ge in der Datei web xml Diese Datei befindet sich im Verzeichnis WEB INF der Webanwendung in der der Content Server gestartet wird lt servlet gt lt servlet name gt WebServiceServlet lt ser
8. Erlaubt Serialisierung und Deserialisierung ObjectType GenericFilter Erzeugt die XML Serialisie Filter samtliche rung der WCM Filter Objekte WCM Filter Da es in VBA keine Verer bung gibt ist die Implementierung etwas aufwendig User Serialisiert und deserialisiert User die WCM User Objekte Value Serialisiert und deserialisiert Value die WCM Value Objekte StringValue DateValue LongValue Version Serialisiert und deserialisiert Version die WCM Version Objekte Locale Serialisiert und deserialisiert Locale die Java Locale Objekte 164 Livelink WCM Server Anwendungsbeispiele Verbindungsaufbau Modul VipWebServiceClient Der Web Service der Website InternetSite steht unter der URL http wcemserver company example wcem WebsService Port InternetSite edit zur Verf gung Ersetzen Sie dabei bitte die einzelnen Bestandteile der URL durch die Werte in Ihrer Konfiguration Der SoapConnector ben tigt die folgenden Properties EndPointURL m AuthUser Benutzerkennung des WCM Benutzers der auf die Daten zugreifen soll m AuthPassword Passwort des WCM Benutzers VipWebServiceClient SOAP Encoding Namespace URI Private Const SOAP_ENCODING_NS_URI _ http schemas xmlsoap org soap encoding Private Const VIP_NAMESPACE_URI http gaussvip com instance variables Private serializer As SoapSerializer Private Connector As SoapConnector Private Su
9. Livelink WCM Server WCM WebServices Programmierhandbuch Dieses Handbuch beschreibt die Web Services Programmierschnittstelle mit der tiber das Internet auf Funktionen und Methoden von Livelink WCM Server zugegriffen werden kann Sie erhalten Informationen zu folgenden Themen e grundlegende Konzepte von WCM WebServices e Einsatz von WCM WebServices e Zugriff auf Administrationsdaten und Authentifizierung sowie Objektverwaltung ber WCM WebServices e Anwendungsbeispiele OPEN TEXT Great Minds Working Together corRPORA TION Copyright 2005 Open Text Corporation Das Copyright an diesen Unterlagen und der dazugeh rigen Software geh rt ohne Einschr nkungen Open Text Diese Unterlagen und die dazugeh rige Software d rfen ohne die ausdr ckliche schriftliche Genehmigung von Open Text weder ganz noch teilweise kopiert werden Die Open Text Corporation ist Eigent mer der Warenzeichen Open Text Great Minds Working Together Livelink MeetingZone u a diese Liste ist nicht vollst ndig Andere erw hnte Warenzeichen sind Eigentum des jeweiligen Unternehmens und werden nur zum Zweck der Identifizierung der Produkte und Unternehmen verwendet Alle Rechte vorbehalten F r die in diesem Dokument beschriebene Software der Open Text Corporation gelten bestimmte Gew hrleistungen und Einschr nkungen Informationen zu diesen Gew hrleistungen und Einschr nkungen erhalten Sie in dem Lizenzvertrag der zwischen dem Lize
10. Protokoll Stack f r Web Services In der untersten Schicht des Protokoll Stacks findet der Datentransport Uber das Standard Protokoll HTTP statt Oberhalb dieser Schicht erfolgt der XML basierte Datenaustausch Uber den Standard SOAP Der Stan dard beschreibt den Web Service Innerhalb der obersten Schicht wird der UDDI Standard zur Ver ffentlichung des Dienstes in einem UDDI Verzeichnis verwendet Diese Schicht ist optional UDDI ist fur die Funkti onalitat von Web Services nicht zwingend erforderlich Web Services Workflow Die folgenden Schritte fassen die Bereitstellung und Nutzung eines Web Service inklusive der jeweils verwendeten Standards zusammen 1 Der Dienstanbieter erstellt einen Web Service 2 Er liefert eine Beschreibung des Web Service und verwendet dazu den Standard WSDL WCM WebServices Programmierhandbuch 23 Kapitel 2 3 Der Dienstanbieter lasst den Web Service in einem UDDI Verzeichnis registrieren Dieser Vorgang ist optional 4 Ein anderer Web Service oder Benutzer ermittelt den registrierten Web Service ber eine Suche in einem UDDI Verzeichnis das auch die erforderliche Beschreibung liefert Alternativ kann die Beschrei bung dem Dienstnehmer auch direkt vom Dienstanbieter zur Verf gung gestellt werden Anschlie end f hrt der Dienstnehmer einen Request an den ermit telten Web Service durch 5 Der Web Service bzw Benutzer der den Request durchf hrt verwendet eine Applikation um ein
11. int Zahl die das erste Element des Sucher gebnisses angibt meistens 0 numberOfResults int Anzahl der zur ckzuliefernden Sucher gebnisse beginnend bei startResult 1 f r alle Ergebnisse attr ibuteKeys 152 String Namen aller Attribute die in den zur ck gelieferten Objektdaten gesetzt sein sollen Livelink WCM Server Objektverwaltung R ckgabe ObjectData objectData Eine Liste von Objektdaten Dies sind die Daten der WCM Objekte auf die das angegebene Suchkriterium passt Voraussetzungen Erforderliches Zugriffsrecht READ m Objektstatus keine Einschr nkungen Folge Der Objektstatus ndert sich nicht WCM WebServices Programmierhandbuch 153 154 Livelink WCM Server KAPITEL 6 Anwendungsbeispiele Ein zentrales Anliegen der Web Service Technologie ist das einfache Auffinden und die einfache Verwendung eines Web Service Der erste Punkt wird von UDDI bernommen und ist nicht Thema dieses Hand buchs Da sich Web Services durch WSDL selbst beschreiben gibt es von vielen Herstellern Werkzeuge die eine Web Service Definition einlesen und automatisch in ein f r eine Client Anwendung nutzbares Modul umwandeln Als Anwendungsentwickler binden Sie dieses Modul in Ihre Entwicklungsumgebung ein und schreiben Ihre Anwendung in der von dem Werkzeug unterst tzten Programmiersprache In diesem Kapitel wird an zwei Beispielen gezeigt wie WCM WebServices genutzt werde
12. lt objectId href id10 gt lt objectState href id7 gt lt title xsi type xsd string gt 8 0 1 contentManagerUserManual_en lt title gt lt multiRef gt lt multiRef id id1 SOAP ENC root 0 xsi type ns7 0bjectData xmins ns7 http gaussvip com xmins SOAP ENC http schemas xmlsoap org soap encoding gt lt createdDate xsi type xsd dateTime gt 2002 04 17T16 45 06 000Z lt createdDate gt lt objectId href id11 gt lt objectState href id7 gt lt title xsi type xsd string gt VipNote20_PomaMigration_en lt title gt lt multiRef gt lt multiRef id id6 SOAP ENC root 0 xsi type ns8 ObjectId xmins ns8 http gaussvip com xmins SOAP ENC http schemas xmlsoap org soap encoding gt lt id xsi type xsd string gt 62 lt id gt lt multiRef gt lt multiRef id id9 SOAP ENC root 0 xsi type ns9 ObjectId xmins ns9 http gaussvip com xmins SOAP ENC http schemas xmlsoap org soap encoding gt lt id xsi type xsd string gt 61 lt id gt lt multiRef gt lt multiRef id id10 SOAP ENC root 0 xsi type ns10 ObjectId xmins ns10 http gaussvip com xmins SOAP ENC http schemas xmlsoap org soap encoding gt lt id xsi type xsd string gt 60 lt id gt lt multiRef gt lt multiRef id id8 SOAP ENC root 0 xsi type ns11 ObjectId xmins ns11 http gaussvip com xmins SOAP ENC http schemas xmlsoap org soap encoding gt lt id xsi type xsd string gt 59 lt
13. m Objektstatus keine Einschr nkungen Folge Der Objektstatus ndert sich nicht getParent Liefert die OIDs der WCM Objekte die in der angegebenen Ansicht view dem spezifizierten WCM Objekt bergeordnet sind Eltern Objekte WCM WebServices Programmierhandbuch 139 Kapitel 5 Parameter Tabelle 66 Parameter der Methode getParent Parameter Datentyp Beschreibung oid ObjectId OID des WCM Objekts view int 1 Themenbaumansicht 2 Vorlagenansicht 3 Verbundobjektansicht toRoot boolean true falls alle Eltern Objekte bis zur Wurzel zur ckgeliefert werden sollen R ckgabe ObjectId objectIds Eine Liste von OIDs der angeforderten Eltern Objekte Hatte toRoot den Wert false so wird genau ein Objekt zur ckgeliefert F r das Wurzel Objekt wird eine leere Liste zur ckgeliefert Voraussetzungen Es sind keine Zugriffsrechte erforderlich m Objektstatus keine Einschr nkungen Folge Der Objektstatus ndert sich nicht getVersionList Liefert die vollst ndige Liste aller Versionen des angegebenen WCM Objekts 140 Livelink WCM Server Objektverwaltung Parameter Tabelle 67 Parameter der Methode getVersionList ObjectId OID des betreffenden WCM Objekts R ckgabe Version versions die angeforderte Liste aller Versionen zum gegebenen WCM Objekt Voraussetzungen Erforderliches Zugriffsrecht READ m Objektstatus keine Einschr nkungen
14. modi f iedBy Locale User A A F r das WCM Objekt verwendete Sprache Locale A A Kennung des Benutzers der das WCM Objekt zuletzt ge ndert hat modifiedDate dateTime a Datum mit Uhrzeit an dem das WCM Objekt zuletzt ge ndert wurde objectCategory objectId String ObjectId a aA f Name der Objektkategorie des WCM Objekts oder null wenn das WCM Objekt keiner Objektkategorie zugeordnet ist a OID die das WCM Objekt innerhalb einer Website eindeutig identifiziert WCM WebServices Programmierhandbuch 81 Kapitel 5 Attribut Datentyp Beschreibung objectState ObjectState A Aktueller Bearbeitungsstatus des WCM Objekts objectType ObjectType aoa Objekttyp des WCM Objekts Dieser kann im Rahmen der Regeln fur kompatible Objekttypen geandert werden pathname String d A Pfadname der generierten Seite des WCM Objekts Dieser h ngt vom Deploymentsystem ab Wenn kein Deploymentsystem f r diese Website existiert steht hier null pending ReleaseDate dateTime 3 Q Datum mit Uhrzeit an dem die Objektversion in der Produktions sicht ver ffentlicht werden soll possible Actions String M gliche Staging Aktionen die mit dem aktuellen Status des WCM Objekts und den Rechten des Benutzers durchgef hrt werden k nnen QAEMail Receivers String Q f E Mail Adressen die zur Benac
15. Das Ergebnis kann sortiert werden durch Spezifizieren einer Liste von Sortierobjekten die die zu sortierenden Attribute und die Sortierrei henfolge festlegt Es ist au erdem m glich Spezialattribute zur Konstruktion eines Suchfilters zu verwenden Hinweis Bei der Angabe von Spezialattributen f r die Sortierung der Ergebnisliste arbeitet die fi Lter Methode zurzeit noch nicht einwandfrei WCM Objekte f r die der Benutzer der Methode keine Leserechte hat werden automatisch von der Suche ausgeschlossen Das WCM Objekt das als Startpunkt der Suche definiert wird muss ein Thema sein WCM WebServices Programmierhandbuch 151 Kapitel 5 Die Ergebnismenge kann durch startResult und numberOfResults begrenzt werden Parameter Tabelle 73 Parameter der Methode filter Parameter Datentyp Beschreibung filter Filter Suchkriterium oder null um nach allen Objekten zu suchen startOID ObjectId Durch die Angabe der OID eines Startkno tens erfolgt die Suche erst unterhalb des angegebenen WCM Objekts In diesem Fall werden der Startknoten startOID selbst und alle in der Themenstruktur untergeordneten WCM Objekte ber cksichtigt Die startOID muss ein WCM Objekt vom Typ Thema referenzieren sortList Sort Liste von Attributkonstanten nach denen die Ergebnismenge sortiert werden soll Standardm ig werden die gefundenen WCM Objekte nach der OID sortiert startResult
16. VipObjectApplication VipUserApplication Abb 5 Applications des Content Servers 42 Livelink WCM Server Einsatz von WCM WebServices Parameter der Application WebServiceApplication festlegen Damit Benutzer Uber WCM WebServices auf die Inhalte Ihres WCM Systems zugreifen k nnen m ssen Sie den Zugriff auf die betreffenden Websites explizit erlauben Dies erreichen Sie ber entsprechende Para metereinstellungen der Application WebServiceApplication Die Parameter definieren Sie ber Konfiguration gt Applications gt WebServiceApplication gt Parameter gt Parametername Konfiguration m Pools T Aone Verbindungstypen deniedWebsites InternetSite Companylntranet wy Websites L Deploymentsysteme E 7 Server Agenten B Dienstprogramme Repositories Applications E E ClickStreamApplication E LivelinkApplication VipDAVApplication E VipHCLApplication E E VIPHTMLClientApplication E VipObjectApplication E Wert JallowedvVebsites amp amp amp Of VipUserApplication WebSerniceApplication Repositories Parameter allowedVebsites denied Vebsites Abb 6 Parameter der Application WebServiceApplication Die Application WebServiceApplication verf gt standardm ig Uber die Parameter allowedWebsites und deniedWebsites m allowedWebsites Geben Sie eine durch Komma separierte Liste von Website Namen an Auf diese Web
17. amp 2 amp ee Bw Adresse Kttp flocalhost VipWebServiceclient default aspx Wechseln zu Links submitted 8 0 1 contentManagerAdminManual en 17 04 2002 18 45 57 r submitted VipNote18 WebSphere en 17 04 2002 18 45 51 69 submitted VipNote 25 ComiMisration en 17 04 2002 18 45 50 68 ejected VipNote 23 Migration8To8 en 17 04 2002 18 45 49 67 rejected VipNote 22 MigrationSTo8 en 17 04 2002 18 45 47 66 rejected VipNote 21 TagLibraries en 17 04 2002 18 45 46 65 submitted 8 1 portalManagerClassDiagram 17 04 2002 18 45 45 64 rejected 8 1 editOnProIntegration en 17 04 2002 18 45 42 63 rejected 8 0 contentDirectorManual en 17 04 2002 18 45 37 62 changed 8 0 1 portallManagerProgrammersManual en 17 04 2002 18 45 32 61 submitted 8 0 1 contentMinerManual_en 17 04 2002 18 45 24 60 rejected 8 0 1 contentManagerUserManual_en 17 04 2002 18 45 18 changed 8 0 1 contentManagerProgrammersManual_en 17 04 2002 18 45 08 submitted VipNote20 PomaMigration en 17 04 2002 18 45 06 2 Release Submit amp Release l Reject o o E o m a a o o o o o B y Lokales Intranet Abb 13 Die Beispielanwendung Liste aller PDF Dateien WCM WebServices Programmierhandbuch 181 Kapitel 6 Mail Microsoft Internet Explorer Datei Bearbeiten Ansicht Favoriten Extras Q zr ck z x a O JO Suchen
18. dplWaitInfo DeploymentWaitInfo Liste der Deploymentsysteme oder null R ckgabe ObjectId objectId die OID des neuen kopierten WCM Objekts Voraussetzungen Erforderliche Zugriffsrechte auf das kopierte WCM Objekt READ TREE_OPERATIONS und WRITE_META Erforderliche Zugriffsrechte auf das Zielthema READ und CREATE m Objektstatus muss EDITED REJECTED RELEASED oder PENDING RELEASE sein WCM WebServices Programmierhandbuch 127 Kapitel 5 Folge Der Status des kopierten WCM Objekts des Quellobjekts andert sich nicht Die neu angelegte Kopie erh lt den Status EDITED create Erzeugt ein neues WCM Objekt mit den angegebenen Metadaten Die Vorlage in den Objektdaten objectData template darf null sein Parameter Tabelle 54 Parameter der Methode create Parameter Datentyp Beschreibung objectData ObjectData Fur ein neues Objekt mussen mindestens die Attribute topic objectType und title ange geben werden Soll das neue Objekt auf einer Vorlage basieren so ist auch template anzugeben Zugriffsrechte ACL k nnen hier noch nicht definiert werden content byte Inhalt des Objekts oder null falls kein Inhalt angegeben werden soll remark String Zeichenkette die zum Protokoll des WCM Objekts hinzugef gt wird oder null dplWaitInfo DeploymentWaitInfo Liste der Deploymentsysteme oder null R ckgabe ObjectId objectId die OID des neu erzeugten WCM Ob
19. gew hrten oder verweigerten Zugriffsrecht Tabelle 21 Die Komponenten des Datentyps AclEntry Attribut Datentyp Beschreibung permission Permission Zugriffsrecht das dem Principal von diesem AclEntry zugewiesen wird policy boolean Definiert ob dem Principal das Zugriffsrecht gew hrt wahr oder verweigert falsch werden soll principal Principal Zugeh riger Principal ACL eines WCM Objekts ndern So ndern Sie die ACL eines WCM Objekts 1 Erzeugen Sie f r jeden Principal der in der neuen ACL vorkommen soll ein entsprechendes User Group Role bzw GroupRole Objekt 2 Erzeugen Sie f r jede Rechteart die in der ACL definiert werden soll ein entsprechendes Permission Objekt 3 Erzeugen Sie mit den angelegten Principal und Permission Objekten f r jedes Recht das gew hrt bzw verweigert werden soll ein AclEntry Objekt In diesem AclEntry Objekt wird ber das Attribut policy gesteuert ob das Recht gew hrt true oder verwei gert false wird 4 Legen Sie ein Array von AclEntries an in das die gerade erzeugten AclEntries eingetragen werden WCM WebServices Programmierhandbuch 91 Kapitel 5 5 Mit diesem Feld wird das entries Attribut eines Ac1 Objekts gesetzt das owner und inherited Attribut spielen dabei keine Rolle 6 Belegen Sie folgende Attribute eines Obj ectData Objekts mit folgenden Werten das ACL Attribut mit dem erzeugten Ac1 Objekt m
20. http schemas xmlsoap org soap encoding gt lt createdDate xsi type xsd dateTime gt 2002 04 17T16 45 32 000Z lt createdDate gt lt objectId href id6 gt lt objectState href id7 gt lt title xsi type xsd string gt 8 0 1_ portalManagerProgrammersManual_en lt title gt lt multiRef gt lt multiRef id id2 SOAP ENC root 0 xsi type ns4 0bjectData xmins ns4 http gaussvip com xmins SOAP ENC http schemas xmlsoap org soap encoding gt lt createdDate xsi type xsd dateTime gt 2002 04 17T16 45 08 000Z lt createdDate gt lt objectId href id8 gt lt objectState href id7 gt lt title xsi type xsd string gt 8 0 1_contentManagerProgrammersManual_en lt title gt lt multiRef gt lt multiRef id id4 SOAP ENC root 0 xsi type ns5 0bjectData xmins ns5 http gaussvip com xmins SOAP ENC http schemas xmlsoap org soap encoding gt lt createdDate xsi type xsd dateTime gt 2002 04 17T16 45 24 000Z lt createdDate gt lt objectId href id9 gt lt objectState href id7 gt 160 Livelink WCM Server Anwendungsbeispiele lt title xsi type xsd string gt 8 0 1 contentMinerManual_en lt title gt lt multiRef gt lt multiRef id id3 SOAP ENC root 0 xsi type ns6 0bjectData xmins ns6 http gaussvip com xmins SOAP ENC http schemas xmlsoap org soap encoding gt lt createdDate xsi type xsd dateTime gt 2002 04 17T16 45 18 000Z lt createdDate gt
21. id gt lt multiRef gt lt multiRef id id7 SOAP ENC root 0 xsi type ns12 0bjectState xmins ns12 http gaussvip com xmins SOAP ENC http schemas xmlsoap org soap encoding gt lt name xsi type xsd string gt edited lt name gt lt description xsi type xsd string gt ge amp 228 ndert lt description gt WCM WebServices Programmierhandbuch 161 Kapitel 6 lt imageURL xsi type xsd string gt http wcmserver company example wcm InternetSite_edit vipimages objectstate changed gif lt imageURL gt lt multiRef gt lt multiRef id id11 SOAP ENC root 0 xsi type ns13 0bjectId xmins ns13 http gaussvip com xmins SOAP ENC http schemas xmlsoap org soap encoding gt lt id xsi type xsd string gt 53 lt id gt lt multiRef gt lt SOAP ENV Body gt lt SOAP ENV Envelope gt Vorarbeiten Das SOAP Toolkit steht unter http download microsoft com download xml soap 2 0 W98NT42KMe EN US Soap Toolkit20 exe zum Download zur Verf gung Es beinhaltet die Version 3 MSXML3 des Microsoft XML Parsers Wenn Sie beispielsweise ein Add In f r Microsoft Word erstellen wollen legen Sie in Word eine Dokumentvorlage an und ffnen den VisualBasic Editor mit ALT F11 Das SOAP Toolkit und den XML Parser m ssen Sie als Verweise im Men Extras gt Verweise eintragen 162 Livelink WCM Server Anwendungsbeispiele Verweise TemplateProject Verf gbare verweise WM visual Basic For
22. serializer writeXML sortList i xml serializer endElement Next i serializer endElement Start element startResult serializer startElement startResult serializer SoapAttribute xsi type xsd int serializer writeString startResult serializer endElement Start element numberOfResults serializer startElement numberOfResults serializer SoapAttribute xsi type xsd int 172 Livelink WCM Server Anwendungsbeispiele serializer writeString numberOfResults serializer endElement start attributeKeys serializer startElement attributeKeys serializer SoapAttribute xsi type SOAP ENC Array serializer SoapAttribute SOAP ENC arrayType xsd string amp UBound attributekeys LBound attributeKeys amp For i LBound attributekeys To UBound attributeKeys 1 serializer startElement Item serializer SoapAttribute xsi type xsd string serializer writeXML attributeKeys i serializer endElement Next i serializer endElement serializer endElement close SOAP Body serializer endBody close SOAP Envelope serializer endEnvelope signal the end of the SOAP message being sent to the server Connector EndMessage create a new SoapReader Dim Reader As New SoapReader load the XML from the Stream If Not Reader Load Connector OutputStream Then Dim reason As String reason IIf Reader dom parseError Is Nothing _ parser unknown reason _ Reader dom parseError reason MsgBox filter fa
23. Akti onen f r das entsprechende Metadatum 0 Der Wert null ist f r dieses Attribut erlaubt amp Nach dem Attribut kann gesucht werden d h es kann f r die Konstruktion von Filtern verwendet werden of Der Attributwert kann geandert werden 78 Livelink WCM Server Objektverwaltung Tabelle 13 Die Komponenten des Datentyps ObjectData Attribut Datentyp Beschreibung ACL Acl ad Zugriffssteuerungsliste des WCM Objekts attributeKeys String a Werden die Objektdaten mit einer create oder get Methode zum Server gesendet so muss dieses Array die Menge von Attributnamen enthalten deren Werte vom Server gesetzt oder ge ndert werden sollen Werden die Objektdaten vom Server zur ckgeschickt dann enth lt dieses Array die Menge der Attributnamen die tats chlich vom Server gesetzt wurden Alle anderen Attribute haben nicht verl ssliche Werte children ObjectId LA OIDs der untergeordneten Objekte Kinder des WCM Objekts falls das WCM Objekt ein Thema ist Falls das WCM Objekt kein Thema ist oder es keine untergeordneten Objekte hat ist dieser Wert null compatible ObjectTypes ObjectType Objekttypen in die der Objekttyp des WCM Objekts berf hrt werden kann contentSize int Gr e des Objektinhalts in Byte 1 bedeutet dass das Objekt keinen Inhalt hat WCM WebServices Programmierhandbuch 79 Kapitel 5 At
24. Applications Abbrechen M Microsoft Word 9 0 Object Library 3 MOLE Automation Microsoft Office 9 0 Object Library Durchsuchen M Microsoft Forms 2 0 Object Librar Mi Microsoft Soap Type Library 4 Microsoft XML v3 0 Ml Microsoft Activex Data Objects 2 7 Library Priorit t NICHT GESPEICHERT Project Hilfe Normal gt O IAS Helper COM Component 1 0 Type Library U IAS RADIUS Protocol 1 0 Type Library LIA QuickStart Tutorial Assembly 1 8 QuickStart Tutorial Assembly Microsoft Soap Type Library Pfad C Programme Gemeinsame Dateien MSSoap Binaries mssoap1 dll Sprache Voreinstellung Abb 8 Einbindung der Bibliotheken im VisualBasic Editor Architektur der VBA Anwendung Die folgenden Klassenmodule werden definiert Tabelle 74 Klassenmodule VipWebServiceClient Schnittstelle zur Nutzung von WCM WebServices Neben der Initialisierung unter Angabe der Service URL der Benutzerkennung und des Passworts stellt dieses Modul alle in WCM WebServices definierten Methoden als Funktionen zur Verf gung WCM WebServices Programmierhandbuch 163 Kapitel 6 Name Beschreibung WCM Objekttyp ObjectId Kapselt die OID eines WCM Objekts Erlaubt Serialisierung und Deserialisierung ObjectId ObjectState Kapselt den Status eines WCM Objekts Erlaubt Serialisierung und Deserialisierung ObjectState ObjectType Kapselt den Typ eines WCM Objekts
25. Die Beschrei bung muss genaue Informationen liefern ber das verwendete Protokoll die Adresse und Port Nummer die m glichen Prozeduren und Funktionen sowie die Formate f r Eingabe und Ausgabe Der Anbieter eines Web Service stellt diese Informationen in Form einer WSDL Datei zur Verf gung UDDI UDDI Universal Description Discovery and Integration ist ebenfalls ein XML basierter Standard Er legt fest wie Detailinformationen zu Web Services und deren Anbietern in einheitlicher Form in Verzeichnissen abgelegt werden k nnen Um die vielen verschiedenen Web Services lokalisieren zu k nnen gibt es UDDI Verzeichnisse in denen Anbieter ihre Dienste registrieren und Dienstnehmer gezielt nach Web Services suchen k nnen So entspricht ein UDDI Verzeichnis einer Art globaler Gelber Seiten Die Web Services sind nach bestimmten Eigenschaften sortiert Die entspre chenden Eintr ge referenzieren die WSDL Dateien der zugeh rigen Web Services In einem UDDI Verzeichnis sind Web Services meist abh ngig von gesch ftlichen Anwendungen Dementsprechend enth lt das Verzeichnis eine Kategorisierung von Branchen und Unternehmen 22 Livelink WCM Server Konzepte Das Web Service Schichtenmodell Die folgende Abbildung veranschaulicht die Schichtung der einzelnen Protokolle UDDI Ver ffentlichung des Dienstes WSDL Dienstbeschreibung SOAP XML basierter Datenaustausch HTTP Netzwerk Abb 2
26. Fehlermeldungen von WCM WebServices werden automatisch in der Sprache des Benutzers ausgegeben Neben dem kurzen f r den Endbe nutzer gedachten Fehlertext enthalten die Fehlermeldungen von Livelink WCM Server weitere Detailinformationen die speziell f r den Systemadministrator und den Technical Support der Gauss Interprise AG wichtig sind Diese k nnen hnlich wie im Content Client als Details angezeigt werden Der Fehlercode steht ber das Attribut Code vom Typ System Xml XmlQualifiedName der SoapException zur Verf gung Eine Liste der Server Fehlercodes finden Sie im Abschnitt Exceptions des Content Servers auf Seite 49 190 Livelink WCM Server Anwendungsbeispiele Samtliche Detailinformationen sind Uber das Attribut Detail vom Typ System Xml XmlNode der SoapException verf gbar Der folgende Codeauszug enth lt die SOAP Message mit dem Fehler code lt soap Envelope xmins soap http schemas xmlsoap org soap envelope xmlns soapenc http schemas xmlsoap org soap encoding xmins tns http gaussvip com xmilns types http gaussvip com encodedTypes xmlns xsi http www w3 org 2001 XMLSchema instance xmins xsd http www w3 org 2001 XMLSchema gt lt soap Body gt lt soap Fault gt lt faultcode xmins nsl http gaussvip com gt ns1 Server ActionNotPermittedException lt faultcode gt lt faultstring gt 0582 No direct release is permitted for object amp apos 68 amp apos lt faults
27. Folge Der Objektstatus ndert sich nicht move Verschiebt das angegebene WCM Objekt unter ein anderes Thema Parameter Tabelle 68 Parameter der Methode move oid ObjectId OID des betreffenden WCM Objekts newParentOID ObjectId OID des Themas unter das das WCM Objekt verschoben werden soll WCM WebServices Programmierhandbuch 141 Kapitel 5 Parameter Datentyp Beschreibung remark String Zeichenkette die zum Protokoll des WCM Objekts hinzugef gt wird oder null dplWaitInfo DeploymentWaitInfo Liste der Deploymentsysteme oder null R ckgabe keine Voraussetzungen Erforderliche Zugriffsrechte auf das verschobene WCM Objekt READ TREE_OPERATIONS und WRITE_META Erforderliche Zugriffsrechte auf das Zielthema READ und CREATE m Objektstatus muss EDITED RELEASED oder PENDING_RELEASE sein Folge Nach dem Verschieben hat das angegebene WCM Objekt den Status EDITED multi Import 142 Erzeugt mehrere neue WCM Objekte in einem Aufruf Hierzu wird das initiale Objekt imports objectData angelegt und anschlie end die in imports children definierten Objekte Der Import unter scheidet dabei die folgenden M glichkeiten m Wenn das initiale Objekt einen Inhalt hat imports content null so wird dieses als Startseite des Imports aufgefasst und von den in imports children angegebenen Objekten werden nur die direkt oder indirekt von diesem WCM Objekt refe re
28. Programmierhandbuch 113 Kapitel 5 R ckgabe Workflow workflow das aktuell zugeordnete Workflow Objekt Voraussetzungen Keine Folge Der Objektstatus andert sich nicht getAssignedWorkflowActivities Liefert eine Liste von WorkflowNavigationInfo Objekten deren Aktivit ten vom angemeldeten Principal ausgef hrt werden k nnen R ckgabe WorkflowNavigationInfo workflowNavigationInfos eine Menge von WorkflowNavigationInfo Objekten Voraussetzungen Keine Folge Der Objektstatus ndert sich nicht getAssignedWorkflows Liefert alle Workflow Objekte deren aktueller Aktivit t der angemel dete Principal zugeordnet ist R ckgabe Workflow workflows eine Menge von Workflow Objekten Voraussetzungen Keine 114 Livelink WCM Server Objektverwaltung Folge Der Objektstatus andert sich nicht getAvai LableWorkflows Liefert alle Workflow Objekte fur die der Principal Uber das Zugriffs recht READ verf gt R ckgabe Workflow workflows eine Menge von Workflow Objekten Voraussetzungen Erforderliches Zugriffsrecht READ m Objektstatus keine Einschr nkungen Folge Der Objektstatus ndert sich nicht getWorkflow Liefert die Workflow Definition in der angegebenen Version Tabelle 42 Parameter der Methode getWorkflow Parameter Datentyp Beschreibung workflowOid ObjectId OID des Workflow Objekts version Version Version des Workflow Objekts R ckgabe Workflow workf
29. WCM Objekts wie er im Content Repository gespeichert ist ohne weitere Manipulationen am Inhalt in Bezug auf die verwendete Vorlage durchzuf hren Hinweis Wenn das WCM Objekt keinen Inhalt hat wird beim Aufruf dieser Methode eine Exception geworfen Parameter Tabelle 62 Parameter der Methode getContent Parameter Datentyp Beschreibung oid ObjectId OID des WCM Objekts version Version Gew nschte Version null liefert den Inhalt der aktuellen Version R ckgabe byte content der Inhalt des angeforderten WCM Objekts Voraussetzungen Erforderliches Zugriffsrecht READ Objektstatus keine Einschr nkungen Folge Der Objektstatus ndert sich nicht 136 Livelink WCM Server Objektverwaltung getDepLoyment Jobs Liefert alle verbleibenden Deploymentaufgaben f r ein angegebenes Deploymentsystem und ein WCM Objekt zur ck Jede Staging Aktion die ein WCM Objekt ndert erzeugt Deploymentaufgaben f r das Deploymentsystem einer Website Parameter Tabelle 63 Parameter der Methode getDeploymentJobs Parameter Datentyp Beschreibung dplSystem String Name des Deploymentsystems oid ObjectId OID des betreffenden WCM Objekts R ckgabe DeploymentJobInfo deplJobs Die Liste der verbleibenden Deploymentaufgaben Gibt es keine Aufgaben f r die angegebenen Parameter so wird eine leere Liste zur ckgeliefert Voraussetzungen m Es sind keine Zugriffsrechte erf
30. Wege Hier wird folgender Ansatz genutzt 1 Die SOAP Antwort wird in einen separaten Parser geladen resultDom loadXML Reader Body xm1 2 Dort wird das Attribut href im Element filterResult gesucht result resultDom selectSingleNode filterResult href 3 Aus dem Attribut wird der Wert der entsprechenden ID extrahiert resultId Mid result text 2 170 Livelink WCM Server Anwendungsbeispiele 4 Dadurch wird das Array im DOM lokalisiert List resultDom selectNodes id amp resultId amp 5 F r jeden Eintrag in der Liste wird nun ein Obj ectData Objekt angelegt itemId _ Mid List Item i Attributes getNamedItem href nodeValue 2 objectDataltem resultDom selectNodes id amp itemId amp results i tmpObjectData getObjectFromNodeList _ objectDataltem resultDom 6 Der Methode getObjectFromNodeList werden die einzelnen ObjectData Attribute als eine IXMLDOMSelection bergeben Diese Elemente enthalten jeweils die Objekttyp Information zum Beispiel lt title xsi type xsd string gt PortalManager ger_vOl lt title gt Abh ngig vom Typ wird nun das entsprechende Attribut in ObjectData gesetzt Komplexe Typen wie zum Beispiel ObjectState verf gen jeweils ber eine eigene Methode getObjectFromNodeList Hier folgt der Code der Methode filter filter returns an array of ObjectData containing the objects via the reference variable Pu
31. bergang ber den auf die n chste Aktivit t verwiesen wird remark String Zeichenkette die zum Protokoll des WCM Objekts hinzugef gt wird oder null emailInfo EMailInfo E Mail Information die an den Prin cipal gesendet wird der der n chsten Aktivit t zugeordnet ist oder null falls keine E Mail gesendet werden soll R ckgabe keine Voraussetzungen Erforderliche Zugriffsrechte und Funktionsbereiche werden durch die Workflow Aktivit t bestimmt Folge Der Objektstatus wird durch die letzte Workflow Aktivit t bestimmt 112 Livelink WCM Server Objektverwaltung getAssignedJobs Liefert die IDs aller WCM Objekte zur ck denen ein bestimmer Work flow zugeordnet ist und die sich in einer Aktivitat befinden der der angemeldete Principal zugeordnet ist Parameter Tabelle 40 Parameter der Methode getAssignedJobs Parameter Datentyp Beschreibung workflow Workflow Workflow Definition oder null activityld String Aktivit ts ID oder null R ckgabe ObjectId objectlds Liste von OIDs Voraussetzungen keine Folge Der Objektstatus andert sich nicht getAssignedWorkflow Liefert fur das angegebene WCM Objekt die zugeordnete Workflow Instanz Tabelle 41 Parameter der Methode getAssi gnedWorkf Low Parameter Datentyp Beschreibung oid ObjectId OID des WCM Objekts dessen zuge ordneter Workflow ermittelt werden soll WCM WebServices
32. der WCM Objekte fur die Generie rung verwendet werden siehe dazu Datenhaltungssichten auf Seite 34 F r die Seitengenerierung sind die Deploymentsysteme zust ndig Die Deploymentsysteme erzeugen aus den in der Datenbank gespeicherten WCM Objekten Seiten die mithilfe eines HTTP Servers in einem Browser dargestellt werden k nnen Ein Deploymentsystem generiert die Seiten f r eine Datenhaltungssicht und eine Website In einem WCM System k nnen Sie beliebig viele Deploymentsysteme konfigurieren Jede Seite wird ber eine URL referenziert Da f r ein und dasselbe WCM Objekt von mehreren Deploymentsystemen verschiedene Seiten erzeugt werden k nnen gibt es im Allgemeinen mehrere URLs f r ein und dasselbe WCM Objekt 32 Livelink WCM Server Konzepte Topologien Organisation von WCM Objekten Die WCM Objekte einer Website k nnen aufgrund bestimmter Eigen schaften Metadaten als hierarchische Struktur mit ber und untergeord neten Objekten dargestellt werden In einer Website gibt es zwei hierarchische Ordnungsmerkmale von WCM Objekten die Themenstruktur Navigationstopologie und die Vorlagenstruktur Vorla gentopologie Themenstruktur Navigationstopologie In der Themenstruktur werden Objekte Themen zugewiesen Jedes Thema ist wiederum ein WCM Objekt das einem anderen Thema unter geordnet ist Diese Hierarchie ist vergleichbar mit Verzeichnissen und Unterverzeichnissen in einem Dateisystem F r jede Website
33. derlich Lesen Sie dazu Abschnitt 4 7 Authentifizierung auf Seite 71 4 1 Benutzer Gruppen und Rollen Sie k nnen ber WCM WebServices die Einstellungen Profile von Benutzern Gruppen und Rollen auslesen und die Standard Objektrechte von Principals setzen Datentypen f r Principals F r die bergabe der Profile von Principals werden die Datentypen User Group und Role benutzt Alle diese Datentypen basieren auf dem Datentyp Principal Die folgende Tabelle zeigt die Komponenten des Datentyps User 54 Livelink WCM Server Zugriff auf Administrationsdaten und Authentifizierung Tabelle 3 Datentypen f r Benutzer Attribut Datentyp Beschreibung name String Benutzerkennung hasProfile boolean Zeigt an ob weitere Profilinforma tion enthalten ist commonName String Kompletter Name des Benutzers eMailAddress String E Mail Adresse des Benutzers locale Locale Sprache des Benutzers websites Stringl Liste der Website Namen denen der Benutzer zugeordnet ist subsitute User Stellvertreter der das Recht hat sich unter diesem Benutzer anzumelden substituteOf User Menge von Benutzern fur die dieser Benutzer der Stellvertreter ist groups Group Liste der Gruppen zu denen der Benutzer geh rt roles Role Liste der Rollen zu denen der Benutzer geh rt initially Permission Erlaubte Standard Objektrechte Granted des Benutzers Diese Rechte Permissions werden als V
34. gibt es genau ein Thema das das Wurzelobjekt des Navigationsbaums einer Website ist Ausgehend vom Wurzelobjekt verzweigt der Baum in Themen und Unterthemen Alle Objekte sind diesem Wurzelobjekt direkt oder indirekt untergeordnet Vorlagenstruktur Vorlagentopologie In der Vorlagenstruktur werden Objekte nach ihren Vorlagen geordnet Vorlagen sind ebenfalls WCM Objekte Jede Website kann eine oder mehrere Vorlagen enthalten die ineinander verschachtelt sein k nnen Alle Objekte werden ihren jeweiligen Vorlagen untergeordnet Objekte die keine Vorlagen besitzen und selbst nicht vom Objekttyp Vorlage sind werden in dieser Sicht nicht dargestellt WCM WebServices Programmierhandbuch 33 Kapitel 2 Datenhaltungssichten Die Erstellung und Bearbeitung von Objekten mit Livelink WCM Server unterliegen festen Stufen aus Editieren Bearbeiten Qualitatssicherung und Ver ffentlichung im Produktionsbetrieb Entsprechend dem Bearbei tungsstatus eines WCM Objekts gibt es verschiedene Sichten auf das Objekt Edit QS und Produktionssicht Edit Sicht Die Edit Sicht repr sentiert den Arbeitsschritt der Erstel lung und Bearbeitung von WCM Objekten Die Objekte wie beispielsweise HTML Seiten werden von Redakteuren oder Grafi kern angelegt und ge ndert Daf r ben tigen diese Benutzer entsprechende Zugriffsrechte f r die Objekte Nach der Bearbeitung werden die Objekte der Qualit tssicherung vorgelegt Dadurch werden neu angel
35. r int und long sowie null f r komplexe Typen ersetzen Das Einlesen der Serverantwort muss sorgf ltig erfolgen Es sind folgende Fehlerszenarien denkbar m der Server antwortet gar nicht die Antwort des Servers enth lt kein XML die Antwort des Servers enth lt keinen SOAP Envelope m die Antwort des Servers enth lt keinen SOAP Body die Antwort des Servers enth lt einen Anwendungsfehler Im Beispielprogramm werden genau diese Aspekte getestet Der R ckga bewert der Funktion submit zeigt an ob das Vorlegen zur Quali t tssicherung erfolgreich durchgef hrt wurde WCM WebServices Programmierhandbuch 169 Kapitel 6 Der Schwerpunkt des nachsten Beispiels ist die Deserialisierung der vom Web Service gelieferten XML Daten Aufruf einer Methode mit Ruckgabewert Als Beispiel wird hier die Auswertung eines Filterausdrucks verwendet WCM WebServices liefert als Ergebnis ein Array von ObjectData Dieses Array besteht aus n Eintragen die ihren Inhalt Uber href id refe renzieren In dem Beispiel werden XPath Ausdr cke verwendet um die entsprechenden Elemente im DOM Tree zu lokalisieren ObjectData selber ist ein komplexer Datentyp der unter anderem Elemente des Typs ObjectState ObjectType User ArrayOfString und ArrayOfObjectId referenziert Diese sind auch wieder ber href id eingebunden Zur Deserialisierung eines solchen komplexen Objekts mittels einer einfa chen Programmiersprache gibt es mehrere
36. system wird hier null geliefert version Version A Aktuelle dreiteilige Versions nummer des WCM Objekts websiteName String Name der Website zu der das WCM Objekt geh rt Datentyp ObjectType Allgemeine Informationen zu Objekttypen erhalten Sie im Abschnitt Objekttyp auf Seite 31 Der Datentyp ObjectType repr sentiert den Typ eines WCM Objekts Objekttypen sind Website spezifisch und nur innerhalb einer bestimmten Website g ltig Die Objekttypen einer Website k nnen mit der Methode getObjectTypes ausgelesen werden siehe getObjectTypes auf Seite 65 Mithilfe der Methode change kann der Objekttyp ge ndert werden siehe change auf Seite 122 Eine bersicht ber kompatible Objekt typen enth lt das Attribut compatibleObjectTypes des Datentyps ObjectData 84 Livelink WCM Server Objektverwaltung Tabelle 14 Die Komponenten des Datentyps ObjectType Attribut Datentyp Beschreibung attributeSetName String Name der Attributmenge die diesem Objekttyp zugeordnet ist defaultSuffix description String String Standard Endung von Dateien die Inhalte von WCM Objekten dieses Typs enthalten Diese Endung wird z B bei der Erzeugung neuer WCM Objekte verwendet Lokalisierte Beschreibung des Objekttyps fileOnCreate Needed boolean Dieser Wert ist genau dann wahr wenn beim Anlegen eines WCM Objekts dieses Typs eine Datei ange geben werden muss
37. werden Deploymentsysteme verschiedenen Kategorien zugeordnet Standard Deploymentsysteme erzeugen bei jeder Anderung an einem WCM Objekt automatisch eine neue Seite Die generierten Seiten werden im Dateisystem abgelegt Dynamische Deploymentsysteme generieren die Seiten auf Grundlage benutzerdefinierter Einstellungen und nur dann wenn die Seite Uber den HTTP Server angefordert wird Die generierten Dateien werden in einer flachen Dateistruktur abgelegt Mit Suchmaschinen Deploymentsystemen k nnen Sie die Daten Ihrer Website f r den Einsatz einer Suchmaschine aufbereiten WebDAV Deploymentsysteme bilden die Voraussetzung f r den Einsatz von WebDAV Clients InSite Editing Deploymentsysteme schaffen die Voraussetzung daf r dass Inhalte direkt innerhalb der Website ohne Content Client bearbeitet und hinzugef gt werden k nnen Deploymentsystem Typen Bei Deploymentsystemen wird entsprechend dem Staging Konzept von Livelink WCM Server zwischen den Typen Edit QS und Produktion unterschieden Je nach Typ werden unterschiedliche Sichten auf die Daten der Website erzeugt Edit Sicht In der Edit Sicht von Livelink WCM Server werden die Objekte einer Website angelegt und redaktionell bearbeitet Hier ist der jeweils aktuelle Bearbeitungsstand zu sehen Freigeben Staging Aktion von Livelink WCM Server Die Qualit tssicherung pr ft inhaltlich und formal ob ein vorgelegtes Objekt den Qualit tsstandards des Untern
38. werden die Websites f r den schreibenden Zugriff freigegeben Die Verteilung von WCM Objekten an Proxy Content Server findet erst im n chsten Runlevel statt 10 Website l uft Eine bzw alle Websites stehen f r den schrei benden Zugriff zur Verf gung Methoden zum Auslesen von Runlevels getRunlevel Liefert den Runlevel der Website zur ck die dem Web Service zuge ordnet ist Parameter keine R ckgabe Runlevel runlevel der Runlevel der Website WCM WebServices Programmierhandbuch 69 Kapitel 4 listAllRunlevels Liefert alle in einem WCM System m glichen Runlevels zur ck Parameter keine R ckgabe Runlevel runlevels die m glichen Runlevels 4 6 Allgemeine Abfragen F r allgemeine Abfragen stehen folgende Methoden zur Verf gung getLanguages Liefert alle vom Server unterst tzten Sprachen zur ck Parameter keine R ckgabe Locale languages Liste der verf gbaren Sprachen getVIPVersion 70 Liefert die Version von Livelink WCM Server zur ck Parameter keine R ckgabe KernelVersion version Version von Livelink WCM Server Livelink WCM Server Zugriff auf Administrationsdaten und Authentifizierung 4 7 Authentifizierung Der Zugriff auf ein WCM System Uber WCM WebServices erfordert eine Benutzerauthentifizierung um die einzelnen Methoden berhaupt nutzen zu k nnen Bei vielen Aktionen werden die Funktionsbereiche des Benut zers bzw die Zugriffssteuerungslisten der WCM
39. 0 E Eltern Objekte eines WCM Objekts abfragen 139 E Mail Daten 99 EMaillnfo 99 188 Erzeugen Seite 132 WCM Objekte 128 externe Referenzen eines WCM Objekts abfragen 138 F Fehlerbehandlung 169 C 190 SOAP Beispiel 191 filter 151 170 202 Filtern von WCM Objekten 151 171 185 forward 112 Freigeben 105 Funktionsbereiche abfragen 64 G generatePage 132 get 133 getAssignedJobs 113 getAssignedWorkflow 113 getAssignedWorkflowActivities 114 getAssignedWorkflows 114 getAttributeSets 65 getAvailableWorkflows 115 getCheckOutContent 134 getChildren 135 getContent 136 getDeploymentJobs 137 getDeploymentSystems 67 getExternalLinks 138 getFunctionalAreas 64 getGroupProfiles 58 getLanguages 70 getLastLogEntries 138 getObjectCategories 65 getObjectTypes 65 getParent 139 getRoleProfiles 59 getRunlevel 69 getUserProfiles 60 getVersionList 140 getVIPVersion 70 getWebsiteNames 66 getWorkflow 115 Gruppendaten abfragen 58 Livelink WCM Server l Import verkn pfter Objekte 142 Inhalt eines WCM Objekts erhalten 136 isForwardable 116 isRemovable 116 ItemTemplate 186 K Kind Objekte eines WCM Objekts abfragen 135 Kopieren 127 L listAllRunlevels 70 logout 72 L schen 129 L schen endg ltig 131 L schen Seite aus Dateisystem 130 M Metadaten 78 Methoden addRemark 121 assignWorkflow 109 assignWorkflowAsync 110 change 122 changePassword 71 checkin 101 checkOut 102 checkReferencesForDel
40. 04 188 release 105 188 removeWorkflow 117 removeWorkflowAsync 118 restoreVersion 145 Rollendaten abfragen 59 Runlevel aktuellen abfragen 69 alle abfragen 70 204 S Session Timeout 184 Session Verwaltung C 184 SOAP Toolkit 166 SOAP Beispiel 156 Body 156 Envelope 156 SOAP Toolkit 162 Authentifizierung 165 Verbindungsaufbau 165 sortParentsFirst 146 Sprachen abfragen 70 submit 106 188 submitImmediately 107 substituteLogin 72 Suchen nach WCM Objekten 151 T Timeout 184 Transition 96 U Ubergang 96 undoCheckout 108 V Verbindungsaufbau C 184 Verbundobjekt konvertieren 126 Verschieben 141 Version 193 Version abfragen 70 Version zur ckholen 145 Versionsliste eines WCM Objekts abfragen 140 Vertreter anmelden 72 Livelink WCM Server VisualBasic 156 VisualStudio 176 Projekt einrichten 177 Webverweis 177 Vorlegen 106 107 Ww WCM Objekt Attribute 78 Web Services allgemein 19 Websitenamen abfragen 66 Weiterleiten 112 Workflow 94 entfernen 117 zuordnen 109 WorkflowNavigationinfo 97 WSDL Nutzung in VisualStudio 177 X XML Serialisierung 158 XML Serialisierung Beispiel 169 href 170 multiRef 170 XPath 170 Z Zeitbegrenzung 184 Zerst ren 131 Zugriffsrecht 88 Zugriffssteuerungsliste 90 Zugriffssteuerungsliste ndern 91 Zur ckgeben 101 Zustand eines WCM Objekts 86 WCM WebServices Programmierhandbuch Index 205 Index 206 Livelink WCM Ser
41. 1 12 16 19 19 26 28 39 39 44 47 53 54 62 65 66 67 70 71 Kapitel 5 Objektverwaltung 5 1 WCM spezifische Datentypen 5 2 Allgemeine Parameter 5 3 Staging Methoden 5 4 Workflow Methoden 5 5 Methoden der Objektverwaltung 5 6 Suchen nach WCM Objekten Kapitel 6 Anwendungsbeispiele 6 1 VisualBasic for Applications 6 2 C und ASP NET Glossar Index WCM WebServices Programmierhandbuch 75 76 98 100 109 119 147 155 156 176 195 201 Abbildungsverzeichnis Abb 1 Rollen und Aktionen innerhalb der Web Service Architektur 21 Abb 2 Protokoll Stack f r Web Services 23 Abb 3 Methodenaufruf eines Web Service Clients 25 Abb 4 Grundlegende Funktionsweise von WCM WebServices 27 Abb 5 Applications des Content Servers 42 Abb 6 Parameter der Application WebServiceApplication 43 Abb 7 Der Datentyp Filter und davon abgeleitete spezielle Filter typen 148 Abb 8 Einbindung der Bibliotheken im VisualBasic Editor 163 Abb 9 C Projekt einrichten 177 Abb 10 WSDL als Webverweis hinzuf gen 178 Abb 11 Benutzerkennung und Passwort eingeben 179 Abb 12 Automatisch erzeugte Klassen im Namensraum VipWebServiceClient 180 Abb 13 Die Beispielanwendung Liste aller PDF Dateien 181 Abb 14 Maildialog der Beispielanwendung 182 6 Livelink WCM Server Tabellenverzeichnis Tabelle 1 Tabelle 2 Tabelle 3 Tabelle 4 Tabelle 5 Tabelle 6 Tabelle 7 Tabelle 8 Tabel
42. 57 Favoriten Medien B amp al Adresse amp http localhost vipwebServiceClient default aspx Objects submitted The following objects were submitted website InternetSite Cannot be changed Delayed release i DY With E mail Without E mail Y Lokales Intranet Abb 14 Maildialog der Beispielanwendung Dieses Beispiel besteht aus den folgenden Dateien Tabelle 75 ASP NET Beispiel default aspx ASP Seite lt asp datagrid gt Benutzeroberfl che lt asp Label gt lt asp TemplateColumn gt lt asp CheckBox gt lt asp HyperLink gt lt asp button gt Enth lt ein DataGrid zur Anzeige der Objektdaten 182 Livelink WCM Server Anwendungsbeispiele Name Beschreibung Verwendete Elemente default aspx cs mail aspx mail aspx cs Anwendungscode hinter der ASP Seite Hier werden die Daten aus Livelink WCM Server geladen Au erdem sind die Callbacks f r die f nf Schalt fl chen implementiert Einfaches Mail Erfassungs formular siehe Abbildung 14 Maildialog der Beispielan wendung auf Seite 182 Hier k nnen zus tzliche Mailempf nger eingetragen das Freigabedatum vorge geben und Anmerkungen f r das Objektprotokoll einge tragen werden Der Code hinter dem Mailfor mular Insbesondere wird die Zeile mitdem Freigabedatum nur sichtbar wenn der Dialog zum Vorlegen zur QS
43. CM WebServices Programmierhandbuch 177 Kapitel 6 Add Web Reference 8 Address Web Service Directories p 5 guddi Universal Description Discovery Integratio UDDI Directory Query the UDDI Business Registry to find companies and production Web Services r s Hii Universal Description i Discovery Integratio Test Microsoft UDDI Directory Locate test Web Services to use during development Abb 10 WSDL als Webverweis hinzuf gen Visual Studio l dt das WSDL in den linken Bereich dieses Fensters und verlangt dann noch einmal Benutzernamen und Passwort 178 Livelink WCM Server Anwendungsbeispiele Discovery Credential Please supply the credential information to access the given url Url com vip8 1 WebService Port InternetSite edit WSDL User name jamin SSS Password Domain Abb 11 Benutzerkennung und Passwort eingeben Nach erfolgreicher Autorisierung k nnen Sie den Dialog Add Web Reference abschlieRen indem Sie auf Add Reference klicken Visual Studio erzeugt aus der WSDL Beschreibung von WCM WebServices ein Modul im Namensraum Namespace VipWebServiceClient com company wcmserver Dort finden Sie f r jeden in WCM WebServices ben tigten Datentyp eine Klasse Der Object Browser gibt einen guten berblick ber die automatisch erzeugten Klassen WCM WebServices Programmierhandbuch 179 Kapitel 6 Object Browser Browse Selected Components Customize
44. Fehlersituationen sind folgende Elemente wichtig SOAP Fehlermeldungen Fehlermeldungen Exceptions der WCM Server Aufbau von SOAP Fehlermeldungen Falls der WCM Server einen Methodenaufruf nicht erfolgreich ausf hren kann wird eine SOAP Fehlermeldung an den Dienstnehmer zur ckge geben Diese SOAP Fehlermeldung enth lt ein Fault Element das wiederum folgende Elemente enth lt faultcode Hier steht hinter der allgemeinen Bezeichnung Server der Typ der aufgetretenen Fehlersituation z B AccessDeniedException Die m glichen Exceptions des Content Servers sind in Tabelle 2 Exceptions und m gliche Ursachen auf Seite 49 aufgelistet faultstring Beschreibung der Fehlersituation und eventuell der Ursachen als Klartext Diese Meldung ist lokalisiert d h sie wird in der Sprache verfasst die im Admin Client f r den angemeldeten Benutzer eingestellt ist WCM WebServices Programmierhandbuch 47 Kapitel 3 faultactor Dieses Element enth lt die Bezeichnung Vip Content Manager API um dem Dienstnehmer zu zeigen dass die Ausnah mesituation bei der Bearbeitung im WCM Server und nicht beim Verbindungsaufbau bei der Umwandlung der XML Beschreibung der Eingabedaten oder der Transformation der R ckgabewerte in eine SOAP Nachricht aufgetreten ist detail Dieses Element enth lt eine Folge von lokalisierten Nach richten die in komplexen Fehlersituationen die Suche nach den Ursachen erleichtern Es fol
45. Installation des WCM Systems und gibt Konfigurati onshinweise f r HTTP Server und JSP Engine Es gibt verschiedene flexible Programmierschnittstellen mit denen die Kernfunktionalit ten von Livelink WCM Server ber externe Programme genutzt werden k nnen Die folgende Tabelle beinhaltet eine bersicht ber die verschiedenen Schnittstellen und die jeweils verf gbare Funktio nalit t Tabelle 1 Verf gbare Funktionalit t in den APIs von Livelink WCM Server AdminHandler oY oY S nur lesend ber VipUserBean AttributeHandler S VW s va ber ber VipWebsiteBean VipWebService_ Port EventDispatcher s oY 14 Livelink WCM Server Mai LHandler ObjectHandler v ber VipEMailBean Y Uber VipObject HandlerBean Einleitung ber VipWebService_ Port ObjectLoader SystemHandler WorkflowHandler s ber VipWorkf low Bean x ber VipWebService_ Port DeploymentHandler ContextHandler LivelinkAdmin Handler LivelinkObject Handler v Uber LivelinkUser Bean Y Uber LivelinkObject Bean WCM WebServices Programmierhandbuch 15 Kapitel 1 1 2 Typographische Konventionen Programmelemente u A werden im Text folgenderma en hervorgehoben Element Schriftart oder Symbol Beispiele Programmoberfl che Men Eintrag Datei Anlegen wie z B Men befehle Fenster Dialoge F
46. ML Inhalt m ssen Sie als Anwen dungsentwickler generieren Daher lassen sich die in diesem Kapitel beschriebenen Techniken auch auf andere Skriptsprachen bertragen Aufbau eines Web Service Aufrufs Zur Vorbereitung soll zun chst der Aufbau eines Web Service Aufrufs erl utert werden Jeder Aufruf beginnt jeweils mit dem SOAP Envelope gefolgt vom SOAP Body Dieser enth lt genau ein Element repr sentiert durch den Namen der aufzurufenden Methode Dieses Element enth lt wiederum die Para meter der Methode Leere Parameter d rfen dabei weggelassen werden Das folgende Beispiel zeigt einen vollst ndigen Request inklusive HTTP Header wie er im NET Framework SDK von Microsoft f r den Metho denaufruf filter objectType PDF erzeugt wird 156 Livelink WCM Server Anwendungsbeispiele POST wcm WebService Port InternetSite edit HTTP 1 1 User Agent Mozilla 4 0 compatible MSIE 6 0 MS Web Services Client Protocol 1 0 3705 0 Content Type text xml charset utf 8 SOAPAction http gaussvip com Authorization Basic YWRtaW46YQ Content Length 1820 Expect 100 continue Host wcmserver company example Cookie JSESSIONID B8D157BC6E214885EE2A2A3A0FA788C8 lt xml version 1 0 encoding utf 8 gt lt soap Envelope xmlns soap http schemas xmlsoap org soap envelope xmlns soapenc http schemas xmlsoap org soap encoding xmlns tns http gaussvip com xmilns types http gaussvip com encode
47. OAP Befehle demonstrieren Die vom Server ebenfalls als SOAP Envelope empfangene Antwort ist mindestens genauso komplex wie die oben abgedruckte Anfrage Hier l sst sich die Komplexit t leider nicht steuern Der aufwendigere Teil des Programmierbeispiels behandelt deshalb die Deserialisierung der empfangenen Daten HTTP 1 1 100 Continue HTTP 1 1 200 OK Content Type text xml charset utf 8 Content Length 4151 Date Thu 18 Apr 2002 07 30 32 GMT Server Apache Tomcat 4 0 3 HTTP 1 1 Connector lt xml version 1 0 encoding UTF 8 gt WCM WebServices Programmierhandbuch 159 Kapitel 6 lt SOAP ENV Envelope SOAP ENV encodingStyle http schemas xmlsoap org soap encoding xmins SOAP ENV http schemas xmlsoap org soap envelope xmins xsd http www w3 0rg 2001 XMLSchema xmins xsi http www w3 org 2001 XMLSchema instance gt lt SOAP ENV Body gt lt ns1 filterResponse SOAP ENV encodingStyle http schemas xmlsoap org soap encoding xmins nsl http gaussvip com gt lt filterResult xsi type SOAP ENC Array SOAP ENC arrayType ns1 0bjectData 5 xmins SOAP ENC http schemas xmlsoap org soap encoding gt lt item href id1 gt lt item href id2 gt lt item href id3 gt lt item href id4 gt lt item href id5 gt lt filterResult gt lt ns1 filterResponse gt lt multiRef id id5 SOAP ENC root 0 xsi type ns3 O0bjectData xmlns ns3 http gaussvip com xmins SOAP ENC
48. Objekte gepr ft um fest zustellen ob der Benutzer ber die notwendigen Rechte verf gt Die Authentifizierung erfolgt bei der Anmeldung des Web Service am WCM Server Sie f hrt im WCM System zur Erzeugung eines bei jeder Anmeldung unterschiedlichen innerhalb eines WCM Systems eindeu tigen ContextId Objekts Damit ist der Web Service eindeutig im System registriert Die ContextId bleibt im WCM System so lange erhalten wie die zum aktuellen Web Service geh rige Session existiert Es ist f r WCM WebServices keine weitere 1ogin Methode erforderlich Die bergabe von Benutzername und Passwort f r die Anmeldung am WCM System erfolgt ber die auf Grundlage von WCM WebServices programmierte Anwendung Name und Passwort m ssen dazu im Header des HTTP Requests eingetragen werden F r das Beenden einer Session die Authentifizierung als Stellvertreter und das ndem von Passw rtern stehen folgende Methoden zur Verf gung changePassword ndert das Passwort f r den angegebenen Benutzer Parameter Tabelle 10 Parameter der Methode changePassword Parameter Datentyp Beschreibung newPassword String Neues Passwort WCM WebServices Programmierhandbuch 71 Kapitel 4 R ckgabe keine logout Meldet den Benutzer bekannt durch seine ContextId ab Parameter keine R ckgabe keine substituteLogin 72 Meldet den bereits angemeldeten Benutzer bekannt durch seine ContextId als Ve
49. Programmierhandbuch Tabelle 24 Die Komponenten des Datentyps Activity Attribut Datentyp Beschreibung activityType String Staging Typ der Aktivit t description String Beschreibung der Aktivit t id String Aktivit ts ID name String Name der Aktivit t principalName String Name des Principals der der Akti vit t zugeordnet ist principalType int Typ des Principals der der Akti vitat zugeordnet ist transitions Transition Alle von der Aktivit t wegf h renden berg nge Datentyp Transition Ein gerichteter bergang zwischen zwei Aktivit ten eines Workflows wird durch das Interface Transition repr sentiert Neben der Bezeichnung und der Beschreibung k nnen zu einem bergang die zugeordneten Akti vit ten abgefragt werden 96 Livelink WCM Server Objektverwaltung Tabelle 25 Die Komponenten des Datentyps Transition Attribut Datentyp Beschreibung description String Beschreibung des Ubergangs fromActivity Activity Aktivitat die Ausgangspunkt des Ubergangs ist id String Aktivitats ID toActivity Activity Aktivitat die Zielpunkt des Uber gangs ist name String Name des Ubergangs Datentyp Work flowNavigat ionInfo Das WorkflowNavigationInfo Objekt bernimmt die Funktion eines Containers der Informationen Uber Workflows zusammenfasst Derartige Informationen k nnen f r die Entwicklung von Benutzeroberflachen f r verwendete Workflo
50. Protokolleintr gen siehe getLastLogEntries auf Seite 138 Bemerkung zum Protokoll hinzuf gen siehe addRemark auf Seite 121 m Versionen eines Objekts auflisten siehe getVersionList auf Seite 140 ltere Version eines Objekts wiederherstellen siehe restoreVersion auf Seite 145 Referenzen pr fen Pr fung vor dem L schen ob die angegebenen WCM Objekte von anderen WCM Objekten referenziert werden siehe checkRefe rencesForDelete auf Seite 123 m Pr fung vor der Freigabe ob die angegebenen WCM Objekte andere WCM Objekte referenzieren die noch nicht freigegeben wurden siehe checkReferencesForRelease auf Seite 124 120 Livelink WCM Server Objektverwaltung m Pr fung vor dem Vorlegen ob die angegebenen WCM Objekte andere WCM Objekte referenzieren die noch nicht zur Qualit tssi cherung vorgelegt wurden siehe checkReferencesForSubmit auf Seite 125 m Abfragen externer Referenzen siehe getExternalLinks auf Seite 138 Deployment Seite n erzeugen siehe generatePage auf Seite 132 generierte Seite n aus dem Dateisystem l schen siehe depublish Page auf Seite 130 m Abfragen verbleibender Deploymentaufgaben f r ein angegebenes Deploymentsystem und ein WCM Objekt siehe getDeployment Jobs auf Seite 137 In der folgenden bersicht sind die Methoden alphabetisch sortiert addRemark F gt eine Bemerkung zum Protokoll des spezifizierten WCM Objek
51. Quellcode fur die in Tabelle 74 Klassenmodule auf Seite 163 aufgelisteten Module finden Sie im Verzeichnis WCM Installationsverzeichnis examples webservices vba Diese Klassen k nnen Sie ber Datei importieren in ein Visual Basic Projekt Ubernehmen 6 2 C und ASP NET Die Entwicklung Browser basierter Benutzeroberflachen mit ASP NET oder Standard Windows Oberflachen mit Windows Forms wird durch Visual Studio NET sehr vereinfacht In diesem Abschnitt erfahren Sie wie Sie WCM WebServices in Visual Studio nutzen k nnen 176 Livelink WCM Server Anwendungsbeispiele Vorarbeiten Richten Sie ein neues C Projekt ein z B mit dem Namen VipWebSer viceClient New Project Project Types Templates Visual Basic Projects Visual C Projects 5 Visual C Projects E Setup and Deployment Projects Other Projects Visual Studio Solutions F Windows Application Class Library windows Control ASP NET Web Library Application A project for creating an application with a Web user interface Name Location http localhost vipwebServiceClient X Browse Project will be created at http localhost vipwebServiceClient More Cancel Help Abb 9 C Projekt einrichten Visual Studio erzeugt automatisch die ben tigten Module f r den Zugriff auf WCM WebServices sobald Sie die URL der WSDL Beschreibung als Webverweis Im Men Projects gt Add Web Reference hinzuf gen W
52. Request Params operation trDelayed Visible operation Equals submit operation Equals directRelease Ausf hren der Aktion Sobald im Maildialog eine der beiden Schaltfl chen ausgew hlt wird wird die gew nschte Aktion ausgef hrt Zu diesem Zweck werden die Eingabe daten aus dem Dialog in ein EMail Info Objekt bernommen und der gew nschten Methode als Parameter bergeben private void execute Boolean withMail VipWebService service VipWebService this Session service String operation Request Params operation if service null String oids textAreaObjectList Value Split ToCharArray ObjectId oidsToSubmit new ObjectId oids Length for int i 0 i lt oids Length i oidsToSubmit i new ObjectId oidsToSubmit i id oids i DateTime pendingReleaseDate pendingReleaseDate new DateTime 1 1 1 EMailInfo eMaillnfo null if withMail eMailInfo new EMaillnfo eMaillnfo subject textAreaMessageText Value eMaillnfo cc textAreaCC Value 188 Livelink WCM Server Anwendungsbeispiele DeploymentWaitInfo dplWaitInfo null try switch operation case submit service submit oidsToSubmit pendingReleaseDate textAreaRemark Value eMaillnfo dplWaitInfo break case directRelease service directRelease oidsToSubmit pendingReleaseDate textAreaRemark Value eMaillnfo dplWaitInfo break case release service rel
53. WebServices Beschreibung und die Meldungen in Fehlersituationen Kapitel 4 Zugriff auf Administrationsdaten und Authentifizierung beschreibt die Methoden zum Auslesen von Gruppen Rollen und Benutzern des WCM Systems zum Auslesen von Systeminformati onen sowie zur Authentifizierung Kapitel 5 Objektverwaltung beschreibt die WCM Datentypen und Methoden zum Zugriff auf WCM Objekte Einige Programmierbeispiele f r WCM WebServices finden Sie im Kapitel 6 Anwendungsbeispiele Die hier beschriebene Programmierschnittstelle ist Bestandteil von Livelink WCM Server Zus tzlich zum vorliegenden Programmierhand buch k nnen Sie Informationen aus folgenden Quellen beziehen WCM Java API Programmierhandbuch Dieses Handbuch enth lt Informationen ber Interfaces Klassen und Methoden der Java Programmierschnittstelle WCM Java API mit der die Funktionalit t der WCM Server ber externe Programme genutzt werden kann Content Client Benutzerhandbuch Dieses Handbuch weist Sie ausf hrlich in alle Aufgaben der redaktionellen Pflege von WCM verwalteten Websites ein WCM WebServices Programmierhandbuch 13 Kapitel 1 Livelink WCM Server Administratorhandbuch Dieses Handbuch beschreibt die Konfiguration und Administration von WCM Systemen und enth lt eine ausf hrlich Darstellung der technischen Konzepte von Livelink WCM Server Livelink WCM Server Installationshandbuch Dieses Handbuch beschreibt die
54. Zugriff auf Administrationsdaten und Authentifizierung 4 3 Websites Eine Website innerhalb eines WCM Systems wird eindeutig durch einen Namen identifiziert WCM WebServices bietet die Methode getWebSiteNames um die Namen aller Websites auszulesen die im WCM System verwaltet werden Jeder Website sind im Allgemeinen mehrere Deploymentsystem zugeordnet Methoden f r Websites getAttributeSets Liefert alle der Website zugeordneten Attributmengen zur ck Parameter keine R ckgabe AttributeSet attributeSets die verf gbaren Attributmengen getObjectCategories Liefert alle der Website zugeordneten Objektkategorien zur ck Parameter keine R ckgabe ObjectCategory objectCategories die verf gbaren Objektkategorien getObjectTypes Liefert alle der Website zugeordneten Objekttypen zur ck Parameter keine WCM WebServices Programmierhandbuch 65 Kapitel 4 R ckgabe ObjectType objectTypes die verf gbaren Objekttypen getWebsiteNames Liefert die Namen aller im WCM System verf gbaren Websites zur ck Parameter keine R ckgabe string websiteNames die Namen der verf gbaren Websites 4 4 Deploymentsysteme Es gibt drei verschiedene Typen von Deploymentsystemen entsprechend den Datenhaltungssichten Edit QS und Produktion Ein Deployment system f r die Edit Sicht verf gt ber alle Auspr gungen der WCM Objekte und verwendet diese f r die Seitengenerierung Im Qualit tssi cherungs bzw Produktionsdepl
55. abelle zeigt die Status und die m glichen berg nge zwischen den Status Der bergang zu einem anderen Status erfolgt im Rahmen von Staging Aktionen Wenn ein WCM Objekt neu angelegt wird erh lt es den Status edited Informationen zu den einzelnen Staging Methoden erhalten Sie im Abschnitt 5 3 Staging Methoden ab Seite 100 86 Livelink WCM Server Objektverwaltung Tabelle 16 Die m glichen berg nge zwischen den Objektstatus pending release released Status vor der Status nach der Aktion Aktion Aktion edited edited change checked_out checkOut deleted delete submitted submit checked_out edited checkIn Zur ck zum Status den undoCheckOut das Objekt vorher hatte deleted Das Objekt wird destroy endg ltig aus dem WCM System entfernt rejected reject submitted rejected reject released release pending_release release Automatisch wenn das Ver ffentlichungsdatum erreicht ist checked_out checkOut edited change released checked_out checkOut edited change WCM WebServices Programmierhandbuch 87 Kapitel 5 Tabelle 17 Die Komponenten des Datentyps ObjectState Attribut Datentyp Beschreibung description String Lokalisierte Beschreibung des Objektstatus imageURL String URL auf die Datei des Symbols das den Objektstatus reprasentiert Dabei ist die URL abhangig vom Deploymentsystem das WCM WebServices zugeordne
56. ann eine genaue Liste von Attributen angefordert werden die nach dem Aufruf der Methode im R ckgabewert verf gbar sind Parameter Tabelle 59 Parameter der Methode get Parameter Datentyp Beschreibung oid ObjectId OID des WCM Objekts version Version Gew nschte Version Die Zahl f r die aktuelle Version kann hier nicht angegeben werden null liefert die aktuelle Version attributeKeys String Liste der gew nschten Attribute R ckgabe ObjectData objectData die angeforderten Daten des spezifizierten WCM Objekts WCM WebServices Programmierhandbuch 133 Kapitel 5 Voraussetzungen Erforderliche Zugriffsrechte READ bzw READ_ PRODUCTION m Objektstatus keine Einschr nkungen Folge Der Objektstatus ndert sich nicht getCheckOutContent Liefert den Inhalt des WCM Objekts mit der angegebenen OID und der definierten Version in einem Byte Array zur ck Diese Methode kann auch verwendet werden wenn das WCM Objekt nicht ausge liehen ist d h wenn der Status des WCM Objekts nicht CHECKED_OUT ist Der Inhalt wird von dem Deploymentsystem generiert das WCM WebServices zugeordnet ist Bei HTML Objekten und hnlichen Objekttypen werden die Head Bereiche der Vorlagen zusammenge f hrt und in den Head Bereich des Inhalts eingef gt Der Body Bereich wird nicht ge ndert bis auf die enthaltenen Referenzen die ggf auf den neuesten Stand gebracht werden WCM Tags werden nicht e
57. b initialize_connection If Connector Is Nothing Then Set Connector New HttpConnector set EndPointURL Connector Property EndPointURL _ http wcemserver company example wcm WebService Port InternetSite edit set SoapAction AuthUser and AuthPassword Connector Property SoapAction VIP_NAMESPACE_URI Connector Property AuthUser admin Connector Property AuthPassword a Else WCM WebServices Programmierhandbuch 165 Kapitel 6 Connector Reset End If initialise the SoapConnector Objekt and prepare the connection Connector Connect Begin the SOAP Message Connector BeginMessage create the necessary SoapSerializer Set serializer New SoapSerializer connect the Serializer with the SOAP Connection serializer Init Connector InputStream Begin the SOAP Envelope serializer startEnvelope add the following required XML Namespace definitions serializer SoapAttribute xmlns SOAP ENC SOAP _ENCODING_NS_URI serializer SoapAttribute xmins xsi _ http www w3 org 2001 XMLSchema instance serializer SoapAttribute xmlns xsd _ http www w3 org 2001 XMLSchema serializer SoapAttribute xmlns vip VIP_NAMESPACE_URI Begin the request body serializer startBody End Sub Hinweise Das SOAP Toolkit unterst tzt leider keine Session Verwaltung ber Cookies WCM WebServices f hrt deshalb f r jeden Request eine separate Anmeldung durch Fur alle Funktionen die Daten vera
58. benen OID in der definierten Version lesen siehe get auf Seite 133 Inhalt des WCM Objekts mit der angegebenen OID und der defi nierten Version erhalten Der Inhalt wird vom zugeordneten Deploymentsystem generiert Dabei wird der Inhalt mit den verwen deten Vorlagen zusammengef hrt Siehe getCheckOutContent auf Seite 134 Inhalt des WCM Objekts mit der angegebenen OID und der defi nierten Version erhalten ohne weitere Manipulationen am Inhalt in Bezug auf die verwendete Vorlage Siehe getContent auf Seite 136 m Metadaten ndern siehe change auf Seite 122 Verbundobjekte konvertieren siehe convertContent auf Seite 126 Position in der Hierarchie ermitteln sortieren Ermitteln der untergeordneten Objekte eines Themas siehe getChildren auf Seite 135 Ermitteln des bergeordneten Objekts siehe getParent auf Seite 139 WCM WebServices Programmierhandbuch 119 Kapitel 5 Sortierung von Elementen sodass jedes Kind Objekt hinter seinem Eltern Objekt platziert ist siehe sortParentsFirst auf Seite 146 Objekte kopieren und verschieben Objekte kopieren siehe copy auf Seite 127 m Objekt verschieben siehe move auf Seite 141 Objekte l schen m Objekte l schen muss von der Qualit tssicherung best tigt werden siehe delete auf Seite 129 Objekte endg ltig l schen siehe destroy auf Seite 131 Protokoll und Versionen m Abfragen von
59. bjektstatus muss EDITED REJECTED RELEASED oder PENDING RELEASE sein Folge Nach der Anderung hat das angegebene WCM Objekt den Status EDITED checkReferencesForDelete Methode zur Pr fung ob die angegebenen WCM Objekte von anderen WCM Objekten referenziert werden Diese Methode sollte vor dem L schen oder Zerst ren von WCM Objekten aufgerufen werden Parameter Tabelle 49 Parameter der Methode checkReferencesForDelete Parameter Datentyp Beschreibung oids ObjectId Liste von OIDs deren zugeh rige WCM Objekte gepr ft werden sollen R ckgabe ObjectId objectlds eine Liste von OIDs die in oids enthalten sind und deren zugeh rige WCM Objekte von anderen WCM Objekten referenziert werden Voraussetzungen Es sind keine Zugriffsrechte erforderlich m Objektstatus keine Einschr nkungen WCM WebServices Programmierhandbuch 123 Kapitel 5 Folge Der Objektstatus andert sich nicht checkReferencesForRe Lease Methode zur Pr fung ob die angegebenen WCM Objekte andere WCM Objekte referenzieren die noch nicht freigegeben wurden Diese Methode sollte vor dem Freigeben von WCM Objekten aufge rufen werden Parameter Tabelle 50 Parameter der Methode checkReferencesForRelease Parameter Datentyp Beschreibung oids ObjectId Liste von OIDs deren zugeh rige WCM Objekte gepr ft werden sollen R ckgabe ObjectId objectIds Eine Liste von OIDs die in
60. blic Function filter ByVal ByVal ByRef ByVal ByVal ByRef ByRef matching the specified filter and READ permissions for the authenticated user The number of records returned is passed numRows myFilter As GenericFilter _ startOid As ObjectID _ sortList As Sort _ startResult As Long _ numberOfResults As Long _ attributeKeys As String _ numRows As Integer As Variant WCM WebServices Programmierhandbuch 171 Kapitel 6 initialize_connection numRows 0 serialize request for filter serializer startElement filter VIP_NAMESPACE_URI Start element filter xsi type vip EqualFilter LessFilter serializer startElement filter serializer SoapAttribute xsi type vip amp myFilter FilterType If Not myFilter Is Nothing Then serializer writeXML myFilter xml serializer End If serializer endElement Start element startOID serializer startElement startOID serializer SoapAttribute xsi type vip ObjectId If Not startOid Is Nothing Then serializer writeXML startOid xml End If serializer endElement Start element sortList serializer startElement sortList serializer SoapAttribute xsi type SOAP ENC Array serializer SoapAttribute SOAP ENC arrayType _ vip Sort amp UBound sortList LBound sortList amp Dim i As Integer For i LBound sortList To UBound sortList 1 serializer startElement Item serializer SoapAttribute xsi type vip Sort
61. ctId amp UBound oids 1 LBound oids amp Dim arrayOfOids As New Value Let arrayOfOids ArrayValue oids serializer writeXML arrayOfOids xml serializer endElement Start element pendingReleaseDate serializer startElement pendingReleaseDate Dim v As New Value Let v dateValue pendingReleaseDate pendingReleaseDate is only valid if it s in the future If pendingReleaseDate gt Now Then serializer SoapAttribute xsi type xsd dateTime serializer writeString v simpleXml Else serializer SoapAttribute xsi nil true End If serializer endElement Start element remark serializer startElement remark WCM WebServices Programmierhandbuch 167 Kapitel 6 serializer SoapAttribute xsi type xsd string serializer writeString remark serializer endElement Start element emaillnfo serializer startElement emaillnfo If Not emailI Is Nothing Then serializer SoapAttribute xsi type vip EMaillnfo serializer writeXML emaill xml Else serializer SoapAttribute xsi nil true End If serializer endElement Start element dplWaitInfo serializer startElement dplWaitInfo If Not dplWaitInfo Is Nothing Then serializer SoapAttribute xsi type vip DeploymentWaitInfo serializer writeXML dplWaitInfo xml Else serializer SoapAttribute xsi nil true End If serializer endElement serializer endElement end of SOAP Body serializer endBody end of SOAP Env
62. d der E Mail Hier k nnen zus tzliche Empf nger eingetragen werden excludeOIDList boolean Dieser Wert ist genau dann wahr wenn die Liste der OIDs in der erzeugten E Mail weggelassen werden soll subject String Betreff der E Mail text String Inhalt der E Mail In diesem Abschnitt werden die Methoden von WCM WebServices vorge stellt mit denen Staging Aktionen realisiert werden k nnen Ausleihen von Objekten zur Bearbeitung siehe checkOut auf Seite 102 Ausleihen von Objekten r ckg ngig machen siehe undoCheckOut auf Seite 108 Zur ckgeben von Objekten nach der Bearbeitung siehe checkIn auf Seite 101 Objekte ohne Vorlegen direkt freigeben siehe directRelease auf Seite 103 Objekte zur Qualit tssicherung vorlegen siehe submit auf Seite 106 und submitlmmediately auf Seite 107 100 Livelink WCM Server Objektverwaltung Objekte in der Qualit tssicherung ablehnen siehe reject auf Seite 104 Objekte in der Qualit tssicherung freigeben siehe release auf Seite 105 In der folgenden bersicht sind die Methoden alphabetisch sortiert checkIn Gibt den modifizierten Inhalt des angegebenen WCM Objekts an das WCM System zur ck Parameter Tabelle 29 Parameter der Methode checkIn Parameter Datentyp Beschreibung oid ObjectId OID des betreffenden WCM Objekts content byte Inhalt des WCM Objekts als Datei spezifizier
63. dTypes xmlns xsi http www w3 org 2001 XMLSchema instance xmins xsd http www w3 org 2001 XMLSchema gt lt soap Body soap encodingStyle http schemas xmlsoap org soap encoding gt lt tns filter gt lt filter href id1 gt lt startOID href id2 gt lt sortList href id3 gt lt startResult xsi type xsd int gt 0 lt startResult gt lt numberOfResults xsi type xsd int gt 5 lt numberOfResults gt lt attributeKeys href id4 gt lt tns filter gt lt tns EqualFilter id id1 xsi type tns EqualFilter gt lt key href id5 gt lt value href id6 gt lt caseSensitive xsi type xsd boolean gt false lt caseSensitive gt lt tns EqualFilter gt lt tns ObjectId id id2 xsi type tns ObjectId gt lt id xsi type xsd string gt 1 lt id gt lt tns ObjectId gt lt soapenc Array id id3 soapenc arrayType tns Sort 1 gt lt Item href id7 gt lt soapenc Array gt lt soapenc Array id id4 soapenc arrayType xsd string 4 gt lt Item gt createdDate lt Item gt lt Item gt objectId lt Item gt lt Item gt objectState lt Item gt lt Item gt title lt Item gt lt soapenc Array gt lt tns Key id id5 xsi type tns Key gt WCM WebServices Programmierhandbuch 157 Kapitel 6 lt stringValue xsi type xsd string gt objectType lt stringValue gt lt tns Key gt lt tns ObjectType id id6 xsi type tns ObjectType gt lt name xsi type xsd string gt PDF l
64. der null R ckgabe Keine Voraussetzungen Erforderliches Zugriffsrecht READ und CHANGE_RIGHTS m Objektstatus keine Einschr nkungen Folge Der Objektstatus ndert sich nicht WCM WebServices Programmierhandbuch 117 Kapitel 5 removeWor kf LowAsync Hebt die Zuordnung zwischen dem Workflow Objekt und mehreren WCM Objekten auf Hierbei handelt es sich um eine asynchrone Methode d h die Methode kehrt praktisch sofort nach dem Aufruf zur ck und wartet nicht bis die damit verbundenen Aufgaben abge schlossen sind Tabelle 46 Parameter der Methode removehWorkflowAsync Parameter Datentyp Beschreibung oids ObjectId OIDs der WCM Objekte deren Zuord nung zu einem Workflow Objekt aufgehoben werden soll remark String Zeichenkette die zum Protokoll der WCM Objekte hinzugef gt wird oder null R ckgabe Keine Voraussetzungen Erforderliches Zugriffsrecht READ und CHANGE_RIGHTS Objektstatus keine Einschr nkungen Folge Der Objektstatus ndert sich nicht 118 Livelink WCM Server Objektverwaltung 5 5 Methoden der Objektverwaltung In diesem Abschnitt werden die Methoden von WCM WebServices vorge stellt mit denen WCM Objekte bearbeitet werden k nnen Objekte anlegen m neue Objekte anlegen siehe create auf Seite 128 verkn pfte Objekte durch einen Import anlegen siehe multilmport auf Seite 142 Objekte erhalten und bearbeiten Objekt mit der angege
65. der null R ckgabe keine WCM WebServices Programmierhandbuch 131 Kapitel 5 Voraussetzungen Erforderliche Zugriffsrechte READ und RELEASE m Objektstatus muss DELETED sein Folge Nach dem Zerst ren ist das WCM Objekt einschlie lich aller alten Versionen nicht mehr im WCM System sichtbar generatePage 132 Erzeugt die Seiten zu der angegebenen Liste von WCM Objekten Seitengenerierung WCM Objekte deren generierte Seiten mithilfe der Funktion Seite entfernen aus der Produktionssicht entfernt wurden k nnen mit dieser Methode nicht neu generiert werden Solche Objekte m ssen noch einmal s mtliche Staging Stufen durch laufen ehe sie wieder ver ffentlicht werden k nnen Parameter Tabelle 58 Parameter der Methode generatePage Parameter Datentyp Beschreibung dplSystem String Name eines Deployment systems oids ObjectId Liste von OIDs useReleasedTemplate boolean true falls die freigegebene Vorlage verwendet werden soll false fur die aktuelle Version der Vorlage dplWaitInfo DeploymentWait Liste der Deploymentsysteme Info oder null Livelink WCM Server Objektverwaltung R ckgabe keine Voraussetzungen Erforderliches Zugriffsrecht READ m Objektstatus keine Einschr nkungen Folge Der Objektstatus ndert sich nicht get Liefert das WCM Objekt mit der angegebenen OID in der definierten Version ber den Parameter attrKeys k
66. die ObjectId mit der OID des zu ndernden WCM Objekts m das Array attributeKeys mit dem Attributnamen ACL 7 Rufen Sie mit diesem ObjectData Objekt die Methode change auf um die neuen Rechte f r das WCM Objekt zu setzen siehe change auf Seite 122 Datentyp Multi ImportPart Dieser Datentyp dient dazu eine baumartige Struktur von WCM Objekten zu repr sentieren die von Livelink WCM Server mit der Methode multiImport angelegt werden k nnen siehe multilmport auf Seite 142 Tabelle 22 Die Komponenten des Datentyps MultiImportPart Attribut Datentyp Beschreibung children MultilImportPart Hier werden die unterhalb des aktu ellen WCM Objekts anzulegenden WCM Objekte definiert Diese Liste wird nur ausgewertet wenn das anzulegende Objekt den Typ Thema hat 92 Livelink WCM Server Objektverwaltung Attribut Datentyp Beschreibung content base64Binary Inhalt des anzulegenden WCM Objekts Hier darf null stehen wenn das Objekt ohne Inhalt ange legt werden soll Hinsichtlich des Inhalts gelten die Regeln f r den jeweiligen Objekttyp So muss ein Objekt vom Typ Frame zum Beispiel einen frameset Tag enthalten objectData ObjectData Hier werden die Metadaten des anzu legenden Objekts definiert Folgende Felder m ssen dabei gesetzt sein deploymentHint Der Vorschlag f r den Dateinamen der generierten Seite objectType Der Objekttyp des anzulegenden WCM Objekts
67. dieser Beschreibung baut der Dienstnehmer eine Verbindung zum Dienstanbieter bzw zu dessen Web Service auf und kann so auf den gew nschten Dienst zugreifen Die folgende Abbildung veranschaulicht das Zusammenspiel zwischen den genannten Rollen und den einzelnen Aktionen 20 Livelink WCM Server Konzepte Dienst beschreibung Dienstverzeichnis Anfrage Ver ffentlichung WSDL UDDI WSDL UDDI Dienstnehmer Verbindung Dienstanbieter SOAP Dienst beschreibung Abb 1 Rollen und Aktionen innerhalb der Web Service Architektur Standards f r Web Services Die folgenden Standards bestimmen im Wesentlichen den Web Services Standard m SOAP m WSDL Web Services Description Language UDDI Universal Description Discovery and Integration Diese Standards werden in den folgenden Abschnitten kurz beschrieben SOAP SOAP ist ein Standard der den plattformunabh ngigen Zugriff auf Web Services erm glicht bzw die Daten bertragung zwischen dem Dienstan bieter und dem Dienstnehmer definiert Das verwendete Austauschformat ist XML WCM WebServices Programmierhandbuch 21 Kapitel 2 WSDL WSDL Web Services Description Language ist die Beschreibungs sprache fur Web Services Es handelt sich dabei um einen XML basierten Standard Fur die Nutzung eines Web Service seitens einer Applikation ist eine genaue Sprachregelung bzw Beschreibung erforderlich
68. e Verbindung zu dem entspre chenden Web Service aufzubauen SOAP ist das eingesetzte Standard Protokoll f r den Zugriff auf den Web Service 6 Der eigentliche Datenaustausch erfolgt ber das Austauschformat XML bzw das Protokoll HTTP Web Services nutzen Die WSDL Datei liefert die Beschreibung eines Web Service Zur Interpre tation dieser Beschreibung stehen Dienstnehmern verschiedene Werk zeuge Toolkits zur Verf gung die die Beschreibung einlesen und automatisch in ein f r ihre Client Anwendung nutzbares Modul umwan deln Der Dienstnehmer oder auch Client bindet dieses Modul in seine Entwicklungsumgebung ein und schreibt seine eigene Applikation in der von seinem Werkzeug unterst tzten Programmiersprache Das Modul arbeitet wie ein Web Service Proxy der Objekte annimmt und im Namen einer anderen Anwendung ausf hrt Der Web Service Client kann also mithilfe des Moduls bzw des Proxys den eigentlichen Web Service ansprechen und dessen angebotenen Funktionen bzw Methoden nutzen Die entsprechenden Objekte werden ber das Modul wieder an die Appli kation gegeben 24 Livelink WCM Server Konzepte Hinweis Dienstnehmer die mit SOAP vertraut sind k nnen die f r den Zugriff auf den Web Service erforderlichen HTTP Requests auch ohne zusatzliches Werkzeug erstellen Die folgende Abbildung veranschaulicht das Zusammenspiel der einzelnen Komponenten Web Service SOAP SOAP Objekte Objekte
69. e von WCM Objekten zur Qualit tssicherung vor Parameter Tabelle 34 Parameter der Methode submit Parameter oids Datentyp ObjectId Beschreibung OIDs der WCM Objekte die vorgelegt werden pendingReleaseDate Date Datum und Uhrzeit bei verz gerter Freigabe oder null falls eine sofortige Freigabe erm g licht werden soll remark String Zeichenkette die zum Proto koll der WCM Objekte hinzugef gt wird oder null emaillnfo EMaillnfo E Mail Information die an die in den Objektdaten definierten Empf nger gesendet wird oder null falls keine E Mail gesendet werden soll dplWaitInfo DeploymentWait Info Liste der Deploymentsysteme oder null 106 Livelink WCM Server Objektverwaltung R ckgabe keine Voraussetzungen Erforderliche Zugriffsrechte READ und WRITE oder WRITE_META m Objektstatus muss EDITED oder REJECTED sein Folge Nach dem Vorlegen haben die WCM Objekte den Status SUBMITTED submitImmediately Legt eine Liste von WCM Objekten zur Qualitatssicherung vor und erm glicht eine sofortige Freigabe Parameter Tabelle 35 Parameter der Methode submit Immediately Parameter Datentyp Beschreibung oids ObjectId OIDs der WCM Objekte die vorgelegt werden remark String Zeichenkette die zum Protokoll der WCM Objekte hinzugef gt wird oder null emaillnfo EMaillnfo E Mail Information die an die in den Objektda
70. ease oidsToSubmit textAreaRemark Value eMaillnfo dplWaitInfo break case reject service reject oidsToSubmit textAreaRemark Value eMaillnfo dplWaitInfo break and return to the calling page Server Transfer nextURL catch Exception exc Exception el exc rowError Visible true literalError Text exc Message Die gew nschte Aktion wird in einem Try Catch Block ausgef hrt Hier werden alle Ausnahmebedingungen abgefangen WCM WebServices Programmierhandbuch 189 Kapitel 6 Fehlerbehandlung Es liegt in der Natur verteilter Anwendungen dass es mehr m gliche Fehlerquellen gibt Umso sorgf ltiger m ssen Sie als Anwendungsent wickler die Fehlerbedingungen auswerten und in einer Form pr sentieren die f r den Endbenutzer verst ndlich ist Zu den m glichen Fehlerquellen geh ren m Verbindungsprobleme zu WCM WebServices WCM Server nicht erreichbar Authentifizierungsprobleme falscher Benutzer oder falsches Passwort Ablauf der Zeitbegrenzung f r den Aufruf Timeout zu klein SOAP Fehler Client oder Server schicken fehlerhafte bzw nicht korrekt interpretierbare SOAP Envelopes m Fehlermeldungen des WCM API Operation nicht erlaubt System fehler wie zum Beispiel Fehler beim Zugriff auf die Datenbank Alle oben genannten Fehler werden durch eine Message in der gewor fenen Exception beschrieben Diese wird in dem hier dargestellten Mail dialog angezeigt Die
71. egte Objekte bzw nderungen an bestehenden Objekten auch in der QS Sicht sichtbar QS Sicht Die QS Sicht zeigt die WCM Objekte einschlie lich aller nderungen die der Qualit tssicherung vorgelegt worden sind Mitarbeiter der Qualit tssicherung k nnen die nderungen inhaltlich und formal pr fen Aufgrund dieser Pr fung wird entschieden ob ein Objekt zur Nachbesserung zur ckgeschickt oder freigegeben wird F r die Freigabe ist das entsprechende Zugriffsrecht n tig Durch die Freigabe werden die Objekte in die Produktionssicht bertragen Damit wird die aktuelle Version in der publizierten Website verf gbar Produktionssicht Die Produktionssicht stellt die freigegebenen Seiten einer Website bereit Mithilfe eines HTTP Servers kann auf die Seiten ber das Internet oder Intranet zugegriffen werden Je nach Objektstatus sind die WCM Objekte einer Website in verschie denen Sichten verf gbar und k nnen bearbeitet werden Ein neu ange legtes Objekt ist beispielsweise nur in der Edit Sicht sichtbar nicht aber in der QS oder Produktionssicht Durch verschiedene Aktionen im Rahmen der Objektverarbeitung kann der Status eines WCM Objekts in den verschiedenen Sichten unterschiedlich sein 34 Livelink WCM Server Konzepte Authentifizierung und Zugriffsrechte Fur das Arbeiten mit dem WCM System muss sich ein Benutzer authenti fizieren Bei der Anmeldung ist daher die Angabe einer eindeutigen Benutzerkennung User D und ein
72. ehmens entspricht Ist dies der Fall wird das Objekt freigegeben Durch die Freigabe wird die qualit tsgesicherte Version des Objekts in die Produktionssicht bertragen und damit dem Endbenutzer in der publizierten Website verf gbar gemacht Navigationstopologie Nach Themen angeordnete Struktur von WCM Objekten innerhalb einer Website Themenstruktur 196 Livelink WCM Server Glossar Objektdaten Bestandteile eines WCM Objekts Inhalt Metadaten und Protokoll Objektkategorie Zuordnung eines WCM Objekts zu einer bestimmten Kategorie Aufgrund dieser Zuordnung hat das WCM Objekt eine Reihe von zus tzlichen Spezialattributen Metadaten Objekttyp Bezeichnet die spezifische Art des jeweiligen Objekts z B HTML Seite HTML Vorlage Thema Aus dem Objekttyp ergeben sich verschiedene Eigenschaften des WCM Objekts Der Objekttyp wird beim Anlegen des Objekts festgelegt und kann f r einige Objekttypen nachtr glich ge ndert werden Objekttypen k nnen ber den Admin Client oder den Content Client bearbeitet werden Produktionssicht Die Produktionssicht von Livelink WCM Server stellt die freigegebenen Seiten einer Website bereit Mithilfe eines Webservers kann auf die Seiten ber das Internet Intranet oder Extranet zugegriffen werden QS Sicht Die QS Sicht von Livelink WCM Server dient der Qualitatssicherung der Objekte und damit der Website Inhalte Diese Sicht stellt also die Kontrollinstanz
73. ekt ber die Gruppen bzw Rollenzugeh rigkeit Funktionsbereichen zugeordnet sein um bestimmte Aktionen im Rahmen der Website Verwaltung durchzu f hren Allgemeine Informationen zu Funktionsbereichen erhalten Sie im Abschnitt Funktionsbereiche auf Seite 36 In WCM WebServices werden Funktionsbereiche durch den Datentyp FunctionalArearepr sentiert Die Methode getFunctionalAreas liefert alle innerhalb des WCM System definierten Funktionsbereiche Der Datentyp FunctionalArea enth lt den Namen des Funktionsbe reichs und die Mengen von Benutzern Gruppen und Rollen die diesem Funktionsbereich direkt zugeordnet sind Die folgende Tabelle zeigt die verf gbaren Standard Funktionsbereiche und die dazugeh rigen Namen ber den Admin Client k nnen eigene Funktionsbereiche angelegt und Objekttypen zugeordnet werden Diese Funktionsbereiche werden durch ihren Namen repr sentiert Tabelle 8 Namen der Standard Funktionsbereiche Funktionsbereich Konstante Erlaubte Ansicht oder Funktion im Content Client Basis VIP Anlegen Ausleihen und Zur ckgeben von Objekten Fortgeschritten ADVANCED die auf den zugeordneten Objekttypen basieren Dynamisch DYNAMIC Formular FORM Workflow WORKFLOW Zuordnung von Workflows zu Objekten herstellen und aufheben 62 Livelink WCM Server Zugriff auf Administrationsdaten und Authentifizierung Funktionsbereich Konstante Erlaubte Ansicht oder Funktion im Co
74. eld und Schaltfl chen bezeichnungen Pfade zu Verzeichnis Laufwerk Verzeichnis D WCM sen Namen von Dateiname admin bat Dateien und Ver zeichnissen Zitate aus Programm Code Zitate lt head gt code oder Konfigu lt title gt heading rationsdateien lt title gt lt head gt Variablen d h Variable WCM Platzhalter f r Installationsver bestimmte Elemente zeichnis Wichtige Hinweise und Warnungen stehen in grauen K sten Diese Informationen sollten Sie unbedingt lesen um Fehler bei der Nutzung und Verwaltung von WCM Systemen sowie Datenverluste zu vermeiden 16 Livelink WCM Server WCM WebServices Programmierhandbuch Einleitung 17 18 Livelink WCM Server KAPITEL 2 Konzepte Dieses Kapitel bietet Ihnen eine allgemeine bersicht ber Web Services Anschlie end wird auf die Programmierschnittstelle WCM WebServices und auf die Konzepte von Livelink WCM Server eingegangen 2 1 Web Services Web Services sind ein XML basierter Standard f r Schnittstellen Sie erm glichen eine direkte Kommunikation zwischen verschiedenen Appli kationen ber das Internet Ein Web Service kann von einer Person aber auch von einem anderen Web Service aufgerufen werden der den angebotenen Dienst bzw die angebotene Funktion nutzen m chte F r den Aufruf des Dienstes spielt die zugrunde liegende Software Infrastruktur keine Rolle Die Schnitt stellen sind in einem einheitlic
75. elope serializer endEnvelope end of SOAP message Connector EndMessage create a new SoapReader Dim Reader As New SoapReader Load XML from OutputStream amp display an error on failure If Not Reader Load Connector OutputStream Then Dim reason As String reason IIf Reader dom parseError Is Nothing _ parser unknown reason _ Reader dom parseError reason MsgBox submit failed amp reason vbExclamation Error Exit Function End If if there is an application fault use a message box to report it If Not Reader Fault Is Nothing Then MsgBox submit failed amp _ Reader faultstring nodeTypedValue _ vbExclamation Error 168 Livelink WCM Server Anwendungsbeispiele ElseIf Not Reader Body Is Nothing Then submit True End If End Function Diese Funktion zeigt sehr anschaulich wie die Parameter nach XML seri alisiert werden m ssen m das Array mit den OIDs wird ber die Value Klasse serialisiert m EMaillnfo und DeploymentWaitInfo sind eigene Klassen die jeweils eine xml Funktion beinhalten m das Bemerkungsfeld vom Typ String wird hier direkt ausgegeben f r das Datumsfeld wird die Value Klasse verwendet Alle fehlerhaften bzw fehlenden Parameter werden durch xsi nil True repr sentiert Sie k nnen im Prinzip auch weggelassen werden da Web Services die Parameter ber ihre Namen identifizieren und fehlende Parameter durch die Typ spezifischen Standardwerte False f r Boolean O f
76. en abgelegt werden k nnen VIPP VIP Protocol Propriet res Protokoll zum Austausch von Daten zwischen den Komponenten eines WCM Systems F r die Kommunikation in WANs oder ber das Internet kann VIPP in HTTP getunnelt werden Vorlagentopologie Nach Vorlagen angeordnete Struktur von WCM Objekten innerhalb einer Website Vorlagenstruktur Vorlegen Staging Aktion von Livelink WCM Server Bevor ein neu angelegtes oder ge ndertes Objekt ver ffentlicht werden kann muss es der Qualit tssicherung zur Pr fung vorgelegt werden Durch das Vorlegen werden die nderungen am Objekt in der QS Sicht sichtbar Web Services XML basierter Standard f r Schnittstellen Web Services erm glichen eine direkte Kommunikation zwischen Programmen die in unterschiedlichen Programmiersprachen geschrieben werden und auf verschiedenen Plattformen laufen ber das standardisierte Protokoll SOAP Ein weiterer gro er Vorteil von Web Services ist die Verwendung von Standard Web Formaten und Protokollen XML HTTP und TCP IP 198 Livelink WCM Server Glossar Workflow Definition Beschreibung eines Workflows Eine Workflow Definition setzt sich aus Start und Endpunkten sowie Aktivitaten und berg ngen zusammen Workflow Definitionen werden im Format XPDL gespeichert und k nnen ber den Content Workflow Modeler grafisch bearbeitet werden WSDL Web Services Description Language Beschreibungssprache f r Web Services auf der Grundlage
77. er Parameter in der URL bewirkt die Generierung der WSDL Datei die zum Benutzer bzw Dienstnehmer Ubertragen wird Datenhaltungssicht Der Zugriff auf eine Website Uber WCM WebServices bezieht sich immer auf eine bestimmte Daten haltungssicht M gliche Werte sind Edit Sicht edit QS Sicht ga Produktionssicht prod Die verschiedenen Sichten auf die Website Daten werden von den entsprechenden Deploymentsystemen erzeugt F r die Generierung der WSDL Datei sind die Informationen zur Datenhaltungssicht und zum Namen des Deploymentsystems nicht zwingend erforderlich Geben Sie die Sicht auf die Website Daten nicht an werden standardm ig die Daten zur Edit Sicht bertragen m Name des Deploymentsystems Geben Sie den Namen des Deploymentsystems an auf dessen Daten Sie zugreifen m chten Das Deploymentsystem muss auf einem Content Server installiert sein der im Kontext einer JSP Engine bzw als Webanwendung in einem Application Server l uft Wenn Sie kein Deploymentsystem angeben wird dies automatisch bestimmt Dabei sucht der Content Server nach einem Deployment system dessen Basis URL der des angebotenen Web Service hnelt Auf diese Weise soll auch bei fehlender Angabe des Deploy mentsystems gew hrleistet werden dass der Web Service Client URLs bermittelt bekommt mit denen er auf die generierten Seiten zugreifen kann WCM WebServices Programmierhandbuch 45 Kapitel 3 Hinweis Um den Zugriff auf d
78. er Zuordnung zwischen Workflow und WCM Objekt In diesem Abschnitt werden die Methoden von WCM WebServices vorge stellt mit denen die Workflow Aktionen realisiert werden k nnen assignWorkflow Ordnet die aktuell freigegebene Version eines Workflow Objekts dem angegebenen WCM Objekt zu Ein initialer bergang muss ausge w hlt werden der nach der Zuordnung automatisch ausgef hrt wird Parameter Tabelle 37 Parameter der Methode assignWorkflow Parameter Datentyp Beschreibung oid ObjectId OID des WCM Objekts dem ein Work flow zugeordnet werden soll workflowOid ObjectId OID des zugeordneten Workflows WCM WebServices Programmierhandbuch 109 Kapitel 5 Parameter Datentyp Beschreibung startTransition String Name des initialen Ubergangs remark String Zeichenkette die zum Protokoll des WCM Objekts hinzugef gt wird oder null emaillnfo EMaillnfo E Mail Information die an den Prin cipal gesendet wird der der n chsten Aktivit t zugeordnet ist oder null falls keine E Mail gesendet werden soll R ckgabe keine Voraussetzungen Erforderliche Zugriffsrechte READ Objektstatus wird durch die initiale Workflow Aktivitat bestimmt m Funktionsbereich WORKFLOW Folge Der Objektstatus andert sich nicht assignWorkflowAsync Ordnet die aktuell freigegebene Version eines Workflow Objekts mehreren WCM Objekten zu Ein initialer bergang muss ausge
79. er verwendeten Programmiersprache abh ngt wurde eine allgemeine Form der Beschreibung von Methodennamen und Parametern gew hlt Im letzten Abschnitt wird die Suche nach WCM Objekten mithilfe von Filtern beschrieben siehe Abschnitt 5 6 Suchen nach WCM Objekten auf Seite 147 WCM WebServices Programmierhandbuch 75 Kapitel 5 5 1 WCM spezifische Datentypen Jedes WCM Objekt wird durch eine Reihe von Daten reprasentiert Um uber WCM WebServices auf das WCM System zuzugreifen bendtigen Sie Kenntnisse Uber die verwendeten Datentypen Ein Datentyp legt dabei die mdglichen Werte und deren Verwendung fest In Livelink WCM Server werden die Daten intern sofern es sich nicht um Java Basistypen wie Integer oder Boolsche Werte handelt durch Java Klassen bzw Java Interface Definitionen charakterisiert In WCM WebServices sind diesen Datentypen XML Schema Datentypen zugeordnet Zum Teil k nnen dabei die Standard XML Schema Simple Types verwendet werden F r andere WCM Datentypen m ssen WCM spezifische Complex Types verwendet werden die zum Namensraum http gaussvip com geh ren Eine vollst ndige bersicht ber die verwendeten Datentypen bietet die WSDL Datei von WCM WebServices siehe Inhalt der WCM WebServices Beschreibung auf Seite 46 Im Folgenden werden die wichtigsten Datentypen beschrieben OID und Versionen von WCM Objekten siehe Datentyp Object Id auf Seite 77 M
80. erden Das Staging von Livelink WCM Server bestimmt den Status eines WCM Objekts Entsprechend den Aktionen der Objektverarbeitung werden die folgenden Objektstatus unterschieden ge ndert auch bei neu angelegten Objekten ausgeliehen vorgelegt abgelehnt freigegeben verz gert freigegeben gel scht Durch die verschiedenen Arbeitsschritte bzw Aktionen am WCM Objekt ndert sich der jeweilige Status eines Objekts Jede Status nderung wird protokolliert Dabei wird die vorherige Version eines WCM Objekts immer in einer separaten Datenhaltung archiviert sodass ltere Versionen nicht 30 Livelink WCM Server Konzepte verloren gehen Auf diese Versionen k nnen Sie jederzeit wieder zugreifen Welche Aktionen Sie an einem WCM Objekt durchf hren k nnen h ngt von folgenden Faktoren ab dem aktuellen Status des WCM Objekts Hinweis Die M glichkeit bestimmte Aktionen am Objekt durchzu f hren h ngt auch vom Status des bergeordneten Themas innerhalb der Navigationstopologie ab der Zugriffssteuerungsliste des WCM Objekts m den zugewiesenen Funktionsbereichen des Benutzers Objekttyp Der Objekttyp bestimmt zu welcher Klasse von Dokumenten ein WCM Objekt geh rt Daraus ergeben sich verschiedene Eigenschaften des WCM Objekts u a Attribute aus einer Attributmenge ber die das WCM Objekt verf gt Art der Vorlagen die das WCM Objekt verwenden kann Dateien die be
81. ert betr gt 3 Minuten Mit Ausnahme aufwendiger Importe von verkn pften Objekten sind WCM WebServices Aufrufe normalerweise innerhalb k rzerer Zeit beendet Sie k nnen die Zeitbegrenzung mithilfe des Attributs service Timeout in Millisekunden auf einen beliebigen anderen Wert einstellen So stellt service Timeout 60000 10 die Zeitbegren zung auf 10 Minuten ein 184 Livelink WCM Server Anwendungsbeispiele Aufbau der Seite Beim Laden der ASP Seite wird die Methode Page Load aufgerufen Hier wird der Filter ber den Web Service ausgef hrt private void Page_Load object sender System EventArgs e Put user code to initialize the page here initialize the service intializeService if IsPostBack load the data into the DataGrid tableOfObjects DataSource filterPDF tableOfObjects DataBind Die eigentliche Filterung ist dabei in die folgende Methode ausgelagert lt summary gt Retrieves all PDF files via a WCM Web Service call lt summary gt lt returns gt lt returns gt private ObjectData filterPDF EqualFilter filter new EqualFilter filter key new Key filter value new ObjectType filter key stringValue objectType ObjectType filter value name PDF ObjectId startId new ObjectId startId id 1 Sort sortList new Sort new Sort sortList 0 stringValue createdDate sortList 0 d
82. es Passworts erforderlich Die Uber pr fung der Angaben bernimmt der Master Administrationsserver des WCM Systems Innerhalb eines WCM Systems gibt es verschiedene Berechtigungen Fur die Arbeit mit WCM Objekten sind vor allem die Objekt Zugriffsrechte und Funktionsbereiche wichtig Zugriffsrechte fur WCM Objekte Livelink WCM Server f hrt f r jedes WCM Objekt eine Zugriffssteuerungs liste Access Control List ACL In dieser Liste ist festgelegt Uber welche Zugriffsrechte die jeweiligen Benutzer Gruppen oder Rollen die so genannten Principals verf gen Dabei k nnen Zugriffsrechte explizit als erlaubt bzw verboten ausgezeichnet werden oder sie werden nicht explizit gesetzt Bei einer Rechte berpr fung werden im letzteren Fall alle zugewiesenen Gruppen und Rollen dahingehend untersucht ob sie eine explizite Erlaubnis oder ein Verbot definieren wobei ein Verbot immer Vorrang hat Die Zugriffssteuerungslisten werden vererbt d h jedes in der Navigati onssicht tiefer angeordnete WCM Objekt erbt in der Regel die Rechte des bergeordneten Objekts Beim Anlegen einer Website wird ein Principal ausgew hlt der initial vollen Zugriff auf alle Objekte der Website hat Website Administrator Dieser wird in der Zugriffssteuerungsliste des Wurzelobjekts der Website aufgenommen Alle weiteren WCM Objekte dieser Website erben falls nicht explizit gesetzt die Rechte des Wurzel objekts WCM WebServices Programmierhandbuc
83. escending true String attributeKeys new String objectId objectState title WCM WebServices Programmierhandbuch 185 Kapitel 6 createdDate createdBy modifiedDate modifiedBy URL return service filter filter startId sortList 0 100 attributeKeys Dieser Code zeigt noch einmal wie einfach es ist die Methoden von WCM WebServices zu nutzen Durch die CodeCompletion Technik in Visual Studio haben Sie sofort einen berblick ber die verf gbaren Methoden Datentypen und Attribute Aufbau der Tabelle Zur Darstellung der Filterergebnisse wird ein DataGr id Control verwendet Es bietet eine ausreichende Flexibilit t in der Darstellung der Daten F r die Pr sentation der Daten sorgen so genannte TemplateColumns Im ItemTemplate hat man vollen Zugriff auf den Inhalt der aktuellen Tabellenzeile hier ein ObjectData Objekt Damit die Darstellung der Ergebnisse funktioniert muss die Eigenschaft AutoGenerateColumns des DataGrid auf False gesetzt werden So sehen die ItemTemplates aus lt asp TemplateColumn HeaderText ID gt lt ItemTemplate gt lt asp Label id C_OID runat server Text lt ObjectData Container DataItem objectId id gt gt lt asp Label gt lt ItemTemplate gt lt asp TemplateColumn gt 186 Livelink WCM Server Anwendungsbeispiele In einer Zelle der Tabelle k nnen aber auch mehrere Elemente verwendet werden hier z B das Symbol f
84. essage gt lt detail gt lt soap Fault gt lt soap Body gt lt soap Envelope gt 48 Livelink WCM Server Einsatz von WCM WebServices Exceptions des Content Servers Die Fehlersituationen auf dem Content Server werden durch folgende Exceptions klassifiziert Tabelle 2 Exceptions und m gliche Ursachen Name der Exception M gliche Ursache AccessDenied Exception Die aufgerufene Methode erfordert eine Aktion f r die der angemeldete Benutzer keine Berechtigung hat ActionNotPermitted Exception Das Ausf hren einer Methode wird verweigert da dies zu einer Regelverletzung f hren w rde Dies kann z B der Fall sein wenn ein WCM Objekt vorgelegt werden soll dessen bergeordnetes Thema noch nicht in der QS Sicht sichtbar ist Eine andere Ursache k nnte sein dass das Ausf hren der Methode zu Namenskonflikten f hren w rde AttributeException DatabaseException Diese Exception tritt auf wenn ein unbekanntes Attribut bergeben wird ein Attribut ge ndert werden soll das der Benutzer nicht ndern darf oder f r das Attribut ein von der Website Konfigu ration abweichender Datentyp verwendet wird Beim Zugriff auf das von Livelink WCM Server genutzte RDBMS traten Probleme auf FileException Beim lesenden oder schreibenden Zugriff auf eine Datei traten Probleme auf InvalidContextId Exception WCM WebServices verwaltet fur jeden angemel deten Dienstnehmer e
85. etadaten siehe Datentyp ObjectData auf Seite 78 Objekttyp siehe Datentyp ObjectType auf Seite 84 Objektstatus siehe Datentyp ObjectState auf Seite 86 Objekt Zugriffsrechte siehe Datentyp Permission auf Seite 88 Zugriffsteuerungsliste siehe Datentyp Ac1 auf Seite 90 Eintrag in der Zugriffssteuerungsliste siehe Datentyp AclEntry auf Seite 91 76 Livelink WCM Server Objektverwaltung Repr sentation von Baumstrukturen f r Objekte siehe Datentyp MultiImportPart auf Seite 92 m Workflow Aktionen siehe Datentypen f r Workflow Aktionen auf Seite 94 Datentyp ObjectId Die Objekt ID die so genannte OID repr sentiert eine Referenz auf ein WCM Objekt Sie ist ein eindeutiger Bezeichner f r ein WCM Objekt innerhalb einer Website Die Eindeutigkeit bezieht sich nur auf die aktuelle Version eines WCM Objekts Archivierte Objekte haben dieselbe OID mit einer unterschiedlichen Versionsnummer Tabelle 12 Die Komponenten des Datentyps ObjectId Attribut Datentyp Beschreibung id String Interne Repr sentation als Zeichenkette Wenn ein WCM Objekt eine Staging Stufe wie Bearbeitung oder Quali t tssicherung durchl uft entsteht eine neue Version des Objekts Die Versionierung von WCM Objekten erfolgt mithilfe des Datentyps Version Eine Version besteht aus drei Nummern f r Hauptversion major Neben version minor und Mikroversion micro Die M
86. ete 123 checkReferencesForRelease 124 checkReferencesForSubmit 125 convertContent 126 copy 127 create 128 delete 129 depublishPage 130 destroy 131 directRelease 103 188 Index filter 151 forward 112 generatePage 132 get 133 getAssignedJobs 113 getAssignedWorkflow 113 getAssignedWorkflowActivities 114 getAssignedWorkflows 114 getAttributeSets 65 getAvailableWorkflows 115 getCheckOutContent 134 getChildren 135 getContent 136 getDeploymentJobs 137 getDeploymentSystems 67 getExternalLinks 138 getFunctionalAreas 64 getGroupProfiles 58 getLanguages 70 getLastLogEntries 138 getObjectCategories 65 getObjectTypes 65 getParent 139 getRoleProfiles 59 getRunlevel 69 getUserProfiles 60 getVersionList 140 getVIPVersion 70 getWebsiteNames 66 getWorkflow 115 isForwardable 116 isRemovable 116 listAllRunlevels 70 logout 72 move 141 multilmport 142 reject 104 188 release 105 188 removeWorkflow 117 removeWorkflowAsync 118 restoreVersion 145 sortParentsFirst 146 WCM WebServices Programmierhandbuch 203 Index submit 106 188 submitImmediately 107 substituteLogin 72 undoCheckout 108 move 141 multilmport 142 Multilmport Info 92 MultilmportPart 92 O ObjectData 78 Objectld 77 ObjectState 86 ObjectType 84 Objektkategorien abfragen 65 Objektserialisierung 158 Objekttyp 84 abfragen 65 OID 77 P Passwort ndern 71 Permission 88 Protokolleintrage eines WCM Objekts abfragen 138 R reject 1
87. eter der Methode create 128 Tabelle 55 Parameter der Methode delete 129 8 Livelink WCM Server Tabelle 56 Tabelle 57 Tabelle 58 Tabelle 59 Tabelle 60 Tabelle 61 Tabelle 62 Tabelle 63 Tabelle 64 Tabelle 65 Tabelle 66 Tabelle 67 Tabelle 68 Tabelle 69 Tabelle 70 Tabelle 71 Tabelle 72 Tabelle 73 Tabelle 74 Tabelle 75 Parameter der Methode depublishPage Parameter der Methode destroy Parameter der Methode generatePage Parameter der Methode get Parameter der Methode getCheckOutContent Parameter der Methode getChildren Parameter der Methode getContent Parameter der Methode getDeployment Jobs Parameter der Methode getExternallinks Parameter der Methode getLastLogEntries Parameter der Methode getParent Parameter der Methode getVersionList Parameter der Methode move Parameter der Methode multiImport Parameter der Methode restoreVersion Parameter der Methode SortParentsFirst Attributtypen und Filter Parameter der Methode filter Klassenmodule ASP NET Beispiel WCM WebServices Programmierhandbuch 130 131 132 133 134 135 136 137 138 139 140 141 141 143 145 146 149 152 163 182 10 Livelink WCM Server KAPITEL 1 Einleitung WCM WebServices ist eine Programmierschnittstelle die den Zugriff auf viele von Livelink Web Content Management Server kurz Livelink WCM Server angebotene Funktionen erm glicht Mithilfe von WCM WebServices k nnen Sie von einem beliebigen Rechner aus auf einen Co
88. fe von WCM WebServices k nnen Sie auf die Daten und Funktionen des Administrationsservers des WCM Systems zugreifen Ermitteln der Benutzer Gruppen und Rollenprofilen mit den entsprechenden Einstellungen und Zuordnungen siehe Abschnitt 4 1 Benutzer Gruppen und Rollen auf Seite 54 Ermitteln der Funktionsbereiche von Principals siehe Abschnitt 4 2 Funktionsbereiche auf Seite 62 Ermitteln von Informationen ber Websites siehe Abschnitt 4 3 Websites auf Seite 65 Ermitteln von Informationen ber Deploymentsysteme siehe Abschnitt 4 4 Deploymentsysteme auf Seite 66 Auslesen des Systemzustands Runlevel von WCM Servern und Websites siehe Abschnitt 4 5 Runlevels auf Seite 67 Ermitteln anderer Informationen des WCM Systems wie Version und Sprachen siehe Abschnitt 4 6 Allgemeine Abfragen auf Seite 70 WCM WebServices Programmierhandbuch 53 Kapitel 4 Hinweis Der Zugriff auf die Daten des Administrationsservers setzt Administrationsrechte voraus z B das Recht Zugriff auf Benutzerver waltung f r das Lesen von Benutzer Gruppen und Rollenprofilen und Zugriff auf Systemverwaltung f r das Lesen von Systeminforma tionen Weitere Informationen zu den Administrationsrechten finden Sie im Livelink WCM Server Administratorhandbuch Um die Funktionen von Livelink WCM Server ber WCM WebServices nutzen zu k nnen ist au erdem die Anmeldung am WCM System erfor
89. genutzt wird Im Fehlerfall wird unten eine Zeile mit der Fehlerbe schreibung eingeblendet CookieContainer CredentialCache NetworkCredential Server Session EqualFilter VipWebService lt asp Label gt lt asp literal gt lt tr runat server gt VipWebService SoapException WCM WebServices Programmierhandbuch 183 Kapitel 6 Verbindungsaufbau Die korrekte URL f r den Verbindungsaufbau wird von WCM WebServices in das WSDL eingetragen und von Visual Studio in den automatisch erzeugten Code eingefugt Ihre Aufgabe ist es den Code f r die Authentifizierung und das Session Tracking einzuf gen lt summary gt Initializes the service and saves the service reference within the sesion as service lt summary gt private void intializeService service VipWebService Session service if service null service new VipWebService allow reception of cookies service CookieContainer new CookieContainer create the necessary credentials using basic authentication NetworkCredential credentials new NetworkCredential userName userPassword CredentialCache credCache new CredentialCache credCache Add new Uri service Url Basic credentials service Credentials credCache Session service service Session Timeout 60 Hinweis Das NET Framework hat eine voreingestellte Zeitbegrenzung f r synchrone Web Service Aufrufe Der Standardw
90. gt lt SOAP ENV Body gt lt SOAPSDK1 filter xmins SOAPSDK1 http gaussvip com gt lt filter xsi type vip EqualFilter gt lt key xsi type vip Key gt lt stringValue xsi type xsd string gt objectType lt stringValue gt lt key gt 158 Livelink WCM Server Anwendungsbeispiele lt value xsi type vip ObjectType gt lt name type xsd string gt PDF lt name gt lt value gt lt filter gt lt startOID xsi type vip ObjectId gt lt id xsi type xsd string gt 1 lt id gt lt startOID gt lt sortList xsi type SOAP ENC Array SOAP ENC arrayType vip Sort 1 gt lt Item xsi type vip Sort gt lt stringValue xsi type xsd string gt createdDate lt stringValue gt lt descending xsi type xsd boolean gt False lt descending gt lt Item gt lt sortList gt lt startResult xsi type xsd int gt 0 lt startResult gt lt numberOfResults xsi type xsd int gt 5 lt numberOfResults gt lt attributeKeys xsi type SOAP ENC Array SOAP ENC arrayType xsd string 4 gt lt Item xsi type xsd string gt createdDate lt Item gt lt Item xsi type xsd string gt objectId lt Item gt lt Item xsi type xsd string gt objectState lt Item gt lt Item xsi type xsd string gt title lt Item gt lt attributeKeys gt lt SOAPSDK1 filter gt lt SOAP ENV Body gt lt SOAP ENV Envelope gt In den folgenden Abschnitten werden wir die Konstruktion solcher einfach formulierten S
91. gt ein Beispiel f r eine SOAP Fehlermeldung die dadurch entstanden ist dass der angemeldete Benutzer admin nicht das Recht besitzt Uber release ein WCM Objekt freizugeben lt xml version 1 0 encoding UTF 8 gt lt soap Envelope xmlns soap http schemas xmlsoap org soap envelope xmins soapenc http schemas xmlsoap org soap encoding xmins tns http gaussvip com xmins types http gaussvip com encodedTypes xmins xsi http www w3 org 2001 XMLSchema instance xmins xsd http www w3 org 2001 XMLSchema gt lt soap Body gt lt soap Fault gt lt faultcode gt tns Server AccessDeniedException lt faultcode gt lt faultstring gt 0474 Der Benutzer amp apos admin amp apos besitzt nicht das Recht amp apos Freigeben amp apos lt faultstring gt lt faultactor gt Vip Content Manager API lt faultactor gt lt detail gt lt tns message sequenceNo 0 gt 0303 Der Master Server konnte die Anfrage nicht ausf hren lt tns message gt lt tns message sequenceNo 1 gt 0635 Das Freigeben von Objekt amp apos 171 amp apos ist fehlgeschlagen lt tns message gt lt tns message sequenceNo 2 gt 0300 W hrend der Vorbereitung der Aktion amp apos Freigeben amp apos auf Objekt amp apos 171 amp apos in der Website amp apos Susi amp apos trat ein Fehler auf lt tns message gt lt tns message sequenceNo 3 gt 0474 Der Benutzer amp apos admin amp apos besitzt nicht das Recht amp apos Freigeben amp apos lt tns m
92. h richtigung verwendet werden sollen wenn das WCM Objekt zur Quali t tssicherung vorgelegt wurde 82 Livelink WCM Server Objektverwaltung Attribut Datentyp Beschreibung releasedBy User a Kennung des Benutzers der das WCM Objekt zuletzt freigegeben hat releasedDate dateTime d q Datum mit Uhrzeit an dem das WCM Objekt zuletzt freigegeben wurde releaseEMail Receivers String A E Mail Adressen die zur Benach richtigung verwendet werden sollen wenn das WCM Objekt freigegeben wurde subtitle String A q f berschrift des WCM Objekts surrogateURL String ga URL f r die Surrogatseite des WCM Objekts oder null falls dieser Objekttyp keine Surrogat seite erfordert targetGroup String a f Zielgruppe des WCM Objekts template ObjectId A A PB OID der Vorlage des WCM Objekts oder null falls dem Objekt keine Vorlage zugeordnet ist title String a f Titel Name des WCM Objekts WCM WebServices Programmierhandbuch 83 Kapitel 5 Attribut Datentyp Beschreibung topic ObjectId 7 A OID des Themas unterhalb dessen sich das WCM Objekt befindet oder null falls das WCM Objekt das Wurzelobjekt der Website ist URL String d A URL f r die generierte Seite des WCM Objekts Diese URL h ngt vom Deploymentsystem ab dem WCM WebServices zugeordnet wurde Existiert kein Deployment
93. h 35 Kapitel 2 Funktionsbereiche Jedem Principal k nnen Funktionsbereiche zugewiesen werden Uber die Funktionsbereiche steuern Sie welche Funktionen von Livelink WCM Server dem Benutzer zur Verf gung stehen Dabei erf llen die Funktionsbereiche zwei wesentliche Aufgaben m Sie legen fest welche Typen von Objekten die Benutzer anlegen ausleihen und zur ckgeben d rfen Einige Funktionsbereiche wie z B Basis sind mit Objekttypen verkn pft Nur Benutzer die ber den entsprechenden Funktionsbereich verf gen k nnen Objekte dieses Objekttyps anlegen ausleihen und zur ckgeben m Sie bestimmen welche Ansichten und Dialoge dem Benutzer im Content Client zur Verf gung stehen Auf diese Weise k nnen Sie genau festlegen welche Aktionen der Benutzer durchf hren kann Administrationsrechte f r das WCM System Neben den Zugriffsrechten f r WCM Objekte gibt es au erdem Administ rationsrechte f r das WCM System Principals mit Administrationsrechten haben Zugriff auf den Admin Client und k nnen die Elemente des WCM Systems wie Server Websites Deploymentsysteme und Benutzerinfor mationen bearbeiten Die Administrationsrechte k nnen abgestuft gew hrt werden sodass ein Benutzer nur Teilbereiche der Administration einsehen oder bearbeiten kann Die Administrationsrechte k nnen ausschlie lich ber den Admin Client ge ndert werden 36 Livelink WCM Server WCM WebServices Programmierhandbuch Konzepte 37
94. hen Standard definiert und gestaltet Somit k nnen Web Services auf Basis plattformunabh ngiger Technologien angebunden werden F r gesch ftliche Anwendungen bedeutet dies dass die Frage nach der Integrationssoftware der so genannten Middle ware zwischen zwei propriet ren Systemen universell gel st werden kann WCM WebServices Programmierhandbuch 19 Kapitel 2 Web Service Architektur Die Web Service Architektur basiert auf dem Zusammenspiel der folgenden drei Rollen m dem Anbieter eines Web Service bzw Dienstes m einem Dienstverzeichnis dem Dienstnehmer Diese Rollen sind durch bestimmte Aktionen wie Ver ffentlichen Erstellen einer Anfrage sowie Aufbauen einer Verbindung miteinander verkn pft In einem typischen Web Service Szenario verf gt der Anbieter des Web Service ber einen bestimmten Dienst den er ber das Internet zug ng lich machen m chte Der Dienstanbieter definiert zu diesem Zweck eine formale Beschreibung seines Web Service Diese Beschreibung ben tigt ein Dienstnehmer f r den Zugriff auf den Web Service Die Beschreibung kann der Dienstanbieter in einem universellen Dienstverzeichnis ver f fentlichen damit sein Web Service leicht gefunden werden kann Wenn der Dienstnehmer auf einen Web Service zugreifen m chte sucht er den Dienst bzw seine Beschreibung in der Regel in dem Dienstver zeichnis Die Dienstbeschreibung kann er aber auch direkt vom Dienstan bieter erhalten Mithilfe
95. i der Seitengenerierung als Repr sentation des WCM Objekts erzeugt werden Neben Objekttypen wie z B HTML Seite JSP Vorlage oder PDF Dokument gibt es Themenobjekte Ein Themenobjekt kann andere unter geordnete Objekte aufnehmen Es dient insofern auch der Strukturierung der WCM Objekte in der Navigationssicht und damit der Strukturierung der Website Ein weiterer wichtiger Objekttyp ist die Vorlage Sie bestimmt das Layout und ist f r die Seitengenerierung wesentlich WCM WebServices Programmierhandbuch 31 Kapitel 2 Seitengenerierung Der Inhalt eines WCM Objekts unterscheidet sich von den Daten die fur einen HTTP Server generiert werden Jedes WCM Objekt kann eine Vorlage Template haben die in der Regel ein Layout f r die zu generie rende Webseite definiert Eine Vorlage ist selbst ein WCM Objekt das wiederum eine Vorlage enthalten kann Die generierte Seite hangt u a von dieser Vorlagenhierarchie Kaskade ab Weiterhin spielen der Objekttyp des zu generierenden WCM Objekts und die Objekttypen der Vorlagen eine wesentliche Rolle fur die Seitengene rierung So werden beispielsweise fur GIF Objekte zwei Dateien erzeugt die Grafik selbst und eine HTML Seite mit einem Verweis auf die Grafik datei Bei HTML Objekten mit zugeordneter Vorlage wird der Body Bereich des HTML Dokuments ausgeschnitten Entscheidend ist auch die Datenhaltungssicht Edit QS oder Produktion die bestimmt welche Auspragungen
96. ie Komponenten des Datentyps Permission Attribut Datentyp Beschreibung name String Name als Abk rzung des Zugriffsrechts WCM WebServices Programmierhandbuch 89 Kapitel 5 Datentypen fur Zugriffssteuerungslisten Fur das Bearbeiten von Zugriffssteuerungslisten stehen zwei Datentypen zur Verf gung m Acl m AclEntry Datentyp Acl Eine Zugriffssteuerungsliste Access Control List ACL kombiniert eine Menge von Zugriffsrechten In einem WCM System enth lt eine ACL typi scherweise alle Zugriffsrechte die f r ein WCM Objekt gesetzt wurden In einer ACL sind die Zugriffsrechte f r Principals Benutzer Gruppen Rollen Gruppenrollen oder Jeder gesetzt Ein Zugriffsrecht kann gew hrt oder explizit verweigert sein Tabelle 20 Die Komponenten des Datentyps Acl Attribut Datentyp Beschreibung entries AclEntry Array von Zugriffsrechten die dem gegebenen Principal gew hrt oder verweigert werden inherited boolean Dieser Wert ist genau dann wahr wenn dies ein geerbtes ACL Objekt ist d h wenn die Zugriffsrechte vom bergeordneten Objekt ber nommen wurden Das Objekt zu dem die geerbte ACL geh rt ist ber das Attribut owner verf gbar owner ObjectId OID des WCM Objekts zu dem diese ACL gehort 90 Livelink WCM Server Datentyp AclEntry Objektverwaltung Dieser Datentyp repr sentiert die Zuordnung eines Principals zu einem
97. ie Seiten genau zu steuern sollten Sie den exakten Namen des Deploymentsystems mit der gew nschten Datenhaltungssicht explizit in der URL angeben Inhalt der WCM WebServices Beschreibung Die WSDL Datei zur Beschreibung von WCM WebServices enth lt folgende Informationen m Liste der verf gbaren Methoden mit den erforderlichen Eingangspa rametern und den R ckgabewerten WCM spezifische Datentypen URL ber die der Web Service Proxy auf den Content Server zugreift Die Funktions bzw Methodenaufrufe erfolgen ausschlie lich ber entfernte Prozeduraufrufe Die Eingangsparameter jedes Aufrufs enthalten die Daten die der Content Server f r die jeweiligen Methoden aufrufe ben tigt Anschlie end liefert der Web Service Proxy s mtliche Daten ber den R ckgabewert der aufgerufenen Methode an den Client zur ck Die WCM WebServices Beschreibung liefert au erdem s mtliche WCM spezifischen Datentypen die in den Eingangsparametern oder im R ck gabewert enthalten sein k nnen Die wichtigsten Datentypen werden im Abschnitt 5 1 WCM spezifische Datentypen ab Seite 76 n her beschrieben Mit folgender URL greift der Web Service Proxy auf den Content Server zu 46 Livelink WCM Server Einsatz von WCM WebServices Basis URL des HTTP Servers Verzeichnis der Webanwendung WebService Port Website Name Datenhaltungssicht Name des Deploymentsystems 3 3 Fehlerbehandlung F r das Auswerten von
98. ikroversion ndert sich wenn ein WCM Objekt in der Edit Sicht ge ndert wird Ausleihen Meta daten ndern Die Nebenversion ndert sich wenn ein WCM Objekt zur Qualit tssicherung vorgelegt wird wobei dann die Mikroversion auf 0 gesetzt wird Die Hauptversion wird beim Freigeben erh ht wobei die Nebenversion auf 0 gesetzt wird Mithilfe der Methode getVersionList k nnen Sie die verf gbaren Versionen eines WCM Objekts bestimmen siehe getVersionList auf Seite 140 WCM WebServices Programmierhandbuch 77 Kapitel 5 Datentyp ObjectData Allgemeine Informationen zu Objektdaten erhalten Sie im Abschnitt Objektdaten auf Seite 29 Der Datentyp ObjectData enth lt die Metadaten eines WCM Objekts Bei der Suche mit der filter Methode wird ein ObjectData Array zur ckge geben das je ein Element pro gefundenes WCM Objekt enth lt Diese Elemente enthalten dann genau die Attribute die in dem Eingabepara meter attributeKeys der filter Methode angegeben wurden Mit der get Methode k nnen Sie sich diese Daten genau f r ein WCM Objekt einer bestimmten Version vom Server holen auch hier m ssen Sie die gew nschten Attribute in der Liste attributeKeys vorher w hlen Umgekehrt wird bei der change und der create Methode ein Parameter vom Typ ObjectData an den Server bergeben um die Attribute zu ndern bzw die Attribute eines neuen Objekts zu setzen Die Symbole in der folgenden Tabelle verdeutlichen die m glichen
99. iled amp reason vbExclamation Error Exit Function End If if there is a fault use a message box to report it If Not Reader Fault Is Nothing Then MsgBox filter failed amp _ Reader faultstring nodeTypedValue _ vbExclamation Error Else get the return Document Dim resultDom As DOMDocument30 WCM WebServices Programmierhandbuch 173 Kapitel 6 Set resultDom New DOMDocument30 resultDom setProperty SelectionLanguage XPath resultDom async False resultDom validateOnParse False Dim success As Boolean set up the temporary results array Dim results As objectData If Reader Body Is Nothing Then success False Else Let success resultDom loadXML Reader Body xm1 get the nodelist of array items from the response traverse to multiref with corresponding id Dim result As IXMLDOMNode Dim resultId As String look for corresponding attribute href lt xyy gt Set result resultDom selectSingleNode _ filterResult href If Not result Is Nothing Then resultId result text resultId Mid resultId 2 Dim List objectDataItemList As IXMLDOMNodeList Set List resultDom selectNodes id amp resultId amp If List Length 0 Then Exit Function End If ReDim results List Length 1 numRows List Length for each array element For i 0 To List Length 1 Create Temporary DocData Dim tmpDocData As New objectData Dim itemId As String itemId _ Mid List Item i At
100. illnfo E Mail Information die an die in den Objektdaten definierten Empf nger gesendet wird oder null falls keine E Mail gesendet werden soll dplWaitInfo DeploymentWaitInfo Liste der Deploymentsysteme oder null Livelink WCM Server R ckgabe keine Voraussetzungen Objektverwaltung Erforderliche Zugriffsrechte READ und RELEASE m Objektstatus muss SUBMITTED oder DELETED sein Folge Nach dem Ablehnen haben die WCM Objekte den Status REJECTED release Gibt eine Liste von WCM Objekten frei Parameter Tabelle 33 Parameter der Methode release Parameter Datentyp Beschreibung oids ObjectId OIDs der WCM Objekte die frei gegeben werden remark String Zeichenkette die zum Protokoll jedes WCM Objekts hinzugef gt wird oder null emaillnfo EMaillnfo E Mail Information die an die in den Objektdaten definierten Empf nger gesendet wird oder null falls keine E Mail gesendet werden soll dplWaitInfo DeploymentWaitInfo Liste der Deploymentsysteme oder null R ckgabe keine WCM WebServices Programmierhandbuch 105 Kapitel 5 Voraussetzungen Erforderliche Zugriffsrechte READ und RELEASE Objektstatus muss SUBMITTED sein Folge Nach der Freigabe haben die WCM Objekte den Status RELEASED oder PENDING RELEASE Der Statuswechsel bei der Freigabe h ngt davon ab ob das Metadatum Verz gerte Freigabe gesetzt ist submit Legt eine List
101. ine Kontext Kennung Wenn diese ung ltig wird dann wird diese Excep tion gemeldet Der Dienstnehmer muss sich erneut mit Benutzerkennung und Passwort anmelden WCM WebServices Programmierhandbuch 49 Kapitel 3 Name der Exception M gliche Ursache InvalidObject Werden die Attribute eines WCM Objekts von Exception zwei Benutzers nahezu gleichzeitig ge ndert dann kann es passieren dass der Benutzer dessen nderung zuletzt bearbeitet wird seine Transaktion intern mit einem veralteten Datensatz beginnt Dies f hrt zu dieser Exception Im Fall von WCM WebServices ist dies jedoch unwahrscheinlich da die internen Objektdaten erst kurz vor der nderung vom Content Server geholt werden LicenseException Die Lizenzen f r Livelink WCM Server sind abgelaufen LoginException Der Dienstnehmer hat sich mit einer ung ltigen Benutzerkennung oder einem falschen Passwort am WCM System angemeldet MailException Probleme beim Versenden von E Mails im Rahmen des Stagings z B weil ein Mail Server nicht erreicht wurde NetException Bei der Nutzung von Netzwerkverbindungen durch den WCM Server beim Verbindungsaufbau oder beim Datenaustausch traten Probleme auf Verbindungsprobleme zwischen dem WCM WebServices Dienstnehmer und der Appli kation des Dienstanbieters sind nicht der Grund f r diese Exception ObjectInUseException Das WCM Objekt das ge ndert werden soll wird gerade von einem anderen Be
102. jekts 128 Livelink WCM Server Objektverwaltung Voraussetzungen Erforderliche Zugriffsrechte auf das bergeordnete Thema READ und CREATE m Objektstatus keine Einschr nkungen m Die ben tigten Funktionsbereiche h ngen von dem zu erzeu genden Objekttyp ab Folge Nach dem Anlegen hat das WCM Objekt den Status EDITED delete L scht die angegebenen WCM Objekte Wurde ein WCM Objekt noch nie zur Qualit tssicherung vorgelegt so wird es durch diese Methode vollst ndig aus dem WCM System entfernt Anderenfalls erh lt es den Objektstatus DELETED und bleibt weiterhin in der QS Sicht sichtbar Dort muss das L schen mit einer destroy Aktion best tigt oder mittels reject abgelehnt werden Parameter Tabelle 55 Parameter der Methode delete Parameter Datentyp Beschreibung oids ObjectId Liste von OIDs remark String Zeichenkette die zum Protokoll der WCM Objekte hinzugef gt wird oder null emaillnfo EMaillnfo E Mail Information die an die in den Objektdaten definierten Empf nger gesendet wird oder null falls keine E Mail gesendet werden soll WCM WebServices Programmierhandbuch 129 Kapitel 5 Parameter Datentyp Beschreibung dplWaitInfo DeploymentWaitInfo Liste der Deploymentsysteme oder null R ckgabe keine Voraussetzungen Erforderliche Zugriffsrechte READ und DELETE Objektstatus muss EDITED REJECTED RELEASED oder PENDING RELEASE sei
103. le 9 Tabelle 10 Tabelle 11 Tabelle 12 Tabelle 13 Tabelle 14 Tabelle 15 Tabelle 16 Tabelle 17 Tabelle 18 Tabelle 19 Tabelle 20 Tabelle 21 Tabelle 22 Tabelle 23 Tabelle 24 Tabelle 25 Tabelle 26 Verf gbare Funktionalit t in den APIs von Livelink WCM Server Exceptions und m gliche Ursachen Datentypen f r Benutzer Datentypen f r Gruppen und Rollen Parameter der Methode getGroupProfile Parameter der Methode getRoleProfile Parameter der Methode getUserProfile Namen der Standard Funktionsbereiche Parameter der Methode getDeploymentSystems Parameter der Methode changePassword Parameter der Methode substituteLogin Die Komponenten des Datentyps ObjectId Die Komponenten des Datentyps ObjectData Die Komponenten des Datentyps ObjectType Die einzelnen Objektstatus Die m glichen berg nge zwischen den Objektstatus Die Komponenten des Datentyps ObjectState Die m glichen Zugriffsrechte f r WCM Objekte Die Komponenten des Datentyps Permission Die Komponenten des Datentyps Acl Die Komponenten des Datentyps AclEntry Die Komponenten des Datentyps MultiImportPart Die Komponenten des Datentyps Workflow Die Komponenten des Datentyps Activity Die Komponenten des Datentyps Transition Die Komponenten des Datentyps WorkflowNavigationInfo WCM WebServices Programmierhandbuch 14 49 55 56 58 59 60 62 67 71 72 77 79 85 86 87 88 89 89 90 91 92 95 96 97 97 Tabelle 27 Die Komponenten des Datentyps Depl
104. legt und bearbeitet Zum Anlegen von Objekten vom Typ Workflow ben tigt ein Benutzer den Funktionsbereich Workflow 94 Livelink WCM Server Objektverwaltung Tabelle 23 Die Komponenten des Datentyps Workflow Attribut Datentyp Beschreibung activities Activity Einzelne Aktivitaten eines Workflows assignedObject ObjectId Dem Workflow zugeordnetes WCM Objekt currentActivities Activity Alle Aktivitaten eines Workflows currentActivity Activity Aktuelle Aktivitat description String Beschreibung des Workflow Objekts hasBeenForwarded Boolean Ermittelt ob das zugeordnete Workflow Objekt bereits weiterge schaltet wurde hasContent Boolean Ermittelt ob die XPDL Datei auf der die Workflow Definition basiert ber Inhalt verf gt name String Name des Workflow Objekts processId String Prozess ID startActivities Activity Alle Start Aktivitaten des aktu ellen Workflow Objekts workflowOid ObjectId OID des Workflow Objekts workflowTitle String Titel des Workflow Objekts workflowVersion Version Version des Workflow Objekts WCM WebServices Programmierhandbuch 95 Kapitel 5 Datentyp Activity Die einzelnen Aktivitaten eines Workflows werden durch den Datentyp Activity reprasentiert Die Aktivitaten haben einen Typ der das Staging in Livelink WCM Server widerspiegelt Weiterf hrende Informationen zur Verwendung und Nutzung von Aktivit ten finden Sie im WCM Java API
105. lgenden Tabelle kann abgelesen werden welche Attribut typen mit welchen Filtertypen zusammen verwendet werden k nnen 148 Livelink WCM Server Objektverwaltung Tabelle 72 Attributtypen und Filter IntegerValue v v v iv v iv ivV LongValue ListValue L ILs SetValue DateValue v x lt 4 lt 1 4 lt lt lt 1 4 BooleanValue StringValue ILLI LocaleValue ObjectId ObjectType ObjectState User Version a Mit diesem Filter kann getestet werden ob der Wert f r ein Attribut gesetzt wurde b Dieser Filter vergleicht zwei Attributwerte miteinander Beide Werte m ssen vom gleichen Typ sein c Gesucht wird jeweils nach einem Eintrag aus der Liste der als StringValue angegeben wird d BeiLocaleValue und User kann der Wert auch als StringValue angegeben werden dadurch k nnen auch die anderen Filter verwendet werden WCM WebServices Programmierhandbuch 149 Kapitel 5 Beispiele new IsNullFilter subtitle new StringContainsFilter QAEMailReceivers new StringValue jstein company example new LikeFilter QAEMail new StringValue jstein new EqualFilter createdBy new StringValue jstein Vordefinierte Suchfunktionen als Filter Der Filtertyp RootTemplateFilter sucht alle WCM Objekte einer Website die vom Objekttyp Vorlage sind und die selbst keine Vorlage besitzen Der Filterty
106. low ein Workflow Objekt Voraussetzungen Erforderliches Zugriffsrecht READ m Objektstatus keine Einschr nkungen WCM WebServices Programmierhandbuch 115 Kapitel 5 Folge Der Objektstatus ndert sich nicht isForwardable berpr ft ob der angemeldete Principal der Aktivit t in der sich das WCM Objekt aktuell befindet zugeordnet ist Tabelle 43 Parameter der Methode isForwardable oid ObjectId OID des WCM Objekts mit zugeord netem Workflow R ckgabe true wenn der Principal das Objekt im Workflow weiterleiten darf sonst false Voraussetzungen Keine Folge Der Objektstatus ndert sich nicht isRemovable berpr ft ob der angemeldete Principal die Zuordnung zwischen Workflow und WCM Objekt aufheben darf Tabelle 44 Parameter der Methode isRemovable oid ObjectId OID des Workflow Objekts 116 Livelink WCM Server Objektverwaltung R ckgabe true wenn der Principal die Zuordnung zwischen Workflow und WCM Objekt aufheben darf sonst false Voraussetzungen Keine Folge Der Objektstatus ndert sich nicht removeWorkflow Hebt die Zuordnung zwischen Workflow und WCM Objekt auf Tabelle 45 Parameter der Methode removehorkflow Parameter Datentyp Beschreibung oid ObjectId OID des WCM Objekts dessen Zuord nung zu einem Workflow Objekt aufgehoben werden soll remark String Zeichenkette die zum Protokoll des WCM Objekts hinzugef gt wird o
107. n Folge Ist ein WCM Objekt bereits einmal zur Qualitatssicherung vorgelegt worden so erh lt es nach dem L schen den Status DELETED depublishPage L scht die f r die angegebenen WCM Objekte erzeugten Seiten aus dem Dateisystem Die Seiten werden damit aus der Produktionssicht entfernt Die gel schten Seiten werden erst nach einer erneuten Frei gabe der entsprechenden WCM Objekte wieder erzeugt Parameter Tabelle 56 Parameter der Methode depubl ishPage Parameter Datentyp Beschreibung dplSystem String Name eines Deploymentsystems oids ObjectId Liste von OIDs dplWaitInfo DeploymentWaitInfo Liste der Deploymentsysteme oder null 130 Livelink WCM Server Objektverwaltung R ckgabe keine Voraussetzungen Erforderliches Zugriffsrecht READ und RELEASE m Objektstatus keine Einschr nkungen Folge Der Objektstatus ndert sich nicht destroy Zerst rt die angegebenen WCM Objekte und best tigt damit das L schen durch delete Parameter Tabelle 57 Parameter der Methode destroy Parameter Datentyp Beschreibung oids ObjectId Liste von OIDs remark String Zeichenkette die zum Protokoll der WCM Objekte hinzugef gt wird oder null emaillnfo EMaillnfo E Mail Information die an die in den Objektdaten definierten Empf nger gesendet wird oder null falls keine E Mail gesendet werden soll dplWaitInfo DeploymentWaitInfo Liste der Deploymentsysteme o
108. n sind folgende Anpassungen in der Konfiguration erfor derlich Zuordnen der Application WebServiceApplication zum Content Server Konfigurieren der Application WebServiceApplication mithilfe von Parametern Die entsprechenden Eintr ge f r die Konfiguration nehmen Sie ber den Admin Client vor WCM WebServices Programmierhandbuch 41 Kapitel 3 Hinweise Bitte beachten Sie dass der Content Server im Kontext einer JSP Engine bzw als Webanwendung in einem Application Server laufen muss Genaue Informationen dar ber wie Sie einem Content Server Applica tions zuordnen und die entsprechenden Parameter festlegen finden Sie im Portal Manager API Programmierhandbuch Application WebServiceApplication zuordnen F r den Einsatz von WCM WebServices ordnen Sie die Application WebServiceApplication dem entsprechenden Content Server zu Starten Sie dazu den Admin Client von Livelink WCM Server Nehmen Sie die Zuordnung in der Ansicht Konfiguration ber Server gt Name des Content Servers Applications vor Konfiguration Pools er Eigene Verbindungstypen G Server A Admin Al Master_Content wy Websites amp Deploymentsysteme Pe Pools 8 Agenten Dienste Pfade f r Secure Access Ej Applications E A Proxy_Content U E Name ClickStreamApplication LivelinkApplication VipHCLApplication VIPHTMLClientApplication
109. n kann Aus der gro en Vielfalt von Programmiersprachen die Web Services nutzen k nnen werden hier VisualBasic for Applica tions VBA stellvertretend f r nicht objekt orientierte Skriptsprachen und C im Zusammenspiel mit VisualStudio NET f r die Beispiele benutzt Es ist nicht Ziel dieses Kapitels einen Programmierkurs f r diese Spra chen zu bieten sondern vielmehr auf die Besonderheiten im Zusammen hang mit ihrer Nutzung hinzuweisen und prototypisch lauff higen Code zu pr sentieren Die Beispiele beziehen sich auf die fiktive Website InternetSite der Firma company example Beispiel 1 demonstriert wie komplexe Filterausdr cke formuliert und die Ergebnismengen bearbeitet werden Beispiel 2 zeigt wie die Staging Funktionen von Livelink WCM Server genutzt werden WCM WebServices Programmierhandbuch 155 Kapitel 6 Im Rahmen dieser Beispiele lernen Sie auch wie in den beiden Programmierumgebungen die Authentifizierung das Session Manage ment und die Fehlerbehandlung gehandhabt werden 6 1 VisualBasic for Applications VisualBasic for Applications wird immer dann eingesetzt wenn neue Funktionen in Microsoft Office Anwendungen integriert werden sollen Zur Nutzung von Web Services stellt Microsoft das so genannte SOAP Toolkit zur Verf gung Dieser muss auf den Client Rechnern installiert werden Das SOAP Toolkit ist f r den korrekten Versand und Empfang der SOAP Nachrichten zust ndig den X
110. nFilter getWebsiteNames g Principal listallRunlevels 92 Role logout eg RootTemplateFilter move ObjectId ObjectId string DeploymentWaitInfo oy Runlevel multilmport ObjectId string ObjectData string DeploymentWa g Sort reject ObjectId string EMailInfo Deployment WaitInfo g StringContainsFilter release ObjectId string EMailInfo Deployment WaitInfo oy String alue restoreVersion Objectld Version string Deployment WaitInfo oy SubTreeFilter sortParentsFirst ObjectId int ics oy User submit ObjectId System DateTime string EMailInfo Deploym g Value substituteLogin string eg ValueFilter undoCheckOut ObjectIdf string Deployment WaitInFo 92 Version amp Vip WebService VipWel AR World Abb 12 Automatisch erzeugte Klassen im Namensraum VipWebServiceClient Sie k nnen nun mit der Nutzung von WCM WebServices beginnen Als Beispiel wird im Folgenden eine ASP NET Seite default aspx verwendet die in einer Tabelle alle PDF Dateien der Website Internet Site auflistet Jede Zeile der Tabelle enth lt ein K stchen zur Auswahl der Zeile Alle ausgew hlten Objekte lassen sich ber eine Schaltfl che vorlegen bzw freigeben 180 Livelink WCM Server Anwendungsbeispiele a VipWebServiceClient Microsoft Internet Explorer BEE Datei Bearbeiten Ansicht Favoriten Extras a Q aurick 2 x a m po Suchen Sie Favoriten Medien
111. nFilter oder erweitern den Datentyp ValueFilter Filter die schon vorhandene Filter logisch miteinander verkn pfen und dadurch die Konstruktion von komplexen Suchanfragen erm gli chen Folgende Filtertypen geh ren zu dieser Kategorie NotFilter AndFilter und OrFilter Filter die eine vordefinierte Suchfunktion ausf hren Folgende Filter typen geh ren zu dieser Kategorie RootTemplateFilter PermissionFilter SubtreeFilter und PrincipalFilter Die folgende bersicht veranschaulicht den Datentyp Filter und davon abgeleitete Filtertypen WCM WebServices Programmierhandbuch 147 Kapitel 5 Abb 7 Der Datentyp Filter und davon abgeleitete spezielle Filtertypen Attributwerte Filter ValueFilter Livelink WCM Server verwaltet die Daten einer Website einschlie lich der Inhalte und der Metadaten in einer Datenbank Bei der Suche wird auf Basis eines Filters eine f r das jeweilige Datenbanksystem geeig nete Suchanfrage eine SQL Anweisung der Form SELECT FROM WHERE ORDER BY formuliert Die Attributnamen entspre chen den Komponentennamen des Datentyps ObjectData Es gibt jedoch einige Einschr nkungen bez glich der Verwendung von Attributen f r die Formulierung von SQL Anfragen Aus diesem Grund k nnen nicht alle Attribute in einer Suche verwendet werden Genaue Angaben zu den suchbaren Attributen finden Sie in Tabelle 13 Die Komponenten des Datentyps ObjectData auf Seite 79 Anhand der fo
112. ndbuch 57 Kapitel 4 m Es k nnen Bedingungen f r die Attribute name commonName eMailAddress locale trustedLoginund vipAccess angegeben werden getGroupProfiles Liefert die Daten der Gruppen zur ck die auf das spezifizierte Filter kriterium zutreffen Die Ergebnismenge kann durch startResult und numberOfResults begrenzt werden Parameter Tabelle 5 Parameter der Methode getGroupProfile Parameter Datentyp Beschreibung ldapContext String LDAP Kontext in dem die Suche durch gef hrt wird oder null falls die Benutzerverwaltung nicht LDAP basiert ist sortList Sort Liste der Attribute nach denen die Ergeb nisliste sortiert werden soll in nach Priorit t absteigender Folge filter Filter Suchkriterium oder null um nach allen Gruppen zu suchen startResult int Zahl die das erste Element des Sucher gebnisses angibt Mit 0 wird das Suchergebnis von Anfang an geliefert numberOfResults int Anzahl der zur ckzuliefernden Sucher gebnisse beginnend bei startResult Mit 1 werden alle Ergebnisse zur ckgeliefert 58 Livelink WCM Server Zugriff auf Administrationsdaten und Authentifizierung R ckgabe Group groups Liste von Gruppen die dem angegebenen Suchkri terium entsprechen getRoleProfiles Liefert die Daten der Rollen zur ck die auf das spezifizierte Filterkrite rium zutreffen Die Ergebnismenge kann durch startResult und numberOfResults begrenzt
113. ndern zum Beispiel Vorlegen wird eine g ltige WCM Benutzerlizenz ben tigt WCM WebServices gibt diese Lizenz mit Ablauf der Session automatisch wieder frei sp testens aber nach Ablauf des f r den Administrationsserver eingestellten Ablaufintervalls nach der letzten feststellbaren Aktivit t des Benutzers Informationen zur Konfiguration des Ablaufintervalls finden Sie im Livelink WCM Server Administratorhandbuch Zur Vermeidung von Lizenzproblemen sollten Sie die Methode logout von WCM WebServices zur expliziten Lizenzfreigabe verwenden 166 Livelink WCM Server Anwendungsbeispiele Aufruf einer Methode ohne Ruckgabewert Nach der Initialisierung des SoapSerializer kann direkt die Methode mitsamt ihren Parametern in den Datenstrom eingef gt werden Dies wird im folgenden Code Beispiel am Beispiel der Methode submit Vorlegen gezeigt Submit an array of WCM objects identified by their ObjectIDs to QA Public Function submit ByRef oids As ObjectID _ ByVal pendingReleaseDate As Date _ ByVal remark As String _ ByVal emailI As emaillnfo _ ByVal dplWaitInfo As DeploymentWaitInfo As Boolean Dim success As Boolean success False initialize_connection serialize request for submit serializer startElement submit VIP_NAMESPACE_URI Start element oids serializer startElement oids serializer SoapAttribute xsi type SOAP ENC Array serializer SoapAttribute SOAP ENC arrayType vip Obje
114. ndex A Ablehnen 104 Abmelden 72 Acl 90 ACL andern 91 AclEntry 91 Activity 96 addRemark 121 Aktivitat 96 Alte Versionen eines WCM Objekts zur ckholen 145 Andern ACL 91 Andern von Metadaten 122 ASP NET Beispiel 176 ItemTemplate 186 Page_Load 185 assignWorkflow 109 assignWorkflowAsync 110 Attribute zu einem WCM Objekt abfragen 133 Attributmengen abfragen 65 Ausleihen 102 Ausleihen r ckg ngig machen 108 Authentifizierung 179 C 184 SOAP Toolkit 165 B Bearbeiten ACL 91 Beispiel ASP NET 176 C 176 Maildialog 182 VisualBasic 156 Bemerkung zu Protokoll hinzuf gen 121 Benutzerdaten abfragen 60 03 C Beispiel 176 Cookies 184 filter 185 change 122 changePassword 71 checkin 101 checkOut 102 checkReferencesForDelete 123 checkReferencesForRelease 124 checkReferencesForSubmit 125 convertContent 126 Cookies C 184 copy 127 create 128 D Datentyp Acl 90 AclEntry 91 Activity 96 DeploymentWaitinfo 98 EMaillnfo 99 MultilmportPart 92 ObjectData 78 Objectld 77 WCM WebServices Programmierhandbuch 201 Index ObjectState 86 ObjectType 84 Permission 88 Transition 96 Workflow 94 WorkflowNavigationInfo 97 Datentypen allgemein 76 delete 129 Deployment Aufgaben abfragen 137 Deploymentinhalt eines WCM Objekts abfragen 134 Deploymentsysteme 98 abfragen 67 DeploymentWaitinfo 98 depublishPage 130 destroy 131 directRelease 103 188 direkte Freigabe 103 DOM 17
115. nk WCM Server Administratorhandbuch Die Runlevels k nnen mit der Methode 1istAllRunlevels ausgelesen werden Beim Start eines Servers werden die Runlevels von Runlevel 0 bis Runlevel 10 durchlaufen beim Herunterfahren des Servers entspre chend von 10 bis 0 Dar berhinaus k nnen die Runlevels von Servern und Websites ber den Admin Client von Livelink WCM Server separat gesteuert werden WCM WebServices Programmierhandbuch 67 Kapitel 4 Mit der Methode getRunlevel kann der aktuelle Runlevel der Website die dem Web Service zugeordnet ist ermittelt werden d h die Runlevels ab Runlevel 6 Folgende Runlevels stehen f r Server zur Verf gung 0 Server nicht erreichbar Der Server ist nicht erreichbar 1 Verbindungen geschlossen Alle Kommunikationsverbindungen sind geschlossen Datenbank und LDAP Verbindungen sowie Dienste sind nicht mehr verf gbar Beim bergang zum n chsth heren Runlevel wird die Verbindungsverwaltung aufgebaut 2 Keine Benutzer angemeldet Es sind keine Benutzer mehr an diesem Server angemeldet Beim bergang zum n chsth heren Runlevel wird die Benutzerverwaltung aktiviert 3 Keine Agenten aktiv Alle Server Agenten sind beendet Beim bergang zum n chsth heren Runlevel werden alle Server Agenten gestartet 4 Einzelnutzer Betrieb Alle Benutzer bis auf den Administrator der die Runlevel nderung vornimmt werden abgemeldet und k nnen sich nicht mehr am WCM System anmelden Dieser Runle
116. ntent Konvertiert den Inhalt eines Verbundobjekts Dabei werden die unter geordneten Objekte eines Verbundobjekts angelegt Parameter Tabelle 52 Parameter der Methode convertContent Parameter Datentyp Beschreibung oid ObjectId OID des Verbundobjekts dplWaitInfo DeploymentWaitInfo Liste der Deploymentsysteme oder null R ckgabe Keine Voraussetzungen Erforderliches Zugriffsrecht auf das Quellobjekt READ Erforderliche Zugriffsrechte auf das Thema in dem sich das Quellobjekt befindet READ CREATE DELETE WRITE und WRITE_META Objektstatus des Quellobjekts muss EDITED REJECTED RELEASED oder PENDING_RELEASE sein Folge Der Objektstatus des Verbundobjekts ndert sich nicht Der Objekt status der untergeordneten Objekte die w hrend der Konvertierung erzeugt wurden ist EDITED 126 Livelink WCM Server Objektverwaltung copy Kopiert ein WCM Objekt unter ein Thema Das angegebene Objekt darf auch unter das Thema kopiert werden in dem es sich bereits befindet Dabei ndert sich der Titel des Objekts nicht Es existieren dann zwei Objekte mit gleichem Namen Parameter Tabelle 53 Parameter der Methode copy Parameter Datentyp Beschreibung oid ObjectId OID des betreffenden WCM Objekts newParentOID ObjectId OID des Themas unter das das WCM Objekt kopiert werden soll remark String Zeichenkette die zum Protokoll des WCM Objekts hinzugef gt wird oder null
117. ntent Client Intelligente ITF Wird nicht standardm ig Vorlagen verwendet dient der Abw rtskompatibilit t zu VIP 5e Direkte Freigabe Dialog Referenzen DIRECT_RELEASE REFERENCES Bearbeiten der Option Direkte Freigabe in den Metadaten Ansicht des Referenzen Dialogs Dialog ACCESS_RIGHTS Ansicht des Zugriffsrechte Zugriffsrechte Dialogs Dialog Protokoll LOG Ansicht des Protokoll Dialogs Livelink LIVELINK Ansicht des Livelink Metadaten Dialogs Filter Standard Filter Bearbeiten FILTER_STANDARD FILTER_EDIT Verwenden der Standardfilter Erstellen und Bearbeiten von Filtern im Filtereditor Ansicht Meine Objekte FILTER_TODO Ansicht OBJECTLIST Ansicht Untergeordnete Untergeordnete Objekte Objekte Ansicht Objektliste LISTVIEW Ansicht Objektliste Ansicht Meine Objekte und Ansicht Mein Eingangskorb WCM WebServices Programmierhandbuch 63 Kapitel 4 Ansicht Vorlagenstruktur TEMPLATE_STRUCTURE Ansicht Vorlagenstruktur Importieren IMPORT Verwenden der Import funktionen Suche COMI_SEARCH Verwenden der Such funktionen Methoden zum Auslesen von Funktionsbereichen getFunctionalAreas Liefert alle im WCM System verf gbaren Funktionsbereiche zur ck Parameter keine R ckgabe FunctionalArea functionalAreas die verf gbaren Funktionsbereiche 64 Livelink WCM Server
118. ntent Server und damit auf die WCM verwalteten Inhalte zugreifen Der Zugriff erfolgt v llig plattformunabhangig Der Datenaus tausch mit dem WCM System erfolgt ber das XML basierte Protokoll SOAP WCM WebServices bietet Ihnen folgende Funktionen Entwicklung eigenst ndiger WCM Client Applikationen die auf Ihre individuellen Anforderungen zugeschnitten sind Erstellen dynamischer Inhalte f r Ihre Website mit der M glichkeit auf die Funktionalit ten zur Verwaltung der Website Inhalte zuzu greifen Zur Implementation der dynamischen Inhalte k nnen Sie eine beliebige Programmiersprache w hlen Integration der Funktionalit ten zur Verwaltung der Website Inhalte in Desktop und Office Werkzeuge bei denen der Funktionsumfang mit g ngigen Programmiersprachen erweitert werden kann WCM WebServices basiert auf dem WCM Java API und arbeitet mit den gleichen oder sehr hnlichen Methoden um den Zugriff ber das Internet zu erm glichen WCM WebServices Programmierhandbuch 11 Kapitel 1 Achtung Das falsche Verwenden der in diesem Handbuch beschrie benen Programmierschnittstelle kann zu Fehlern im WCM System bis hin zum Absturz des Systems und zu Datenverlusten f hren Durch eine falsche Programmierung k nnen auch Probleme in den Bereichen Performance und Systemressourcen auftreten Es ist deshalb wichtig die entwickelte Software erfolgreich hinsichtlich Korrektheit Stabilit t Robustheit und Performance zu tes
119. nutzer des WCM Systems bearbeitet ObjectNotFound Der angemeldete Benutzer hat kein Leserecht f r Exception ein Objekt die beim Zugriff auf ein WCM Objekt angegebene OID Versionsnummer ist nicht g ltig oder das entsprechende Objekt konnte nicht in der Website gefunden werden 50 Livelink WCM Server Einsatz von WCM WebServices Name der Exception Mogliche Ursache RunlevelException Der angesprochene WCM Server oder die Website befinden sich in einem Runlevel in dem die gew nschte Operation nicht m glich ist Der Runlevel wird u a f r Wartungsarbeiten am WCM System ge ndert UnexpectedException Bei der Ausf hrung einer Methode traten interne Fehler auf die keinem der anderen Fehlertypen zugeordnet werden k nnen Siehe auch VipApiException VetoException Ein auf dem WCM Server laufender Agent hat die Ausf hrung der aufgerufenen Methode durch ein Veto verhindert Agenten k nnen z B die Ausf h rung bestimmter Staging Aktionen an ausgew hlten WCM Objekten in einem bestimmten Zeitraum verhindern VipApiException Kann ein Fehler keinem der anderen Fehlertypen zugeordnet werden tritt diese Exception auf WorkflowException Wurde im Workflow ein bergang ausgew hlt der nicht ausgef hrt werden kann tritt diese Excep tion auf WCM WebServices Programmierhandbuch 51 52 Livelink WCM Server KAPITEL 4 Zugriff auf Administrationsdaten und Authentifizierung Mithil
120. nzierten Objekte angelegt Livelink WCM Server Objektverwaltung Hat das initiale Objekt keinen Inhalt werden alle Ubergebenen Objekte angelegt Beim Anlegen der einzelnen Objekte werden explizite Hyperlinks in die bestehende Website und relative Hyperlinks auf mit importierte Objekte erkannt und in die Referenzenverwaltung von Livelink WCM Server bernommen Parameter Tabelle 69 Parameter der Methode mult iImport Parameter Datentyp Beschreibung initialData ObjectData Hier werden das Thema topic der Objekttyp objectType der Vorschlag fur den Dateinamen deploymentHint und der Titel title des neu anzulegenden Objekts angegeben Alle anderen Attribute werden automatisch fur die untergeordneten Objekte ber nommen und berschreiben die in imports children objectData angegebenen Werte So ist es z B m glich einheitliche Attribute f r alle Objekte vorzugeben Attribute die nur f r das Startobjekt des Imports gelten sollten Sie in imports children 0 objectData festlegen Der Import erzeugt ein eigenes Thema wenn initialData objectType vom Typ Thema ist Anderenfalls werden die anzulegenden Objekte unterhalb des Themas initialData topic angelegt WCM WebServices Programmierhandbuch 143 Kapitel 5 Parameter Datentyp Beschreibung imports MultiImportPart Metadaten Inhalt und untergeord nete Objekte Siehe Datentyp MultiImportPart
121. nznehmer und der Open Text Corporation geschlossen wurde Kontaktadresse Unternehmenshauptsitz Open Text Corporation 185 Columbia Street West Waterloo Ontario N2L 5Z5 Kanada Telefon 1 519 888 7111 Wenn Sie Abonnent des Software Maintenance Program sind oder weitere Informationen zu anderen Kundendienstprogrammen w nschen wenden Sie sich an den Kundendienst von Open Text unter http www opentext com services support html Wenn Sie zu dieser Ver ffentlichung Vorschl ge machen m chten senden Sie eine E Mail Nachricht an documentation opentext com Weitere Informationen zu den Produkten und Dienstleistungen von Open Text finden Sie auf unserer Homepage unter http www opentext com 2005 IXOS SOFTWARE AG Bretonischer Ring 12 85630 Grasbrunn Deutschland Tel 49 89 4629 0 Fax 49 89 4629 1199 E Mail lt office ixos de gt Internet http www ixos de Alle Rechte vorbehalten Einschlie lich solche die die Reproduktion das Kopieren oder eine andere Verwendung oder bermittlung der Inhalte dieses Dokumentes oder Teile davon betreffen Kein Teil dieser Publikation darf egal in welcher Form ohne die schriftliche Zustimmung der IXOS SOFTWARE AG reproduziert an Dritte bermittelt unter Einsatz elektronischer Retrieval Systeme verarbeitet kopiert verteilt oder f r ffentliche Vorf hrungen verwendet werden IXOS beh lt sich das Recht vor Aktualisierungen und nderungen der Inhalte
122. oduktion Vertrieb und Dekompilierung eingeschr nkt wird Weder der Erhalt noch der Besitz dieses Dokumentes erm chtigt Sie dessen Inhalte ganz oder teilweise auf Papier elektronisch oder einem anderen Medium zu reproduzieren weiterzugeben oder anderen den Zugang darauf zu erm glichen Kein Teil dieses Dokumentes darf in irgendeiner Form und Weise ohne vorherige schriftliche Zustimmung der Gauss Interprise AG oder Gauss Interprise Inc reproduziert werden Dar ber hinaus gelten f r diese Dokumentation die Bestimmungen des Softwarelizenzvertrags Alle Warenzeichen oder Handelsmarken die in diesem Dokument erw hnt wurden sind Eigentum der entsprechenden Firmen http www gaussvip com Programmversion Livelink Web Content Management Server Content Server 9 5 0 Dokumentenversion De 03 Erscheinungsdatum Marz 2005 Inhaltsverzeichnis Abbildungsverzeichnis Tabellenverzeichnis Kapitel 1 Einleitung 1 1 Hinweise zu dieser Dokumentation 1 2 Typographische Konventionen Kapitel 2 Konzepte 2 1 Web Services 2 2 WCM WebServices 2 3 Konzepte von Livelink WCM Server Kapitel 3 Einsatz von WCM WebServices 3 1 Konfiguration 3 2 Die WCM WebServices Beschreibung 3 3 Fehlerbehandlung Kapitel 4 Zugriff auf Administrationsdaten und Authentifizierung 4 1 Benutzer Gruppen und Rollen 4 2 Funktionsbereiche 4 3 Websites 4 4 Deploymentsysteme 4 5 Runlevels 4 6 Allgemeine Abfragen 4 7 Authentifizierung 4 Livelink WCM Server 1
123. oids enthalten sind und deren zugeh rige WCM Objekte auf andere WCM Objekte referenzieren die nicht in oids enthalten sind und noch nicht freige geben wurden Es werden nur solche WCM Objekte zur ckgegeben die in der QS Sicht verf gbar sind und somit mindestens einmal der Qualit tssicherung vorgelegt worden sind Voraussetzungen Es sind keine Zugriffsrechte erforderlich m Objektstatus keine Einschr nkungen Folge Der Objektstatus ndert sich nicht 124 Livelink WCM Server Objektverwaltung checkReferencesForSubmit Methode zur Pr fung ob die angegebenen WCM Objekte andere WCM Objekte referenzieren die noch nicht zur Qualit tssicherung vorgelegt wurden Diese Methode sollte vor dem Vorlegen von WCM Objekten zur Qualit tssicherung aufgerufen werden Parameter Tabelle 51 Parameter der Methode checkReferencesForSubmit Parameter Datentyp Beschreibung oids ObjectId Liste von OIDs deren zugeh rige WCM Objekte gepr ft werden sollen R ckgabe ObjectId objectlds eine Liste von OIDs die in oids enthalten sind und deren zugeh rige WCM Objekte auf andere WCM Objekte referenzieren die nicht in oids enthalten sind und noch nicht zur Qualit tssicherung vorgelegt wurden Voraussetzungen Es sind keine Zugriffsrechte erforderlich m Objektstatus keine Einschr nkungen Folge Der Objektstatus ndert sich nicht WCM WebServices Programmierhandbuch 125 Kapitel 5 convertCo
124. okument erstellt wurde zu welchem Zeitpunkt es erstellt wurde welchen Titel es hat von welchem Typ es ist usw Protokoll Das Protokoll liefert eine Beschreibung s mtlicher nde rungen die am Objekt durchgef hrt wurden S mtliche WCM Objekte werden ber ihre OID Object Identifier referen ziert Die OID identifiziert das aktuelle Objekt Neben einem definierten Satz von Metadaten k nnen Sie jedem Objekttyp eine Attributmenge zuordnen Dies ist eine Menge von Attributen die spezielle Eigenschaften von Objekttypen beschreiben Dazu k nnen u a die Aufl sung von Grafiken oder ein Copyright Vermerk geh ren WCM WebServices Programmierhandbuch 29 Kapitel 2 Au erdem k nnen Sie die Inhalte von WCM Objekten kategorisieren Zu diesem Zweck definieren Sie Objektkategorien f r die Sie eine Reihe von Eigenschaften festlegen k nnen Eine m gliche Objektkategorie w re Rechnung die durch die Eigenschaften Rechnungsempfaenger und Status gekennzeichnet sein k nnen Objektstatus Alle WCM Objekte einer Website die mit Livelink WCM Server verwaltet werden durchlaufen feste Stufen aus Bearbeitung Editieren Qualit tssi cherung und Ver ffentlichung im Produktionsbetrieb Durch das Zuordnen von Workflows zu WCM Objekten l sst sich dieses so genannte Staging erweitern So kann z B eine aufeinander folgende Bearbeitung durch mehrere Redakteure oder eine mehrstufige Qualit tssicherung durchge f hrt w
125. on Ausleihen Staging Aktion von Livelink WCM Server Der Inhalt eines WCM Objekts kann erst bearbeitet werden wenn das Objekt ausgeliehen wurde Ein ausgeliehenes Objekt ist f r die Zugriffe anderer Benutzer gesperrt Die nderungen die am Objekt vorgenommen werden sind erst nach dem Zur ckgeben in der Edit Sicht verf gbar Datenhaltungssicht Die Datenhaltungssicht eines Servers bezeichnet die aktuell verf gbaren Auspr gungen der WCM Objekte Edit Sicht QS Sicht Produktionssicht ber welche Datenhaltungssicht ein Server verf gt wird in den Routing Einstellungen der Website festgelegt Deployment Deployment bezeichnet die Verteilung von Daten Das Deployment von Livelink WCM Server bernimmt zwei Hauptaufgaben erstens die Generierung von Seiten aus den in der Datenbank gespeicherten WCM Objekten und die Verteilung der generierten Dateien in die daf r vorgesehenen Verzeichnisse zweitens die Benachrichtigung der WCM Server bei nderungen im WCM System Deploymentsystem Die Deploymentsysteme erzeugen aus den WCM Objekten Seiten und verteilen die generierten Dateien in die daf r vorgesehenen Verzeichnisse Von dort aus werden die Dateien ber den Einsatz eines HTTP Servers f r die Benutzer sichtbar Deploymentsysteme k nnen unterschiedliche Typen und Kategorien haben WCM WebServices Programmierhandbuch 195 Glossar Deploymentsystem Kategorie Je nach Art der Verarbeitung von Deploymentauftragen
126. orderlich m Objektstatus keine Einschr nkungen Folge Der Objektstatus ndert sich nicht WCM WebServices Programmierhandbuch 137 Kapitel 5 getExternaLLinks Liefert alle externen Referenzen die in der Liste der angegebenen WCM Objekte enthalten sind Externe Referenzen zeigen auf URLs auRerhalb der WCM verwalteten Website Parameter Tabelle 64 Parameter der Methode getExternalLinks Parameter Datentyp Beschreibung oids ObjectId OIDs der zu betrachtenden WCM Objekte R ckgabe LinkInfo links die Liste der externen Links Voraussetzungen Erforderliches Zugriffsrecht READ m Objektstatus keine Einschr nkungen Folge Der Objektstatus ndert sich nicht getLastLogEntries Liefert eine Liste von Protokolleintragen zum angegebenen WCM Objekt Die Protokolleintrage werden in absteigender Reihenfolge geliefert beginnend bei first 138 Livelink WCM Server Objektverwaltung Parameter Tabelle 65 Parameter der Methode getLastLogEntries Parameter Datentyp Beschreibung oid ObjectId OID des WCM Objekts first int Nummer des ersten zu liefernden Protokol leintrags 1 bedeutet beginnend mit dem letzten Protokolleintrag number int Anzahl der zu liefernden Protokolleintrage 1 bedeutet alle Eintrage bis zum ersten R ckgabe LogEntry logEntries die Liste der angeforderten Protokolleintr ge Voraussetzungen Erforderliches Zugriffsrecht READ
127. orgabe eingetragen wenn der Benutzer der Zugriffs steuerungsliste ACL eines WCM Objekts hinzugef gt wird WCM WebServices Programmierhandbuch 55 Kapitel 4 Permissions Attribut Datentyp Beschreibung initially Permission Verbotene Standard Objektrechte Denied des Benutzers Diese Rechte werden als Vorgabe eingetragen wenn der Benutzer der Zugriffs steuerungsliste ACL eines WCM Objekts hinzugef gt wird trustedLogin boolean Zeigt an ob fur diesen Benutzer die vertraute Anmeldung erlaubt ist Diese Einstellung macht es m glich dass sich ein Benutzer nach einer Anmeldung f r andere Produkte von Livelink WCM Server nicht noch einmal authentifizieren muss single sign on vipAccess boolean Zeigt an ob dem Benutzer der Zugang zum WCM System gestattet ist Die Datentypen Group und Role sind identisch aufgebaut Ihre Kompo nenten sind in der folgenden Tabelle aufgef hrt Tabelle 4 Datentypen f r Gruppen und Rollen 56 Attribut Datentyp Beschreibung name String Eindeutiger Name der Gruppe bzw Rolle hasProfile boolean Zeigt an ob weitere Profilinformation enthalten ist eMailAddress String E Mail Adresse der Gruppe bzw Rolle websites String Liste der Website Namen denen die Gruppe bzw Rolle zugeordnet ist Livelink WCM Server Zugriff auf Administrationsdaten und Authentifizierung Attribut Datentyp Beschreibung
128. oymentWaitInfo 99 Tabelle 28 Die Komponenten des Datentyps EMailInfo 100 Tabelle 29 Parameter der Methode checkIn 101 Tabelle 30 Parameter der Methode checkOut 102 Tabelle 31 Parameter der Methode directRelease 103 Tabelle 32 Parameter der Methode reject 104 Tabelle 33 Parameter der Methode release 105 Tabelle 34 Parameter der Methode submit 106 Tabelle 35 Parameter der Methode submitImmediately 107 Tabelle 36 Parameter der Methode undoCheckOut 108 Tabelle 37 Parameter der Methode assignWorkflow 109 Tabelle 38 Parameter der Methode assignWorkflowAsync 111 Tabelle 39 Parameter der Methode forward 112 Tabelle 40 Parameter der Methode getAssignedJobs 113 Tabelle 41 Parameter der Methode getAssignedWorkflow 113 Tabelle 42 Parameter der Methode getWorkflow 115 Tabelle 43 Parameter der Methode isForwardable 116 Tabelle 44 Parameter der Methode isRemovable 116 Tabelle 45 Parameter der Methode removeWorkflow 117 Tabelle 46 Parameter der Methode removeWorkflowAsync 118 Tabelle 47 Parameter der Methode addRemark 121 Tabelle 48 Parameter der Methode change 122 Tabelle 49 Parameter der Methode checkReferencesForDelete 123 Tabelle 50 Parameter der Methode checkReferencesForRelease 124 Tabelle 51 Parameter der Methode checkReferencesForSubmit 125 Tabelle 52 Parameter der Methode convertContent 126 Tabelle 53 Parameter der Methode copy 127 Tabelle 54 Param
129. oymentsystem sind nur die entspre chenden Daten der jeweiligen Sicht vorhanden Die wesentlichen Eigenschaften eines Deploymentsystems sind wie folgt die Website auf der das Deploymentsystem basiert m der Server auf dem das Deploymentsystem ausgef hrt wird das Verzeichnis auf dem o g Server in dem die generierten Seiten gespeichert werden sollen die Basis URL die f r die Generierung von Verweisen verwendet werden soll 66 Livelink WCM Server Zugriff auf Administrationsdaten und Authentifizierung Mit der Methode getDepLoymentSystems kann die Liste aller Deploy mentsysteme fur eine Website ermittelt werden Pro Deploymentsystem werden der Name und der Typ an den Dienstnehmer zuruckgegeben getDeploymentSystems Liefert alle Deploymentsysteme f r eine angegebene Website zur ck Parameter Tabelle 9 Parameter der Methode getDeploymentSystems Parameter Datentyp Beschreibung website String Name der Website R ckgabe DeploymentSystem deploymentSystems Liste der verf gbaren Deploymentsysteme 4 5 Runlevels Der Runlevel bezeichnet den aktuellen Zustand eines Servers oder einer Website der definiert welche funktionalen Komponenten des Servers oder der Website gerade aktiviert bzw deaktiviert sind Die Runlevels sind unterteilt in Server Runlevels und Website Runlevels wobei die Website Runlevels auf den Server Runlevels aufbauen Weitere Angaben zu den Runlevels finden Sie im Liveli
130. p PermissionFilter sucht nach allen WCM Objekten bei denen ein vorgegebener Benutzer mit einem vorgegebenen Recht in die Zugriffssteuerungsliste eingetragen wurde Mit dem Filtertyp SubtreeFilter k nnen alle WCM Objekte unter halb eines gegebenen WCM Objekts Thema in der Themenstruktur bzw Vorlage in der Vorlagenstruktur ermittelt werden Der SubtreeFilter kann auch ohne Angabe des Topology Parameters verwendet werden In diesem Fall gilt die Themenstruktur als Defaultwert Der Filtertyp PrincipalFilter sucht nach WCM Objekten denen ein bestimmter Principal Benutzer Gruppe oder Rolle zugeordnet ist Zus tzlich besteht die M glichkeit das Ergebnis auf WCM Objekte einzuschr nken f r die der Principal ein bestimmtes Recht Permission besitzt Weitere Informationen zu Principals finden Sie u a in Abschnitt 4 1 Benutzer Gruppen und Rollen auf Seite 54 150 Livelink WCM Server Objektverwaltung Beispiele Der folgende Filter sucht alle WCM Objekte die der Benutzer jstein lesen darf new PermissionFilter new Permission r new User jstein Mit dem folgenden Filter werden alle WCM Objekte einschlie lich des spezifizierten Startknotens zuruckgegeben die in der Themenstruktur unter dem WCM Objekt mit der OID 4711 liegen new SubtreeFilter new ObjectId 4711 Die Methode filter Diese Methode findet Objekte die dem definierten Filterkriterium entsprechen unter dem angegebenen Thema
131. r den Objektstatus gefolgt von der Beschreibung lt asp TemplateColumn HeaderText State gt lt ItemTemplate gt lt IMG src lt ObjectData Container Dataltem objectState imageURL gt gt lt ObjectData Container Dataltem objectState description gt lt ItemTemplate gt lt asp TemplateColumn gt Die erste Spalte der Tabelle beinhaltet eine CheckBox Sie ist hier als serverseitiges Steuerelement realisiert Jeder Klick in eine CheckBox wird ber die PostBack Funktion direkt auf den Server bertragen lt asp TemplateColumn gt lt ItemTemplate gt lt asp CheckBox id cb1 runat server AutoPostBack True gt lt asp CheckBox gt lt ItemTemplate gt lt asp TemplateColumn gt Auf dem Server wird aus allen durch die CheckBox ausgew hlten Zeilen die ObjectId extrahiert und zur weiteren Verarbeitung an den Maildialog bergeben mail aspx Aufbau des Maildialogs Der Maildialog unterscheidet sich f r die verschiedenen Staging Aktionen Vorlegen Freigeben Direkte Freigabe Ablehnen nur durch Folgendes die Texte sind unterschiedlich m die Eingabe des gew nschten Freigabedatums ist beim Vorlegen bzw bei der direkten Freigabe m glich WCM WebServices Programmierhandbuch 187 Kapitel 6 Die entsprechende Zeile der Tabelle ist deshalb als serverseitiges Steuer element id trDelayed realisiert und wird in der Methode Page Load entsprechend ein bzw ausgeblendet String operation
132. rentsFirst Liefert eine Liste zur ck in der jedes Kind Objekt bezogen auf die spezifizierte Ansicht view hinter seinem direkten Eltern Objekt plat ziert ist Diese Methode ist n tzlich um WCM Objekte zu sortieren die zur Qualit tssicherung vorgelegt oder freigegeben werden sollen Parameter Tabelle 71 Parameter der Methode SortParentsFirst Parameter Datentyp Beschreibung oids ObjectId OIDs der zu sortierenden WCM Objekte topologyView int 1 Themenbaumansicht 2 Vorlagenansicht 3 Verbundobjektansicht R ckgabe ObjectId objectIds eine Liste die die neu sortierten OIDs enth lt Voraussetzungen Es sind keine Zugriffsrechte erforderlich m Objektstatus keine Einschr nkungen Folge Der Objektstatus ndert sich nicht 146 Livelink WCM Server Objektverwaltung 5 6 Suchen nach WCM Objekten Die Suche nach WCM Objekten wird durch die Methode filter erm g licht Eine Suchbedingung wird dabei als ein Objekt vom Typ Filter repr sentiert Mit den auf dem Typ Filter basierenden Datentypen lassen sich logische Ausr cke modellieren Dabei k nnen mithilfe von Verkn pfungen komplexe Filter zusammengestellt werden Es gibt verschiedene Kategorien von Filtertypen Filter die auf den Attributen der WCM Objekte basieren Informati onen zu suchbaren Attributen enth lt Tabelle 13 Die Komponenten des Datentyps ObjectData auf Seite 79 Diese Filter sind vom Typ IsNullFilter Joi
133. rsetzt Die Head Bereiche werden bei Themen nicht zusammengef hrt Bei binaren WCM Objekten wie z B GIF Bildern wird der Inhalt nicht ge ndert Parameter Tabelle 60 Parameter der Methode getCheckOutContent Parameter Datentyp Beschreibung oid ObjectId OID des WCM Objekts version Version Gew nschte Version null liefert die aktu elle Version 134 Livelink WCM Server Objektverwaltung R ckgabe byte content der ausgeliehene Inhalt des angeforderten WCM Objekts Voraussetzungen Erforderliches Zugriffsrecht READ m Objektstatus keine Einschr nkungen Folge Der Objektstatus ndert sich nicht getChildren Liefert die OIDs der Kind Objekte des angegebenen WCM Objekts unter der spezifizierten Ansicht view Parameter Tabelle 61 Parameter der Methode getChildren Parameter Datentyp Beschreibung oid ObjectId OID des WCM Objekts view int 1 Themenbaumansicht 2 Vorlagenansicht 3 Verbundobjektansicht R ckgabe ObjectId objectIds eine Liste von OIDs der angeforderten Kind Objekte Voraussetzungen Erforderliches Zugriffsrecht READ m Objektstatus keine Einschr nkungen WCM WebServices Programmierhandbuch 135 Kapitel 5 Folge Der Objektstatus andert sich nicht getContent Liefert den Inhalt des WCM Objekts mit der angegebenen OID und der definierten Version in einem Byte Array zuruck Diese Methode liefert den Inhalt des
134. rtreter des angegebenen Benutzers userName am WCM System an Der durch die ContextId repr sentierte Benutzer muss als Vertreter des angegebenen Benutzers arbeiten d rfen Parameter Tabelle 11 Parameter der Methode substituteLogin Parameter Datentyp Beschreibung userName String Kennung des Benutzers in dessen Vertretung gearbeitet werden soll R ckgabe keine Livelink WCM Server Zugriff auf Administrationsdaten und Authentifizierung WCM WebServices Programmierhandbuch 73 74 Livelink WCM Server KAPITEL 5 Objektverwaltung In diesem Kapitel werden zun chst die wichtigsten Datentypen beschrieben die f r die Bearbeitung von WCM Objekten ber WCM WebServices genutzt werden Anschlie end werden die Methoden der Objektverwaltung vorgestellt Dabei wird zwischen folgenden Haupt gruppen unterschieden allgemeine Parameter wie DeploymentWaitInfo und EMaillnfo siehe Abschnitt 5 2 Allgemeine Parameter auf Seite 98 Methoden f r die Durchf hrung von Staging Aktionen wie Ausleihen oder Vorlegen siehe Abschnitt 5 3 Staging Methoden auf Seite 100 Methoden f r die Duchf hrung von Content Workflow siehe Abschnitt 5 4 Workflow Methoden auf Seite 109 m Methoden f r die Bearbeitung von WCM Objekten z B zum ndern der Metadaten siehe Abschnitt 5 5 Methoden der Objektverwal tung auf Seite 119 Hinweis Da die Syntax des Methodenaufrufs von d
135. sites kann ber WCM WebServices zugegriffen werden Durch Eingabe eines Stern chens erlauben Sie den Zugriff auf alle WCM verwalteten WCM WebServices Programmierhandbuch 43 Kapitel 3 Websites Der Standardwert ist leer d h es ist kein Zugriff Uber WCM WebServices m glich deniedWebsites Geben Sie eine durch Komma separierte Liste von Website Namen an Auf diese Websites kann ber WCM WebServices nicht zugegriffen werden Durch Eingabe eines Sternchens verbieten Sie den Zugriff auf alle WCM verwalteten Websites Ein Verbot hat Vorrang vor einer Erlaubnis Der Standard wert ist leer 3 2 Die WCM WebServices Beschreibung Die Beschreibung von WCM WebServices wird in Form einer WSDL Datei geliefert Dieser Abschnitt beschreibt welche Informationen die Datei enth lt und wie Sie auf diese zugreifen Auf die WCM WebServices Beschreibung zugreifen Die WSDL Datei die die WCM WebServices Beschreibung enthalt wird dynamisch erzeugt Um auf die Datei zuzugreifen geben Sie folgende URL in Ihren Browser bzw Ihr verwendetes Werkzeug ein Basis URL des HTTP Servers Verzeichnis der Webanwendung WebService Port Website Name Datenhaltungssicht Name des Deploymentsystems WSDL Beispiel http wemserver company example wcm WebService Port InternetSite edit InternetSite_edit WSDL 44 Livelink WCM Server Einsatz von WCM WebServices Erlauterung zu einzelnen Bestandteilen der URL m WSDL Dies
136. t keepCheckOut boolean Flagge ob das Objekt nach dem Aufruf weiterhin ausgeliehen bleiben soll remark String Zeichenkette die zum Protokoll des WCM Objekts hinzugef gt wird oder null dplWaitInfo DeploymentWaitInfo Liste der Deploymentsysteme oder null R ckgabe keine WCM WebServices Programmierhandbuch 101 Kapitel 5 Voraussetzungen Erforderliche Zugriffsrechte READ und WRITE m Objektstatus muss CHECKED_OUT sein Folge Nach dem Zur ckgeben hat das WCM Objekt den Status EDITED falls keepCheckOut den Wert false hatte m CHECKED_OUT falls keepCheckOut den Wert true hatte checkOut Leiht das angegebene WCM Objekt aus Parameter Tabelle 30 Parameter der Methode checkOut Parameter Datentyp Beschreibung oid ObjectId OID des betreffenden WCM Objekts remark String Zeichenkette die zum Protokoll des WCM Objekts hinzugef gt wird oder null dplWaitInfo DeploymentWaitInfo Liste der Deploymentsysteme oder null R ckgabe keine Voraussetzungen Erforderliche Zugriffsrechte READ und WRITE m Objektstatus muss EDITED REJECTED RELEASED oder PENDING RELEASE sein 102 Livelink WCM Server Folge Objektverwaltung Nach dem Ausleihen hat das WCM Objekt den Status CHECKED_OUT Hinweis Um den Objektinhalt zu bearbeiten muss anschlie end getCheckQutContent aufgerufen werden siehe getCheckOutCon tent auf Seite 134 direc
137. t name gt lt template xsi type xsd boolean gt false lt template gt lt topic xsi type xsd boolean gt false lt topic gt lt frame xsi type xsd boolean gt false lt frame gt lt fileOnCreateNeeded xsi type xsd boolean gt false lt fileOnCreateNeeded gt lt tns ObjectType gt lt tns Sort id id7 xsi type tns Sort gt lt stringValue xsi type xsd string gt createdDate lt stringValue gt lt descending xsi type xsd boolean gt false lt descending gt lt tns Sort gt lt soap Body gt lt soap Envelope gt Dieses Beispiel ist sehr komplex Die Ursache hierf r liegt in dem allge meinen L sungsansatz den das NET Framework SDK wie andere Tool kits auch f r die Serialisierung von Objekten in XML w hlt Es wird versucht gleiche Objekte nur genau einmal zu serialisieren Das ist nicht zwingend erforderlich Deshalb kann ein quivalenter SOAP Befehl auch so einfach aussehen POST wcm WebService Port InternetSite edit HTTP 1 1 Authorization Basic YWRtaW46YQ Content Type text xml Host wcmserver company example SOAPAction http gaussvip com Content Length 1378 lt xml version 1 0 encoding UTF 8 standalone no gt lt SOAP ENV Envelope xmins SOAP ENV http schemas xmlsoap org soap envelope xmins SOAP ENC http schemas xmlsoap org soap encoding xmins xsi http www w3 org 2001 XMLSchema instance xmins xsd http www w3 org 2001 XMLSchema xmins vip http gaussvip com
138. t ist Wenn kein Deploymentsystem f r diese Website existiert wird hier null geliefert name Datentyp Permission String Name des Status Allgemeine Informationen zu Zugriffsrechten erhalten Sie im Abschnitt Zugriffsrechte f r WCM Objekte auf Seite 35 Der Datentyp Permission repr sentiert ein Zugriffsrecht das f r WCM Objekte gew hrt oder verweigert werden kann Jedes WCM Objekt hat eine Zugriffssteuerungsliste ACL die eine Menge von Principals zusammen mit ihren gew hrten und verweigerten Zugriffsrechten enth lt Das WCM Objekt erbt die ACL des bergeordneten Objekts rekursiv wenn es keine eigene ACL hat Weitere Informationen zu ACLs erhalten Sie im Abschnitt Datentyp Ac1 auf Seite 90 88 Livelink WCM Server Objektverwaltung Tabelle 18 Die m glichen Zugriffsrechte fur WCM Objekte Name Abk rzung Beschreibung CHANGE_RIGHTS cr Recht zur Anderung der Zugriffsrechte eines WCM Objekts CREATE c Recht zum Anlegen eines neuen WCM Objekts DELETE d Recht zum L schen eines WCM Objekts READ r Recht zum Lesen eines WCM Objekts READ_PRODUCTION rp Recht zum Lesen eines WCM Objekts in der Produktionssicht RELEASE rl Recht zum Freigeben eines WCM Objekts TREE_OPERATIONS t Recht zum Kopieren und Verschieben eines WCM Objekts WRITE w Recht zum ndern eines WCM Objekts WRITE_META wm Recht zum ndern von Metadaten Tabelle 19 D
139. tChild Value literalError Text lt hr gt catch Exception exc rowError Visible true literalError Text exc Message Damit sind die Code Beispiele fur C und ASP NET abgeschlossen Den vollst ndigen Quellcode f r die in Tabelle 75 ASP NET Beispiel auf Seite 182 aufgelisteten Module finden Sie im Verzeichnis WCM Installationsverzeichnis examples webservices asp net Diese Dateien k nnen Sie Uber Add existing item in ein Visual Studio Projekt Ubernehmen 192 Livelink WCM Server Anwendungsbeispiele Caveats Bei der Nutzung von WCM WebServices im NET Umfeld ist Folgendes zu beachten Es gibt einen Namenskonflikt zwischen dem WCM Datentyp Version und dem eingebauten NET Datentyp Version im Namensraum System Aus diesem Grunde muss der WCM Datentyp Version immer vollstandig mit Namensraum qualifiziert werden Beispiel VipWebServiceClient com company wcmserver Version v new VipWebServiceClient com company wcmserver Version WCM WebServices Programmierhandbuch 193 194 Livelink WCM Server Glossar ACL Access Control List siehe Zugriffssteuerungsliste Aktion Schritt der zur Verwaltung von Website Objekten notwendig ist und meistens zur Status nderung des betreffenden Objekts f hrt Asynchrone Aktion Eine asynchrone Aktion kehrt praktisch sofort nach dem Aufruf zur ck wartet also nicht bis die damit verbundenen Aufgaben abgeschlossen sind Siehe auch synchrone Akti
140. tRelease Gibt eine Liste von WCM Objekten ohne eine Vorlage zur Qualitatssi cherung frei Parameter Tabelle 31 Parameter der Methode directRelease Parameter Datentyp Beschreibung oids ObjectId OIDs der WCM Objekte die direkt freigegeben werden pendingReleaseDate Date Datum und Uhrzeit wann die angegebenen WCM Objekte freigegeben werden sollen verz gerte Freigabe remark String Zeichenkette die zum Protokoll der WCM Objekte hinzugef gt wird oder null emaillnfo EMailInfo E Mail Information die an die in den Objektdaten definierten Empf nger gesendet wird oder null falls keine E Mail gesendet werden soll dplWaitInfo DeploymentWait Info Liste der Deploymentsysteme oder null WCM WebServices Programmierhandbuch 103 Kapitel 5 R ckgabe keine Voraussetzungen Erforderliche Zugriffsrechte READ und WRITE oder WRITE_META m Objektstatus muss EDITED sein Folge Nach der direkten Freigabe hat WCM Objekt den Status RELEASED bzw PENDING_RELEASE falls ein Freigabetermin in der Zukunft ange geben wurde reject 104 Lehnt eine Liste von WCM Objekten ab Parameter Tabelle 32 Parameter der Methode reject Parameter Datentyp Beschreibung oids Objectld OIDs der WCM Objekte die abgelehnt werden remark String Zeichenkette die zum Protokoll jedes WCM Objekts hinzugef gt wird oder null emaillnfo EMa
141. ten bevor sie in den produktiven Betrieb bernommen wird F r das korrekte Funktionieren der entwickelten Software kann keinerlei Garantie durch die Gauss Interprise AG bernommen werden Gern unterst tzen wir Sie beratend und entwickelnd durch den Bereich Gauss Professional Services um so Probleme bereits in einer fr hen Phase der Entwicklung zu verhindern 1 1 Hinweise zu dieser Dokumentation Diese Dokumentation richtet sich an Betreiber eines WCM Systems die den Zugriff auf die Daten des WCM Systems ber Web Services einrichten m chten Dienstanbieter und Softwareentwickler die ber WCM WebServices auf die Funktionalit ten des WCM Systems zugreifen m chten Dienstnehmer Um ber WCM WebServices auf WCM Funktionalit ten zugreifen zu k nnen werden entsprechende Vorkenntnisse ber die Arbeitsweise und Funktionen von Livelink WCM Server vorausgesetzt Die Realisierung einer Client Applikation zur Nutzung von WCM Funktionen kann in verschiedenen Programmiersprachen erfolgen 12 Livelink WCM Server Einleitung Der Inhalt dieses Handbuchs ist folgenderma en gegliedert Kapitel 2 Konzepte erl utert die grundlegenden Konzepte von WCM WebServices und Livelink WCM Server Kapitel 3 Einsatz von WCM WebServices ist vorrangig f r den Dienstanbieter bestimmt Es beschreibt die erforderlichen Konfigura tionsma nahmen im WCM System f r den Einsatz von WCM WebServices Au erdem behandelt es die WCM
142. ten definierten Empf nger gesendet wird oder null falls keine E Mail gesendet werden soll dplWaitInfo DeploymentWaitInfo Liste der Deploymentsysteme oder null WCM WebServices Programmierhandbuch 107 Kapitel 5 R ckgabe keine Voraussetzungen Erforderliche Zugriffsrechte READ und WRITE oder WRITE_META m Objektstatus muss EDITED oder REJECTED sein Folge Nach dem Vorlegen haben die WCM Objekte den Status SUBMITTED undoCheckOut Das Ausleihen der angegebenen WCM Objekte wird r ckg ngig gemacht Dadurch sind die Objekte zur Bearbeitung durch andere verf gbar Parameter Tabelle 36 Parameter der Methode undoCheckOut Parameter Datentyp Beschreibung oids Objectld OIDs der betreffenden WCM Objekte remark String Zeichenkette die zum Protokoll der WCM Objekte hinzugef gt wird oder null dplWaitInfo DeploymentWaitInfo Liste der Deploymentsysteme oder null R ckgabe keine 108 Livelink WCM Server Objektverwaltung Voraussetzungen Erforderliche Zugriffsrechte READ und WRITE m Objektstatus muss CHECKED_OUT sein Folge Nachdem die nderungen an den ausgeliehenden WCM Objekten verworfen wurden haben die WCM Objekte den Status EDITED 5 4 Workflow Methoden Die Schnittstelle f r die Verwaltung von Workflow Objekten erlaubt das Zuordnen eines Workflows zu einem WCM Objekt das Weiterleiten von WCM Objekten im Workflow und das Aufheben d
143. tribut Datentyp Beschreibung createdBy User A Benutzer der das WCM Objekt angelegt hat createdDate dateTime 4 Datum mit Uhrzeit an dem das WCM Objekt erstellt wurde deploymentHint String a a Deploymenthinweis d h der vorge schlagene Name f r die Seite die aus dem WCM Objekt erzeugt wird description String ga Beschreibung des Objektinhalts directRelease boolean q f Dieser Wert ist genau dann wahr wenn das WCM Objekt direkt freige geben werden kann ohne die Qualitatssicherung zu durchlaufen editEMail Receivers String ad E Mail Adressen die zur Benach richtigung verwendet werden sollen wenn das WCM Objekt abgelehnt oder das Ablaufdatum erreicht wurde expireDate dateTime d A Datum mit Uhrzeit bis zu dem das WCM Objekt g ltig ist keywords String d A Geordnete Menge von Schl sselbe griffen die diesem WCM Objekt zugeordnet sind 80 Livelink WCM Server Objektverwaltung Attribut Datentyp Beschreibung LinkedFrom ObjectId La Array von OIDs der WCM Objekte die Referenzen auf das aktuelle WCM Objekt enthalten Falls keine Referenzen vorhanden sind wird null zur ckgeliefert LinksTo Link a Array der Referenzen die sich im Inhalt des WCM Objekts befinden Falls keine Referenzen vorhanden sind wird ein leeres Array zur ckgeliefert locale
144. tributes getNamedItem href nodeValue 2 174 Livelink WCM Server Anwendungsbeispiele Set objectDataItemList _ resultDom selectNodes id amp itemId amp Populate the array element Set results i _ tmpDocData getObjectFromNodeList objectDataItemList _ resultDom Next End If End If set the return value filter results End If End Function Die Filter Methode kann zum Beispiel folgenderma en angewendet werden Sub vipFilterPDF Dim filteresult As Variant If VipWebService Is Nothing Then Set VipWebService New VipWebServiceClient End If Dim pdfFilter As New GenericFilter Let pdfFilter FilterType EqualFilter Set pdfFilter Key New Key Let pdfFilter Key stringValue objectType Set pdfFilter Value New Value Set pdfFilter Value objectType New objectType Let pdfFilter Value objectType name PDF Dim startId As New objectID Let startId id 1 Dim dateSort 1 As New Sort Let dateSort 0 stringValue createdDate Dim attributeKeys 4 As String Let attributeKeys 0 createdDate Let attributeKeys 1 objectId Let attributeKeys 2 objectState Let attributeKeys 3 title WCM WebServices Programmierhandbuch 175 Kapitel 6 Dim numRows As Integer filterResult VipWebService filter pdfFilter startId dateSort _ 0 5 attributeKeys numRows End Sub Mit diesem Beispiel werden die Code Beispiele f r Visual Basic beendet Den vollst ndigen
145. tring gt lt faultactor gt Vip Content Manager API lt faultactor gt lt detail gt lt tns message sequenceNo 0 gt 0303 The master server was unable to perform the request lt tns message gt lt tns message sequenceNo 1 gt 0738 Direct release of object amp apos 68 amp apos failed lt tns message gt lt tns message sequenceNo 2 gt 0582 No direct release is permitted for object amp apos 68 amp apos lt tns message gt lt tns wrappedExceptionName gt de gauss vip api VipApiException lt tns wrappedExceptionName gt lt tns wrappedExceptionMessage gt 0303 The master server was unable to perform the request lt tns wrappedExceptionMessage gt lt detail gt lt soap Fault gt lt soap Body gt lt soap Envelope gt WCM WebServices Programmierhandbuch 191 Kapitel 6 Eine Detailanzeige k nnte also die lt tns message gt Elemente anzeigen Dabei gilt die Regel dass die Meldungen mit aufsteigender Serien nummer Attribut sequenceNo immer spezifischer werden So k nnte der Quellcode aussehen catch SoapException soapExc rowError Visible true literalError Text soapExc Message lt hr gt Code amp nbsp soapExc Code Name lt hr gt Details lt br gt XmlNodeList details soapExc Detail ChildNodes for int i 0 i lt details Count i XmlNode detail details i if detail LocalName Equals message literalError Text lt br gt detail Firs
146. ts hinzu Parameter Tabelle 47 Parameter der Methode addRemark Parameter Datentyp Beschreibung oid ObjectId OID des betreffenden WCM Objekts remark String Zeichenkette die zum Protokoll des WCM Objekts hinzugef gt werden soll oder null R ckgabe keine WCM WebServices Programmierhandbuch 121 Kapitel 5 Voraussetzungen Erforderliche Zugriffsrechte READ und WRITE_META m Objektstatus keine Einschr nkungen Folge Der Objektstatus ndert sich nicht change ndert die Metadaten eines WCM Objekts Es k nnen nur die in Tabelle 13 Die Komponenten des Datentyps ObjectData auf Seite 79 als modifizierbar angegebenen Attribute ge ndert werden In objectData attributeKeys m ssen alle Attribute angegeben werden die ge ndert werden sollen Dar ber hinaus muss objectData objectId gesetzt sein Parameter Tabelle 48 Parameter der Methode change Parameter Datentyp Beschreibung objectData ObjectData Geanderte Objektdaten remark String Zeichenkette die zum Protokoll des WCM Objekts hinzugef gt wird oder null dplWaitInfo DeploymentWaitInfo Liste der Deploymentsysteme oder null R ckgabe keine 122 Livelink WCM Server Objektverwaltung Voraussetzungen Erforderliche Zugriffsrechte READ und WRITE_META Soll die Zugriffssteuerungsliste ACL ge ndert werden ist zus tzlich das Zugriffsrecht CHANGE_RIGHTS notwendig m O
147. tung Tabelle 27 Die Komponenten des Datentyps DepLoymentWai t Info Attribut Datentyp Beschreibung deploymentSystems String Liste von Deploymentsystemen auf die gewartet werden soll isTimeout boolean In WCM WebServices ist dies ein Feld das fur zukunftige Funktionen reserviert ist Zum jetzigen Zeit punkt hat es keine Bedeutung timeout long Maximale Zeit in Millisekunden die auf die Beendigung der Deploy mentaufgaben gewartet wird Parameter EMai LInfo Der Datentyp EMailInfo repr sentiert die Informationen die zum auto matischen Erstellen von E Mails verwendet werden Diese E Mails werden beim Vorlegen Freigeben L schen und Ablehnen von WCM Objekten versendet Das Senden der E Mails kann auf dem WCM Server erfolgen wenn die entsprechenden Methoden verwendet werden Der im WCM Server implementierte Algorithmus sammelt alle E Mail Adressen aus den Daten des WCM Objekts Die Aktion definiert welche Attribute zur Erzeugung der E Mail Adressen verwendet werden Die rele vanten Attribute sind editEMailReceivers QAEMailReceivers und releaseEMailReceivers Wenn im Aufruf einer Staging Methode der Parameter f r die EMailInfo gleich null ist erzeugt das WCM System keine E Mails WCM WebServices Programmierhandbuch 99 Kapitel 5 Tabelle 28 Die Komponenten des Datentyps EMailInfo 5 3 Staging Methoden Attribut Datentyp Beschreibung cc String CC Fel
148. vel ist besonders f r Wartungsarbeiten am WCM System vorgesehen Beim bergang zum Runlevel 3 werden die Websites vollst ndig heruntergefahren Beim bergang zum n chsth heren Runlevel wird das System f r alle Benutzer freigegeben 5 Server l uft Der Server ist vollst ndig gestartet Folgende Runlevels von Websites gibt es F r die Website Runlevel wird mindestens der Server Runlevel 4 vorausgesetzt 68 6 Website nicht zugreifbar Eine bzw alle Websites sind nicht mehr verf gbar auch nicht f r lesende Zugriffe Damit sind auch die Deploymentsysteme nicht mehr aktiv Livelink WCM Server Zugriff auf Administrationsdaten und Authentifizierung 7 Website wird konfiguriert Die angegebene Website wird in diesem Runlevel konfiguriert die Konfigurationsdaten werden geschrieben Beim bergang zum n chsth heren Runlevel werden die Websites f r den lesenden Zugriff initialisiert 8 Website schreibgesch tzt Auf eine bzw auf alle Websites kann lesend zugegriffen werden Vom Deploymentsystem abh ngige Daten wie z B URLs und Pfade sind in diesem Runlevel noch nicht verf gbar Beim bergang zum n chsth heren Runlevel werden die Deploymentsysteme initialisiert 9 Deployment abgeschlossen Die Deploymentsysteme sind voll st ndig initialisiert d h Deploymentaufgaben werden durchgef hrt Beim bergang zu Runlevel 8 werden keine Deploymentaufgaben mehr durchgef hrt Beim bergang zum n chsth heren Runlevel
149. ver
150. vlet name gt lt display name gt WCM WebServices Servlet lt display name gt lt servlet class gt de gauss vip webservice transport WebServiceServlet lt servlet class gt lt servlet gt lt servlet mapping gt lt servlet name gt WebServiceServlet lt servlet name gt lt url pattern gt WebService lt url pattern gt lt servlet mapping gt S mtliche Anfragen die mit WebService beginnen werden an das WCM WebSeriices Servlet weitergeleitet Besonderheiten von Resin Wenn Sie Resin als JSP Engine verwenden sind zus tzlich folgende Schritte erforderlich 1 Setzen Sie in der Datei Resin Installationsverzeichnis conf resin conf folgende System Properties 40 Livelink WCM Server Einsatz von WCM WebServices lt system property javax xml parsers DocumentBuilderFactory org apache xerces jaxp DocumentBuilderFactoryImpl gt lt system property javax xml parsers SAXParserFactory org apache xerces jaxp SAXParserFactoryImpl gt lt xslt gt lt system property javax xml transform TransformerFactory org apache xalan processor TransformerFactoryImpl gt 2 Kopieren Sie folgende JAR Dateien aus dem Verzeichnis WCM Installationsverzeichnis lib in das Verzeichnis Resin Installationsverzeichnis lib xalan jar xercesimpl jar xml apis jar xmiParserAPls jar Anpassungen in der Konfiguration durchf hren Damit Benutzer ber WCM WebServices auf den Content Server zugreifen k nne
151. von XML F r die Nutzung eines Web Service durch eine Applikation ist eine genaue Sprachregelung bzw Beschreibung erforderlich Die Beschreibung muss genaue Informationen liefern ber das verwendete Protokoll die Adresse und Port Nummer die m glichen Prozeduren und Funktionen sowie die Formate f r Input und Output Der Anbieter eines Web Service stellt diese Informationen in Form einer WSDL Datei zur Verf gung XML Extensible Markup Language Ein Standard der zur Normierung des formalen Aufbaus von Dokumenten verwendet wird XSL Extensible Stylesheet Language Ein Standard f r Anweisungen mit dem XML Dokumente in andere Formate umgewandelt werden k nnen XSL wird h ufig zur Umwandlung von XML in HTML genutzt Zugriffssteuerungsliste F r jedes WCM Objekt k nnen Benutzer Gruppen Rollen und Gruppenrollen festgelegt werden die Zugriff auf dieses Objekt haben sollen Die einzelnen Zugriffsrechte werden f r jeden Zugriffsberechtigten separat festgelegt Wird auch als ACL Access Control List bezeichnet Zur ckgeben Staging Aktion von Livelink WCM Server Ein ausgeliehenes und bearbeitetes Objekt wird durch die Aktion Zur ckgeben an das WCM System zur ckgegeben Damit werden die vorgenommenen nderungen in der Edit Sicht sichtbar Das Objekt wird wieder mit der Vorlage verkn pft und steht zur weiteren Bearbeitung zur Verf gung WCM WebServices Programmierhandbuch 199 200 Livelink WCM Server I
152. vorzunehmen S mtliche Daten die auf Bildschirmphotographien screenshots sichtbar sind dienen lediglich als Beispiel zur Demonstration der Software F r den Inhalt dieser Daten bernimmt IXOS keine Gew hr Dieses Produkt beinhaltet Software die im Rahmen des Projekts OpenSSL f r den Gebrauch im OpenSSL Toolkit http www openssl org bzw die durch die Apache Software Foundation http www apache org entwickelt wurde Marken IXOS IXOS SOFTWARE AG SAP R 3 und SAP ArchiveLink sind eingetragene Marken der SAP AG Microsoft Microsoft Windows NT und die Namen weiterer Microsoft Produkte sind eingetragene Marken der Microsoft Corporation Acrobat Reader Copyright 1987 Adobe Systems Incorporated Alle Rechte vorbehalten Adobe und Acrobat sind Marken von Adobe Systems Incorporated die in bestimmten Rechtsbereichen registriert sein k nnen Siebel ist eingetragene Marke der Siebel Systems Inc Sonstige Produktnamen werden nur zur Identifikation der Produkte verwendet und k nnen eingetragene Marken der entsprechenden Hersteller sein Copyright 2005 Gauss Interprise AG Hamburg Gauss Interprise Inc Irvine California Alle Rechte weltweit vorbehalten Dieses Dokument sowie die zugeh rige Software sind Eigentum der Gauss Interprise AG oder ihrer Zulieferer und durch Gesetze zum Schutze des Urheberrechts und andere Gesetze gesch tzt Sie werden unter einer Lizenz vertrieben durch welche die Nutzung Repr
153. w hlt werden der nach der Zuordnung automatisch ausgef hrt wird Bei dieser Methode handelt es sich um eine asynchrone Methode d h die Methode kehrt praktisch sofort nach dem Aufruf zur ck und wartet nicht bis die damit verbundenen Aufgaben abgeschlossen sind 110 Livelink WCM Server Parameter Objektverwaltung Tabelle 38 Parameter der Methode assignWorkflowAsync Parameter Datentyp Beschreibung oids ObjectId OlDs der WCM Objekte denen ein Workflow zugeordnet werden soll workflowOid ObjectId OID des zugeordneten Workflows startTransition String Name des initialen Ubergangs remark String Zeichenkette die zum Protokoll der WCM Objekte hinzugef gt wird oder null emaillnfo EMailInfo E Mail Information die an den Prin cipal gesendet wird der der n chsten Aktivit t zugeordnet ist oder null falls keine E Mail gesendet werden soll R ckgabe keine Voraussetzungen Erforderliche Zugriffsrechte READ Objektstatus wird durch die initiale Workflow Aktivitat bestimmt m Funktionsbereich WORKFLOW Folge Der Objektstatus ndert sich nicht WCM WebServices Programmierhandbuch 111 Kapitel 5 forward Leitet ein Objekt im Workflow ber den angegebenen bergang von der aktuellen zur n chsten Aktivit t weiter Parameter Tabelle 39 Parameter der Methode forward Parameter Datentyp Beschreibung workflow Workflow Workflow Definition transition Transition
154. wendete Protokoll SOAP besteht aus folgenden Komponenten SOAP Envelope eine Art Umschlag in dem beschrieben ist was die Nachricht enthalt und was damit geschehen soll SOAP Body enth lt die eigentlichen Nutzdaten weitere Informationen zum Transport und Code Die folgende Abbildung veranschaulicht das grundsatzliche Prinzip von WCM WebServices Web Service Client WSDL Datei SOAP Request und SOAP Response 1 i HTTP Server 1 1 I i WCM WebServices Servlet 1 Content Server Abb 4 Grundlegende Funktionsweise von WCM WebServices WCM WebServices Programmierhandbuch 27 Kapitel 2 Der Web Service Client schickt eine Anfrage SOAP Request in einem SOAP Envelope an den Content Server Der SOAP Envelope wird dabei vom WCM WebServices Servilet zerlegt und der Inhalt der Nachricht SOAP Body an den WCM WebServices Handler weitergeleitet Nach Bearbeitung der Nachricht durch den Content Server wird eine entspre chende Antwort SOAP Response mit ahnlichem Aufbau vom Servlet zusammengesetzt und an den Client zur ckgeschickt Das Modul des Clients empf ngt die Antwort trennt die SOAP Bestandteile und stellt die Nutzdaten als R ckgabewerte der aufgerufenen Funktion zur Verf gung Hinweis Der Zugriff auf den Content Server ber das WCM WebServices Serviet erfordert eine Authentifizierung Basic Authentication des jeweiligen Benut
155. werden Parameter Tabelle 6 Parameter der Methode getRoleProfile Parameter Datentyp Beschreibung ldapContext String LDAP Kontext in dem die Suche durchge f hrt wird oder null falls die Benutzerverwaltung nicht LDAP basiert ist filter Filter Suchkriterium oder null um nach allen Rollen zu suchen sortList startResult Sort int Liste der Attribute nach denen die Ergeb nisliste sortiert werden soll in nach Priorit t absteigender Folge Zahl die das erste Element des Sucher gebnisses angibt Mit 0 wird das Suchergebnis von Anfang an geliefert numberOfResults int Anzahl der zur ckzuliefernden Suchergeb nisse beginnend bei startResult Mit 1 werden alle Ergebnisse zur ckgeliefert WCM WebServices Programmierhandbuch 59 Kapitel 4 R ckgabe Role roles Liste von Rollen die auf das angegebene Suchkrite rium passen getUserProfiles Liefert die Benutzerdaten der Benutzer zur ck die auf das spezifi zierte Filterkriterium zutreffen Die Ergebnismenge kann durch startResult und numberOfResults begrenzt werden Parameter Tabelle 7 Parameter der Methode getUserProfile Parameter Datentyp Beschreibung ldapContext String LDAP Kontext in dem die Suche durchge f hrt wird oder null falls die Benutzerverwaltung nicht LDAP basiert ist filter Filter Suchkriterium oder null um nach allen Benut
156. ws eingesetzt werden Tabelle 26 Die Komponenten des Datentyps WorkflowNavigationInfo Attribut Datentyp Beschreibung activity Activity M gliche Aktivit ten eines Principals workflow Workflow Workflow Definition WCM WebServices Programmierhandbuch 97 Kapitel 5 5 2 Allgemeine Parameter Einige der im Folgenden beschriebenen Methoden verwenden die Para meter DeploymentWaitInfo und EmailWaitInfo Diese Parameter haben immer die gleiche Funktion und werden daher nur einmal an dieser Stelle beschrieben Parameter Dep LoymentWai tInfo Der Datentyp DeploymentWaitInfo reprasentiert die Informationen die verwendet werden um auf alle Jobs der Deploymentsysteme zu warten die zu einer Aktion geh ren Dieser Datentyp wird in Prozeduraufrufen verwendet die Staging Aktionen ansto en Ist der Parameter DeploymentWaitInfo nicht null so wartet die aufru fende Methode darauf dass die in diesem Parameter spezifizierten Deploymentsysteme alle zugeh rigen Deploymentaufgaben abschlie en Die maximale Wartezeit wird durch DeploymentWaitInfo timeout defi niert Die Methode kehrt sp testens zur ck wenn die Wartezeit f r diese Aktionen den angegebenen Timeout Wert berschreitet Wenn im Aufruf einer Staging Methode der Parameter f r DeploymentWaitInfo gleich null ist wird auf kein Deploymentsystem gewartet Die Abarbeitung der Deploymentaufgaben geschieht dann asynchron 98 Livelink WCM Server Objektverwal
157. zern zu suchen sortList startResult Sort int Liste der Attribute nach denen die Ergeb nisliste sortiert werden soll in nach Priorit t absteigender Folge Zahl die das erste Element des Sucher gebnisses angibt Mit O wird das Suchergebnis von Anfang an geliefert numberOfResults int Anzahl der zur ckzuliefernden Suchergeb nisse beginnend bei startResult Mit 1 werden alle Ergebnisse zur ckgeliefert 60 Livelink WCM Server Zugriff auf Administrationsdaten und Authentifizierung R ckgabe User users Liste von Benutzern die auf das angegebene Such kriterium passen Standard Objektrechte bergeben Die Komponente initialGrantedPermissions der Datentypen User Group und Role enth lt eine Liste mit erlaubten Standard Objektrechten f r den Principal Diese voreingestellten Zugriffsrechte sollten von einem WCM WebServices Dienstprogramm als Einstellung vorgeschlagen werden wenn der Principal in die Zugriffssteuerungsliste eines WCM Objekts aufgenommen wird Die Komponente InitialDeniedPermissions wird analog verwendet und beinhaltet die verbotenen Standard Objektrechte des Principals Die nderung der Zugriffssteuerungsliste eines WCM Objekts erfolgt mithilfe des Datentyps Ac1 siehe ACL eines WCM Objekts ndern auf Seite 91 WCM WebServices Programmierhandbuch 61 Kapitel 4 4 2 Funktionsbereiche In Livelink WCM Server m ssen Benutzer direkt oder indir
158. zers Dieser Benutzer muss im WCM System angelegt sein 2 3 Konzepte von Livelink WCM Server Der folgende Abschnitt beschreibt in kurzer Form die grundlegenden Konzepte von Livelink WCM Server Dabei steht die Beschreibung der Begriffe im Vordergrund die beim Arbeiten mit WCM WebServices eine Rolle spielen Eine ausf hrliche Beschreibung der technischen Konzepte und der Archi tektur von Livelink WCM Server finden Sie im Livelink WCM Server Admi nistratorhandbuch Weitere Informationen zum Arbeiten mit einem WCM System sind im Content Client Benutzerhandbuch enthalten 28 Livelink WCM Server Konzepte Objektdaten Livelink WCM Server dient der Verwaltung von Websites Websites enthalten bestimmte Dokumente die f r die verschiedensten Zielgruppen verwaltet werden Solche Dokumente k nnen z B HTML oder XML Dokumente Grafiken oder Microsoft Word Dokumente sein Die Dokumente einer von Livelink WCM Server verwalteten Website werden als WCM Objekte bezeichnet Jedes WCM Objekt geh rt zu einem bestimmten Typ siehe Abschnitt Objekttyp auf Seite 31 und setzt sich aus folgenden Bestandteilen den so genannten Objektdaten zusammen Inhalt Der Inhalt Content eines WCM Objekts sind die Daten des eigentlichen Dokuments wie z B die Zeichenfolge in einer HTML Datei oder die Folge von Bytes einer Grafikdatei Metadaten Die Metadaten eines Objekts liefern Informationen Uber das Dokument z B von wem das D
159. zwischen der Bearbeitung in der Edit Sicht und der Ver ffentlichung in der Produktionssicht dar Session Einheit die von der JSP Engine verwaltet wird damit logisch zusammenh ngende Aktionen aus Sicht der Ressourcen auch zusammengefasst werden k nnen SOAP Simple Object Access Protocol Standard der den plattformun abh ngigen Zugriff auf Web Services erm glicht bzw die Daten bertra gung zwischen dem Dienstanbieter und dem Dienstnehmer der Web Services definiert Das verwendete Austauschformat ist XML Status Der Bearbeitungszustand eines WCM Objekts nderungen des Status werden durch entsprechende Aktionen am WCM Objekt veranlasst WCM WebServices Programmierhandbuch 197 Glossar Synchrone Aktion Eine synchrone Aktion kehrt erst zur ck wenn alle damit verbundenen Aufgaben abgeschlossen sind Siehe auch asynchrone Aktion Topologie Die hierarchische Anordnung von WCM Objekten nach bestimmten Kriterien Neben der Navigationstopologie Anordnung nach Themen mit ihren jeweiligen Unterobjekten gibt es auch eine Vorlagentopologie Transaktion Durch eine Transaktion k nnen mehrere Aktionen miteinander verbunden werden sodass alle nderungen erst wirksam werden wenn die Transaktion explizit beendet wird UDDI Universal Description Discovery and Integration Dieser XML basierte Standard legt fest wie Detailinformationen zu Web Services und deren Anbietern in einheitlicher Form in Verzeichniss

Download Pdf Manuals

Related Search

Related Contents

Bedienungsanleitung Crosstrainer  Indicazioni di progettazione  

Copyright © All rights reserved. Failed to retrieve file