Katalog- und Bestellformat für Kontaktlinsen

Transkript

1 Formatbeschreibung Katalog- und Bestellformat für Kontaktlinsen V 0.3 erstellt von: am: letzte Änderungen Georg Weiß Engineering - Consulting Schwarzkehlchenweg Freiburg

2 1 Inhaltsverzeichnis 1 Inhaltsverzeichnis CL-Katalog und Bestellformat Anwendungen Anwendungsbeispiele Aufbau des Katalogformates Die Datei Templates Die Datei Catalog.xml - der Produktkatalog Allgemeine Katalog-Informationen Supplier Templates Include Feature Templates Relationship Templates ResourceTemplates Delivery TypeTemplates ArticleGroupTemplates ClientGroupTemplates Articles Client Groups ProductCodingPattern MetaData Relationships Resources Features Delivery ranges Navigation (Definition der Katalogstruktur) Das Bestellformat - die Datei Order.xml Anmerkungen: Anhang HTML -Dokumentation zum Katalog-Schema Spezielle Anwendungsbeispiele... 17

3 2 CL-Katalog und Bestellformat 2.1 Anwendungen Es sollen im Wesentlichen folgende Anwendungen abgedeckt werden: - Kontaktlinsenkatalog als Basis für Online-Shops und für die Versorgung des Augenoptikers und Augenarztes mit aktuellen Katalog- und Preisinformationen des Herstellers für die Übernahme in dessen Verwaltungssoftware - Bestellung von Kontaktlinsen und Zubehör ( XML und TXT mit entsprechenden Konverter) über ein einheitliches Format. - Abgleich von Auftragsstati mit Warenwirtschaftsystemen der Hersteller (Verfügbarkeit, Auftragsbestätigung, Lieferrückmeldung, ) ( XML und TXT sowie unterschiedliche Services wie Mail, FTP, Webservices ) dieser Bereich soll erst in einer zweiten Version berücksichtigt werden 2.2 Anwendungsbeispiele

4 3 Aufbau des Katalogformates Das Format besteht aus vier zentralen standardisierten und somit allgemein gültigen Teilen: Catalog.xsd Templates.xml Templates.xmsd FeatureLanguage.dtd Catalog.xml dem XML-Schema zum Catalog. Hier wird die Struktur des Catalogs zentral definiert. Über diese Datei kann der individuelle Catalog eines Herstellers online verifiziert werden. der Auflistung aller standardisierten Produkteigenschaften dem XML-Schema zur Produkteigenschaften-Liste SpectarisTemplates.xml der Sprachdatei mit den standardisierten deutschen Template- Bezeichnungen dem individuellen Katalog des jeweiligen Herstellers Dies ermöglicht eine hohe Flexibilität und Individualität bei gleichzeitig einheitlichen Strukturen für Kompatibilität und Datenaustausch zwischen verschiedenen Systemen.

5 3.1 Die Datei Templates In dieser Datei werden alle im Standard-Produkteigenschaften definiert. Jede Produkteigenschaft hat eine eindeutige Bezeichnung (templateid). Hier werden für alle Produkteigenschaften die allgemeingültigen Datenelementeigenschaften definiert. Für jedes Datenelement sind folgende Angaben in der Datenelementliste enthalten: TemplateId IncludeInOrder TemplateLabel Step FormatString Unit alwayssigned ist der eindeutige Elementname im.xml-format.die Elementnamen werden Englisch gewählt. Bestellrelevant oder Beschreibende Eigenschaft (Produktinfo) Feature-Bezeichnung in verschiedenen Sprachen Schrittweite der Werte (Rundung) Formatierung des Feldes Einheit der Produkteigenschaft Immer mit Vorzeichen (z.b. sph / cyl für die Anzeige in einer Anwendung) default FeatureEnumTemplate TemplateId IncludeInOrder TemplateLabel Step FormatString Unit NearProfile true Nahprofil Color true Farbe HandlingsTint optional Handlingstint Exchange optional mit Tausch Material false Material UVFilter false UV-Filter HEMAFree false HEMA-frei Characteristics false Eigenschaften LimitationCEN false Einschränkungen nach CEN Limitation false Einschränkungen FeatureValueTemplate TemplateId IncludeIn Order TemplateLabel Step Format String Unit Always Signed lseradiusbasecurve true Radius 0,05 N2 mm false Sphere true F'v 0,25 N2 dpt true Radius1Flat true R1 fl 0,05 N2 mm false Radius2Flat true R2 fl 0,05 N2 mm false Radius3Flat true R3 fl 0,05 N2 mm false Radius4Flat true R4 fl 0,05 N2 mm false RadiusBaseCurve2 true Radius steil 0,05 N2 mm false Radius1Steap true R1 st 0,05 N2 mm false Radius2Steap true R2 st 0,05 N2 mm false Radius3Steap true R3 st 0,05 N2 mm v Radius4Steap true R4 st 0,05 N2 mm false Excentricity true AS-Wert, Exzentrizität 1 N0 Excentricity90 true AS-Wert, Exzentrizität in 90 1 N0 Excentricity180 true AS-Wert, Exzentrizität in N0 Excentricity270 true AS-Wert, Exzentrizität in N0 Cylinder true Cyl 0,25 N2 dpt true DioptreSteap true F'v st 0,25 N2 dpt Axis true Achse 1 N0

