Domino und PHP EC 2013 Track 2 Session 7

Transkript

1 Domino und PHP EC 2013 Track 2 Session 7 1

2 Domino und PHP Worum es heute geht Überblick über die verschiedenen Methoden Installation Allerlei Beispiele und Ideen Worum es nicht geht LotusScript, PHP (Sie sollten die Grundidee beherrschen) 2

3 Domino und PHP Los geht's! - Einführung Über WieLis.com Mit wem haben Sie es zu tun? Wie installieren? Praktische Anwendung Ansichten auslesen Dokumente lesen und speichern PDF-Generierung 3

4 Los geht s! Einführung Über WieLis.com / die Notes-Werkstatt Gegründet Mitarbeiter Domino-Entwicklung Workflows Schnittstellen Intranetlösungen Web-Entwicklung Intra-/Extranets Shop/Community/Schnittstellenlösungen Workflow / Support/Operations Serverbetrieb und Hosting (Windows, Linux, Domino) Netzwerksupport Analyse und Konzeption 4

5 Los geht's! - Einführung Ihre Referentin - Mit wem haben Sie es zu tun? Anne Wiesmann, aw@wielis.com Studierte Diplom-Ingenieurin (FH) Technische Informatik IT-Erfahrung seit 1995 Gründerin und Mitinhaberin von WieLis.com seit

6 Wie installieren? PHP direkt auf dem Domino Server (CGI) Funktioniert prima, spart Ressourcen Keine direkte Kommunikation möglich PHP auf eigenem Apache Vor allem dann zu empfehlen, wenn der Apache ohnehin vorhanden ist oder MySQL Datenbanken genutzt werden sollen Auch keine direkte Kommunikation möglich 6

7 Wie installieren? (2) PHP über COM API Alles möglich (ähnlich Lotusscript) Notes-Client muss auf dem Webserver installiert sein Windows-Betriebssystem erforderlich PHP über C API Klappt gut, erfordert aber C-Kenntnisse und tiefe Kenntnisse über die Schnittstellen des Domino Servers PHP über Notes SQL Mit neueren Betriebssystemen und Notes- Versionen problematisch Windows-Betriebssystem erforderlich 7

8 Zugriff über C API Gut machbar, greift aber tief ins System ein Stabilitätsrelevant Erfordert tiefe Systemkenntnisse Eigene dll muss hergestellt werden Domino Server Abstürze möglich 8

9 Zugriff über Notes SQL Ja, aber Funktioniert nicht sauber auf 64 Bit Systemen Instabil Nicht sonderlich performant Windows-Betriebssystem erforderlich 9

10 Fazit Direkter Zugriff ist schick, aber schwierig zu machen Indirekter Zugriff ist schwieriger, dafür aber sicher und ausreichend performant Im folgenden werden die Möglichkeiten des indirekten Zugriffs gezeigt 10

11 Genug gelabert ;-) Rein ins Praktische 11

12 PHP CGI installieren Installation ist leicht: PHP installieren (Standard Download von PHP Website) 12

13 PHP CGI installieren (2) Installation ist leicht: VC Redistributable installieren php.ini anpassen Testen 13

14 PHP CGI installieren (3) Redirect im Server/Websitedokument eintragen 14

15 PHP CGI installieren (4) Testen, ob alles geklappt hat. 15

16 PHP über eigenen Apache Installation nach Anleitung Kollidierende Ports Domino / Apache beachten Ggf. Domino Port ändern Zugriff nur über Webservices / Agenten etc. möglich 16

17 PHP über COM API Apache / PHP wie gewohnt installieren Notes Client wie gewohnt installieren Einmalig starten, geeignete User-ID nutzen Loslegen 17

18 Webservices Verfügbar ab Domino 8 Vernünftig nutzbar ab Domino

