PowerPoint - T1S2-Bild-Ressourcen - EntwicklerCamp

Bild-Ressourcen
Dirk Alicke
Südwestrundfunk Stuttgart
www.swr.de
Seite 1

• Voraussetzungen
• Prinzip
• Grundlagen (Base64)
• Import
• Export
• Tools
Was erwartet Sie?
Seite 2

Intension
• für Endanwender konfigurierbare
Ansichtssymbole
• für Endanwender konfigurierbare Grafiken in
Dokumenten
Seite 3

• Notes mind. 6.x
Die Klassen
Voraussetzungen
- NotesDXLExporter,
- NotesDXLImporter,
- NotesNoteCollection,
stehen erst ab Notes 6.x zur Verfügung.
Seite 4

Prinzip für den Import
Quelle: Bild-Datei (gif, jpg)
Quelle nach Base64 codieren
Seite 5

Prinzip für den Import (Fortsetzung)
DXL-Datei aufbauen
DXL-Datei importieren
Seite 6

Historisches zu Base64
Die ursprüngliche Fassung von SMTP war nur
für 7-Bit ASCII-Zeichen ausgelegt.
Damit binäre Dateien verschickt werden
können, wurde Base64 entwickelt.
Seite 7

Base64 Codierung
• Codierung von 8-Bit-Binärdaten in eine
Zeichenfolge
• Zeichenfolge besteht aus den ASCII-Zeichen
A-Z, a-z, 0-9, +, /, =
• = dient dabei nur als Auffüllzeichen
• wird z.B. im MIME-Format verwendet
• Verhältnis des Speicherplatzes ca. 3:4
Seite 8

Base64 Codierung Funktionsweise
• Quelle: binäre Datei mit 1 Byte = 8 Bit
• Ziel: Base64-Codierung mit 64 möglichen
Zuständen
(6 Bit entspricht 2 6 )
• Quelldatei in Abschnitte zu 6 Bit zerlegen
• Ggf. fehlende letzte Bits durch ein „=“ ersetzen
Ersetzungstabelle
Wert
Zeichen
0
A
1
B
…
…
25
Z
26
a
…
…
51
z
52
0
…
…
61
9
62
+
63
/
Seite 9

• Quelle: „EC08“
Base64 Codierung Beispiel
• Zerlegen in ASCII-CODE:
69, 67, 48, 56, 0, 0
• Binärschreibweise (8 Bit):
01000101.01000011.00110000.00111000.00000000.00000000
• Aufteilung in 6 Bit-Blöcke:
010001.010100.001100.110000.001110.000000.000000.000000
• Umwandlung in Dezimalzahlen:
17, 20, 12, 48, 14, 0, 0, 0
Seite 10

Base64 Codierung Beispiel (Fortsetzung)
• Umwandlung in Dezimalzahlen:
• Ersetzen der Zahlen:
17, 20, 12, 48, 14, 0, 0, 0
R, U, M, w, O, A, A, A
• Ersetzen der As, die durch Auffüllen entstanden
sind, durch „=“
• Base64-Codierter String:
„RUMwOA==“
Seite 11