6 AxisComplete true Achse gesamt 1 N0 AxisTorus true Achse Torus 1 N0 Addition true Addition 0,25 N2 dpt BackOpticDiameter true D0 0,1 N1 mm BackOpticDiameter1 true D1 0,1 N1 mm BackOpticDiameter2 true D2 0,1 N1 mm BackOpticdiameter3 true D3 0,1 N1 mm BackOpticDiameter4 true D4 0,1 N1 mm FrontOpticDiameter true V.O.Z. 0,1 N1 mm DiameterSteap true Dg st 0,1 N1 mm Diameter0Steap true D0 st 0,1 N1 mm Diameter1Steap true D1 st 0,1 N1 mm Diameter2Steap true D2 st 0,1 N1 mm Diameter3Steap true D3 st 0,1 N1 mm Diameter4Steap true D4 st 0,1 N1 mm RptRadiusFlat true R rpt fl 0,05 N2 mm RptRadiusSteap true R rpt st 0,05 N2 mm DiameterAddZone true NWZ 0,1 N1 mm Diameter true Dg 0,1 N1 mm Prism optional Prisma 0,25 N2 pdpt WaterContent false Wassergehalt 1 N2 % ProductionType false Herstellungsverfahren MinimalThickness false Minimale Dicke 0,01 N2 mm EdgeThickness false Randdicke 0,01 N2 mm EdgeLift false Egdelift 0,01 N2 mm Usage false Anwendung OpeningAngle false Öffnungswinkel 1 N0 NotIonic false nicht ionisch PackageSize false Verpackungsgrösse Permeability false Sauerstoffpermeabilität (DKL-Wert) Transmissibility false Sauerstofftransmissibilität RefractionIndex false Brechungsindex? - - MechaniclStrength false Mechanische Festigkeit TensileStrength false Reißfestigkeit Transmittance false Transmission im sichtbarer Bereich ProductionTechnology false Herstellungstechnik MinEdgeThickness false Minimale Randdicke (tc) 0,01 N2 mm BorderLine optional Stutzkante 0,1 N1 mm BorderLineStype optional Stutzkanten typ LimitationLine optional Trl 0,1 N1 mm CenterThickness optional Mittendicke 0,01 N2 mm JunctionThickness optional Übergangsdicke 0,01 N2 mm BevelRadius optional Bevel-Radius 0,05 N2 mm BevelWidth optional Bevel-Breite 0,01 N2 mm SpecialGrave optional Sondergravur SpecialMark optional Sondermarkierung VentilationPosition optional Position Ventilationsbohrung 0,05 N2 mm VentilationAngle optional Winkel Ventialtionsbohrung 1 N0 JunctionDesign optional Minustragrand - - DecentrationAngle optional Winkel dezentrierte Optikzone 1 N0 DecentrationWidth optional Mass dezentrierte Optikzone 0,05 N2 mm LenticularDesign optional Lentikulare Ausführung OvalOpticZone optional Ovale Optikzone HemisphericalWidth optional HS-Breite 0,05 N2 mm HemisphericalRadius optional HS-Radius 0,05 N2 mm OpticalZone false Optische Zone 0,1 N1 mm

7 <Templates xmlns:xsd=" xmlns:xsi=" xsi:nonamespaceschemalocation=" <FeatureTemplates> <FeatureValueTemplate id=" RadiusBasecurve" inc ludeinorder="true" label=" &t_radiusbasecurve;" labelshort="rad" step="0.05" formatstring=" N2" unit=" mm" descr="description"/> <FeatureValueTemplate id="sphere" includeinorder="true" label="&t_sphere;" labelshort=" F'v " step=" 0.25" formatstring=" N2" unit="dpt" descr="description"/> <FeatureValueTemplate id=" Radius1Flat" includeinorder="true" label="&t_radius1flat;" labelshort=" R1 fl" step="0.05" formatstring=" N2" unit=" mm" descr="description"/>