19 Ansichten auslesen Mit Bordmitteln möglich Vorteil: Geht mit jeder Ansicht ohne weiteren Programmieraufwand Nachteil: Es wird immer die ganze Ansicht übertragen Langsam Hohes Datenvolumen Alternative: Über Webservice Vorteil: Schlank, anpassbar Beliebige Dokumentauswahl möglich (auch z.b. Volltextsuche) Beliebige Feldauswahl möglich Nachteil: Programmieraufwand nötig Für jede Auswahl neuer Programmiercode nötig Alternativ: Parameter übergeben (aber sicherheitsrelevant) 19

20 Ansichten auslesen mit Bordmitteln GetViewEntries liefert View-Inhalt als XML: 20

21 Ansichten auslesen mit Bordmitteln (2) Einfaches PHP-Skript zur Anzeige: So sieht es aus: 21

22 Ansichten auslesen über Webservice Beispielanwendung: PLZ-Auswahl Quelldaten: Notes-Dokumente mit Orten und Postleitzahlen Ziel: Suchfunktion für Orte abhängig von Land und PLZ-Teilstück 22

23 Ansichten auslesen über Webservice(2) PHP Frontend Die Adresse des Domino Webservices SOAP kompatible Anfragedaten mit unseren Suchwörtern Curl Konfiguration Einlesen in simplexml Passendes Element aus dem SOAP Return auslesen 23

24 Ansichten auslesen über Webservice(3) Zurückgegebener XML-Code (SOAP Return) Envelope Body 24

25 Ansichten auslesen über Webservice(4) Lotus Script und wsdl Deklaration Liste von Orten Einzelner Ort Einzelner Ort Array von Orten Liste von Orten 25

26 Ansichten auslesen über Webservice(5) Abfrageklasse Gemäß WSDL übergebene Parameter Volltextsuche Array aus Ort-Elementen Ort befüllen Array zurückgeben 26

27 Dokumente lesen und schreiben Programmierung nötig Es existiert kein URL Befehl, der Dokumente zurückgibt Webservice kann ganz ähnlich aussehen wie eben beschrieben 27

28 Dokument bearbeiten Daten laden (PHP-Seite) ID übergeben Rückgabewerte verarbeiten 28

29 Dokument bearbeiten Daten laden (Webservice) Übergebene ID Werte zurückgeben 29

30 Dokumente bearbeiten Maske 30

31 Dokumente bearbeiten Dokument speichern (PHP-Seite) Rückgabewert anzeigen 31

32 Dokument bearbeiten Dokument speichern (Webservice) Bei neuem Dokument ID vergeben 32

33 Die View Dokument bearbeiten Dokumentliste holen Durchlaufen und ausgeben 33

34 Demo-Time... Dokument bearbeiten 34

35 PDFs generien Mit fpdf ganz einfach Daten aus Domino Links im Web, über XPages oder berechnete Links im Notes-Client 35

36 So geht es: PDFs generieren (2) Fpdf einbinden Erste Seite Überschrift Tabellenzeilen 36

37 Ein Bild sagt mehr als 1000 Worte Bildnamen können oft eindeutig ermittelt werden URL kann im Webservice berechnet werden Download des Bildes über standard Domino Webservice (bei CGI) oder ein spezielles Handler Skript (beiapache-installation) 37

38 Webservice Backend Bilder anzeigen (2) Attachment Name zurückgeben 38

39 PHP Frontend Bilder anzeigen (3) Bild ausgeben 39

40 Ihre Fragen? Kleine Verschnaufpause 40

41 Ausblick / Weiterlesen Allgemeiner Abriss über die Möglichkeiten Installationsanleitung für PHP in Domino PHP Download (z.b.) VC Redistributable Webservices mit Lotus Domino fpdf Domino URL Cheat Sheet 41

42 Jetzt sind Sie dran... Vielen Dank für Ihre Aufmerksamkeit! Ich freue mich auf Ihre Fragen. Anne Wiesmann Technische Leitung / aw@wielis.com 42