Base64 in der Praxis
• unter Verwendung der Base64-Klasse von
Julian Robichaux (http://www.nsftools.com/)
• unter Verwendung der NotesMimeEntity-Klasse
´doc … NotesDocument-Objekt
´streamin … NotesStream-Objekt
Dim body As NotesMimeEntity
Set body = doc.CreateMIMEEntity
Call body.SetContentFromBytes(streamin, "image/gif", _
ENC_NONE)
´ Call body.SetContentFromBytes(streamin, "image/jpeg",_
´ ENC_NONE)
body.EncodeContent(ENC_BASE64)
Seite 12

• DXL ist Domino XML
Was ist DXL?
(XML … Extensible Markup Language)
• Tag-Definitionen sind in der Domino DTD
(Domino Document Type Definition) und ab
Version 7.0 zusätzlich in einem XML Schema
(Dateiendung: XSD) definiert
• ermöglicht die Anzeige einer kompletten oder
Teile einer Domino Anwendung (auch
Gestaltungselemente)
Seite 13

Beispiel
Import einer Bild-Ressource
• IMPORT: 1. Bilder nach Base64 codieren
- unter Verwendung der Base64-Klasse von
Julian Robichaux (http://www.nsftools.com/)
- unter Verwendung der NotesMimeEntity-Klasse
• IMPORT: 2. DXL-Datei erzeugen
• IMPORT: 3. DXL-Import
• IMPORT: 4. Import komplett
Seite 14

Dateianhänge und eingebettete Bilder
Übernahme in eine Bild-Ressource
• DXL-Export und Auswertung der
entsprechenden Tags
• Daten liegen schon Base64 codiert vor
• Namen der Dateianhänge müssen aus einer
Liste der Displaynamen und Name ermittelt
werden
• eingebettete Bilder haben keine Namen
Beispiele:
- Dateianhang als Bild-Ressource übernehmen
- eingebettetes Bild als Bild-Ressource übernehmen
- alle Bilder in einem Verzeichnis importieren
Seite 15

Prinzip für den Export
Quelle: Bild-Ressource
als DXL-Datei exportieren
Seite 16

Prinzip für den Export (Fortsetzung)
Tag / Base64 decodieren
Quelle: Bild-Datei (gif, jpg)
Seite 17

Base64 Decodierung Funktionsweise
• Quelle: Base64 codierte Zeichenfolge
• Zerlegen in 6 Bit Binärblöcke
• Aufteilung in 8 Bit-Gruppen
• Umwandlung in Dezimalzahlen
• Ersetzen durch ASCII-Zeichen
Seite 18

Base64 Decodierung Beispiel
• Quelle: „QjY0“
• Zerlegen in Base64- Zahlencode: 16, 35, 24, 52
• Schreiben in 6 Bit Binärblöcke:
010000.100011.011000.110100
• Aufteilung in 8 Bit-Gruppen:
01000010.00110110.00110100
• Umwandlung in Dezimalzahlen: 66, 54, 52
• Ersetzen durch ASCII-Zeichen: „B64“
Seite 19

Analysieren eines DXL-Streams
• aufbauen einer DOM-Baum-Struktur
(NotesDOMParser)
• Tag
• Attribut name enthält Name der Bild-
Ressource
• Tag oder enthält Base64 codiert
den Binärstream
Mehr dazu in Track 1 - Session 4 „Import von XML-
Daten in Notes“ von Jürgen Kunert.
Seite 20

Beispiele für den Export
- Bilddatei erzeugen aus einem Dokument mit
einem eingebetteten Bild
- alle Bild-Ressourcen exportieren
Seite 21

Nützliche Tools
Höhe und Breite eines Bildes ermitteln
Bild-Typ aus einer Binärdatei ermitteln
gif-Datei: beginnt binär mit „47 49 46“
jpg-Datei: beginnt binär mit „FF D8 FF“ und
endet mit „FF D9“
Beispiel:
- Höhe und Breite ermitteln
- Bildtyp ermitteln
Seite 22

Rechteproblematik
Für den DXLImport werden mind.
Entwicklerrechte benötigt. Folgende
Möglichkeiten gibt es diese Einschränkung zu
umgehen.
1. Ein Agent, bei dem die Eigenschaft
„Ausführen im Namen von“ gesetzt wird.
2. Mail-IN-Datenbank, in der ein ereignisgesteuerter
Agent den Import übernimmt.
3. Eigene Datenbank, auf die jeder Entwicklerrechte
hat und ein Agent kopiert dann die
Bild-Ressourcen in die produktive
Datenbank.
Seite 23

Quellen
Der Codierungs-Standard Base64 (Arndt Brünner )
www.arndt-bruenner.de/mathe/scripts/base64.htm
Wikipedia
de.wikipedia.org/wiki/Base64
JavaScript zur Base64-(De)Codierung (Selfhtml)
aktuell.de.selfhtml.org/artikel/javascript/utf8b64/base64.htm
Seite 24

Quellen
Domino-Designer-Hilfe (F1)
Foren
www.dominoforum.de
www.atnotes.de
Domino-Super-Search (Martin Scott)
www.martinscott.com/dominosupersearch2.nsf/Search
Seite 25

Vielen Dank für Ihre Aufmerksamkeit.
Jetzt sind Sie an der Reihe.
Seite 26