8 3.2 Die Datei Catalog.xml - der Produktkatalog Der Produktkatalog ist die Basis für alle weiteren Anwendungsarten wie Bestellung oder Statusaustausch Allgemeine Katalog-Informationen Der Katalog beginnt mit der Definition allgemeiner Informationen zum Katalog: Tag Beschreibung Beispiel catalogname Eindeutige Bezeichnung des Kataloges Produktkatalog Hecht validstartdate Gültig von Datum T09:30:47-05:00 validenddate Gültig bis Datum T09:30:47-05:00 currencysymbol Währungssymbol currency Währung EUR catalogid 0.1??? catalogversionno KatalogVersion 0.1 ValidCountries Angabe für welche Länder gültig AT DE Beispiel xml-code: <Catalog xmlns:xi=" xmlns:xsi=" xsi:nonamespaceschemalocation=" catalogname =" Produktkatalog Hecht " validstartdate=" t09:30:47-05:00" validenddate=" T09:30:47-05:00" currencysymbol=" " currency=" EUR" catalogid="0.1???" catalogversionno ="0.1"> <ValidCountries> <ValidCountry isocountrycode=" DE"/> <ValidCountry isocountrycode="au"/> </ValidCountries> Im Anschluß an die allgemeinen Kopfdaten gliedert sich der Katalog in drei weitere Bereiche: Supplier (Herstellerstammdaten) Templates (Definition von Eigenschaften die später zur Artikelbeschreibung verwendet werden) Articles (Beschreibung des einzelnen Artikels)

9 3.2.2 Supplier Innerhalb des Tags Supplier erfolgt die Definition aller Informationen zum Lieferanten/Hersteller. Das Tag Supplier besitzt folgende Attribute: Attribut Beschreibung Beispiel name Lieferantenname Hecht Contactlinsen GmbH vatid UmsatzsteuerID DE taxno Steuernummer registration Registrierung Amtsgericht Freiburg HRB 1660 ceo Geschäftsführung Günter Hecht, Dieter Muckenhirn, Ewald Steiert agb Link auf AGBs Beispiel xml-code: <Supplier name=" Hecht Contactlinsen GmbH" vatid=" DE537293" taxno =" " registration="amtsgericht Freiburg HRB 1660" ceo=" Günter Hecht, Dieter Muckenhirn, Ewald Steiert" agb=" label name street zip city isocountrycode phone Mainaddress Hecht Contactlinsen GmbH Dorfstr Au DE Service Center Hecht Contactlinsen GmbH Dorfstr Au DE Als weitere Informationen können hier unterschiedliche Adressen und Bankverbindungen des Lieferanten definiert werden: <Addresses> <Address label=" Mainaddress" name =" Hecht Contactlinsen GmbH" street=" Dorfstr. 2-4" zip="79280" city="au" isocountrycode=" DE" phone=" " fax=" " =" <Address label=" Service Center" name=" Hecht Contactlinsen GmbH" street=" Dorfstr. 2-4" zip="79280" city="au" isocountrycode=" DE" phone=" " fax=" " </Addresses> <BankAccounts > <BankAccount bankname ="Volksbank Freiburg" eban=" EBAN1" swift="swift1" accountno ="12643" bankcodeblz="680100" street="bertoldstraße 4" zip=" 79116" city="au" isocountrycode=" DE"/> <BankAccount bankname =" Sparkasse Freiburg" eban=" EBAN2" swift="swift2" accountno=" " bankcodeblz=" " street=" Münsterplatz 56" zip=" 79076" city =" Freiburg" isocountrycode=" DE"/> </BankAccounts> </Supplier>

10 3.2.3 Templates Include Am Anfang steht die Zeile Include. Damit erfolgt die Einbindung der zentral definierten Standard- Produkteigenschaften. Über weitere Include-Befehle ist es möglich weitere Dateien einzubinden, in der/denen Produkteigenschaften beschrieben werden die nicht im Standard definiert sind. Die Definition weiterer Eigenschaften und Zusammenhänge erfolgt im Anschluß und gliedert sich in die folgenden Bereiche: Feature Templates Hier besteht die Möglichkeit eigene Produkteigenschaften zu definieren, die nicht im Standard enthalten sind. Dies kann alternativ auch in einer separaten Datei PrivateTemplates erfolgen die ebenfalls durch include eingebunden wird. Standard: >> Siehe Feature-Liste in Kapitel 3.1 FeatureEnumTemplateEx Für einige Features können die Wertebereiche nicht im Standard definiert werden. Entsprechende Zuordnungen können im Bereich FeatureEnumTemplateEx definiert werden. Die wichtigsten Anwendungsfälle wären hier z.b. Material- oder Farbangaben. Beispiel XML-Code: <LabeledValue value="1" label=" Rot"/> <LabeledValue value="2" label=" Grün"/> <LabeledValue value="3" label=" Blau"/> <LabeledValue value="4" label=" Gelb"/>

11 Relationship Templates Hier erfolgt die Definition möglicher Arten von Produkt-Beziehungen (z. B. Ersatzteil, Zubehör, Optionsartikel, Altrernativprodukt,..) Diese können später im Bereich Artikel verwendet werden um Beziehungen zwischen Artikeln zu definieren. Zum Beispiel (Artikel E und F sind Ersatzteile von Artikel A) Standard: id optionalarticle accessories sparepart alternativeproduct label Optionsartikel Zubehör Ersatzteile Alternativ-Produkte Beispiel-XML-Code: ResourceTemplates Hier können verschiedene Arten von Resourcedateien. definiert werden: Standard: id mimetype Max. Größe label imglarge image/jpg 1024X1024 px Große Detailansicht (z.b. Pop-Up-Fenster) imgmedium image/jpg 200/200 px kleine Ansicht (z.b. für Artikelbeschreibung imgsmall image/jpg 80/80 px Miniaturanlicht (z.b. für Produkt-Listen) productinfo html Allg. Produktbeschreibung HandlingInfo html AnpassInformationen TechnInfo html technische Informationen DeliveryInfo html Lieferbereichsinformationen Delivery TypeTemplates Hier erfolgt die globale Definition unterschiedlicher Lieferbereiche. Standard: id label priority Stock ab Lager 10 Standard Anfertigung Basis 20 Production Anfertigung Individuell 30

12 ArticleGroupTemplates Definition einzelner Standard-Produktgruppen Für eine einheitliche Strukturierung der Produkte in den Erfassmasken der unterschiedlichen AO-Software werden folgende Standard-Artikelgruppen definiert. Hierbei können Produkte mehreren Gruppen zusortiert werden. Ein Produkt muss allerdings mindestens einer PG_0, PG_C1, PG_C2 und PG_C3 zugeordnet werden. Produktart: (weich/hart) Produktgeometrie: (sph / tor) Produktanwendung: id PG_CL PG_Pflegemittel PG_Mat_Werbemittel PG_Kosmetika PG_Zubehör PG_Seminare PG_Software PG_Sonstiges PG_Beratungsdienstleistungen PG_C4_Farbig PG_C1_Mat_Formstabil PG_C1_Mat_Weich PG_C2_Geom_Sphärisch PG_C2_Geom_Torisch PG_C2_Geom_Mehrstärken PG_C2_Geom_Asphärisch PG_C3_Austauschsysteme PG_C3_Konventionell PG_C3_Tageslinsen PG_C3_Anpasssätze label CL Pflegemittel Werbemittel Kosmetika Zubehör Seminare Software Sonstiges farbig formstabil weich sphärisch torisch mehrstärken asphärisch Austauschsysteme konventionell Tageslinsen Anpasssätze Meta für Artikelinfos die nicht in Templates abgebildet werden sollen ClientGroupTemplates Definition einzelner Kundengruppen, die unter Article den einzelnen Produkten zugeordnet werden. Dies ermöglicht die Steuerung von Berechtigungen und Ansichten einzelner Produkte für eine Produktgruppe, bzw. die automatische Erzeugung von Einzel-Katalogen für verschiedene Produktgruppen aus einem zentral gepflegten Hauptkatalog.

13 3.2.4 Articles Hier erfolgt die genaue Beschreibung der einzelnen Artikel. Die Artikeldefinition gliedert sich in folgende Bereiche: o ClientGroups (Zuordnung zu Kundengruppen > z.b. für Anzeige von Private Labels) o ProductCodingPattern ( o MetaData ( Definition von Suchbegriffen zu Produkten) o Relationships (Definition von Produktbeziehungen > z.b. Ersatzteile/Zubehör) o Resources (Zuordnung von Resourcedateien zum Produkt) o Features (Definition von eindeutigen Produkteigenschaften) o DeliveryRanges (Definition der Lieferbereiche je Produkt) Client Groups Zuordung einzelner Kundengruppen zum Artikel. Hiermit kann definiert werden, für welche Kundengruppen der Artikel verfügbar ist. Damit kann die Anzeige einzelner Produkte für einzelne Kunden gesteuert werden (z.b. im Lieferanten eigenen Shop oder in einer Branchesoftware) oder als Basis für die Erzeugung spezieller Kataloge für einzelne Kundengruppen verwendet werden (z.b. ind. Kataloge für Einkaufsgemeinschaften) >> Wird zusätzlich auch noch ein Flagg Produktart (Standard/Privatelabel) benötigt?? ProductCodingPattern

14 MetaData Hier können dem Produkt Suchbegriffe zugeordnet werden. Dies ermöglicht die Realisierung von Suchfunktionen in Anwendungen (z.b. Stichwortsuche in elektronischem Produktkatalog oder Shop) Relationships Hier können Beziehungen zwischen einzelnen Artikeln definiert werden Resources Hier erfolgt die Definition der zum Produkt verfügbaren Informationen in externen Dateien (Resources). Hier sind im Standard folgende Resourcentypen definiert: Features Hier erfolgt die Zuweisung einzelner Produkteigenschaften einzelner Produkte. Hier können sowohl Standardeigenschaften (zentral definiert in Templates.xml) aber auch herstellerspezifische Eigenschaften zugeordnet werden (z.b. für die Anwendung in herstellerspezifischen Anwendungen). Auch hier gilt die Unterscheidung in FeatureValue (Zuordnung eines Wertes oder Beschreibung) und FeatureEnum-Items (Auswahlliste mehrerer Werte z.b. Sphere, Cylinder,Farbe, ) Delivery ranges Hier erfolgt die Definition der Lieferbereiche. Das heißt Navigation (Definition der Katalogstruktur) Hier erfolgt die Kataloggliederung.

15 3.3 Das Bestellformat - die Datei Order.xml - Das Bestellformat beinhaltet die für das jeweilige Produkt ausgewählten Bestellrelevanten Produkteigenschaften bzw. Features (= Produktkonfigurationsparameter). Die für die Bestellung eines Produktes notwendigen Features werden in der FeatureTemplates allgemein bzw. dem Produktkatalog je Produkt definiert.

16 4 Anmerkungen: CL-Format: - TemplateLabel muss in Datei Catalog.xml >> Entities (Sprache/individuelle Bezeichnungen) - IncludeInOrder > Global (FeatureTemplates) und lokal (Catalog) >> Anpassung Shop?? - neue Aufteilung der Features in globale (SpectarisCL-Format1.0) und lokale Dateien oder Definition im Kopf >> auf CL-Forum.de >> ok Feature Templates FeatureTemplates / Feature Templates Navigation >> Beispiele // wird derzeit nicht umgesetzt - runden auf >> nur wenn später ind. Konfiguration realisert werden soll Catalog: - Lieferantensstammdaten - Name/ Adresse - Gültigkeitsbereich (Land) >> Diskussion nur ein Land / mehrere Länder - Sprache >> Entities in separaten Dateien - Feature Collection von CIBA derzeit nicht verwendet >> Diskussion in AG - Labels/mehrsprachig/Firmenspezifisch >> Realisierung wie?? - Private Labels als Verweis >> Gruppenzuordnung in Artikel >> ok - Article relations >>ok - Bundles aus mehreren konfigurierbaren Artikeln >> nicht jetzt - Versionswerwaltung d. Kataloges (gültig ab / auch für Produkt) >> validstartdate / validenddate - Produktgruppen analog zu Navigation >> für Sortierung in AO-SW unabh. von Katalog-Navigation - optionale Parameter // Bohrung mit beschr. Eigenschaften >> wenn, dann erst später - Metatags für Artikelsuche >> Metadata - IncludeInOrder auch in Delivery Ranges (Produkteigenschaften, die Lieferbereichsabhängig sind aber nicht explizit bestellt werden müssen?? >> schon möglich - Definition von Farben über Ranges und Referenzierung auf Definition (Datei ColorDefinition?) >> EnumMapping / valuemapping

17 5 Anhang 5.1 HTML-Dokumentation zum Katalog-Schema 5.2 HTML-Dokumentation zum Templates-Schema 5.3 Spezielle Anwendungsbeispiele