Integrationsbeschreibung METIS für Verlage ______________________________________________________________________ Dokumentversion: 2.20 Seite 1 von 39 Bearbeitungsstand: final Integrationsbeschreibung METIS für Verlage Dokumentinformation Verantwortliche: Franz Benjamin Nössler Gespeichert am: 16.11.2021 07:06 Dokumentversion: 2.20 Dateiname: C:\Beschreibung_Verlage_2.20.doc
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
1 Einleitung Dieses Dokument dient als Beschreibung fuumlr Verlage die am METIS Verfahren teilnehmen wollen Es beinhaltet sowohl die generelle Verfahrensbeschreibung wie auch die technische Beschreibung der eingesetzten Schnittstellen Es basiert auf langjaumlhriger Erfahrung dadurch sind bereits Erfahrungswerte sowie Probleme bei vergangenen Integrationen eingeflossen
Um an METIS teilnehmen zu koumlnnen ist eine einmalige Meldesystemregistrierung unter httptomvgwortde noumltig
11 Voraussetzung fuumlr die Verguumltung von Texten
Bei METIS wird die Zweitverwertung von Texten im Internet verguumltet (dh Kopien die von den im Internet zur Verfuumlgung gestellten Texten angefertigt werden) Aus diesem Grund werden Texte ausgeschlossen die einen technischen Kopierschutz enthalten
Da es nicht moumlglich ist den technischen Kopiervorgang festzustellen trifft die VG WORT die Annahme dass es einen Zusammenhang zwischen der Nutzung und der Zweitverwertung von einem Text gibt Dh man geht davon aus dass Texte die haumlufig gelesen werden auch haumlufig kopiert werden Aus diesem Grund muumlssen die Texte im Rahmen eines Zaumlhlverfahrens individuell gezaumlhlt werden Fuumlr die Ausschuumlttung werden Texte herangezogen deren Zugriffszaumlhlung einen festgelegten Mindestzugriff erreichen Der Mindestzugriff wird von der VG WORT fuumlr ein Kalenderjahr im Januar des Folgejahres im Meldesystem festgelegt Fuumlr das Jahr 2014 musste ein Text mit einer Laumlnge unter 10000 Zeichen 1500 Visits Jahr erreichen Bei einer Textlaumlnge von zumindest 10000 Zeichen hat sich der Mindestzugriff auf 750 Visits Jahr reduziert (Anteiliger Mindestzugriff) Zaumlhlungen von Texten hinter Bezahlschranken werden ab dem Jahr 2016 mit Faktor 3 multipliziert Weiterfuumlhrende Informationen finden Sie auf der Homepage der VG WORT
- Verteilungsplan httpwwwvgwortdepublikationen-dokumenteverteilungsplaenehtml (sect 58 und sect 59)
Ein weiteres Kriterium betrifft die Textlaumlnge Die Texte muumlssen eine Mindestlaumlnge von 1800 Zeichen (inkl Leerzeichen) erreichen Die Ausnahme bilden Gedichte ndash diese koumlnnen auch kuumlrzer sein
Zusammenfassung der Kriterien - Text muss im Internet veroumlffentlicht sein - Kein Kopierschutz (hartes DRM) - Mindestlaumlnge 1800 Zeichen (ausgenommen Lyrik) - Der festgelegte Mindestzugriff muss erreicht werden
12 Houmlhe der Tantieme
Die Houmlhe der Tantieme wird von der VG WORT fuumlr ein Kalenderjahr im Nachhinein (Mai Juni) festgelegt Die Tantieme besteht aus einem Verlagsanteil und einem Autorenanteil Die aktuellen Tantiemen und Modalitaumlten finden Sie in der Quotenuumlbersicht auf der Homepage der VG WORT unter httpwwwvgwortdepublikationen-dokumentequoten-uebersichthtml (Abschnitt bdquoMETISldquo)
Zu beachten ist dass die Houmlhe der Tantieme pro Text angegeben ist der die oben genannten Voraussetzungen erfuumlllt Dadurch sollten sich bei Verlagen die pro Jahr einige hundert oder tausend solcher Texte veroumlffentlichen die Investitionskosten rasch amortisieren
Um eine Tantieme zu erhalten sind pro Text nur drei Schritte noumltig
1) Zugriffszaumlhlung
2) Meldung uumlbermitteln
3) Ausschuumlttung erhalten
Die Grundlage fuumlr die Ausschuumlttung bilden die Zugriffszahlen daher ist es wichtig so schnell und so vollstaumlndig wie moumlglich mit der Zugriffszaumlhlung zu beginnen (siehe Kapitel bdquo2 Zugriffszaumlhlungldquo) Fuumlr eine spaumltere Meldung muss die dabei vergebene Zaumlhlmarke intern mit dem Text verknuumlpft werden Jeder Text muss dabei mit einer eigenen Zaumlhlmarke versehen werden
Der zweite Schritt ist die Uumlbermittlung der Meldung (siehe Kapitel bdquo3 Meldungldquo) Dabei wird der Text die Veroumlffentlichungsorte (URLs) sowie alle beteiligten Autoren und Uumlbersetzer an die VG WORT gemeldet
Nach Erstellung der Meldung pruumlft die VG WORT bei jedem Text ob er den Kriterien fuumlr die Ausschuumlttung entspricht Ist das der Fall erfolgt automatisch die Ausschuumlttung
14 Technische Grundlagen
Jeder beschriebene Schritt laumlsst sich manuell uumlber Meldemasken oder automatisiert uumlber Web Service Schnittstellen bedienen Die manuelle Variante ist fuumlr kleinere Verlage empfohlen (bis ca 100 Texte Jahr) Ansonsten empfiehlt sich eine vollautomatische Integration uumlber die Schnittstellen
2 Zugriffszaumlhlung Fuumlr die Zugriffszaumlhlung wird das bdquoskalierbare zentrale Messsystemldquo dass auch fuumlr die Werbewirtschaft (IVW) eingesetzt wird verwendet Dabei werden in HTML Seiten unsichtbare Bilder (Zaumlhlmarken) eingebaut die zu Zugriffszaumlhlungen fuumlhren
Die Zugriffszaumlhlung bildet die Basis fuumlr eine moumlgliche Ausschuumlttung Aus diesem Grund muss darauf geachtet werden moumlglichst alle Texte die fuumlr die Ausschuumlttung in Frage kommen zu zaumlhlen
Viele Artikel haben am Erscheinungstag die meisten Zugriffe Achten Sie unbedingt darauf dass Sie die Artikel sofort beim Erscheinen mit einer Zaumlhlmarke versehen da ansonsten moumlglicherweise der festgelegte Mindestzugriff nicht mehr erreicht werden kann
Bei den bisher teilnehmenden Verlagen hat es sich bewaumlhrt als Erstes mit der Zaumlhlung von neu erscheinenden Artikeln zu beginnen Erst sobald das reibungslos automatisiert funktioniert sollte man sich die Frage stellen ob man aumlltere Artikel (zB Archiv hellip) nachtraumlglich mit Zaumlhlmarken ausstatten moumlchte Eine Empfehlung dafuumlr oder dagegen kann man generell nicht aussprechen da es davon abhaumlngt wie stark solche Archivinhalte genutzt werden Das sollte im Verlag anhand von Kosten Nutzen entschieden werden
21 Grundsaumltzliches zu Zaumlhlmarken
211 Zaumlhlmarken der VG WORT
Jede Zaumlhlmarke besteht aus zwei Teilen (oumlffentlicher Identifikationscode privater Identifikationscode) Der oumlf fentliche Identifikationscode dient zum Einbau in die jeweilige HTML ndash Seite (siehe Kapitel 23 Einbau einer Zaumlhlmarke) Der private Identifikationscode wird spaumlter im Rahmen der Meldung benoumltigt
Aus diesem Grund muss der private Identifikationscode in Ihrem CMS System mit dem Artikel verknuumlpft werden
212 Verlagsinterner Schluumlssel als Zaumlhlmarke
In Verlagen werden die Artikel oftmals mit eindeutigen internen Schluumlsseln versehen Diese internen Schluumlssel koumlnnen ebenfalls als Zaumlhlmarke verwendet werden In diesem Fall wird sowohl fuumlr den oumlf fentlichen als auch fuumlr den privaten Identifikationscode der verlagsinterne Schluumlssel verwendet
Dabei gibt es folgendes zu beachten
- Ein verlagsinterner Schluumlssel setzt sich aus dem Praumlfix bdquovgzmltKarteinummergt-ldquo und einen beliebigen Schluumlssel zusammen Der Platzhalter bdquoltKarteinummergtldquo muss mit der VGWORT Karteinummer des Verlags ersetzt werden
- Der Schluumlssel darf keine Sonderzeichen enthalten (dh nur [a-z][A-Z][0-9] sowie den Punkt den Bindestrich und den Unterstrich)
- Der Schluumlssel muss innerhalb vom Verlag eindeutig sein
- DOI (httpwwwdoiorg) koumlnnen ebenfalls als verlagsinterne Schluumlssel zum Einsatz kommen Der Slash nach der Verlagskennung muss durch einen Bindestrich (-) ersetzt werden Es duumlrfen im DOI auch keine weiteren Slashes vorkommen
Beispiel vgzm970-123456789
Bitte setzen Sie sich vor Verwendung von verlagsinternen Schluumlsseln als Zaumlhlmarke unbedingt mit der VG WORT in Verbindung (per Email an metissupportvgwortde) Sie erhalten dann eine Zaumlhldomaumlne die Sie fuumlr den Einbau der Zaumlhlmarken benoumltigen und Sie werden fuumlr die Zugriffszaumlhlung mit verlagsinternen Schluumlsseln freigeschalten Ohne diese Schritte ist keine Zaumlhlung mit verlagsinternen Schluumlsseln moumlglich
Es empfiehlt sich zuerst die Zugriffszaumlhlung umzusetzen und erst dann die Meldung (siehe Kapitel 3) zu implementieren
Zum Zeitpunkt der Zugriffszaumlhlung muumlssen noch nicht alle Informationen zum Text (zB Autoreninformation) vorliegen Daher soll die Umsetzung der Zugriffszaumlhlung auf keinen Fall von solchen Faktoren abhaumlngen
214 Datenschutzerklaumlrung
Im Rahmen der Zugriffszaumlhlung werden Cookies und gegebenenfalls JavaScript - Aufrufe verwendet Es empfiehlt sich daher die Datenschutzerklaumlrung der Verlagsseite in der Zaumlhlmarken eingebaut werden um unten stehende Textbausteine zu ergaumlnzen
Cookies und Meldungen zu Zugriffszahlen
Wir setzen Session-Cookies der VG Wort Muumlnchen zur Messung von Zugriffen auf Texten ein um die Kopierwahrscheinlichkeit zu erfassen Session-Cookies sind kleine Informationseinheiten die ein Anbieter im Arbeitsspeicher des Computers des Besuchers speichert In einem Session-Cook ie wird eine zufaumlllig erzeugte eindeutige Identif ikationsnummer abgelegt eine sogenannte Session-ID Auszligerdem enthaumllt ein Cookie die Angabe uumlber seine Herkunft und die Speicherfrist Session-Cookies koumlnnen keine anderen Daten speichern Diese Messungen werden von der Kantar Germany GmbH nach dem Skalierbaren Zentralen Messverfahren (SZM) durchgefuumlhrt Sie helfen dabei die Kopierwahrscheinlichkeit einzelner Texte zur Verguumltung von gesetzlichen Anspruumlchen von Autoren und Verlagen zu ermitteln Wir erfassen keine personenbezogenen Daten uumlber Cookies
Viele unserer Seiten sind mit JavaScript-Aufrufen versehen uumlber die wir die Zugrif fe an die Verwertungsgesellschaft Wort (VG Wort) melden [BITTE UumlBERPRUumlFEN ob dies bei Ihrem Verlag der Fall ist] Wir ermoumlglichen damit dass unsere Autoren an den Ausschuumlttungen der VG Wort partizipieren die die gesetzliche Verguumltung fuumlr die Nutzungen urheberrechtlich geschuumltzter Werke gem sect 53 UrhG sicherstellen
Eine Nutzung unserer Angebote ist auch ohne Cookies moumlglich Die meisten Browser sind so eingestellt dass sie Cookies automatisch akzeptieren Sie koumlnnen das Speichern von Cookies jedoch deaktivieren oder Ihren Browser so einstellen dass er Sie benachrichtigt sobald Cookies gesendet werden
Datenschutzerklaumlrung zur Nutzung des Skalierbaren Zentralen Messverfahrens
Webangebote
Unsere Website und unser mobiles Webangebot nutzen das bdquoSkalierbare Zent rale Messverfahrenldquo (SZM) der Kantar Germany GmbH fuumlr die Ermittlung statistischer Kennwerte zur Ermittlung der Kopierwahrscheinlichkeit von Texten
Dabei werden anonyme Messwerte erhoben Die Zugrif fszahlenmessung verwendet zur Wiedererkennung von Computersystemen alternativ ein Session-Cookie oder eine Signatur die aus verschiedenen automatisch uumlbertragenen Informationen Ihres Browsers ers tel l t wird IP-Adressen werden nur in anonymisierter Form verarbeitet
Das Verfahren wurde unter der Beachtung des Datenschutzes entwickelt Einziges Ziel des Verfahrens ist es die Kopierwahrscheinlichkeit einzelner Texte zu ermitteln
Zu keinem Zeitpunkt werden einzelne Nutzer identifiziert Ihre Identitaumlt bleibt immer geschuumltzt Sie erhalten uumlber das System keine Werbung
22 Bestellen von Zaumlhlmarken
Verlage haben den Bedarf groszlige Mengen von Zaumlhlmarken auf einmal abzurufen um diese dann in den internen CMS Systemen vorraumltig zu halten Hierfuumlr gibt es zwei Varianten Eine Variante ist es die Zaumlhlmarken direkt aus dem Portal abzurufen bei der anderen Variante erfolgt der Abruf uumlber ein Web Service und kann so automatisiert werden
Grundsaumltzlich koumlnnen pro Jahr 4000 Zaumlhlmarken abgerufen werden Sollte ein Verlag mehr Zaumlhlmarken benoumltigen wird er gebeten sich per Email an metissupportvgwortde zu wenden damit die noumltigen Kapazitaumlten zur Verfuumlgung gestellt werden koumlnnen
Es empfiehlt sich immer einen Zaumlhlmarkenvorrat fuumlr zumindest eine Woche vorraumlt ig zu halten um nicht von der Verfuumlgbarkeit der METIS Anwendung abhaumlngig zu sein
Beim Einsatz von verlagsinternen Schluumlsseln als Zaumlhlmarken entfaumlllt die Bestellung der VG WORT Zaumlhlmarken
221 Bestellung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2211 orderPixelRequest
Feld Typ Beschreibung
count int Anzahl der zu bestellenden Zaumlhlmarken (gt1)
2212 orderPixelResponse
Feld Typ Beschreibung
orderDateTime string Bestelldatum + Zeit im Format bdquoYYYYMMddHHmmldquo
domain string Die Zaumlhlmarken Domaumlne Diese Domaumlne muss beim
Einbau dieser Zaumlhlmarken verwendet werden
pixels pixels Komplexer Datentyp
pixelspublicIdentificationId pixelIDType Oumlffentlicher Identifikationscode der Zaumlhlmarke
pixelsprivateIdentificationId pixelIDType Privater Identifikationscode der Zaumlhlmarke
2213 orderPixelFault
Feld Typ Beschreibung
errorcode int Der Fehlercode
errormsg string Grund fuumlr den Bestellabbruch
maxOrder Int Die maximale Anzahl die fuumlr die jeweilige Bestellung moumlglich gewesen
waumlre (wird nur bei Fehlercode bdquo1ldquo oder Fehlercode bdquo2ldquo angegeben)
22131 Fehlercodes
Fehlerfall Fehlercode maxOrder Meldung
MaxAnzahlBestellung 1 Die maximale Anzahl () an Zaumlhlmarken fuumlr diese
Bestellung wurde um uumlberschritten
MaxAnzahlJahr 2 Die maximale Anzahl () an Zaumlhlmarken fuumlr das
Jahr wurde um uumlberschritten
KeineEMailVorhanden 3 0 Es existiert keine Email-Adresse in Ihrem
Benutzerkonto bitte tragen Sie diese im Meldeportal
Nach Eingabe der benoumltigten Zaumlhlmarken und Klicken auf die Schaltflaumlche bdquoZaumlhlmarken bestellenldquo werden die Zaumlhlmarken vom System generiert Danach wird die Seite zum Download der eben bestellten Zaumlhlmarken angezeigt Falls mehr Zaumlhlmarken bestellt wurden als noch zur Verfuumlgung stehen kommt eine entsprechende Fehlermeldung In diesem Fall wenden Sie sich bitte per Email an metissupportvgwortde
Abbildung 2 Maskenbeschreibung Download der generierten Zaumlhlmarken
In der oben stehenden Maske befindet sich neben der Zaumlhldomaumlne auch Einbaubeispiele fuumlr HTML Texte Beim Klicken auf bdquoDownload der reinen Codepaare als CSV-Dateildquo koumlnnen die bestellten Zaumlhlmarken heruntergeladen werden Das Format der CSV Datei ist im folgenden Abschnitt beschrieben Beim Klicken auf bdquoDownload der vorkonfigurierten Zaumlhlmarken als CSV-Dateildquo wird eine Datei ausgegeben die alle Zaumlhlmarken als fertigen HTML Code enthaumllt
2221 CSV-Datei Format
Die CSV-Datei wird im folgenden Format erstellt (Die Spalten werden durch ein Semikolon getrennt)
Die Zaumlhlmarke ist ein transparentes (unsichtbares) Bild mit der Groumlszlige von 1 x 1 Pixel Es hat keinesfalls Einfluss auf die Ladezeit der Seite da Bilder von den Browsern separat zum Text geladen werden Das unsichtbare Bild hat auch keinen Einfluss auf das Erscheinungsbild der Seite
Einbaubeispiel VG WORT Zaumlhlmarke in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquoc5b7568d28884052a9ff92d5afd08f34rdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquovgzm970-123456789rdquo
Der korrekt formatierte verlagsinterne Schluumlssel des zu zaumlhlenden Textes
232 Fuumlr Dokumente (PDF oder EPUB Dateien)
Eine Zaumlhlmarke kann nicht direkt in eine dieser Dateien eingebaut werden Sie muss daher in die HTML Seite eingebaut werden von der aus das Dokument verlinkt wird Verlinkungen von anderen Seiten koumlnnen nicht beruumlcksichtigt werden Da eine Weiterleitung vom Zaumlhlserver auf externe Dateien aus sicherheitstechnischen Gruumlnden nicht angeboten werden kann benoumltigt man JavaScript um die Zugriffe auf eine PDF Datei zaumlhlen zu koumlnnen
In diesem Fall wird das Zaumlhlpixel (unsichtbare Bild) uumlber JavaScript in die HTML Seite eingefuumlgt sobald das Dokument (der Link auf das Dokument bleibt unveraumlndert) abgerufen wird
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquo98380ae3fc0a4daf84d6197274add99erdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquohttpwwwstepscondebeispielepubrdquo
Der Link auf das zu zaumlhlende Dokument
- LINK-Name
Name des Links
Auch dabei ist der Einsatz von verlagsinternen Schluumlsseln moumlglich In diesem Fall wird der korrekt formatierte verlagsinterne Schluumlssel anstelle vom oumlffentlichen Identifikationscode verwendet Auf ein separates Einbaubeispiel wird in diesem Dokument verzichtet
233 Base64url enkodierte Zaumlhlmarken
Die verwendbaren Zeichen in einer Zaumlhlmarke sind stark beschraumlnkt (siehe oben) Sollten verlagsinterne Schluumlssel mit nicht erlaubten Zeichen zum Einsatz kommen kann die Zaumlhlmarke Base64url (Codepage UTF-8) enkodiert werden In diesem Fall wird die encodierte Zaumlhlmarke mit Praumlf ix bdquobase64-ldquo eingebaut
Zum Thema Base64url Die Zeichen + und werden nach der Base64-Enkodierung durch - (Minus ASCII 2Dhex) und _ (Unterstrich ASCII 5Fhex) ersetzt
Einbaubeispiel verlagsinterner Schluumlssel in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Zugriffe von Texten hinter Bezahlschranken werden mit Faktor 3 multipliziert Die Aufwertung der Zaumlhlwerte hinter Bezahlschranken erfolgt mittels einer gesonderten Zaumlhlung Hierfuumlr muss der Verlag die Zaumlhlmarke beim Einbau mit einem Praumlfix versehen Dieses Praumlfix darf nur fuumlr Texte hinter Bezahlschranken verwendet werden Ist der Text frei zugaumlnglich wird die Zaumlhlmarke wie bisher (ohne Praumlf ix) eingebaut Aufgrund des Praumlfixes kann unterschieden werden ob ein Text hinter einer Bezahlschranke ist oder nicht
Um Texte hinter Bezahlschranken melden zu koumlnnen muumlssen Sie fuumlr die VG WORT zuerst einen kostenfreien Zugang auf diese Texte einrichten Dies ist uumlber die Angabe von Zugangsdaten oder uumlber die Freischaltung von IP Adressen moumlglich (im TOM Menuuml unter Zugriff auf zugangsbeschraumlnkte Inhalte erlauben)
Das Praumlf ix lautet bdquopw-ldquo bdquopwldquo steht fuumlr den englischen Begriff bdquoPaywallldquo (Bezahlschranke)
In der Vergangenheit musste bei Zaumlhlungen von https- Seiten eine separate Zaumlhldomaumlne verwendet werden Wenn Sie die Zaumlhlungen uumlber diese separate Domaumlne eingebaut haben muumlssen Sie den Einbau nicht aumlndern Diese Variante wird weiterhin unterstuumltzt
236 Potenzielle Fehlerquelle Referrer-Tag
Bestimmte Einstellungen im Quellcode koumlnnen dazu fuumlhren dass Zaumlhlungen nicht mehr zugeordnet werden koumlnnen wenn die Meldungen eingehen Es sieht dann so aus als waumlren d ie Zaumlhlungen zu einem Text falsch (zB nur uumlber eine Startseite ohne den eigentlichen Text) erfolgt Das kann dazu fuumlhren dass diese Zaumlhlungen gestrichen werden und der Mindestzugriff nicht mehr gegeben is t Um solche Probleme zu vermeiden muumlssen Sie darauf achten wie das Referrer-Metatag im Quellcode Ihrer Seite eingestellt ist
Die Zeile ltmeta name=referrer content=origingt sorgt zB dafuumlr dass eine Seite die httpswwwbeispieldemein_texthtml heiszligt nur httpswwwbeispielde sendet Damit lassen s ich dann die Zugriffe nicht mehr der richtigen Seite zuordnen
Bei weiteren Einstellungen wird das Senden der Daten vollstaumlndig unterdruumlckt Auch dies kann dazu fuumlhren dass Zaumlhlungen nicht anerkannt werden wenn weitere Faktoren darauf hindeuten dass die Zaumlhlungen nicht korrekt sein koumlnnten
Nur bei den Einstellungen ltmeta name=referrer content=no-referrer-when-downgradeldquogt oder ltmeta name=referrer content=unsafe-urlgt kann man auf gezaumlhlten Seiten 100 sicher sein dass keine Meldungen wegen nicht nachvollziehbarer Zugriffszaumlhlungen abgewiesen werden
Diese Funktion ist in bestimmten Faumlllen hoch problematisch und in anderen Faumlllen sogar zwingend erforderlich
Die Verwendung von bdquoLazy Loadldquo ist immer zu vermeiden wenn sich auf einer URL nur ein Text oder nur ein Teil eines mehrseitigen Textes befindet Hier fuumlhrt die Funktion dazu dass die Zaumlhlmarken erst geladen werden wenn die Stelle mit der Zaumlhlmarke im Browser angezeigt wird Insbesondere wenn die Zaumlhlmarke am Ende der Seite oder des Textes eingebaut wird sorgt die Funkt ion dafuumlr dass unser Zaumlhlbild nur geladen wird wenn der Leser auch an der Stelle ankommt also zB bis ganz ans Ende der Seite oder des Textes scrollt Erreicht er die Stelle nicht weil die Zaumlhlmarke zB erst unterhalb der Seite und nach Werbeeinblendungen oder Kommentaren eingebaut ist dann wird das Bild auch nicht vom Zaumlhlserver abgerufen und es erfolgt somit auch KEINE Zaumlhlung
Anders sieht es hingegen aus wenn sich viele Texte auf einer Seite befinden oder weitere Texte automatisch eingeblendet werden sobald ein Leser das Textende des ersten Textes erreicht hat Da nicht automatisch davon ausgegangen werden kann dass Texte die vom jeweil igen Nutzer nicht gesucht wurden eine Kopierwahrscheinlichkeit haben darf in diesen Faumlllen die Zaumlhlung nur erfolgen wenn der Text tatsaumlchlich ausgewaumlhlt wird Dies kann mit Hilfe von Lazy load erreicht werden Dazu baut man die jeweilige Zaumlhlmarke am besten immer ab der Mitte eines Textes ein so dass einerseits sichergestellt ist dass gezaumlhlt wird und andererseits dass nur eine Zaumlhlung erfolgt wenn wirklich ein bestimmter Text angesehen wurde und damit die notwendige Kopierwahrscheinlichkeit gegeben ist
24 Uumlberpruumlfen der Zaumlhlungen
241 Anzeige Herunterladen in der Anwendung
In der Anwendung gibt es eine Funktionalitaumlt mit der man pruumlfen kann welche Zaumlhlmarken bereits gezaumlhlt werden bzw welche Zaumlhlmarken die Mindestzugriffe uumlberschritten haben Dadurch kann man feststellen ob der Einbau dieser Zaumlhlmarken korrekt ist Diese Funktionalitaumlt kann uumlber den Menuumlpunkt bdquoZaumlhlmarkenuumlbersichtldquo abgerufen werden Siehe Abbildung unten
Abbildung 3 Maskenbeschreibung Zaumlhlerstarts
Dabei gibt es folgende Filtermoumlglichkeiten
- bdquoIdentif ikationscodeldquo Der oumlffentliche bzw private Identifikationscode oder der verlagsinterne Schluumlssel der Zaumlhlmarke
- bdquoBestelldatum (von bis)ldquo Bestelldatum der Zaumlhlmarke
- bdquoMeldung erfolgtldquo Es werden nur Zaumlhlmarken angezeigt fuumlr die bereits eine Meldung vorliegt
- bdquoZaumlhlerstart erfolgtldquo Alle Zaumlhlmarken die gezaumlhlt werden
- bdquoMindestzugriffldquo Alle Zaumlhlmarken die den Mindestzugriff oder den anteiligen Mindestzugriff uumlberschritten haben
- bdquoin Ausgeblendete Zaumlhlmarken suchenldquo Es werden auch Zaumlhlmarken gesucht die uumlber die angebotene Funktionalitaumlt ausgeblendet wurden Zaumlhlmarken sollten ausgeblendet werden wenn diese in Texten eingebaut wurden die den Kriterien der VG WORT nicht entsprechen (zB zu kurze Texte) Ansonsten scheinen diese Zaumlhlmarken weiterhin staumlndig in der Suchergebnisliste auf
Die Filtermoumlglichkeiten fuumlr den Mindestzugriff greifen sobald die ersten Zaumlhldaten fuumlr ein Kalenderjahr vorliegen Allerdings ist die Anzeige fuumlr das laufende Jahr unter Vorbehalt und erfolgt auf der Basis
des letzten bekannten Mindestzugriffes Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald der Mindestzugriff zu einem Jahr im Meldesystem eingegeben wurde (immer im Januar des Folgejahres)
Die Zaumlhlmarken koumlnnen zusaumltzlich als Liste im CSV Format heruntergeladen werden
Der Zaumlhlerstart wird mit einer Verzoumlgerung von ca 4 Tagen angezeigt Dh wenn eine Zaumlhlmarke heute eingebaut wird scheint diese in der Statistik erst in ca 4 Tagen auf
Es empfiehlt sich testweise einige wenige Zaumlhlmarken einzubauen und zu pruumlfen ob die Zaumlhlungen korrekt gestartet werden bevor man den Einbau der Zaumlhlmarken auf das gesamte Internetangebot ausrollt
242 Abruf uumlber Web Service Schnittstelle
Im Gegensatz zur Maske (siehe oben) kann man uumlber das Web Service nur die Zaumlhlmarken bdquomit Mindestzugriff ohne Meldungldquo sowie bdquomit anteiligem Mindestzugriff ohne Meldungldquo herunterladen
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2421 pixelOverviewRequest
Feld Typ Beschreibung
offset Int Wiederaufsetzpunkt Das System returniert maximal 100 Zaumlhlmarken am Stuumlck
Falls es mehr Zaumlhlmarken gibt die die Kriterien erfuumlllen koumlnnen weitere
Zaumlhlmarken uumlber den offset ausgelesen werden
Beispiel (190 Zaumlhlmarken vorhanden)
1 Abfrage (offset = 0) Die Zaumlhlmarken 1 ndash 100 werden zuruumlckgegeben
2 Abfrage (offset = 100) Die Zaumlhlmarken 101 ndash 190 werden zuruumlckgegeben
type Auswahl Entweder bdquoMINDESTZUGRIFFldquo oder bdquoANTEILIGER_MINDESTZUGRIFFldquo
2422 pixelOverviewResponse
Feld Typ Beschreibung
Amount Int Anzahl der gefundenen Zaumlhlmarken
Offset Int Der beim Request angegebene offset
privateIdentificationId pixelIDType (Liste) Privater Identifikationscode oder verlagsinterner Schluumlssel
3 Meldung Nachdem eine Zaumlhlmarke bestellt und eingebaut wurde kann eine Meldung zum jeweiligen Text erfolgen Eine Meldung soll dann gemacht werden wenn sich der Text des gemeldeten Artikels nicht mehr wesentlich aumlndert da die VG WORT in den Pruumlfmechanismen den gemeldeten Text mit dem Text der sich tatsaumlchlich im Internet befindet vergleicht
Der spaumlteste Zeitpunkt zum Melden eines Textes ist der sogenannte Meldeschlusstermin Diesen f inden Sie auf der Homepage der VG WORT unter bdquoTermineldquo Derzeit ist der Meldeschluss fuumlr Verlage der 1 Juni des auf die Zaumlhlung folgenden Jahres
In den meisten Faumlllen empfiehlt sich eine bdquoWartefristldquo von 14 Tagen bevor die Meldung erstellt wird So lange der Text noch Aumlnderungen unterzogen wird besteht die Gefahr dass die von der VG WORT durchgefuumlhrten Pruumlfmechanismen fehlschlagen
Bitte setzen Sie sich vor Meldungen zu Texten die uumlber verlagsinterne Schluumlssel gezaumlhlt werden unbedingt mit der VG WORT (per Email an metissupportvgwortde) in Verbindung
31 Anforderungen an die Meldung
Anbei f inden Sie alle Daten die bei einer Meldung angegeben werden muumlssen - Eindeutiger Identifikationscode - Alle beteiligten Autoren Uumlbersetzer und Agenturen - Kurzbeschreibung Uumlberschrift (Titel) - Text - Erscheinungsorte (Webbereiche)
311 Eindeutiger Identifikationscode
Der Identif ikationscode zur Zaumlhlmarke die in den Text eingebaut wurde Je nachdem welche Zaumlhlmarke verwendet wird ist dies der private Identifikationscode (bei VG WORT Zaumlhlmarken) oder der verlagsinterne Schluumlssel
312 Alle beteiligten Autoren Uumlbersetzer und Agenturen
Alle die am Text beteiligt sind Es gibt drei Arten wie die Autoren undoder Uumlbersetzer gemeldet werden
Vorname + Nachname + Karteinummer Die bevorzugte Variante Dabei werden von einem Autor oder einem Uumlbersetzer der Vorname der Nachname und die VG WORT Karteinummer gemeldet Eine Meldung mit Schreibweisen oder Pseudonymen ist auch moumlglich wenn diese der VG WORT bekannt sind Der Vorteil an dieser Variante ist dass ein Autor somit bei der VG WORT eindeutig identifizierbar ist und der Verlag somit keine weiteren Schritte unternehmen muss damit der jeweilige Autor zu seiner Ausschuumlttung kommt
Diese Variante beinhaltet fuumlr den Verlag zwar einen Initialaufwand da die Karteinummern aller Autoren eingesammelt werden muumlssen in der Praxis hat sich diese Variante bei den meisten teilnehmenden Verlagen aber als die einfachste Variante erwiesen
Vorname + Nachname Wenn von einem Autor die VG WORT Karteinummer nicht bekannt ist kann der Autor auch uumlber den Vornamen und den Nachnamen gemeldet werden Den Autoren steht fuumlr das Auffinden der ausschuumlttungsrelevanten Meldungen eine Suchmaske zur Verfuumlgung Allerdings muss in diesem Fall der gemeldete Name exakt mit dem uumlbereinstimmen der im Datenbestand der VG WORT vorliegt
Ist der Vorname nicht vollstaumlndig bekannt kann er in der Variante erster Buchstabe des Vornamens + Punkt angegeben werden
Urheber ohne Wahrnehmungsvertrag Hat der Urheber des zu meldenden Werkes dem meldenden Verlag fuumlr dieses Werk die von der VG WORT wahrgenommenen gesetzlichen Verguumltungsanspruumlche nach dem Urheberrechtsgesetz abgetreten kann dieser Urheber mit Namen Geburtsdatum und Adresse angegeben werden Zusaumltzlich muss bestaumltigt werden dass der Urheber die Rechte uumlbertragen hat Die uumlbertragenen Rechte werden bei der Ausschuumlttung beruumlcksichtigt
Fuumlr Agenturmeldungen bei denen die Autoren nicht bekannt sind steht eine weitere Variante zur Verfuumlgung
Die Rechte koumlnnen dem Verlag erst nach der Veroumlffentlichung des Textes uumlbertragen werden Die schriftliche Rechteuumlbertragung des jeweiligen Autors muss der VG WORT jederzeit auf Anfrage zur Verfuumlgung gestellt werden
Kuumlrzel Wenn man eine Agentur melden moumlchte dann kann das aktuell uumlber diesen Weg erfolgen Als Kuumlrzel wird die Kurzbezeichnung der jeweiligen Agentur uumlbergeben (zB bdquodpaldquo)
Namentliche bekannte Urheber koumlnnen uumlber die Angabe bdquoKuumlrzelldquo nicht gemeldet werden Diese Angabe kann ausschlieszliglich fuumlr die Meldung von Agenturtexten bzw der Miturheberschaft eines nicht namentlich bekannten Agenturautoren verwendet werden
313 Kurzbeschreibung Uumlberschrift (Titel)
Der Titel des zu meldenden Artikels
314 Text
Der Text des zu meldenden Artikels (entweder als Klartext als PDF oder im EPUB Format) Benoumltigt wird der bdquoNettotextldquo (dh der Text ohne HTML Code und ohne Menuuml oder dergleichen)
315 Erscheinungsorte (Webbereiche)
Es muumlssen alle Erscheinungsorte des Texts auf denen die Zaumlhlmarke eingebaut wurde gemeldet werden Ein Erscheinungsort definiert sich aus allen URLs die benoumltigt werden um den gesamten Text einmal zu lesen
Beispiel 1 Ein Text der sich uumlber 2 URLs erstreckt muss mit einem Webbereich (mit 2 URLs) gemel-det werden (zB httpdomain1depage1html httpdomain1depage2html)
Beispiel 2 Ein Text der sich uumlber 1 URL erstreckt aber auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils einer URL) gemeldet werden (zB httpdomain1demytexthtml und httpdomain2demytexthtml)
Beispiel 3 Ein Text der sich uumlber 2 URLs erstreckt und auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils zwei URLs) gemeldet werden (zB httpdomain1depage1html httpdomain1depage2html und httpdomain2depage1html httpdomain2depage2html)
32 Meldung uumlbermitteln
321 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
bull Es sollen nur Texte gemeldet werden die bereits bdquostabilldquo sind (dh die sich nicht mehr haumlufig aumlndern) Aus diesem Grund wird empfohlen die Texte mit einer Zeitverzoumlgerung von einigen Tagen (zB 14 Tagen) zu melden Auf die Tantieme hat das keinen Einfluss da die Ausschuumlttung erst Ende September Anfang Oktober fuumlr das Vorjahr erfolgt
bull Die Meldungen sollen taumlglich in der Nacht uumlbertragen werden Zeitfenster 2200 ndash 0300 Von 0300 bis 0600 gibt es ein allgemeines Wartungsfenster wo nicht gemeldet werden kann
bull Um eine Uumlberlastung der Server (und somit houmlhere Wartezeit) zu verhindern sollen die Meldungen sequentiell (nicht parallel) uumlbertragen werden Idealerweise soll zwischen zwei Meldungen eine Sekunde verstreichen Aus transaktionaler Sicht wird jede Meldung einzeln behandelt Dh jede erfolgreich eingehende Meldung wird gespeichert ndash unabhaumlngig davon ob die vorherige oder nachfolgende Meldung einen Fehler verursacht hat
bull Alle fachlichen Fehlercodes (ein- oder zweistellig) deuten auf einen Fehler in der Meldung hin Es ist zwecklos diese Meldung unveraumlndert noch einmal abzusenden Dreistellige Fehler (sowie der HTML ndash 500 Fehler) deuten auf technische Probleme hin Hier ist es zweckmaumlszligig dieselben Meldungen zu einem spaumlteren Zeitpunkt (zB mit den Meldungen vom naumlchsten Tag) noch einmal zu uumlbertragen
bull Die Bestaumltigung der Meldung bedeutet dass die Meldung aus technischer Sicht in Ordnung ist (dh Mindestumfang von 1800 Zeichen die Zaumlhlmarke existiert hellip) In einer spaumlteren Phase werden die Meldungen noch durch automatische Pruumlfmechanismen der VG WORT in Stichproben gepruumlft Sollten dabei Maumlngel auftreten werden die betreffenden Meldungen zuruumlckgewiesen und der Inhaber des Meldekontos bei der VG WORT wird per Email verstaumlndigt Diese Meldungen koumlnnen dann im Portal entweder geloumlscht oder manuell nachbearbeitet und erneut versendet werden
3212 newMessageRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der private
Identifikationscode (bei VG WORT Zaumlhlmarken) oder der
verlagsinterne Schluumlssel
Parties Parties Die Urheber Uumlbersetzer Agenturen der Meldung Es muss mindestens ein Autor oder ein Uumlbersetzer angegeben werden
Es koumlnnen in einer Meldung sowohl Autoren als auch
Uumlbersetzer angegeben werden
partiesauthors Authors 0 bis mehrere Autoren Beschreibung siehe separate Tabelle
partiestranslators Translators 0 bis mehrere Uumlbersetzer Beschreibung siehe separate
Tabelle
messagetext MessageText Der gemeldete Text entweder als PDF EPUB oder als Klartext
messagetextshorttext string Kurzbezeichnung Uumlberschrift vom Text
messagetexttext Text Der Text an sich Beschreibung siehe separate Tabelle
messagetextlyric boolean bdquoTrueldquo wenn es sich beim Text um Lyrik handelt ansonsten
bdquoFalseldquo
webranges Webranges Erscheinungsort(e) unter demdenen der Text gefunden werden
kann
webrangeswebrange Webrange Ein Erscheinungsort Beschreibung siehe separate Tabelle
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
1 Einleitung Dieses Dokument dient als Beschreibung fuumlr Verlage die am METIS Verfahren teilnehmen wollen Es beinhaltet sowohl die generelle Verfahrensbeschreibung wie auch die technische Beschreibung der eingesetzten Schnittstellen Es basiert auf langjaumlhriger Erfahrung dadurch sind bereits Erfahrungswerte sowie Probleme bei vergangenen Integrationen eingeflossen
Um an METIS teilnehmen zu koumlnnen ist eine einmalige Meldesystemregistrierung unter httptomvgwortde noumltig
11 Voraussetzung fuumlr die Verguumltung von Texten
Bei METIS wird die Zweitverwertung von Texten im Internet verguumltet (dh Kopien die von den im Internet zur Verfuumlgung gestellten Texten angefertigt werden) Aus diesem Grund werden Texte ausgeschlossen die einen technischen Kopierschutz enthalten
Da es nicht moumlglich ist den technischen Kopiervorgang festzustellen trifft die VG WORT die Annahme dass es einen Zusammenhang zwischen der Nutzung und der Zweitverwertung von einem Text gibt Dh man geht davon aus dass Texte die haumlufig gelesen werden auch haumlufig kopiert werden Aus diesem Grund muumlssen die Texte im Rahmen eines Zaumlhlverfahrens individuell gezaumlhlt werden Fuumlr die Ausschuumlttung werden Texte herangezogen deren Zugriffszaumlhlung einen festgelegten Mindestzugriff erreichen Der Mindestzugriff wird von der VG WORT fuumlr ein Kalenderjahr im Januar des Folgejahres im Meldesystem festgelegt Fuumlr das Jahr 2014 musste ein Text mit einer Laumlnge unter 10000 Zeichen 1500 Visits Jahr erreichen Bei einer Textlaumlnge von zumindest 10000 Zeichen hat sich der Mindestzugriff auf 750 Visits Jahr reduziert (Anteiliger Mindestzugriff) Zaumlhlungen von Texten hinter Bezahlschranken werden ab dem Jahr 2016 mit Faktor 3 multipliziert Weiterfuumlhrende Informationen finden Sie auf der Homepage der VG WORT
- Verteilungsplan httpwwwvgwortdepublikationen-dokumenteverteilungsplaenehtml (sect 58 und sect 59)
Ein weiteres Kriterium betrifft die Textlaumlnge Die Texte muumlssen eine Mindestlaumlnge von 1800 Zeichen (inkl Leerzeichen) erreichen Die Ausnahme bilden Gedichte ndash diese koumlnnen auch kuumlrzer sein
Zusammenfassung der Kriterien - Text muss im Internet veroumlffentlicht sein - Kein Kopierschutz (hartes DRM) - Mindestlaumlnge 1800 Zeichen (ausgenommen Lyrik) - Der festgelegte Mindestzugriff muss erreicht werden
12 Houmlhe der Tantieme
Die Houmlhe der Tantieme wird von der VG WORT fuumlr ein Kalenderjahr im Nachhinein (Mai Juni) festgelegt Die Tantieme besteht aus einem Verlagsanteil und einem Autorenanteil Die aktuellen Tantiemen und Modalitaumlten finden Sie in der Quotenuumlbersicht auf der Homepage der VG WORT unter httpwwwvgwortdepublikationen-dokumentequoten-uebersichthtml (Abschnitt bdquoMETISldquo)
Zu beachten ist dass die Houmlhe der Tantieme pro Text angegeben ist der die oben genannten Voraussetzungen erfuumlllt Dadurch sollten sich bei Verlagen die pro Jahr einige hundert oder tausend solcher Texte veroumlffentlichen die Investitionskosten rasch amortisieren
Um eine Tantieme zu erhalten sind pro Text nur drei Schritte noumltig
1) Zugriffszaumlhlung
2) Meldung uumlbermitteln
3) Ausschuumlttung erhalten
Die Grundlage fuumlr die Ausschuumlttung bilden die Zugriffszahlen daher ist es wichtig so schnell und so vollstaumlndig wie moumlglich mit der Zugriffszaumlhlung zu beginnen (siehe Kapitel bdquo2 Zugriffszaumlhlungldquo) Fuumlr eine spaumltere Meldung muss die dabei vergebene Zaumlhlmarke intern mit dem Text verknuumlpft werden Jeder Text muss dabei mit einer eigenen Zaumlhlmarke versehen werden
Der zweite Schritt ist die Uumlbermittlung der Meldung (siehe Kapitel bdquo3 Meldungldquo) Dabei wird der Text die Veroumlffentlichungsorte (URLs) sowie alle beteiligten Autoren und Uumlbersetzer an die VG WORT gemeldet
Nach Erstellung der Meldung pruumlft die VG WORT bei jedem Text ob er den Kriterien fuumlr die Ausschuumlttung entspricht Ist das der Fall erfolgt automatisch die Ausschuumlttung
14 Technische Grundlagen
Jeder beschriebene Schritt laumlsst sich manuell uumlber Meldemasken oder automatisiert uumlber Web Service Schnittstellen bedienen Die manuelle Variante ist fuumlr kleinere Verlage empfohlen (bis ca 100 Texte Jahr) Ansonsten empfiehlt sich eine vollautomatische Integration uumlber die Schnittstellen
2 Zugriffszaumlhlung Fuumlr die Zugriffszaumlhlung wird das bdquoskalierbare zentrale Messsystemldquo dass auch fuumlr die Werbewirtschaft (IVW) eingesetzt wird verwendet Dabei werden in HTML Seiten unsichtbare Bilder (Zaumlhlmarken) eingebaut die zu Zugriffszaumlhlungen fuumlhren
Die Zugriffszaumlhlung bildet die Basis fuumlr eine moumlgliche Ausschuumlttung Aus diesem Grund muss darauf geachtet werden moumlglichst alle Texte die fuumlr die Ausschuumlttung in Frage kommen zu zaumlhlen
Viele Artikel haben am Erscheinungstag die meisten Zugriffe Achten Sie unbedingt darauf dass Sie die Artikel sofort beim Erscheinen mit einer Zaumlhlmarke versehen da ansonsten moumlglicherweise der festgelegte Mindestzugriff nicht mehr erreicht werden kann
Bei den bisher teilnehmenden Verlagen hat es sich bewaumlhrt als Erstes mit der Zaumlhlung von neu erscheinenden Artikeln zu beginnen Erst sobald das reibungslos automatisiert funktioniert sollte man sich die Frage stellen ob man aumlltere Artikel (zB Archiv hellip) nachtraumlglich mit Zaumlhlmarken ausstatten moumlchte Eine Empfehlung dafuumlr oder dagegen kann man generell nicht aussprechen da es davon abhaumlngt wie stark solche Archivinhalte genutzt werden Das sollte im Verlag anhand von Kosten Nutzen entschieden werden
21 Grundsaumltzliches zu Zaumlhlmarken
211 Zaumlhlmarken der VG WORT
Jede Zaumlhlmarke besteht aus zwei Teilen (oumlffentlicher Identifikationscode privater Identifikationscode) Der oumlf fentliche Identifikationscode dient zum Einbau in die jeweilige HTML ndash Seite (siehe Kapitel 23 Einbau einer Zaumlhlmarke) Der private Identifikationscode wird spaumlter im Rahmen der Meldung benoumltigt
Aus diesem Grund muss der private Identifikationscode in Ihrem CMS System mit dem Artikel verknuumlpft werden
212 Verlagsinterner Schluumlssel als Zaumlhlmarke
In Verlagen werden die Artikel oftmals mit eindeutigen internen Schluumlsseln versehen Diese internen Schluumlssel koumlnnen ebenfalls als Zaumlhlmarke verwendet werden In diesem Fall wird sowohl fuumlr den oumlf fentlichen als auch fuumlr den privaten Identifikationscode der verlagsinterne Schluumlssel verwendet
Dabei gibt es folgendes zu beachten
- Ein verlagsinterner Schluumlssel setzt sich aus dem Praumlfix bdquovgzmltKarteinummergt-ldquo und einen beliebigen Schluumlssel zusammen Der Platzhalter bdquoltKarteinummergtldquo muss mit der VGWORT Karteinummer des Verlags ersetzt werden
- Der Schluumlssel darf keine Sonderzeichen enthalten (dh nur [a-z][A-Z][0-9] sowie den Punkt den Bindestrich und den Unterstrich)
- Der Schluumlssel muss innerhalb vom Verlag eindeutig sein
- DOI (httpwwwdoiorg) koumlnnen ebenfalls als verlagsinterne Schluumlssel zum Einsatz kommen Der Slash nach der Verlagskennung muss durch einen Bindestrich (-) ersetzt werden Es duumlrfen im DOI auch keine weiteren Slashes vorkommen
Beispiel vgzm970-123456789
Bitte setzen Sie sich vor Verwendung von verlagsinternen Schluumlsseln als Zaumlhlmarke unbedingt mit der VG WORT in Verbindung (per Email an metissupportvgwortde) Sie erhalten dann eine Zaumlhldomaumlne die Sie fuumlr den Einbau der Zaumlhlmarken benoumltigen und Sie werden fuumlr die Zugriffszaumlhlung mit verlagsinternen Schluumlsseln freigeschalten Ohne diese Schritte ist keine Zaumlhlung mit verlagsinternen Schluumlsseln moumlglich
Es empfiehlt sich zuerst die Zugriffszaumlhlung umzusetzen und erst dann die Meldung (siehe Kapitel 3) zu implementieren
Zum Zeitpunkt der Zugriffszaumlhlung muumlssen noch nicht alle Informationen zum Text (zB Autoreninformation) vorliegen Daher soll die Umsetzung der Zugriffszaumlhlung auf keinen Fall von solchen Faktoren abhaumlngen
214 Datenschutzerklaumlrung
Im Rahmen der Zugriffszaumlhlung werden Cookies und gegebenenfalls JavaScript - Aufrufe verwendet Es empfiehlt sich daher die Datenschutzerklaumlrung der Verlagsseite in der Zaumlhlmarken eingebaut werden um unten stehende Textbausteine zu ergaumlnzen
Cookies und Meldungen zu Zugriffszahlen
Wir setzen Session-Cookies der VG Wort Muumlnchen zur Messung von Zugriffen auf Texten ein um die Kopierwahrscheinlichkeit zu erfassen Session-Cookies sind kleine Informationseinheiten die ein Anbieter im Arbeitsspeicher des Computers des Besuchers speichert In einem Session-Cook ie wird eine zufaumlllig erzeugte eindeutige Identif ikationsnummer abgelegt eine sogenannte Session-ID Auszligerdem enthaumllt ein Cookie die Angabe uumlber seine Herkunft und die Speicherfrist Session-Cookies koumlnnen keine anderen Daten speichern Diese Messungen werden von der Kantar Germany GmbH nach dem Skalierbaren Zentralen Messverfahren (SZM) durchgefuumlhrt Sie helfen dabei die Kopierwahrscheinlichkeit einzelner Texte zur Verguumltung von gesetzlichen Anspruumlchen von Autoren und Verlagen zu ermitteln Wir erfassen keine personenbezogenen Daten uumlber Cookies
Viele unserer Seiten sind mit JavaScript-Aufrufen versehen uumlber die wir die Zugrif fe an die Verwertungsgesellschaft Wort (VG Wort) melden [BITTE UumlBERPRUumlFEN ob dies bei Ihrem Verlag der Fall ist] Wir ermoumlglichen damit dass unsere Autoren an den Ausschuumlttungen der VG Wort partizipieren die die gesetzliche Verguumltung fuumlr die Nutzungen urheberrechtlich geschuumltzter Werke gem sect 53 UrhG sicherstellen
Eine Nutzung unserer Angebote ist auch ohne Cookies moumlglich Die meisten Browser sind so eingestellt dass sie Cookies automatisch akzeptieren Sie koumlnnen das Speichern von Cookies jedoch deaktivieren oder Ihren Browser so einstellen dass er Sie benachrichtigt sobald Cookies gesendet werden
Datenschutzerklaumlrung zur Nutzung des Skalierbaren Zentralen Messverfahrens
Webangebote
Unsere Website und unser mobiles Webangebot nutzen das bdquoSkalierbare Zent rale Messverfahrenldquo (SZM) der Kantar Germany GmbH fuumlr die Ermittlung statistischer Kennwerte zur Ermittlung der Kopierwahrscheinlichkeit von Texten
Dabei werden anonyme Messwerte erhoben Die Zugrif fszahlenmessung verwendet zur Wiedererkennung von Computersystemen alternativ ein Session-Cookie oder eine Signatur die aus verschiedenen automatisch uumlbertragenen Informationen Ihres Browsers ers tel l t wird IP-Adressen werden nur in anonymisierter Form verarbeitet
Das Verfahren wurde unter der Beachtung des Datenschutzes entwickelt Einziges Ziel des Verfahrens ist es die Kopierwahrscheinlichkeit einzelner Texte zu ermitteln
Zu keinem Zeitpunkt werden einzelne Nutzer identifiziert Ihre Identitaumlt bleibt immer geschuumltzt Sie erhalten uumlber das System keine Werbung
22 Bestellen von Zaumlhlmarken
Verlage haben den Bedarf groszlige Mengen von Zaumlhlmarken auf einmal abzurufen um diese dann in den internen CMS Systemen vorraumltig zu halten Hierfuumlr gibt es zwei Varianten Eine Variante ist es die Zaumlhlmarken direkt aus dem Portal abzurufen bei der anderen Variante erfolgt der Abruf uumlber ein Web Service und kann so automatisiert werden
Grundsaumltzlich koumlnnen pro Jahr 4000 Zaumlhlmarken abgerufen werden Sollte ein Verlag mehr Zaumlhlmarken benoumltigen wird er gebeten sich per Email an metissupportvgwortde zu wenden damit die noumltigen Kapazitaumlten zur Verfuumlgung gestellt werden koumlnnen
Es empfiehlt sich immer einen Zaumlhlmarkenvorrat fuumlr zumindest eine Woche vorraumlt ig zu halten um nicht von der Verfuumlgbarkeit der METIS Anwendung abhaumlngig zu sein
Beim Einsatz von verlagsinternen Schluumlsseln als Zaumlhlmarken entfaumlllt die Bestellung der VG WORT Zaumlhlmarken
221 Bestellung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2211 orderPixelRequest
Feld Typ Beschreibung
count int Anzahl der zu bestellenden Zaumlhlmarken (gt1)
2212 orderPixelResponse
Feld Typ Beschreibung
orderDateTime string Bestelldatum + Zeit im Format bdquoYYYYMMddHHmmldquo
domain string Die Zaumlhlmarken Domaumlne Diese Domaumlne muss beim
Einbau dieser Zaumlhlmarken verwendet werden
pixels pixels Komplexer Datentyp
pixelspublicIdentificationId pixelIDType Oumlffentlicher Identifikationscode der Zaumlhlmarke
pixelsprivateIdentificationId pixelIDType Privater Identifikationscode der Zaumlhlmarke
2213 orderPixelFault
Feld Typ Beschreibung
errorcode int Der Fehlercode
errormsg string Grund fuumlr den Bestellabbruch
maxOrder Int Die maximale Anzahl die fuumlr die jeweilige Bestellung moumlglich gewesen
waumlre (wird nur bei Fehlercode bdquo1ldquo oder Fehlercode bdquo2ldquo angegeben)
22131 Fehlercodes
Fehlerfall Fehlercode maxOrder Meldung
MaxAnzahlBestellung 1 Die maximale Anzahl () an Zaumlhlmarken fuumlr diese
Bestellung wurde um uumlberschritten
MaxAnzahlJahr 2 Die maximale Anzahl () an Zaumlhlmarken fuumlr das
Jahr wurde um uumlberschritten
KeineEMailVorhanden 3 0 Es existiert keine Email-Adresse in Ihrem
Benutzerkonto bitte tragen Sie diese im Meldeportal
Nach Eingabe der benoumltigten Zaumlhlmarken und Klicken auf die Schaltflaumlche bdquoZaumlhlmarken bestellenldquo werden die Zaumlhlmarken vom System generiert Danach wird die Seite zum Download der eben bestellten Zaumlhlmarken angezeigt Falls mehr Zaumlhlmarken bestellt wurden als noch zur Verfuumlgung stehen kommt eine entsprechende Fehlermeldung In diesem Fall wenden Sie sich bitte per Email an metissupportvgwortde
Abbildung 2 Maskenbeschreibung Download der generierten Zaumlhlmarken
In der oben stehenden Maske befindet sich neben der Zaumlhldomaumlne auch Einbaubeispiele fuumlr HTML Texte Beim Klicken auf bdquoDownload der reinen Codepaare als CSV-Dateildquo koumlnnen die bestellten Zaumlhlmarken heruntergeladen werden Das Format der CSV Datei ist im folgenden Abschnitt beschrieben Beim Klicken auf bdquoDownload der vorkonfigurierten Zaumlhlmarken als CSV-Dateildquo wird eine Datei ausgegeben die alle Zaumlhlmarken als fertigen HTML Code enthaumllt
2221 CSV-Datei Format
Die CSV-Datei wird im folgenden Format erstellt (Die Spalten werden durch ein Semikolon getrennt)
Die Zaumlhlmarke ist ein transparentes (unsichtbares) Bild mit der Groumlszlige von 1 x 1 Pixel Es hat keinesfalls Einfluss auf die Ladezeit der Seite da Bilder von den Browsern separat zum Text geladen werden Das unsichtbare Bild hat auch keinen Einfluss auf das Erscheinungsbild der Seite
Einbaubeispiel VG WORT Zaumlhlmarke in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquoc5b7568d28884052a9ff92d5afd08f34rdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquovgzm970-123456789rdquo
Der korrekt formatierte verlagsinterne Schluumlssel des zu zaumlhlenden Textes
232 Fuumlr Dokumente (PDF oder EPUB Dateien)
Eine Zaumlhlmarke kann nicht direkt in eine dieser Dateien eingebaut werden Sie muss daher in die HTML Seite eingebaut werden von der aus das Dokument verlinkt wird Verlinkungen von anderen Seiten koumlnnen nicht beruumlcksichtigt werden Da eine Weiterleitung vom Zaumlhlserver auf externe Dateien aus sicherheitstechnischen Gruumlnden nicht angeboten werden kann benoumltigt man JavaScript um die Zugriffe auf eine PDF Datei zaumlhlen zu koumlnnen
In diesem Fall wird das Zaumlhlpixel (unsichtbare Bild) uumlber JavaScript in die HTML Seite eingefuumlgt sobald das Dokument (der Link auf das Dokument bleibt unveraumlndert) abgerufen wird
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquo98380ae3fc0a4daf84d6197274add99erdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquohttpwwwstepscondebeispielepubrdquo
Der Link auf das zu zaumlhlende Dokument
- LINK-Name
Name des Links
Auch dabei ist der Einsatz von verlagsinternen Schluumlsseln moumlglich In diesem Fall wird der korrekt formatierte verlagsinterne Schluumlssel anstelle vom oumlffentlichen Identifikationscode verwendet Auf ein separates Einbaubeispiel wird in diesem Dokument verzichtet
233 Base64url enkodierte Zaumlhlmarken
Die verwendbaren Zeichen in einer Zaumlhlmarke sind stark beschraumlnkt (siehe oben) Sollten verlagsinterne Schluumlssel mit nicht erlaubten Zeichen zum Einsatz kommen kann die Zaumlhlmarke Base64url (Codepage UTF-8) enkodiert werden In diesem Fall wird die encodierte Zaumlhlmarke mit Praumlf ix bdquobase64-ldquo eingebaut
Zum Thema Base64url Die Zeichen + und werden nach der Base64-Enkodierung durch - (Minus ASCII 2Dhex) und _ (Unterstrich ASCII 5Fhex) ersetzt
Einbaubeispiel verlagsinterner Schluumlssel in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Zugriffe von Texten hinter Bezahlschranken werden mit Faktor 3 multipliziert Die Aufwertung der Zaumlhlwerte hinter Bezahlschranken erfolgt mittels einer gesonderten Zaumlhlung Hierfuumlr muss der Verlag die Zaumlhlmarke beim Einbau mit einem Praumlfix versehen Dieses Praumlfix darf nur fuumlr Texte hinter Bezahlschranken verwendet werden Ist der Text frei zugaumlnglich wird die Zaumlhlmarke wie bisher (ohne Praumlf ix) eingebaut Aufgrund des Praumlfixes kann unterschieden werden ob ein Text hinter einer Bezahlschranke ist oder nicht
Um Texte hinter Bezahlschranken melden zu koumlnnen muumlssen Sie fuumlr die VG WORT zuerst einen kostenfreien Zugang auf diese Texte einrichten Dies ist uumlber die Angabe von Zugangsdaten oder uumlber die Freischaltung von IP Adressen moumlglich (im TOM Menuuml unter Zugriff auf zugangsbeschraumlnkte Inhalte erlauben)
Das Praumlf ix lautet bdquopw-ldquo bdquopwldquo steht fuumlr den englischen Begriff bdquoPaywallldquo (Bezahlschranke)
In der Vergangenheit musste bei Zaumlhlungen von https- Seiten eine separate Zaumlhldomaumlne verwendet werden Wenn Sie die Zaumlhlungen uumlber diese separate Domaumlne eingebaut haben muumlssen Sie den Einbau nicht aumlndern Diese Variante wird weiterhin unterstuumltzt
236 Potenzielle Fehlerquelle Referrer-Tag
Bestimmte Einstellungen im Quellcode koumlnnen dazu fuumlhren dass Zaumlhlungen nicht mehr zugeordnet werden koumlnnen wenn die Meldungen eingehen Es sieht dann so aus als waumlren d ie Zaumlhlungen zu einem Text falsch (zB nur uumlber eine Startseite ohne den eigentlichen Text) erfolgt Das kann dazu fuumlhren dass diese Zaumlhlungen gestrichen werden und der Mindestzugriff nicht mehr gegeben is t Um solche Probleme zu vermeiden muumlssen Sie darauf achten wie das Referrer-Metatag im Quellcode Ihrer Seite eingestellt ist
Die Zeile ltmeta name=referrer content=origingt sorgt zB dafuumlr dass eine Seite die httpswwwbeispieldemein_texthtml heiszligt nur httpswwwbeispielde sendet Damit lassen s ich dann die Zugriffe nicht mehr der richtigen Seite zuordnen
Bei weiteren Einstellungen wird das Senden der Daten vollstaumlndig unterdruumlckt Auch dies kann dazu fuumlhren dass Zaumlhlungen nicht anerkannt werden wenn weitere Faktoren darauf hindeuten dass die Zaumlhlungen nicht korrekt sein koumlnnten
Nur bei den Einstellungen ltmeta name=referrer content=no-referrer-when-downgradeldquogt oder ltmeta name=referrer content=unsafe-urlgt kann man auf gezaumlhlten Seiten 100 sicher sein dass keine Meldungen wegen nicht nachvollziehbarer Zugriffszaumlhlungen abgewiesen werden
Diese Funktion ist in bestimmten Faumlllen hoch problematisch und in anderen Faumlllen sogar zwingend erforderlich
Die Verwendung von bdquoLazy Loadldquo ist immer zu vermeiden wenn sich auf einer URL nur ein Text oder nur ein Teil eines mehrseitigen Textes befindet Hier fuumlhrt die Funktion dazu dass die Zaumlhlmarken erst geladen werden wenn die Stelle mit der Zaumlhlmarke im Browser angezeigt wird Insbesondere wenn die Zaumlhlmarke am Ende der Seite oder des Textes eingebaut wird sorgt die Funkt ion dafuumlr dass unser Zaumlhlbild nur geladen wird wenn der Leser auch an der Stelle ankommt also zB bis ganz ans Ende der Seite oder des Textes scrollt Erreicht er die Stelle nicht weil die Zaumlhlmarke zB erst unterhalb der Seite und nach Werbeeinblendungen oder Kommentaren eingebaut ist dann wird das Bild auch nicht vom Zaumlhlserver abgerufen und es erfolgt somit auch KEINE Zaumlhlung
Anders sieht es hingegen aus wenn sich viele Texte auf einer Seite befinden oder weitere Texte automatisch eingeblendet werden sobald ein Leser das Textende des ersten Textes erreicht hat Da nicht automatisch davon ausgegangen werden kann dass Texte die vom jeweil igen Nutzer nicht gesucht wurden eine Kopierwahrscheinlichkeit haben darf in diesen Faumlllen die Zaumlhlung nur erfolgen wenn der Text tatsaumlchlich ausgewaumlhlt wird Dies kann mit Hilfe von Lazy load erreicht werden Dazu baut man die jeweilige Zaumlhlmarke am besten immer ab der Mitte eines Textes ein so dass einerseits sichergestellt ist dass gezaumlhlt wird und andererseits dass nur eine Zaumlhlung erfolgt wenn wirklich ein bestimmter Text angesehen wurde und damit die notwendige Kopierwahrscheinlichkeit gegeben ist
24 Uumlberpruumlfen der Zaumlhlungen
241 Anzeige Herunterladen in der Anwendung
In der Anwendung gibt es eine Funktionalitaumlt mit der man pruumlfen kann welche Zaumlhlmarken bereits gezaumlhlt werden bzw welche Zaumlhlmarken die Mindestzugriffe uumlberschritten haben Dadurch kann man feststellen ob der Einbau dieser Zaumlhlmarken korrekt ist Diese Funktionalitaumlt kann uumlber den Menuumlpunkt bdquoZaumlhlmarkenuumlbersichtldquo abgerufen werden Siehe Abbildung unten
Abbildung 3 Maskenbeschreibung Zaumlhlerstarts
Dabei gibt es folgende Filtermoumlglichkeiten
- bdquoIdentif ikationscodeldquo Der oumlffentliche bzw private Identifikationscode oder der verlagsinterne Schluumlssel der Zaumlhlmarke
- bdquoBestelldatum (von bis)ldquo Bestelldatum der Zaumlhlmarke
- bdquoMeldung erfolgtldquo Es werden nur Zaumlhlmarken angezeigt fuumlr die bereits eine Meldung vorliegt
- bdquoZaumlhlerstart erfolgtldquo Alle Zaumlhlmarken die gezaumlhlt werden
- bdquoMindestzugriffldquo Alle Zaumlhlmarken die den Mindestzugriff oder den anteiligen Mindestzugriff uumlberschritten haben
- bdquoin Ausgeblendete Zaumlhlmarken suchenldquo Es werden auch Zaumlhlmarken gesucht die uumlber die angebotene Funktionalitaumlt ausgeblendet wurden Zaumlhlmarken sollten ausgeblendet werden wenn diese in Texten eingebaut wurden die den Kriterien der VG WORT nicht entsprechen (zB zu kurze Texte) Ansonsten scheinen diese Zaumlhlmarken weiterhin staumlndig in der Suchergebnisliste auf
Die Filtermoumlglichkeiten fuumlr den Mindestzugriff greifen sobald die ersten Zaumlhldaten fuumlr ein Kalenderjahr vorliegen Allerdings ist die Anzeige fuumlr das laufende Jahr unter Vorbehalt und erfolgt auf der Basis
des letzten bekannten Mindestzugriffes Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald der Mindestzugriff zu einem Jahr im Meldesystem eingegeben wurde (immer im Januar des Folgejahres)
Die Zaumlhlmarken koumlnnen zusaumltzlich als Liste im CSV Format heruntergeladen werden
Der Zaumlhlerstart wird mit einer Verzoumlgerung von ca 4 Tagen angezeigt Dh wenn eine Zaumlhlmarke heute eingebaut wird scheint diese in der Statistik erst in ca 4 Tagen auf
Es empfiehlt sich testweise einige wenige Zaumlhlmarken einzubauen und zu pruumlfen ob die Zaumlhlungen korrekt gestartet werden bevor man den Einbau der Zaumlhlmarken auf das gesamte Internetangebot ausrollt
242 Abruf uumlber Web Service Schnittstelle
Im Gegensatz zur Maske (siehe oben) kann man uumlber das Web Service nur die Zaumlhlmarken bdquomit Mindestzugriff ohne Meldungldquo sowie bdquomit anteiligem Mindestzugriff ohne Meldungldquo herunterladen
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2421 pixelOverviewRequest
Feld Typ Beschreibung
offset Int Wiederaufsetzpunkt Das System returniert maximal 100 Zaumlhlmarken am Stuumlck
Falls es mehr Zaumlhlmarken gibt die die Kriterien erfuumlllen koumlnnen weitere
Zaumlhlmarken uumlber den offset ausgelesen werden
Beispiel (190 Zaumlhlmarken vorhanden)
1 Abfrage (offset = 0) Die Zaumlhlmarken 1 ndash 100 werden zuruumlckgegeben
2 Abfrage (offset = 100) Die Zaumlhlmarken 101 ndash 190 werden zuruumlckgegeben
type Auswahl Entweder bdquoMINDESTZUGRIFFldquo oder bdquoANTEILIGER_MINDESTZUGRIFFldquo
2422 pixelOverviewResponse
Feld Typ Beschreibung
Amount Int Anzahl der gefundenen Zaumlhlmarken
Offset Int Der beim Request angegebene offset
privateIdentificationId pixelIDType (Liste) Privater Identifikationscode oder verlagsinterner Schluumlssel
3 Meldung Nachdem eine Zaumlhlmarke bestellt und eingebaut wurde kann eine Meldung zum jeweiligen Text erfolgen Eine Meldung soll dann gemacht werden wenn sich der Text des gemeldeten Artikels nicht mehr wesentlich aumlndert da die VG WORT in den Pruumlfmechanismen den gemeldeten Text mit dem Text der sich tatsaumlchlich im Internet befindet vergleicht
Der spaumlteste Zeitpunkt zum Melden eines Textes ist der sogenannte Meldeschlusstermin Diesen f inden Sie auf der Homepage der VG WORT unter bdquoTermineldquo Derzeit ist der Meldeschluss fuumlr Verlage der 1 Juni des auf die Zaumlhlung folgenden Jahres
In den meisten Faumlllen empfiehlt sich eine bdquoWartefristldquo von 14 Tagen bevor die Meldung erstellt wird So lange der Text noch Aumlnderungen unterzogen wird besteht die Gefahr dass die von der VG WORT durchgefuumlhrten Pruumlfmechanismen fehlschlagen
Bitte setzen Sie sich vor Meldungen zu Texten die uumlber verlagsinterne Schluumlssel gezaumlhlt werden unbedingt mit der VG WORT (per Email an metissupportvgwortde) in Verbindung
31 Anforderungen an die Meldung
Anbei f inden Sie alle Daten die bei einer Meldung angegeben werden muumlssen - Eindeutiger Identifikationscode - Alle beteiligten Autoren Uumlbersetzer und Agenturen - Kurzbeschreibung Uumlberschrift (Titel) - Text - Erscheinungsorte (Webbereiche)
311 Eindeutiger Identifikationscode
Der Identif ikationscode zur Zaumlhlmarke die in den Text eingebaut wurde Je nachdem welche Zaumlhlmarke verwendet wird ist dies der private Identifikationscode (bei VG WORT Zaumlhlmarken) oder der verlagsinterne Schluumlssel
312 Alle beteiligten Autoren Uumlbersetzer und Agenturen
Alle die am Text beteiligt sind Es gibt drei Arten wie die Autoren undoder Uumlbersetzer gemeldet werden
Vorname + Nachname + Karteinummer Die bevorzugte Variante Dabei werden von einem Autor oder einem Uumlbersetzer der Vorname der Nachname und die VG WORT Karteinummer gemeldet Eine Meldung mit Schreibweisen oder Pseudonymen ist auch moumlglich wenn diese der VG WORT bekannt sind Der Vorteil an dieser Variante ist dass ein Autor somit bei der VG WORT eindeutig identifizierbar ist und der Verlag somit keine weiteren Schritte unternehmen muss damit der jeweilige Autor zu seiner Ausschuumlttung kommt
Diese Variante beinhaltet fuumlr den Verlag zwar einen Initialaufwand da die Karteinummern aller Autoren eingesammelt werden muumlssen in der Praxis hat sich diese Variante bei den meisten teilnehmenden Verlagen aber als die einfachste Variante erwiesen
Vorname + Nachname Wenn von einem Autor die VG WORT Karteinummer nicht bekannt ist kann der Autor auch uumlber den Vornamen und den Nachnamen gemeldet werden Den Autoren steht fuumlr das Auffinden der ausschuumlttungsrelevanten Meldungen eine Suchmaske zur Verfuumlgung Allerdings muss in diesem Fall der gemeldete Name exakt mit dem uumlbereinstimmen der im Datenbestand der VG WORT vorliegt
Ist der Vorname nicht vollstaumlndig bekannt kann er in der Variante erster Buchstabe des Vornamens + Punkt angegeben werden
Urheber ohne Wahrnehmungsvertrag Hat der Urheber des zu meldenden Werkes dem meldenden Verlag fuumlr dieses Werk die von der VG WORT wahrgenommenen gesetzlichen Verguumltungsanspruumlche nach dem Urheberrechtsgesetz abgetreten kann dieser Urheber mit Namen Geburtsdatum und Adresse angegeben werden Zusaumltzlich muss bestaumltigt werden dass der Urheber die Rechte uumlbertragen hat Die uumlbertragenen Rechte werden bei der Ausschuumlttung beruumlcksichtigt
Fuumlr Agenturmeldungen bei denen die Autoren nicht bekannt sind steht eine weitere Variante zur Verfuumlgung
Die Rechte koumlnnen dem Verlag erst nach der Veroumlffentlichung des Textes uumlbertragen werden Die schriftliche Rechteuumlbertragung des jeweiligen Autors muss der VG WORT jederzeit auf Anfrage zur Verfuumlgung gestellt werden
Kuumlrzel Wenn man eine Agentur melden moumlchte dann kann das aktuell uumlber diesen Weg erfolgen Als Kuumlrzel wird die Kurzbezeichnung der jeweiligen Agentur uumlbergeben (zB bdquodpaldquo)
Namentliche bekannte Urheber koumlnnen uumlber die Angabe bdquoKuumlrzelldquo nicht gemeldet werden Diese Angabe kann ausschlieszliglich fuumlr die Meldung von Agenturtexten bzw der Miturheberschaft eines nicht namentlich bekannten Agenturautoren verwendet werden
313 Kurzbeschreibung Uumlberschrift (Titel)
Der Titel des zu meldenden Artikels
314 Text
Der Text des zu meldenden Artikels (entweder als Klartext als PDF oder im EPUB Format) Benoumltigt wird der bdquoNettotextldquo (dh der Text ohne HTML Code und ohne Menuuml oder dergleichen)
315 Erscheinungsorte (Webbereiche)
Es muumlssen alle Erscheinungsorte des Texts auf denen die Zaumlhlmarke eingebaut wurde gemeldet werden Ein Erscheinungsort definiert sich aus allen URLs die benoumltigt werden um den gesamten Text einmal zu lesen
Beispiel 1 Ein Text der sich uumlber 2 URLs erstreckt muss mit einem Webbereich (mit 2 URLs) gemel-det werden (zB httpdomain1depage1html httpdomain1depage2html)
Beispiel 2 Ein Text der sich uumlber 1 URL erstreckt aber auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils einer URL) gemeldet werden (zB httpdomain1demytexthtml und httpdomain2demytexthtml)
Beispiel 3 Ein Text der sich uumlber 2 URLs erstreckt und auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils zwei URLs) gemeldet werden (zB httpdomain1depage1html httpdomain1depage2html und httpdomain2depage1html httpdomain2depage2html)
32 Meldung uumlbermitteln
321 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
bull Es sollen nur Texte gemeldet werden die bereits bdquostabilldquo sind (dh die sich nicht mehr haumlufig aumlndern) Aus diesem Grund wird empfohlen die Texte mit einer Zeitverzoumlgerung von einigen Tagen (zB 14 Tagen) zu melden Auf die Tantieme hat das keinen Einfluss da die Ausschuumlttung erst Ende September Anfang Oktober fuumlr das Vorjahr erfolgt
bull Die Meldungen sollen taumlglich in der Nacht uumlbertragen werden Zeitfenster 2200 ndash 0300 Von 0300 bis 0600 gibt es ein allgemeines Wartungsfenster wo nicht gemeldet werden kann
bull Um eine Uumlberlastung der Server (und somit houmlhere Wartezeit) zu verhindern sollen die Meldungen sequentiell (nicht parallel) uumlbertragen werden Idealerweise soll zwischen zwei Meldungen eine Sekunde verstreichen Aus transaktionaler Sicht wird jede Meldung einzeln behandelt Dh jede erfolgreich eingehende Meldung wird gespeichert ndash unabhaumlngig davon ob die vorherige oder nachfolgende Meldung einen Fehler verursacht hat
bull Alle fachlichen Fehlercodes (ein- oder zweistellig) deuten auf einen Fehler in der Meldung hin Es ist zwecklos diese Meldung unveraumlndert noch einmal abzusenden Dreistellige Fehler (sowie der HTML ndash 500 Fehler) deuten auf technische Probleme hin Hier ist es zweckmaumlszligig dieselben Meldungen zu einem spaumlteren Zeitpunkt (zB mit den Meldungen vom naumlchsten Tag) noch einmal zu uumlbertragen
bull Die Bestaumltigung der Meldung bedeutet dass die Meldung aus technischer Sicht in Ordnung ist (dh Mindestumfang von 1800 Zeichen die Zaumlhlmarke existiert hellip) In einer spaumlteren Phase werden die Meldungen noch durch automatische Pruumlfmechanismen der VG WORT in Stichproben gepruumlft Sollten dabei Maumlngel auftreten werden die betreffenden Meldungen zuruumlckgewiesen und der Inhaber des Meldekontos bei der VG WORT wird per Email verstaumlndigt Diese Meldungen koumlnnen dann im Portal entweder geloumlscht oder manuell nachbearbeitet und erneut versendet werden
3212 newMessageRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der private
Identifikationscode (bei VG WORT Zaumlhlmarken) oder der
verlagsinterne Schluumlssel
Parties Parties Die Urheber Uumlbersetzer Agenturen der Meldung Es muss mindestens ein Autor oder ein Uumlbersetzer angegeben werden
Es koumlnnen in einer Meldung sowohl Autoren als auch
Uumlbersetzer angegeben werden
partiesauthors Authors 0 bis mehrere Autoren Beschreibung siehe separate Tabelle
partiestranslators Translators 0 bis mehrere Uumlbersetzer Beschreibung siehe separate
Tabelle
messagetext MessageText Der gemeldete Text entweder als PDF EPUB oder als Klartext
messagetextshorttext string Kurzbezeichnung Uumlberschrift vom Text
messagetexttext Text Der Text an sich Beschreibung siehe separate Tabelle
messagetextlyric boolean bdquoTrueldquo wenn es sich beim Text um Lyrik handelt ansonsten
bdquoFalseldquo
webranges Webranges Erscheinungsort(e) unter demdenen der Text gefunden werden
kann
webrangeswebrange Webrange Ein Erscheinungsort Beschreibung siehe separate Tabelle
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
1 Einleitung Dieses Dokument dient als Beschreibung fuumlr Verlage die am METIS Verfahren teilnehmen wollen Es beinhaltet sowohl die generelle Verfahrensbeschreibung wie auch die technische Beschreibung der eingesetzten Schnittstellen Es basiert auf langjaumlhriger Erfahrung dadurch sind bereits Erfahrungswerte sowie Probleme bei vergangenen Integrationen eingeflossen
Um an METIS teilnehmen zu koumlnnen ist eine einmalige Meldesystemregistrierung unter httptomvgwortde noumltig
11 Voraussetzung fuumlr die Verguumltung von Texten
Bei METIS wird die Zweitverwertung von Texten im Internet verguumltet (dh Kopien die von den im Internet zur Verfuumlgung gestellten Texten angefertigt werden) Aus diesem Grund werden Texte ausgeschlossen die einen technischen Kopierschutz enthalten
Da es nicht moumlglich ist den technischen Kopiervorgang festzustellen trifft die VG WORT die Annahme dass es einen Zusammenhang zwischen der Nutzung und der Zweitverwertung von einem Text gibt Dh man geht davon aus dass Texte die haumlufig gelesen werden auch haumlufig kopiert werden Aus diesem Grund muumlssen die Texte im Rahmen eines Zaumlhlverfahrens individuell gezaumlhlt werden Fuumlr die Ausschuumlttung werden Texte herangezogen deren Zugriffszaumlhlung einen festgelegten Mindestzugriff erreichen Der Mindestzugriff wird von der VG WORT fuumlr ein Kalenderjahr im Januar des Folgejahres im Meldesystem festgelegt Fuumlr das Jahr 2014 musste ein Text mit einer Laumlnge unter 10000 Zeichen 1500 Visits Jahr erreichen Bei einer Textlaumlnge von zumindest 10000 Zeichen hat sich der Mindestzugriff auf 750 Visits Jahr reduziert (Anteiliger Mindestzugriff) Zaumlhlungen von Texten hinter Bezahlschranken werden ab dem Jahr 2016 mit Faktor 3 multipliziert Weiterfuumlhrende Informationen finden Sie auf der Homepage der VG WORT
- Verteilungsplan httpwwwvgwortdepublikationen-dokumenteverteilungsplaenehtml (sect 58 und sect 59)
Ein weiteres Kriterium betrifft die Textlaumlnge Die Texte muumlssen eine Mindestlaumlnge von 1800 Zeichen (inkl Leerzeichen) erreichen Die Ausnahme bilden Gedichte ndash diese koumlnnen auch kuumlrzer sein
Zusammenfassung der Kriterien - Text muss im Internet veroumlffentlicht sein - Kein Kopierschutz (hartes DRM) - Mindestlaumlnge 1800 Zeichen (ausgenommen Lyrik) - Der festgelegte Mindestzugriff muss erreicht werden
12 Houmlhe der Tantieme
Die Houmlhe der Tantieme wird von der VG WORT fuumlr ein Kalenderjahr im Nachhinein (Mai Juni) festgelegt Die Tantieme besteht aus einem Verlagsanteil und einem Autorenanteil Die aktuellen Tantiemen und Modalitaumlten finden Sie in der Quotenuumlbersicht auf der Homepage der VG WORT unter httpwwwvgwortdepublikationen-dokumentequoten-uebersichthtml (Abschnitt bdquoMETISldquo)
Zu beachten ist dass die Houmlhe der Tantieme pro Text angegeben ist der die oben genannten Voraussetzungen erfuumlllt Dadurch sollten sich bei Verlagen die pro Jahr einige hundert oder tausend solcher Texte veroumlffentlichen die Investitionskosten rasch amortisieren
Um eine Tantieme zu erhalten sind pro Text nur drei Schritte noumltig
1) Zugriffszaumlhlung
2) Meldung uumlbermitteln
3) Ausschuumlttung erhalten
Die Grundlage fuumlr die Ausschuumlttung bilden die Zugriffszahlen daher ist es wichtig so schnell und so vollstaumlndig wie moumlglich mit der Zugriffszaumlhlung zu beginnen (siehe Kapitel bdquo2 Zugriffszaumlhlungldquo) Fuumlr eine spaumltere Meldung muss die dabei vergebene Zaumlhlmarke intern mit dem Text verknuumlpft werden Jeder Text muss dabei mit einer eigenen Zaumlhlmarke versehen werden
Der zweite Schritt ist die Uumlbermittlung der Meldung (siehe Kapitel bdquo3 Meldungldquo) Dabei wird der Text die Veroumlffentlichungsorte (URLs) sowie alle beteiligten Autoren und Uumlbersetzer an die VG WORT gemeldet
Nach Erstellung der Meldung pruumlft die VG WORT bei jedem Text ob er den Kriterien fuumlr die Ausschuumlttung entspricht Ist das der Fall erfolgt automatisch die Ausschuumlttung
14 Technische Grundlagen
Jeder beschriebene Schritt laumlsst sich manuell uumlber Meldemasken oder automatisiert uumlber Web Service Schnittstellen bedienen Die manuelle Variante ist fuumlr kleinere Verlage empfohlen (bis ca 100 Texte Jahr) Ansonsten empfiehlt sich eine vollautomatische Integration uumlber die Schnittstellen
2 Zugriffszaumlhlung Fuumlr die Zugriffszaumlhlung wird das bdquoskalierbare zentrale Messsystemldquo dass auch fuumlr die Werbewirtschaft (IVW) eingesetzt wird verwendet Dabei werden in HTML Seiten unsichtbare Bilder (Zaumlhlmarken) eingebaut die zu Zugriffszaumlhlungen fuumlhren
Die Zugriffszaumlhlung bildet die Basis fuumlr eine moumlgliche Ausschuumlttung Aus diesem Grund muss darauf geachtet werden moumlglichst alle Texte die fuumlr die Ausschuumlttung in Frage kommen zu zaumlhlen
Viele Artikel haben am Erscheinungstag die meisten Zugriffe Achten Sie unbedingt darauf dass Sie die Artikel sofort beim Erscheinen mit einer Zaumlhlmarke versehen da ansonsten moumlglicherweise der festgelegte Mindestzugriff nicht mehr erreicht werden kann
Bei den bisher teilnehmenden Verlagen hat es sich bewaumlhrt als Erstes mit der Zaumlhlung von neu erscheinenden Artikeln zu beginnen Erst sobald das reibungslos automatisiert funktioniert sollte man sich die Frage stellen ob man aumlltere Artikel (zB Archiv hellip) nachtraumlglich mit Zaumlhlmarken ausstatten moumlchte Eine Empfehlung dafuumlr oder dagegen kann man generell nicht aussprechen da es davon abhaumlngt wie stark solche Archivinhalte genutzt werden Das sollte im Verlag anhand von Kosten Nutzen entschieden werden
21 Grundsaumltzliches zu Zaumlhlmarken
211 Zaumlhlmarken der VG WORT
Jede Zaumlhlmarke besteht aus zwei Teilen (oumlffentlicher Identifikationscode privater Identifikationscode) Der oumlf fentliche Identifikationscode dient zum Einbau in die jeweilige HTML ndash Seite (siehe Kapitel 23 Einbau einer Zaumlhlmarke) Der private Identifikationscode wird spaumlter im Rahmen der Meldung benoumltigt
Aus diesem Grund muss der private Identifikationscode in Ihrem CMS System mit dem Artikel verknuumlpft werden
212 Verlagsinterner Schluumlssel als Zaumlhlmarke
In Verlagen werden die Artikel oftmals mit eindeutigen internen Schluumlsseln versehen Diese internen Schluumlssel koumlnnen ebenfalls als Zaumlhlmarke verwendet werden In diesem Fall wird sowohl fuumlr den oumlf fentlichen als auch fuumlr den privaten Identifikationscode der verlagsinterne Schluumlssel verwendet
Dabei gibt es folgendes zu beachten
- Ein verlagsinterner Schluumlssel setzt sich aus dem Praumlfix bdquovgzmltKarteinummergt-ldquo und einen beliebigen Schluumlssel zusammen Der Platzhalter bdquoltKarteinummergtldquo muss mit der VGWORT Karteinummer des Verlags ersetzt werden
- Der Schluumlssel darf keine Sonderzeichen enthalten (dh nur [a-z][A-Z][0-9] sowie den Punkt den Bindestrich und den Unterstrich)
- Der Schluumlssel muss innerhalb vom Verlag eindeutig sein
- DOI (httpwwwdoiorg) koumlnnen ebenfalls als verlagsinterne Schluumlssel zum Einsatz kommen Der Slash nach der Verlagskennung muss durch einen Bindestrich (-) ersetzt werden Es duumlrfen im DOI auch keine weiteren Slashes vorkommen
Beispiel vgzm970-123456789
Bitte setzen Sie sich vor Verwendung von verlagsinternen Schluumlsseln als Zaumlhlmarke unbedingt mit der VG WORT in Verbindung (per Email an metissupportvgwortde) Sie erhalten dann eine Zaumlhldomaumlne die Sie fuumlr den Einbau der Zaumlhlmarken benoumltigen und Sie werden fuumlr die Zugriffszaumlhlung mit verlagsinternen Schluumlsseln freigeschalten Ohne diese Schritte ist keine Zaumlhlung mit verlagsinternen Schluumlsseln moumlglich
Es empfiehlt sich zuerst die Zugriffszaumlhlung umzusetzen und erst dann die Meldung (siehe Kapitel 3) zu implementieren
Zum Zeitpunkt der Zugriffszaumlhlung muumlssen noch nicht alle Informationen zum Text (zB Autoreninformation) vorliegen Daher soll die Umsetzung der Zugriffszaumlhlung auf keinen Fall von solchen Faktoren abhaumlngen
214 Datenschutzerklaumlrung
Im Rahmen der Zugriffszaumlhlung werden Cookies und gegebenenfalls JavaScript - Aufrufe verwendet Es empfiehlt sich daher die Datenschutzerklaumlrung der Verlagsseite in der Zaumlhlmarken eingebaut werden um unten stehende Textbausteine zu ergaumlnzen
Cookies und Meldungen zu Zugriffszahlen
Wir setzen Session-Cookies der VG Wort Muumlnchen zur Messung von Zugriffen auf Texten ein um die Kopierwahrscheinlichkeit zu erfassen Session-Cookies sind kleine Informationseinheiten die ein Anbieter im Arbeitsspeicher des Computers des Besuchers speichert In einem Session-Cook ie wird eine zufaumlllig erzeugte eindeutige Identif ikationsnummer abgelegt eine sogenannte Session-ID Auszligerdem enthaumllt ein Cookie die Angabe uumlber seine Herkunft und die Speicherfrist Session-Cookies koumlnnen keine anderen Daten speichern Diese Messungen werden von der Kantar Germany GmbH nach dem Skalierbaren Zentralen Messverfahren (SZM) durchgefuumlhrt Sie helfen dabei die Kopierwahrscheinlichkeit einzelner Texte zur Verguumltung von gesetzlichen Anspruumlchen von Autoren und Verlagen zu ermitteln Wir erfassen keine personenbezogenen Daten uumlber Cookies
Viele unserer Seiten sind mit JavaScript-Aufrufen versehen uumlber die wir die Zugrif fe an die Verwertungsgesellschaft Wort (VG Wort) melden [BITTE UumlBERPRUumlFEN ob dies bei Ihrem Verlag der Fall ist] Wir ermoumlglichen damit dass unsere Autoren an den Ausschuumlttungen der VG Wort partizipieren die die gesetzliche Verguumltung fuumlr die Nutzungen urheberrechtlich geschuumltzter Werke gem sect 53 UrhG sicherstellen
Eine Nutzung unserer Angebote ist auch ohne Cookies moumlglich Die meisten Browser sind so eingestellt dass sie Cookies automatisch akzeptieren Sie koumlnnen das Speichern von Cookies jedoch deaktivieren oder Ihren Browser so einstellen dass er Sie benachrichtigt sobald Cookies gesendet werden
Datenschutzerklaumlrung zur Nutzung des Skalierbaren Zentralen Messverfahrens
Webangebote
Unsere Website und unser mobiles Webangebot nutzen das bdquoSkalierbare Zent rale Messverfahrenldquo (SZM) der Kantar Germany GmbH fuumlr die Ermittlung statistischer Kennwerte zur Ermittlung der Kopierwahrscheinlichkeit von Texten
Dabei werden anonyme Messwerte erhoben Die Zugrif fszahlenmessung verwendet zur Wiedererkennung von Computersystemen alternativ ein Session-Cookie oder eine Signatur die aus verschiedenen automatisch uumlbertragenen Informationen Ihres Browsers ers tel l t wird IP-Adressen werden nur in anonymisierter Form verarbeitet
Das Verfahren wurde unter der Beachtung des Datenschutzes entwickelt Einziges Ziel des Verfahrens ist es die Kopierwahrscheinlichkeit einzelner Texte zu ermitteln
Zu keinem Zeitpunkt werden einzelne Nutzer identifiziert Ihre Identitaumlt bleibt immer geschuumltzt Sie erhalten uumlber das System keine Werbung
22 Bestellen von Zaumlhlmarken
Verlage haben den Bedarf groszlige Mengen von Zaumlhlmarken auf einmal abzurufen um diese dann in den internen CMS Systemen vorraumltig zu halten Hierfuumlr gibt es zwei Varianten Eine Variante ist es die Zaumlhlmarken direkt aus dem Portal abzurufen bei der anderen Variante erfolgt der Abruf uumlber ein Web Service und kann so automatisiert werden
Grundsaumltzlich koumlnnen pro Jahr 4000 Zaumlhlmarken abgerufen werden Sollte ein Verlag mehr Zaumlhlmarken benoumltigen wird er gebeten sich per Email an metissupportvgwortde zu wenden damit die noumltigen Kapazitaumlten zur Verfuumlgung gestellt werden koumlnnen
Es empfiehlt sich immer einen Zaumlhlmarkenvorrat fuumlr zumindest eine Woche vorraumlt ig zu halten um nicht von der Verfuumlgbarkeit der METIS Anwendung abhaumlngig zu sein
Beim Einsatz von verlagsinternen Schluumlsseln als Zaumlhlmarken entfaumlllt die Bestellung der VG WORT Zaumlhlmarken
221 Bestellung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2211 orderPixelRequest
Feld Typ Beschreibung
count int Anzahl der zu bestellenden Zaumlhlmarken (gt1)
2212 orderPixelResponse
Feld Typ Beschreibung
orderDateTime string Bestelldatum + Zeit im Format bdquoYYYYMMddHHmmldquo
domain string Die Zaumlhlmarken Domaumlne Diese Domaumlne muss beim
Einbau dieser Zaumlhlmarken verwendet werden
pixels pixels Komplexer Datentyp
pixelspublicIdentificationId pixelIDType Oumlffentlicher Identifikationscode der Zaumlhlmarke
pixelsprivateIdentificationId pixelIDType Privater Identifikationscode der Zaumlhlmarke
2213 orderPixelFault
Feld Typ Beschreibung
errorcode int Der Fehlercode
errormsg string Grund fuumlr den Bestellabbruch
maxOrder Int Die maximale Anzahl die fuumlr die jeweilige Bestellung moumlglich gewesen
waumlre (wird nur bei Fehlercode bdquo1ldquo oder Fehlercode bdquo2ldquo angegeben)
22131 Fehlercodes
Fehlerfall Fehlercode maxOrder Meldung
MaxAnzahlBestellung 1 Die maximale Anzahl () an Zaumlhlmarken fuumlr diese
Bestellung wurde um uumlberschritten
MaxAnzahlJahr 2 Die maximale Anzahl () an Zaumlhlmarken fuumlr das
Jahr wurde um uumlberschritten
KeineEMailVorhanden 3 0 Es existiert keine Email-Adresse in Ihrem
Benutzerkonto bitte tragen Sie diese im Meldeportal
Nach Eingabe der benoumltigten Zaumlhlmarken und Klicken auf die Schaltflaumlche bdquoZaumlhlmarken bestellenldquo werden die Zaumlhlmarken vom System generiert Danach wird die Seite zum Download der eben bestellten Zaumlhlmarken angezeigt Falls mehr Zaumlhlmarken bestellt wurden als noch zur Verfuumlgung stehen kommt eine entsprechende Fehlermeldung In diesem Fall wenden Sie sich bitte per Email an metissupportvgwortde
Abbildung 2 Maskenbeschreibung Download der generierten Zaumlhlmarken
In der oben stehenden Maske befindet sich neben der Zaumlhldomaumlne auch Einbaubeispiele fuumlr HTML Texte Beim Klicken auf bdquoDownload der reinen Codepaare als CSV-Dateildquo koumlnnen die bestellten Zaumlhlmarken heruntergeladen werden Das Format der CSV Datei ist im folgenden Abschnitt beschrieben Beim Klicken auf bdquoDownload der vorkonfigurierten Zaumlhlmarken als CSV-Dateildquo wird eine Datei ausgegeben die alle Zaumlhlmarken als fertigen HTML Code enthaumllt
2221 CSV-Datei Format
Die CSV-Datei wird im folgenden Format erstellt (Die Spalten werden durch ein Semikolon getrennt)
Die Zaumlhlmarke ist ein transparentes (unsichtbares) Bild mit der Groumlszlige von 1 x 1 Pixel Es hat keinesfalls Einfluss auf die Ladezeit der Seite da Bilder von den Browsern separat zum Text geladen werden Das unsichtbare Bild hat auch keinen Einfluss auf das Erscheinungsbild der Seite
Einbaubeispiel VG WORT Zaumlhlmarke in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquoc5b7568d28884052a9ff92d5afd08f34rdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquovgzm970-123456789rdquo
Der korrekt formatierte verlagsinterne Schluumlssel des zu zaumlhlenden Textes
232 Fuumlr Dokumente (PDF oder EPUB Dateien)
Eine Zaumlhlmarke kann nicht direkt in eine dieser Dateien eingebaut werden Sie muss daher in die HTML Seite eingebaut werden von der aus das Dokument verlinkt wird Verlinkungen von anderen Seiten koumlnnen nicht beruumlcksichtigt werden Da eine Weiterleitung vom Zaumlhlserver auf externe Dateien aus sicherheitstechnischen Gruumlnden nicht angeboten werden kann benoumltigt man JavaScript um die Zugriffe auf eine PDF Datei zaumlhlen zu koumlnnen
In diesem Fall wird das Zaumlhlpixel (unsichtbare Bild) uumlber JavaScript in die HTML Seite eingefuumlgt sobald das Dokument (der Link auf das Dokument bleibt unveraumlndert) abgerufen wird
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquo98380ae3fc0a4daf84d6197274add99erdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquohttpwwwstepscondebeispielepubrdquo
Der Link auf das zu zaumlhlende Dokument
- LINK-Name
Name des Links
Auch dabei ist der Einsatz von verlagsinternen Schluumlsseln moumlglich In diesem Fall wird der korrekt formatierte verlagsinterne Schluumlssel anstelle vom oumlffentlichen Identifikationscode verwendet Auf ein separates Einbaubeispiel wird in diesem Dokument verzichtet
233 Base64url enkodierte Zaumlhlmarken
Die verwendbaren Zeichen in einer Zaumlhlmarke sind stark beschraumlnkt (siehe oben) Sollten verlagsinterne Schluumlssel mit nicht erlaubten Zeichen zum Einsatz kommen kann die Zaumlhlmarke Base64url (Codepage UTF-8) enkodiert werden In diesem Fall wird die encodierte Zaumlhlmarke mit Praumlf ix bdquobase64-ldquo eingebaut
Zum Thema Base64url Die Zeichen + und werden nach der Base64-Enkodierung durch - (Minus ASCII 2Dhex) und _ (Unterstrich ASCII 5Fhex) ersetzt
Einbaubeispiel verlagsinterner Schluumlssel in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Zugriffe von Texten hinter Bezahlschranken werden mit Faktor 3 multipliziert Die Aufwertung der Zaumlhlwerte hinter Bezahlschranken erfolgt mittels einer gesonderten Zaumlhlung Hierfuumlr muss der Verlag die Zaumlhlmarke beim Einbau mit einem Praumlfix versehen Dieses Praumlfix darf nur fuumlr Texte hinter Bezahlschranken verwendet werden Ist der Text frei zugaumlnglich wird die Zaumlhlmarke wie bisher (ohne Praumlf ix) eingebaut Aufgrund des Praumlfixes kann unterschieden werden ob ein Text hinter einer Bezahlschranke ist oder nicht
Um Texte hinter Bezahlschranken melden zu koumlnnen muumlssen Sie fuumlr die VG WORT zuerst einen kostenfreien Zugang auf diese Texte einrichten Dies ist uumlber die Angabe von Zugangsdaten oder uumlber die Freischaltung von IP Adressen moumlglich (im TOM Menuuml unter Zugriff auf zugangsbeschraumlnkte Inhalte erlauben)
Das Praumlf ix lautet bdquopw-ldquo bdquopwldquo steht fuumlr den englischen Begriff bdquoPaywallldquo (Bezahlschranke)
In der Vergangenheit musste bei Zaumlhlungen von https- Seiten eine separate Zaumlhldomaumlne verwendet werden Wenn Sie die Zaumlhlungen uumlber diese separate Domaumlne eingebaut haben muumlssen Sie den Einbau nicht aumlndern Diese Variante wird weiterhin unterstuumltzt
236 Potenzielle Fehlerquelle Referrer-Tag
Bestimmte Einstellungen im Quellcode koumlnnen dazu fuumlhren dass Zaumlhlungen nicht mehr zugeordnet werden koumlnnen wenn die Meldungen eingehen Es sieht dann so aus als waumlren d ie Zaumlhlungen zu einem Text falsch (zB nur uumlber eine Startseite ohne den eigentlichen Text) erfolgt Das kann dazu fuumlhren dass diese Zaumlhlungen gestrichen werden und der Mindestzugriff nicht mehr gegeben is t Um solche Probleme zu vermeiden muumlssen Sie darauf achten wie das Referrer-Metatag im Quellcode Ihrer Seite eingestellt ist
Die Zeile ltmeta name=referrer content=origingt sorgt zB dafuumlr dass eine Seite die httpswwwbeispieldemein_texthtml heiszligt nur httpswwwbeispielde sendet Damit lassen s ich dann die Zugriffe nicht mehr der richtigen Seite zuordnen
Bei weiteren Einstellungen wird das Senden der Daten vollstaumlndig unterdruumlckt Auch dies kann dazu fuumlhren dass Zaumlhlungen nicht anerkannt werden wenn weitere Faktoren darauf hindeuten dass die Zaumlhlungen nicht korrekt sein koumlnnten
Nur bei den Einstellungen ltmeta name=referrer content=no-referrer-when-downgradeldquogt oder ltmeta name=referrer content=unsafe-urlgt kann man auf gezaumlhlten Seiten 100 sicher sein dass keine Meldungen wegen nicht nachvollziehbarer Zugriffszaumlhlungen abgewiesen werden
Diese Funktion ist in bestimmten Faumlllen hoch problematisch und in anderen Faumlllen sogar zwingend erforderlich
Die Verwendung von bdquoLazy Loadldquo ist immer zu vermeiden wenn sich auf einer URL nur ein Text oder nur ein Teil eines mehrseitigen Textes befindet Hier fuumlhrt die Funktion dazu dass die Zaumlhlmarken erst geladen werden wenn die Stelle mit der Zaumlhlmarke im Browser angezeigt wird Insbesondere wenn die Zaumlhlmarke am Ende der Seite oder des Textes eingebaut wird sorgt die Funkt ion dafuumlr dass unser Zaumlhlbild nur geladen wird wenn der Leser auch an der Stelle ankommt also zB bis ganz ans Ende der Seite oder des Textes scrollt Erreicht er die Stelle nicht weil die Zaumlhlmarke zB erst unterhalb der Seite und nach Werbeeinblendungen oder Kommentaren eingebaut ist dann wird das Bild auch nicht vom Zaumlhlserver abgerufen und es erfolgt somit auch KEINE Zaumlhlung
Anders sieht es hingegen aus wenn sich viele Texte auf einer Seite befinden oder weitere Texte automatisch eingeblendet werden sobald ein Leser das Textende des ersten Textes erreicht hat Da nicht automatisch davon ausgegangen werden kann dass Texte die vom jeweil igen Nutzer nicht gesucht wurden eine Kopierwahrscheinlichkeit haben darf in diesen Faumlllen die Zaumlhlung nur erfolgen wenn der Text tatsaumlchlich ausgewaumlhlt wird Dies kann mit Hilfe von Lazy load erreicht werden Dazu baut man die jeweilige Zaumlhlmarke am besten immer ab der Mitte eines Textes ein so dass einerseits sichergestellt ist dass gezaumlhlt wird und andererseits dass nur eine Zaumlhlung erfolgt wenn wirklich ein bestimmter Text angesehen wurde und damit die notwendige Kopierwahrscheinlichkeit gegeben ist
24 Uumlberpruumlfen der Zaumlhlungen
241 Anzeige Herunterladen in der Anwendung
In der Anwendung gibt es eine Funktionalitaumlt mit der man pruumlfen kann welche Zaumlhlmarken bereits gezaumlhlt werden bzw welche Zaumlhlmarken die Mindestzugriffe uumlberschritten haben Dadurch kann man feststellen ob der Einbau dieser Zaumlhlmarken korrekt ist Diese Funktionalitaumlt kann uumlber den Menuumlpunkt bdquoZaumlhlmarkenuumlbersichtldquo abgerufen werden Siehe Abbildung unten
Abbildung 3 Maskenbeschreibung Zaumlhlerstarts
Dabei gibt es folgende Filtermoumlglichkeiten
- bdquoIdentif ikationscodeldquo Der oumlffentliche bzw private Identifikationscode oder der verlagsinterne Schluumlssel der Zaumlhlmarke
- bdquoBestelldatum (von bis)ldquo Bestelldatum der Zaumlhlmarke
- bdquoMeldung erfolgtldquo Es werden nur Zaumlhlmarken angezeigt fuumlr die bereits eine Meldung vorliegt
- bdquoZaumlhlerstart erfolgtldquo Alle Zaumlhlmarken die gezaumlhlt werden
- bdquoMindestzugriffldquo Alle Zaumlhlmarken die den Mindestzugriff oder den anteiligen Mindestzugriff uumlberschritten haben
- bdquoin Ausgeblendete Zaumlhlmarken suchenldquo Es werden auch Zaumlhlmarken gesucht die uumlber die angebotene Funktionalitaumlt ausgeblendet wurden Zaumlhlmarken sollten ausgeblendet werden wenn diese in Texten eingebaut wurden die den Kriterien der VG WORT nicht entsprechen (zB zu kurze Texte) Ansonsten scheinen diese Zaumlhlmarken weiterhin staumlndig in der Suchergebnisliste auf
Die Filtermoumlglichkeiten fuumlr den Mindestzugriff greifen sobald die ersten Zaumlhldaten fuumlr ein Kalenderjahr vorliegen Allerdings ist die Anzeige fuumlr das laufende Jahr unter Vorbehalt und erfolgt auf der Basis
des letzten bekannten Mindestzugriffes Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald der Mindestzugriff zu einem Jahr im Meldesystem eingegeben wurde (immer im Januar des Folgejahres)
Die Zaumlhlmarken koumlnnen zusaumltzlich als Liste im CSV Format heruntergeladen werden
Der Zaumlhlerstart wird mit einer Verzoumlgerung von ca 4 Tagen angezeigt Dh wenn eine Zaumlhlmarke heute eingebaut wird scheint diese in der Statistik erst in ca 4 Tagen auf
Es empfiehlt sich testweise einige wenige Zaumlhlmarken einzubauen und zu pruumlfen ob die Zaumlhlungen korrekt gestartet werden bevor man den Einbau der Zaumlhlmarken auf das gesamte Internetangebot ausrollt
242 Abruf uumlber Web Service Schnittstelle
Im Gegensatz zur Maske (siehe oben) kann man uumlber das Web Service nur die Zaumlhlmarken bdquomit Mindestzugriff ohne Meldungldquo sowie bdquomit anteiligem Mindestzugriff ohne Meldungldquo herunterladen
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2421 pixelOverviewRequest
Feld Typ Beschreibung
offset Int Wiederaufsetzpunkt Das System returniert maximal 100 Zaumlhlmarken am Stuumlck
Falls es mehr Zaumlhlmarken gibt die die Kriterien erfuumlllen koumlnnen weitere
Zaumlhlmarken uumlber den offset ausgelesen werden
Beispiel (190 Zaumlhlmarken vorhanden)
1 Abfrage (offset = 0) Die Zaumlhlmarken 1 ndash 100 werden zuruumlckgegeben
2 Abfrage (offset = 100) Die Zaumlhlmarken 101 ndash 190 werden zuruumlckgegeben
type Auswahl Entweder bdquoMINDESTZUGRIFFldquo oder bdquoANTEILIGER_MINDESTZUGRIFFldquo
2422 pixelOverviewResponse
Feld Typ Beschreibung
Amount Int Anzahl der gefundenen Zaumlhlmarken
Offset Int Der beim Request angegebene offset
privateIdentificationId pixelIDType (Liste) Privater Identifikationscode oder verlagsinterner Schluumlssel
3 Meldung Nachdem eine Zaumlhlmarke bestellt und eingebaut wurde kann eine Meldung zum jeweiligen Text erfolgen Eine Meldung soll dann gemacht werden wenn sich der Text des gemeldeten Artikels nicht mehr wesentlich aumlndert da die VG WORT in den Pruumlfmechanismen den gemeldeten Text mit dem Text der sich tatsaumlchlich im Internet befindet vergleicht
Der spaumlteste Zeitpunkt zum Melden eines Textes ist der sogenannte Meldeschlusstermin Diesen f inden Sie auf der Homepage der VG WORT unter bdquoTermineldquo Derzeit ist der Meldeschluss fuumlr Verlage der 1 Juni des auf die Zaumlhlung folgenden Jahres
In den meisten Faumlllen empfiehlt sich eine bdquoWartefristldquo von 14 Tagen bevor die Meldung erstellt wird So lange der Text noch Aumlnderungen unterzogen wird besteht die Gefahr dass die von der VG WORT durchgefuumlhrten Pruumlfmechanismen fehlschlagen
Bitte setzen Sie sich vor Meldungen zu Texten die uumlber verlagsinterne Schluumlssel gezaumlhlt werden unbedingt mit der VG WORT (per Email an metissupportvgwortde) in Verbindung
31 Anforderungen an die Meldung
Anbei f inden Sie alle Daten die bei einer Meldung angegeben werden muumlssen - Eindeutiger Identifikationscode - Alle beteiligten Autoren Uumlbersetzer und Agenturen - Kurzbeschreibung Uumlberschrift (Titel) - Text - Erscheinungsorte (Webbereiche)
311 Eindeutiger Identifikationscode
Der Identif ikationscode zur Zaumlhlmarke die in den Text eingebaut wurde Je nachdem welche Zaumlhlmarke verwendet wird ist dies der private Identifikationscode (bei VG WORT Zaumlhlmarken) oder der verlagsinterne Schluumlssel
312 Alle beteiligten Autoren Uumlbersetzer und Agenturen
Alle die am Text beteiligt sind Es gibt drei Arten wie die Autoren undoder Uumlbersetzer gemeldet werden
Vorname + Nachname + Karteinummer Die bevorzugte Variante Dabei werden von einem Autor oder einem Uumlbersetzer der Vorname der Nachname und die VG WORT Karteinummer gemeldet Eine Meldung mit Schreibweisen oder Pseudonymen ist auch moumlglich wenn diese der VG WORT bekannt sind Der Vorteil an dieser Variante ist dass ein Autor somit bei der VG WORT eindeutig identifizierbar ist und der Verlag somit keine weiteren Schritte unternehmen muss damit der jeweilige Autor zu seiner Ausschuumlttung kommt
Diese Variante beinhaltet fuumlr den Verlag zwar einen Initialaufwand da die Karteinummern aller Autoren eingesammelt werden muumlssen in der Praxis hat sich diese Variante bei den meisten teilnehmenden Verlagen aber als die einfachste Variante erwiesen
Vorname + Nachname Wenn von einem Autor die VG WORT Karteinummer nicht bekannt ist kann der Autor auch uumlber den Vornamen und den Nachnamen gemeldet werden Den Autoren steht fuumlr das Auffinden der ausschuumlttungsrelevanten Meldungen eine Suchmaske zur Verfuumlgung Allerdings muss in diesem Fall der gemeldete Name exakt mit dem uumlbereinstimmen der im Datenbestand der VG WORT vorliegt
Ist der Vorname nicht vollstaumlndig bekannt kann er in der Variante erster Buchstabe des Vornamens + Punkt angegeben werden
Urheber ohne Wahrnehmungsvertrag Hat der Urheber des zu meldenden Werkes dem meldenden Verlag fuumlr dieses Werk die von der VG WORT wahrgenommenen gesetzlichen Verguumltungsanspruumlche nach dem Urheberrechtsgesetz abgetreten kann dieser Urheber mit Namen Geburtsdatum und Adresse angegeben werden Zusaumltzlich muss bestaumltigt werden dass der Urheber die Rechte uumlbertragen hat Die uumlbertragenen Rechte werden bei der Ausschuumlttung beruumlcksichtigt
Fuumlr Agenturmeldungen bei denen die Autoren nicht bekannt sind steht eine weitere Variante zur Verfuumlgung
Die Rechte koumlnnen dem Verlag erst nach der Veroumlffentlichung des Textes uumlbertragen werden Die schriftliche Rechteuumlbertragung des jeweiligen Autors muss der VG WORT jederzeit auf Anfrage zur Verfuumlgung gestellt werden
Kuumlrzel Wenn man eine Agentur melden moumlchte dann kann das aktuell uumlber diesen Weg erfolgen Als Kuumlrzel wird die Kurzbezeichnung der jeweiligen Agentur uumlbergeben (zB bdquodpaldquo)
Namentliche bekannte Urheber koumlnnen uumlber die Angabe bdquoKuumlrzelldquo nicht gemeldet werden Diese Angabe kann ausschlieszliglich fuumlr die Meldung von Agenturtexten bzw der Miturheberschaft eines nicht namentlich bekannten Agenturautoren verwendet werden
313 Kurzbeschreibung Uumlberschrift (Titel)
Der Titel des zu meldenden Artikels
314 Text
Der Text des zu meldenden Artikels (entweder als Klartext als PDF oder im EPUB Format) Benoumltigt wird der bdquoNettotextldquo (dh der Text ohne HTML Code und ohne Menuuml oder dergleichen)
315 Erscheinungsorte (Webbereiche)
Es muumlssen alle Erscheinungsorte des Texts auf denen die Zaumlhlmarke eingebaut wurde gemeldet werden Ein Erscheinungsort definiert sich aus allen URLs die benoumltigt werden um den gesamten Text einmal zu lesen
Beispiel 1 Ein Text der sich uumlber 2 URLs erstreckt muss mit einem Webbereich (mit 2 URLs) gemel-det werden (zB httpdomain1depage1html httpdomain1depage2html)
Beispiel 2 Ein Text der sich uumlber 1 URL erstreckt aber auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils einer URL) gemeldet werden (zB httpdomain1demytexthtml und httpdomain2demytexthtml)
Beispiel 3 Ein Text der sich uumlber 2 URLs erstreckt und auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils zwei URLs) gemeldet werden (zB httpdomain1depage1html httpdomain1depage2html und httpdomain2depage1html httpdomain2depage2html)
32 Meldung uumlbermitteln
321 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
bull Es sollen nur Texte gemeldet werden die bereits bdquostabilldquo sind (dh die sich nicht mehr haumlufig aumlndern) Aus diesem Grund wird empfohlen die Texte mit einer Zeitverzoumlgerung von einigen Tagen (zB 14 Tagen) zu melden Auf die Tantieme hat das keinen Einfluss da die Ausschuumlttung erst Ende September Anfang Oktober fuumlr das Vorjahr erfolgt
bull Die Meldungen sollen taumlglich in der Nacht uumlbertragen werden Zeitfenster 2200 ndash 0300 Von 0300 bis 0600 gibt es ein allgemeines Wartungsfenster wo nicht gemeldet werden kann
bull Um eine Uumlberlastung der Server (und somit houmlhere Wartezeit) zu verhindern sollen die Meldungen sequentiell (nicht parallel) uumlbertragen werden Idealerweise soll zwischen zwei Meldungen eine Sekunde verstreichen Aus transaktionaler Sicht wird jede Meldung einzeln behandelt Dh jede erfolgreich eingehende Meldung wird gespeichert ndash unabhaumlngig davon ob die vorherige oder nachfolgende Meldung einen Fehler verursacht hat
bull Alle fachlichen Fehlercodes (ein- oder zweistellig) deuten auf einen Fehler in der Meldung hin Es ist zwecklos diese Meldung unveraumlndert noch einmal abzusenden Dreistellige Fehler (sowie der HTML ndash 500 Fehler) deuten auf technische Probleme hin Hier ist es zweckmaumlszligig dieselben Meldungen zu einem spaumlteren Zeitpunkt (zB mit den Meldungen vom naumlchsten Tag) noch einmal zu uumlbertragen
bull Die Bestaumltigung der Meldung bedeutet dass die Meldung aus technischer Sicht in Ordnung ist (dh Mindestumfang von 1800 Zeichen die Zaumlhlmarke existiert hellip) In einer spaumlteren Phase werden die Meldungen noch durch automatische Pruumlfmechanismen der VG WORT in Stichproben gepruumlft Sollten dabei Maumlngel auftreten werden die betreffenden Meldungen zuruumlckgewiesen und der Inhaber des Meldekontos bei der VG WORT wird per Email verstaumlndigt Diese Meldungen koumlnnen dann im Portal entweder geloumlscht oder manuell nachbearbeitet und erneut versendet werden
3212 newMessageRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der private
Identifikationscode (bei VG WORT Zaumlhlmarken) oder der
verlagsinterne Schluumlssel
Parties Parties Die Urheber Uumlbersetzer Agenturen der Meldung Es muss mindestens ein Autor oder ein Uumlbersetzer angegeben werden
Es koumlnnen in einer Meldung sowohl Autoren als auch
Uumlbersetzer angegeben werden
partiesauthors Authors 0 bis mehrere Autoren Beschreibung siehe separate Tabelle
partiestranslators Translators 0 bis mehrere Uumlbersetzer Beschreibung siehe separate
Tabelle
messagetext MessageText Der gemeldete Text entweder als PDF EPUB oder als Klartext
messagetextshorttext string Kurzbezeichnung Uumlberschrift vom Text
messagetexttext Text Der Text an sich Beschreibung siehe separate Tabelle
messagetextlyric boolean bdquoTrueldquo wenn es sich beim Text um Lyrik handelt ansonsten
bdquoFalseldquo
webranges Webranges Erscheinungsort(e) unter demdenen der Text gefunden werden
kann
webrangeswebrange Webrange Ein Erscheinungsort Beschreibung siehe separate Tabelle
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
1 Einleitung Dieses Dokument dient als Beschreibung fuumlr Verlage die am METIS Verfahren teilnehmen wollen Es beinhaltet sowohl die generelle Verfahrensbeschreibung wie auch die technische Beschreibung der eingesetzten Schnittstellen Es basiert auf langjaumlhriger Erfahrung dadurch sind bereits Erfahrungswerte sowie Probleme bei vergangenen Integrationen eingeflossen
Um an METIS teilnehmen zu koumlnnen ist eine einmalige Meldesystemregistrierung unter httptomvgwortde noumltig
11 Voraussetzung fuumlr die Verguumltung von Texten
Bei METIS wird die Zweitverwertung von Texten im Internet verguumltet (dh Kopien die von den im Internet zur Verfuumlgung gestellten Texten angefertigt werden) Aus diesem Grund werden Texte ausgeschlossen die einen technischen Kopierschutz enthalten
Da es nicht moumlglich ist den technischen Kopiervorgang festzustellen trifft die VG WORT die Annahme dass es einen Zusammenhang zwischen der Nutzung und der Zweitverwertung von einem Text gibt Dh man geht davon aus dass Texte die haumlufig gelesen werden auch haumlufig kopiert werden Aus diesem Grund muumlssen die Texte im Rahmen eines Zaumlhlverfahrens individuell gezaumlhlt werden Fuumlr die Ausschuumlttung werden Texte herangezogen deren Zugriffszaumlhlung einen festgelegten Mindestzugriff erreichen Der Mindestzugriff wird von der VG WORT fuumlr ein Kalenderjahr im Januar des Folgejahres im Meldesystem festgelegt Fuumlr das Jahr 2014 musste ein Text mit einer Laumlnge unter 10000 Zeichen 1500 Visits Jahr erreichen Bei einer Textlaumlnge von zumindest 10000 Zeichen hat sich der Mindestzugriff auf 750 Visits Jahr reduziert (Anteiliger Mindestzugriff) Zaumlhlungen von Texten hinter Bezahlschranken werden ab dem Jahr 2016 mit Faktor 3 multipliziert Weiterfuumlhrende Informationen finden Sie auf der Homepage der VG WORT
- Verteilungsplan httpwwwvgwortdepublikationen-dokumenteverteilungsplaenehtml (sect 58 und sect 59)
Ein weiteres Kriterium betrifft die Textlaumlnge Die Texte muumlssen eine Mindestlaumlnge von 1800 Zeichen (inkl Leerzeichen) erreichen Die Ausnahme bilden Gedichte ndash diese koumlnnen auch kuumlrzer sein
Zusammenfassung der Kriterien - Text muss im Internet veroumlffentlicht sein - Kein Kopierschutz (hartes DRM) - Mindestlaumlnge 1800 Zeichen (ausgenommen Lyrik) - Der festgelegte Mindestzugriff muss erreicht werden
12 Houmlhe der Tantieme
Die Houmlhe der Tantieme wird von der VG WORT fuumlr ein Kalenderjahr im Nachhinein (Mai Juni) festgelegt Die Tantieme besteht aus einem Verlagsanteil und einem Autorenanteil Die aktuellen Tantiemen und Modalitaumlten finden Sie in der Quotenuumlbersicht auf der Homepage der VG WORT unter httpwwwvgwortdepublikationen-dokumentequoten-uebersichthtml (Abschnitt bdquoMETISldquo)
Zu beachten ist dass die Houmlhe der Tantieme pro Text angegeben ist der die oben genannten Voraussetzungen erfuumlllt Dadurch sollten sich bei Verlagen die pro Jahr einige hundert oder tausend solcher Texte veroumlffentlichen die Investitionskosten rasch amortisieren
Um eine Tantieme zu erhalten sind pro Text nur drei Schritte noumltig
1) Zugriffszaumlhlung
2) Meldung uumlbermitteln
3) Ausschuumlttung erhalten
Die Grundlage fuumlr die Ausschuumlttung bilden die Zugriffszahlen daher ist es wichtig so schnell und so vollstaumlndig wie moumlglich mit der Zugriffszaumlhlung zu beginnen (siehe Kapitel bdquo2 Zugriffszaumlhlungldquo) Fuumlr eine spaumltere Meldung muss die dabei vergebene Zaumlhlmarke intern mit dem Text verknuumlpft werden Jeder Text muss dabei mit einer eigenen Zaumlhlmarke versehen werden
Der zweite Schritt ist die Uumlbermittlung der Meldung (siehe Kapitel bdquo3 Meldungldquo) Dabei wird der Text die Veroumlffentlichungsorte (URLs) sowie alle beteiligten Autoren und Uumlbersetzer an die VG WORT gemeldet
Nach Erstellung der Meldung pruumlft die VG WORT bei jedem Text ob er den Kriterien fuumlr die Ausschuumlttung entspricht Ist das der Fall erfolgt automatisch die Ausschuumlttung
14 Technische Grundlagen
Jeder beschriebene Schritt laumlsst sich manuell uumlber Meldemasken oder automatisiert uumlber Web Service Schnittstellen bedienen Die manuelle Variante ist fuumlr kleinere Verlage empfohlen (bis ca 100 Texte Jahr) Ansonsten empfiehlt sich eine vollautomatische Integration uumlber die Schnittstellen
2 Zugriffszaumlhlung Fuumlr die Zugriffszaumlhlung wird das bdquoskalierbare zentrale Messsystemldquo dass auch fuumlr die Werbewirtschaft (IVW) eingesetzt wird verwendet Dabei werden in HTML Seiten unsichtbare Bilder (Zaumlhlmarken) eingebaut die zu Zugriffszaumlhlungen fuumlhren
Die Zugriffszaumlhlung bildet die Basis fuumlr eine moumlgliche Ausschuumlttung Aus diesem Grund muss darauf geachtet werden moumlglichst alle Texte die fuumlr die Ausschuumlttung in Frage kommen zu zaumlhlen
Viele Artikel haben am Erscheinungstag die meisten Zugriffe Achten Sie unbedingt darauf dass Sie die Artikel sofort beim Erscheinen mit einer Zaumlhlmarke versehen da ansonsten moumlglicherweise der festgelegte Mindestzugriff nicht mehr erreicht werden kann
Bei den bisher teilnehmenden Verlagen hat es sich bewaumlhrt als Erstes mit der Zaumlhlung von neu erscheinenden Artikeln zu beginnen Erst sobald das reibungslos automatisiert funktioniert sollte man sich die Frage stellen ob man aumlltere Artikel (zB Archiv hellip) nachtraumlglich mit Zaumlhlmarken ausstatten moumlchte Eine Empfehlung dafuumlr oder dagegen kann man generell nicht aussprechen da es davon abhaumlngt wie stark solche Archivinhalte genutzt werden Das sollte im Verlag anhand von Kosten Nutzen entschieden werden
21 Grundsaumltzliches zu Zaumlhlmarken
211 Zaumlhlmarken der VG WORT
Jede Zaumlhlmarke besteht aus zwei Teilen (oumlffentlicher Identifikationscode privater Identifikationscode) Der oumlf fentliche Identifikationscode dient zum Einbau in die jeweilige HTML ndash Seite (siehe Kapitel 23 Einbau einer Zaumlhlmarke) Der private Identifikationscode wird spaumlter im Rahmen der Meldung benoumltigt
Aus diesem Grund muss der private Identifikationscode in Ihrem CMS System mit dem Artikel verknuumlpft werden
212 Verlagsinterner Schluumlssel als Zaumlhlmarke
In Verlagen werden die Artikel oftmals mit eindeutigen internen Schluumlsseln versehen Diese internen Schluumlssel koumlnnen ebenfalls als Zaumlhlmarke verwendet werden In diesem Fall wird sowohl fuumlr den oumlf fentlichen als auch fuumlr den privaten Identifikationscode der verlagsinterne Schluumlssel verwendet
Dabei gibt es folgendes zu beachten
- Ein verlagsinterner Schluumlssel setzt sich aus dem Praumlfix bdquovgzmltKarteinummergt-ldquo und einen beliebigen Schluumlssel zusammen Der Platzhalter bdquoltKarteinummergtldquo muss mit der VGWORT Karteinummer des Verlags ersetzt werden
- Der Schluumlssel darf keine Sonderzeichen enthalten (dh nur [a-z][A-Z][0-9] sowie den Punkt den Bindestrich und den Unterstrich)
- Der Schluumlssel muss innerhalb vom Verlag eindeutig sein
- DOI (httpwwwdoiorg) koumlnnen ebenfalls als verlagsinterne Schluumlssel zum Einsatz kommen Der Slash nach der Verlagskennung muss durch einen Bindestrich (-) ersetzt werden Es duumlrfen im DOI auch keine weiteren Slashes vorkommen
Beispiel vgzm970-123456789
Bitte setzen Sie sich vor Verwendung von verlagsinternen Schluumlsseln als Zaumlhlmarke unbedingt mit der VG WORT in Verbindung (per Email an metissupportvgwortde) Sie erhalten dann eine Zaumlhldomaumlne die Sie fuumlr den Einbau der Zaumlhlmarken benoumltigen und Sie werden fuumlr die Zugriffszaumlhlung mit verlagsinternen Schluumlsseln freigeschalten Ohne diese Schritte ist keine Zaumlhlung mit verlagsinternen Schluumlsseln moumlglich
Es empfiehlt sich zuerst die Zugriffszaumlhlung umzusetzen und erst dann die Meldung (siehe Kapitel 3) zu implementieren
Zum Zeitpunkt der Zugriffszaumlhlung muumlssen noch nicht alle Informationen zum Text (zB Autoreninformation) vorliegen Daher soll die Umsetzung der Zugriffszaumlhlung auf keinen Fall von solchen Faktoren abhaumlngen
214 Datenschutzerklaumlrung
Im Rahmen der Zugriffszaumlhlung werden Cookies und gegebenenfalls JavaScript - Aufrufe verwendet Es empfiehlt sich daher die Datenschutzerklaumlrung der Verlagsseite in der Zaumlhlmarken eingebaut werden um unten stehende Textbausteine zu ergaumlnzen
Cookies und Meldungen zu Zugriffszahlen
Wir setzen Session-Cookies der VG Wort Muumlnchen zur Messung von Zugriffen auf Texten ein um die Kopierwahrscheinlichkeit zu erfassen Session-Cookies sind kleine Informationseinheiten die ein Anbieter im Arbeitsspeicher des Computers des Besuchers speichert In einem Session-Cook ie wird eine zufaumlllig erzeugte eindeutige Identif ikationsnummer abgelegt eine sogenannte Session-ID Auszligerdem enthaumllt ein Cookie die Angabe uumlber seine Herkunft und die Speicherfrist Session-Cookies koumlnnen keine anderen Daten speichern Diese Messungen werden von der Kantar Germany GmbH nach dem Skalierbaren Zentralen Messverfahren (SZM) durchgefuumlhrt Sie helfen dabei die Kopierwahrscheinlichkeit einzelner Texte zur Verguumltung von gesetzlichen Anspruumlchen von Autoren und Verlagen zu ermitteln Wir erfassen keine personenbezogenen Daten uumlber Cookies
Viele unserer Seiten sind mit JavaScript-Aufrufen versehen uumlber die wir die Zugrif fe an die Verwertungsgesellschaft Wort (VG Wort) melden [BITTE UumlBERPRUumlFEN ob dies bei Ihrem Verlag der Fall ist] Wir ermoumlglichen damit dass unsere Autoren an den Ausschuumlttungen der VG Wort partizipieren die die gesetzliche Verguumltung fuumlr die Nutzungen urheberrechtlich geschuumltzter Werke gem sect 53 UrhG sicherstellen
Eine Nutzung unserer Angebote ist auch ohne Cookies moumlglich Die meisten Browser sind so eingestellt dass sie Cookies automatisch akzeptieren Sie koumlnnen das Speichern von Cookies jedoch deaktivieren oder Ihren Browser so einstellen dass er Sie benachrichtigt sobald Cookies gesendet werden
Datenschutzerklaumlrung zur Nutzung des Skalierbaren Zentralen Messverfahrens
Webangebote
Unsere Website und unser mobiles Webangebot nutzen das bdquoSkalierbare Zent rale Messverfahrenldquo (SZM) der Kantar Germany GmbH fuumlr die Ermittlung statistischer Kennwerte zur Ermittlung der Kopierwahrscheinlichkeit von Texten
Dabei werden anonyme Messwerte erhoben Die Zugrif fszahlenmessung verwendet zur Wiedererkennung von Computersystemen alternativ ein Session-Cookie oder eine Signatur die aus verschiedenen automatisch uumlbertragenen Informationen Ihres Browsers ers tel l t wird IP-Adressen werden nur in anonymisierter Form verarbeitet
Das Verfahren wurde unter der Beachtung des Datenschutzes entwickelt Einziges Ziel des Verfahrens ist es die Kopierwahrscheinlichkeit einzelner Texte zu ermitteln
Zu keinem Zeitpunkt werden einzelne Nutzer identifiziert Ihre Identitaumlt bleibt immer geschuumltzt Sie erhalten uumlber das System keine Werbung
22 Bestellen von Zaumlhlmarken
Verlage haben den Bedarf groszlige Mengen von Zaumlhlmarken auf einmal abzurufen um diese dann in den internen CMS Systemen vorraumltig zu halten Hierfuumlr gibt es zwei Varianten Eine Variante ist es die Zaumlhlmarken direkt aus dem Portal abzurufen bei der anderen Variante erfolgt der Abruf uumlber ein Web Service und kann so automatisiert werden
Grundsaumltzlich koumlnnen pro Jahr 4000 Zaumlhlmarken abgerufen werden Sollte ein Verlag mehr Zaumlhlmarken benoumltigen wird er gebeten sich per Email an metissupportvgwortde zu wenden damit die noumltigen Kapazitaumlten zur Verfuumlgung gestellt werden koumlnnen
Es empfiehlt sich immer einen Zaumlhlmarkenvorrat fuumlr zumindest eine Woche vorraumlt ig zu halten um nicht von der Verfuumlgbarkeit der METIS Anwendung abhaumlngig zu sein
Beim Einsatz von verlagsinternen Schluumlsseln als Zaumlhlmarken entfaumlllt die Bestellung der VG WORT Zaumlhlmarken
221 Bestellung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2211 orderPixelRequest
Feld Typ Beschreibung
count int Anzahl der zu bestellenden Zaumlhlmarken (gt1)
2212 orderPixelResponse
Feld Typ Beschreibung
orderDateTime string Bestelldatum + Zeit im Format bdquoYYYYMMddHHmmldquo
domain string Die Zaumlhlmarken Domaumlne Diese Domaumlne muss beim
Einbau dieser Zaumlhlmarken verwendet werden
pixels pixels Komplexer Datentyp
pixelspublicIdentificationId pixelIDType Oumlffentlicher Identifikationscode der Zaumlhlmarke
pixelsprivateIdentificationId pixelIDType Privater Identifikationscode der Zaumlhlmarke
2213 orderPixelFault
Feld Typ Beschreibung
errorcode int Der Fehlercode
errormsg string Grund fuumlr den Bestellabbruch
maxOrder Int Die maximale Anzahl die fuumlr die jeweilige Bestellung moumlglich gewesen
waumlre (wird nur bei Fehlercode bdquo1ldquo oder Fehlercode bdquo2ldquo angegeben)
22131 Fehlercodes
Fehlerfall Fehlercode maxOrder Meldung
MaxAnzahlBestellung 1 Die maximale Anzahl () an Zaumlhlmarken fuumlr diese
Bestellung wurde um uumlberschritten
MaxAnzahlJahr 2 Die maximale Anzahl () an Zaumlhlmarken fuumlr das
Jahr wurde um uumlberschritten
KeineEMailVorhanden 3 0 Es existiert keine Email-Adresse in Ihrem
Benutzerkonto bitte tragen Sie diese im Meldeportal
Nach Eingabe der benoumltigten Zaumlhlmarken und Klicken auf die Schaltflaumlche bdquoZaumlhlmarken bestellenldquo werden die Zaumlhlmarken vom System generiert Danach wird die Seite zum Download der eben bestellten Zaumlhlmarken angezeigt Falls mehr Zaumlhlmarken bestellt wurden als noch zur Verfuumlgung stehen kommt eine entsprechende Fehlermeldung In diesem Fall wenden Sie sich bitte per Email an metissupportvgwortde
Abbildung 2 Maskenbeschreibung Download der generierten Zaumlhlmarken
In der oben stehenden Maske befindet sich neben der Zaumlhldomaumlne auch Einbaubeispiele fuumlr HTML Texte Beim Klicken auf bdquoDownload der reinen Codepaare als CSV-Dateildquo koumlnnen die bestellten Zaumlhlmarken heruntergeladen werden Das Format der CSV Datei ist im folgenden Abschnitt beschrieben Beim Klicken auf bdquoDownload der vorkonfigurierten Zaumlhlmarken als CSV-Dateildquo wird eine Datei ausgegeben die alle Zaumlhlmarken als fertigen HTML Code enthaumllt
2221 CSV-Datei Format
Die CSV-Datei wird im folgenden Format erstellt (Die Spalten werden durch ein Semikolon getrennt)
Die Zaumlhlmarke ist ein transparentes (unsichtbares) Bild mit der Groumlszlige von 1 x 1 Pixel Es hat keinesfalls Einfluss auf die Ladezeit der Seite da Bilder von den Browsern separat zum Text geladen werden Das unsichtbare Bild hat auch keinen Einfluss auf das Erscheinungsbild der Seite
Einbaubeispiel VG WORT Zaumlhlmarke in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquoc5b7568d28884052a9ff92d5afd08f34rdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquovgzm970-123456789rdquo
Der korrekt formatierte verlagsinterne Schluumlssel des zu zaumlhlenden Textes
232 Fuumlr Dokumente (PDF oder EPUB Dateien)
Eine Zaumlhlmarke kann nicht direkt in eine dieser Dateien eingebaut werden Sie muss daher in die HTML Seite eingebaut werden von der aus das Dokument verlinkt wird Verlinkungen von anderen Seiten koumlnnen nicht beruumlcksichtigt werden Da eine Weiterleitung vom Zaumlhlserver auf externe Dateien aus sicherheitstechnischen Gruumlnden nicht angeboten werden kann benoumltigt man JavaScript um die Zugriffe auf eine PDF Datei zaumlhlen zu koumlnnen
In diesem Fall wird das Zaumlhlpixel (unsichtbare Bild) uumlber JavaScript in die HTML Seite eingefuumlgt sobald das Dokument (der Link auf das Dokument bleibt unveraumlndert) abgerufen wird
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquo98380ae3fc0a4daf84d6197274add99erdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquohttpwwwstepscondebeispielepubrdquo
Der Link auf das zu zaumlhlende Dokument
- LINK-Name
Name des Links
Auch dabei ist der Einsatz von verlagsinternen Schluumlsseln moumlglich In diesem Fall wird der korrekt formatierte verlagsinterne Schluumlssel anstelle vom oumlffentlichen Identifikationscode verwendet Auf ein separates Einbaubeispiel wird in diesem Dokument verzichtet
233 Base64url enkodierte Zaumlhlmarken
Die verwendbaren Zeichen in einer Zaumlhlmarke sind stark beschraumlnkt (siehe oben) Sollten verlagsinterne Schluumlssel mit nicht erlaubten Zeichen zum Einsatz kommen kann die Zaumlhlmarke Base64url (Codepage UTF-8) enkodiert werden In diesem Fall wird die encodierte Zaumlhlmarke mit Praumlf ix bdquobase64-ldquo eingebaut
Zum Thema Base64url Die Zeichen + und werden nach der Base64-Enkodierung durch - (Minus ASCII 2Dhex) und _ (Unterstrich ASCII 5Fhex) ersetzt
Einbaubeispiel verlagsinterner Schluumlssel in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Zugriffe von Texten hinter Bezahlschranken werden mit Faktor 3 multipliziert Die Aufwertung der Zaumlhlwerte hinter Bezahlschranken erfolgt mittels einer gesonderten Zaumlhlung Hierfuumlr muss der Verlag die Zaumlhlmarke beim Einbau mit einem Praumlfix versehen Dieses Praumlfix darf nur fuumlr Texte hinter Bezahlschranken verwendet werden Ist der Text frei zugaumlnglich wird die Zaumlhlmarke wie bisher (ohne Praumlf ix) eingebaut Aufgrund des Praumlfixes kann unterschieden werden ob ein Text hinter einer Bezahlschranke ist oder nicht
Um Texte hinter Bezahlschranken melden zu koumlnnen muumlssen Sie fuumlr die VG WORT zuerst einen kostenfreien Zugang auf diese Texte einrichten Dies ist uumlber die Angabe von Zugangsdaten oder uumlber die Freischaltung von IP Adressen moumlglich (im TOM Menuuml unter Zugriff auf zugangsbeschraumlnkte Inhalte erlauben)
Das Praumlf ix lautet bdquopw-ldquo bdquopwldquo steht fuumlr den englischen Begriff bdquoPaywallldquo (Bezahlschranke)
In der Vergangenheit musste bei Zaumlhlungen von https- Seiten eine separate Zaumlhldomaumlne verwendet werden Wenn Sie die Zaumlhlungen uumlber diese separate Domaumlne eingebaut haben muumlssen Sie den Einbau nicht aumlndern Diese Variante wird weiterhin unterstuumltzt
236 Potenzielle Fehlerquelle Referrer-Tag
Bestimmte Einstellungen im Quellcode koumlnnen dazu fuumlhren dass Zaumlhlungen nicht mehr zugeordnet werden koumlnnen wenn die Meldungen eingehen Es sieht dann so aus als waumlren d ie Zaumlhlungen zu einem Text falsch (zB nur uumlber eine Startseite ohne den eigentlichen Text) erfolgt Das kann dazu fuumlhren dass diese Zaumlhlungen gestrichen werden und der Mindestzugriff nicht mehr gegeben is t Um solche Probleme zu vermeiden muumlssen Sie darauf achten wie das Referrer-Metatag im Quellcode Ihrer Seite eingestellt ist
Die Zeile ltmeta name=referrer content=origingt sorgt zB dafuumlr dass eine Seite die httpswwwbeispieldemein_texthtml heiszligt nur httpswwwbeispielde sendet Damit lassen s ich dann die Zugriffe nicht mehr der richtigen Seite zuordnen
Bei weiteren Einstellungen wird das Senden der Daten vollstaumlndig unterdruumlckt Auch dies kann dazu fuumlhren dass Zaumlhlungen nicht anerkannt werden wenn weitere Faktoren darauf hindeuten dass die Zaumlhlungen nicht korrekt sein koumlnnten
Nur bei den Einstellungen ltmeta name=referrer content=no-referrer-when-downgradeldquogt oder ltmeta name=referrer content=unsafe-urlgt kann man auf gezaumlhlten Seiten 100 sicher sein dass keine Meldungen wegen nicht nachvollziehbarer Zugriffszaumlhlungen abgewiesen werden
Diese Funktion ist in bestimmten Faumlllen hoch problematisch und in anderen Faumlllen sogar zwingend erforderlich
Die Verwendung von bdquoLazy Loadldquo ist immer zu vermeiden wenn sich auf einer URL nur ein Text oder nur ein Teil eines mehrseitigen Textes befindet Hier fuumlhrt die Funktion dazu dass die Zaumlhlmarken erst geladen werden wenn die Stelle mit der Zaumlhlmarke im Browser angezeigt wird Insbesondere wenn die Zaumlhlmarke am Ende der Seite oder des Textes eingebaut wird sorgt die Funkt ion dafuumlr dass unser Zaumlhlbild nur geladen wird wenn der Leser auch an der Stelle ankommt also zB bis ganz ans Ende der Seite oder des Textes scrollt Erreicht er die Stelle nicht weil die Zaumlhlmarke zB erst unterhalb der Seite und nach Werbeeinblendungen oder Kommentaren eingebaut ist dann wird das Bild auch nicht vom Zaumlhlserver abgerufen und es erfolgt somit auch KEINE Zaumlhlung
Anders sieht es hingegen aus wenn sich viele Texte auf einer Seite befinden oder weitere Texte automatisch eingeblendet werden sobald ein Leser das Textende des ersten Textes erreicht hat Da nicht automatisch davon ausgegangen werden kann dass Texte die vom jeweil igen Nutzer nicht gesucht wurden eine Kopierwahrscheinlichkeit haben darf in diesen Faumlllen die Zaumlhlung nur erfolgen wenn der Text tatsaumlchlich ausgewaumlhlt wird Dies kann mit Hilfe von Lazy load erreicht werden Dazu baut man die jeweilige Zaumlhlmarke am besten immer ab der Mitte eines Textes ein so dass einerseits sichergestellt ist dass gezaumlhlt wird und andererseits dass nur eine Zaumlhlung erfolgt wenn wirklich ein bestimmter Text angesehen wurde und damit die notwendige Kopierwahrscheinlichkeit gegeben ist
24 Uumlberpruumlfen der Zaumlhlungen
241 Anzeige Herunterladen in der Anwendung
In der Anwendung gibt es eine Funktionalitaumlt mit der man pruumlfen kann welche Zaumlhlmarken bereits gezaumlhlt werden bzw welche Zaumlhlmarken die Mindestzugriffe uumlberschritten haben Dadurch kann man feststellen ob der Einbau dieser Zaumlhlmarken korrekt ist Diese Funktionalitaumlt kann uumlber den Menuumlpunkt bdquoZaumlhlmarkenuumlbersichtldquo abgerufen werden Siehe Abbildung unten
Abbildung 3 Maskenbeschreibung Zaumlhlerstarts
Dabei gibt es folgende Filtermoumlglichkeiten
- bdquoIdentif ikationscodeldquo Der oumlffentliche bzw private Identifikationscode oder der verlagsinterne Schluumlssel der Zaumlhlmarke
- bdquoBestelldatum (von bis)ldquo Bestelldatum der Zaumlhlmarke
- bdquoMeldung erfolgtldquo Es werden nur Zaumlhlmarken angezeigt fuumlr die bereits eine Meldung vorliegt
- bdquoZaumlhlerstart erfolgtldquo Alle Zaumlhlmarken die gezaumlhlt werden
- bdquoMindestzugriffldquo Alle Zaumlhlmarken die den Mindestzugriff oder den anteiligen Mindestzugriff uumlberschritten haben
- bdquoin Ausgeblendete Zaumlhlmarken suchenldquo Es werden auch Zaumlhlmarken gesucht die uumlber die angebotene Funktionalitaumlt ausgeblendet wurden Zaumlhlmarken sollten ausgeblendet werden wenn diese in Texten eingebaut wurden die den Kriterien der VG WORT nicht entsprechen (zB zu kurze Texte) Ansonsten scheinen diese Zaumlhlmarken weiterhin staumlndig in der Suchergebnisliste auf
Die Filtermoumlglichkeiten fuumlr den Mindestzugriff greifen sobald die ersten Zaumlhldaten fuumlr ein Kalenderjahr vorliegen Allerdings ist die Anzeige fuumlr das laufende Jahr unter Vorbehalt und erfolgt auf der Basis
des letzten bekannten Mindestzugriffes Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald der Mindestzugriff zu einem Jahr im Meldesystem eingegeben wurde (immer im Januar des Folgejahres)
Die Zaumlhlmarken koumlnnen zusaumltzlich als Liste im CSV Format heruntergeladen werden
Der Zaumlhlerstart wird mit einer Verzoumlgerung von ca 4 Tagen angezeigt Dh wenn eine Zaumlhlmarke heute eingebaut wird scheint diese in der Statistik erst in ca 4 Tagen auf
Es empfiehlt sich testweise einige wenige Zaumlhlmarken einzubauen und zu pruumlfen ob die Zaumlhlungen korrekt gestartet werden bevor man den Einbau der Zaumlhlmarken auf das gesamte Internetangebot ausrollt
242 Abruf uumlber Web Service Schnittstelle
Im Gegensatz zur Maske (siehe oben) kann man uumlber das Web Service nur die Zaumlhlmarken bdquomit Mindestzugriff ohne Meldungldquo sowie bdquomit anteiligem Mindestzugriff ohne Meldungldquo herunterladen
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2421 pixelOverviewRequest
Feld Typ Beschreibung
offset Int Wiederaufsetzpunkt Das System returniert maximal 100 Zaumlhlmarken am Stuumlck
Falls es mehr Zaumlhlmarken gibt die die Kriterien erfuumlllen koumlnnen weitere
Zaumlhlmarken uumlber den offset ausgelesen werden
Beispiel (190 Zaumlhlmarken vorhanden)
1 Abfrage (offset = 0) Die Zaumlhlmarken 1 ndash 100 werden zuruumlckgegeben
2 Abfrage (offset = 100) Die Zaumlhlmarken 101 ndash 190 werden zuruumlckgegeben
type Auswahl Entweder bdquoMINDESTZUGRIFFldquo oder bdquoANTEILIGER_MINDESTZUGRIFFldquo
2422 pixelOverviewResponse
Feld Typ Beschreibung
Amount Int Anzahl der gefundenen Zaumlhlmarken
Offset Int Der beim Request angegebene offset
privateIdentificationId pixelIDType (Liste) Privater Identifikationscode oder verlagsinterner Schluumlssel
3 Meldung Nachdem eine Zaumlhlmarke bestellt und eingebaut wurde kann eine Meldung zum jeweiligen Text erfolgen Eine Meldung soll dann gemacht werden wenn sich der Text des gemeldeten Artikels nicht mehr wesentlich aumlndert da die VG WORT in den Pruumlfmechanismen den gemeldeten Text mit dem Text der sich tatsaumlchlich im Internet befindet vergleicht
Der spaumlteste Zeitpunkt zum Melden eines Textes ist der sogenannte Meldeschlusstermin Diesen f inden Sie auf der Homepage der VG WORT unter bdquoTermineldquo Derzeit ist der Meldeschluss fuumlr Verlage der 1 Juni des auf die Zaumlhlung folgenden Jahres
In den meisten Faumlllen empfiehlt sich eine bdquoWartefristldquo von 14 Tagen bevor die Meldung erstellt wird So lange der Text noch Aumlnderungen unterzogen wird besteht die Gefahr dass die von der VG WORT durchgefuumlhrten Pruumlfmechanismen fehlschlagen
Bitte setzen Sie sich vor Meldungen zu Texten die uumlber verlagsinterne Schluumlssel gezaumlhlt werden unbedingt mit der VG WORT (per Email an metissupportvgwortde) in Verbindung
31 Anforderungen an die Meldung
Anbei f inden Sie alle Daten die bei einer Meldung angegeben werden muumlssen - Eindeutiger Identifikationscode - Alle beteiligten Autoren Uumlbersetzer und Agenturen - Kurzbeschreibung Uumlberschrift (Titel) - Text - Erscheinungsorte (Webbereiche)
311 Eindeutiger Identifikationscode
Der Identif ikationscode zur Zaumlhlmarke die in den Text eingebaut wurde Je nachdem welche Zaumlhlmarke verwendet wird ist dies der private Identifikationscode (bei VG WORT Zaumlhlmarken) oder der verlagsinterne Schluumlssel
312 Alle beteiligten Autoren Uumlbersetzer und Agenturen
Alle die am Text beteiligt sind Es gibt drei Arten wie die Autoren undoder Uumlbersetzer gemeldet werden
Vorname + Nachname + Karteinummer Die bevorzugte Variante Dabei werden von einem Autor oder einem Uumlbersetzer der Vorname der Nachname und die VG WORT Karteinummer gemeldet Eine Meldung mit Schreibweisen oder Pseudonymen ist auch moumlglich wenn diese der VG WORT bekannt sind Der Vorteil an dieser Variante ist dass ein Autor somit bei der VG WORT eindeutig identifizierbar ist und der Verlag somit keine weiteren Schritte unternehmen muss damit der jeweilige Autor zu seiner Ausschuumlttung kommt
Diese Variante beinhaltet fuumlr den Verlag zwar einen Initialaufwand da die Karteinummern aller Autoren eingesammelt werden muumlssen in der Praxis hat sich diese Variante bei den meisten teilnehmenden Verlagen aber als die einfachste Variante erwiesen
Vorname + Nachname Wenn von einem Autor die VG WORT Karteinummer nicht bekannt ist kann der Autor auch uumlber den Vornamen und den Nachnamen gemeldet werden Den Autoren steht fuumlr das Auffinden der ausschuumlttungsrelevanten Meldungen eine Suchmaske zur Verfuumlgung Allerdings muss in diesem Fall der gemeldete Name exakt mit dem uumlbereinstimmen der im Datenbestand der VG WORT vorliegt
Ist der Vorname nicht vollstaumlndig bekannt kann er in der Variante erster Buchstabe des Vornamens + Punkt angegeben werden
Urheber ohne Wahrnehmungsvertrag Hat der Urheber des zu meldenden Werkes dem meldenden Verlag fuumlr dieses Werk die von der VG WORT wahrgenommenen gesetzlichen Verguumltungsanspruumlche nach dem Urheberrechtsgesetz abgetreten kann dieser Urheber mit Namen Geburtsdatum und Adresse angegeben werden Zusaumltzlich muss bestaumltigt werden dass der Urheber die Rechte uumlbertragen hat Die uumlbertragenen Rechte werden bei der Ausschuumlttung beruumlcksichtigt
Fuumlr Agenturmeldungen bei denen die Autoren nicht bekannt sind steht eine weitere Variante zur Verfuumlgung
Die Rechte koumlnnen dem Verlag erst nach der Veroumlffentlichung des Textes uumlbertragen werden Die schriftliche Rechteuumlbertragung des jeweiligen Autors muss der VG WORT jederzeit auf Anfrage zur Verfuumlgung gestellt werden
Kuumlrzel Wenn man eine Agentur melden moumlchte dann kann das aktuell uumlber diesen Weg erfolgen Als Kuumlrzel wird die Kurzbezeichnung der jeweiligen Agentur uumlbergeben (zB bdquodpaldquo)
Namentliche bekannte Urheber koumlnnen uumlber die Angabe bdquoKuumlrzelldquo nicht gemeldet werden Diese Angabe kann ausschlieszliglich fuumlr die Meldung von Agenturtexten bzw der Miturheberschaft eines nicht namentlich bekannten Agenturautoren verwendet werden
313 Kurzbeschreibung Uumlberschrift (Titel)
Der Titel des zu meldenden Artikels
314 Text
Der Text des zu meldenden Artikels (entweder als Klartext als PDF oder im EPUB Format) Benoumltigt wird der bdquoNettotextldquo (dh der Text ohne HTML Code und ohne Menuuml oder dergleichen)
315 Erscheinungsorte (Webbereiche)
Es muumlssen alle Erscheinungsorte des Texts auf denen die Zaumlhlmarke eingebaut wurde gemeldet werden Ein Erscheinungsort definiert sich aus allen URLs die benoumltigt werden um den gesamten Text einmal zu lesen
Beispiel 1 Ein Text der sich uumlber 2 URLs erstreckt muss mit einem Webbereich (mit 2 URLs) gemel-det werden (zB httpdomain1depage1html httpdomain1depage2html)
Beispiel 2 Ein Text der sich uumlber 1 URL erstreckt aber auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils einer URL) gemeldet werden (zB httpdomain1demytexthtml und httpdomain2demytexthtml)
Beispiel 3 Ein Text der sich uumlber 2 URLs erstreckt und auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils zwei URLs) gemeldet werden (zB httpdomain1depage1html httpdomain1depage2html und httpdomain2depage1html httpdomain2depage2html)
32 Meldung uumlbermitteln
321 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
bull Es sollen nur Texte gemeldet werden die bereits bdquostabilldquo sind (dh die sich nicht mehr haumlufig aumlndern) Aus diesem Grund wird empfohlen die Texte mit einer Zeitverzoumlgerung von einigen Tagen (zB 14 Tagen) zu melden Auf die Tantieme hat das keinen Einfluss da die Ausschuumlttung erst Ende September Anfang Oktober fuumlr das Vorjahr erfolgt
bull Die Meldungen sollen taumlglich in der Nacht uumlbertragen werden Zeitfenster 2200 ndash 0300 Von 0300 bis 0600 gibt es ein allgemeines Wartungsfenster wo nicht gemeldet werden kann
bull Um eine Uumlberlastung der Server (und somit houmlhere Wartezeit) zu verhindern sollen die Meldungen sequentiell (nicht parallel) uumlbertragen werden Idealerweise soll zwischen zwei Meldungen eine Sekunde verstreichen Aus transaktionaler Sicht wird jede Meldung einzeln behandelt Dh jede erfolgreich eingehende Meldung wird gespeichert ndash unabhaumlngig davon ob die vorherige oder nachfolgende Meldung einen Fehler verursacht hat
bull Alle fachlichen Fehlercodes (ein- oder zweistellig) deuten auf einen Fehler in der Meldung hin Es ist zwecklos diese Meldung unveraumlndert noch einmal abzusenden Dreistellige Fehler (sowie der HTML ndash 500 Fehler) deuten auf technische Probleme hin Hier ist es zweckmaumlszligig dieselben Meldungen zu einem spaumlteren Zeitpunkt (zB mit den Meldungen vom naumlchsten Tag) noch einmal zu uumlbertragen
bull Die Bestaumltigung der Meldung bedeutet dass die Meldung aus technischer Sicht in Ordnung ist (dh Mindestumfang von 1800 Zeichen die Zaumlhlmarke existiert hellip) In einer spaumlteren Phase werden die Meldungen noch durch automatische Pruumlfmechanismen der VG WORT in Stichproben gepruumlft Sollten dabei Maumlngel auftreten werden die betreffenden Meldungen zuruumlckgewiesen und der Inhaber des Meldekontos bei der VG WORT wird per Email verstaumlndigt Diese Meldungen koumlnnen dann im Portal entweder geloumlscht oder manuell nachbearbeitet und erneut versendet werden
3212 newMessageRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der private
Identifikationscode (bei VG WORT Zaumlhlmarken) oder der
verlagsinterne Schluumlssel
Parties Parties Die Urheber Uumlbersetzer Agenturen der Meldung Es muss mindestens ein Autor oder ein Uumlbersetzer angegeben werden
Es koumlnnen in einer Meldung sowohl Autoren als auch
Uumlbersetzer angegeben werden
partiesauthors Authors 0 bis mehrere Autoren Beschreibung siehe separate Tabelle
partiestranslators Translators 0 bis mehrere Uumlbersetzer Beschreibung siehe separate
Tabelle
messagetext MessageText Der gemeldete Text entweder als PDF EPUB oder als Klartext
messagetextshorttext string Kurzbezeichnung Uumlberschrift vom Text
messagetexttext Text Der Text an sich Beschreibung siehe separate Tabelle
messagetextlyric boolean bdquoTrueldquo wenn es sich beim Text um Lyrik handelt ansonsten
bdquoFalseldquo
webranges Webranges Erscheinungsort(e) unter demdenen der Text gefunden werden
kann
webrangeswebrange Webrange Ein Erscheinungsort Beschreibung siehe separate Tabelle
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
1 Einleitung Dieses Dokument dient als Beschreibung fuumlr Verlage die am METIS Verfahren teilnehmen wollen Es beinhaltet sowohl die generelle Verfahrensbeschreibung wie auch die technische Beschreibung der eingesetzten Schnittstellen Es basiert auf langjaumlhriger Erfahrung dadurch sind bereits Erfahrungswerte sowie Probleme bei vergangenen Integrationen eingeflossen
Um an METIS teilnehmen zu koumlnnen ist eine einmalige Meldesystemregistrierung unter httptomvgwortde noumltig
11 Voraussetzung fuumlr die Verguumltung von Texten
Bei METIS wird die Zweitverwertung von Texten im Internet verguumltet (dh Kopien die von den im Internet zur Verfuumlgung gestellten Texten angefertigt werden) Aus diesem Grund werden Texte ausgeschlossen die einen technischen Kopierschutz enthalten
Da es nicht moumlglich ist den technischen Kopiervorgang festzustellen trifft die VG WORT die Annahme dass es einen Zusammenhang zwischen der Nutzung und der Zweitverwertung von einem Text gibt Dh man geht davon aus dass Texte die haumlufig gelesen werden auch haumlufig kopiert werden Aus diesem Grund muumlssen die Texte im Rahmen eines Zaumlhlverfahrens individuell gezaumlhlt werden Fuumlr die Ausschuumlttung werden Texte herangezogen deren Zugriffszaumlhlung einen festgelegten Mindestzugriff erreichen Der Mindestzugriff wird von der VG WORT fuumlr ein Kalenderjahr im Januar des Folgejahres im Meldesystem festgelegt Fuumlr das Jahr 2014 musste ein Text mit einer Laumlnge unter 10000 Zeichen 1500 Visits Jahr erreichen Bei einer Textlaumlnge von zumindest 10000 Zeichen hat sich der Mindestzugriff auf 750 Visits Jahr reduziert (Anteiliger Mindestzugriff) Zaumlhlungen von Texten hinter Bezahlschranken werden ab dem Jahr 2016 mit Faktor 3 multipliziert Weiterfuumlhrende Informationen finden Sie auf der Homepage der VG WORT
- Verteilungsplan httpwwwvgwortdepublikationen-dokumenteverteilungsplaenehtml (sect 58 und sect 59)
Ein weiteres Kriterium betrifft die Textlaumlnge Die Texte muumlssen eine Mindestlaumlnge von 1800 Zeichen (inkl Leerzeichen) erreichen Die Ausnahme bilden Gedichte ndash diese koumlnnen auch kuumlrzer sein
Zusammenfassung der Kriterien - Text muss im Internet veroumlffentlicht sein - Kein Kopierschutz (hartes DRM) - Mindestlaumlnge 1800 Zeichen (ausgenommen Lyrik) - Der festgelegte Mindestzugriff muss erreicht werden
12 Houmlhe der Tantieme
Die Houmlhe der Tantieme wird von der VG WORT fuumlr ein Kalenderjahr im Nachhinein (Mai Juni) festgelegt Die Tantieme besteht aus einem Verlagsanteil und einem Autorenanteil Die aktuellen Tantiemen und Modalitaumlten finden Sie in der Quotenuumlbersicht auf der Homepage der VG WORT unter httpwwwvgwortdepublikationen-dokumentequoten-uebersichthtml (Abschnitt bdquoMETISldquo)
Zu beachten ist dass die Houmlhe der Tantieme pro Text angegeben ist der die oben genannten Voraussetzungen erfuumlllt Dadurch sollten sich bei Verlagen die pro Jahr einige hundert oder tausend solcher Texte veroumlffentlichen die Investitionskosten rasch amortisieren
Um eine Tantieme zu erhalten sind pro Text nur drei Schritte noumltig
1) Zugriffszaumlhlung
2) Meldung uumlbermitteln
3) Ausschuumlttung erhalten
Die Grundlage fuumlr die Ausschuumlttung bilden die Zugriffszahlen daher ist es wichtig so schnell und so vollstaumlndig wie moumlglich mit der Zugriffszaumlhlung zu beginnen (siehe Kapitel bdquo2 Zugriffszaumlhlungldquo) Fuumlr eine spaumltere Meldung muss die dabei vergebene Zaumlhlmarke intern mit dem Text verknuumlpft werden Jeder Text muss dabei mit einer eigenen Zaumlhlmarke versehen werden
Der zweite Schritt ist die Uumlbermittlung der Meldung (siehe Kapitel bdquo3 Meldungldquo) Dabei wird der Text die Veroumlffentlichungsorte (URLs) sowie alle beteiligten Autoren und Uumlbersetzer an die VG WORT gemeldet
Nach Erstellung der Meldung pruumlft die VG WORT bei jedem Text ob er den Kriterien fuumlr die Ausschuumlttung entspricht Ist das der Fall erfolgt automatisch die Ausschuumlttung
14 Technische Grundlagen
Jeder beschriebene Schritt laumlsst sich manuell uumlber Meldemasken oder automatisiert uumlber Web Service Schnittstellen bedienen Die manuelle Variante ist fuumlr kleinere Verlage empfohlen (bis ca 100 Texte Jahr) Ansonsten empfiehlt sich eine vollautomatische Integration uumlber die Schnittstellen
2 Zugriffszaumlhlung Fuumlr die Zugriffszaumlhlung wird das bdquoskalierbare zentrale Messsystemldquo dass auch fuumlr die Werbewirtschaft (IVW) eingesetzt wird verwendet Dabei werden in HTML Seiten unsichtbare Bilder (Zaumlhlmarken) eingebaut die zu Zugriffszaumlhlungen fuumlhren
Die Zugriffszaumlhlung bildet die Basis fuumlr eine moumlgliche Ausschuumlttung Aus diesem Grund muss darauf geachtet werden moumlglichst alle Texte die fuumlr die Ausschuumlttung in Frage kommen zu zaumlhlen
Viele Artikel haben am Erscheinungstag die meisten Zugriffe Achten Sie unbedingt darauf dass Sie die Artikel sofort beim Erscheinen mit einer Zaumlhlmarke versehen da ansonsten moumlglicherweise der festgelegte Mindestzugriff nicht mehr erreicht werden kann
Bei den bisher teilnehmenden Verlagen hat es sich bewaumlhrt als Erstes mit der Zaumlhlung von neu erscheinenden Artikeln zu beginnen Erst sobald das reibungslos automatisiert funktioniert sollte man sich die Frage stellen ob man aumlltere Artikel (zB Archiv hellip) nachtraumlglich mit Zaumlhlmarken ausstatten moumlchte Eine Empfehlung dafuumlr oder dagegen kann man generell nicht aussprechen da es davon abhaumlngt wie stark solche Archivinhalte genutzt werden Das sollte im Verlag anhand von Kosten Nutzen entschieden werden
21 Grundsaumltzliches zu Zaumlhlmarken
211 Zaumlhlmarken der VG WORT
Jede Zaumlhlmarke besteht aus zwei Teilen (oumlffentlicher Identifikationscode privater Identifikationscode) Der oumlf fentliche Identifikationscode dient zum Einbau in die jeweilige HTML ndash Seite (siehe Kapitel 23 Einbau einer Zaumlhlmarke) Der private Identifikationscode wird spaumlter im Rahmen der Meldung benoumltigt
Aus diesem Grund muss der private Identifikationscode in Ihrem CMS System mit dem Artikel verknuumlpft werden
212 Verlagsinterner Schluumlssel als Zaumlhlmarke
In Verlagen werden die Artikel oftmals mit eindeutigen internen Schluumlsseln versehen Diese internen Schluumlssel koumlnnen ebenfalls als Zaumlhlmarke verwendet werden In diesem Fall wird sowohl fuumlr den oumlf fentlichen als auch fuumlr den privaten Identifikationscode der verlagsinterne Schluumlssel verwendet
Dabei gibt es folgendes zu beachten
- Ein verlagsinterner Schluumlssel setzt sich aus dem Praumlfix bdquovgzmltKarteinummergt-ldquo und einen beliebigen Schluumlssel zusammen Der Platzhalter bdquoltKarteinummergtldquo muss mit der VGWORT Karteinummer des Verlags ersetzt werden
- Der Schluumlssel darf keine Sonderzeichen enthalten (dh nur [a-z][A-Z][0-9] sowie den Punkt den Bindestrich und den Unterstrich)
- Der Schluumlssel muss innerhalb vom Verlag eindeutig sein
- DOI (httpwwwdoiorg) koumlnnen ebenfalls als verlagsinterne Schluumlssel zum Einsatz kommen Der Slash nach der Verlagskennung muss durch einen Bindestrich (-) ersetzt werden Es duumlrfen im DOI auch keine weiteren Slashes vorkommen
Beispiel vgzm970-123456789
Bitte setzen Sie sich vor Verwendung von verlagsinternen Schluumlsseln als Zaumlhlmarke unbedingt mit der VG WORT in Verbindung (per Email an metissupportvgwortde) Sie erhalten dann eine Zaumlhldomaumlne die Sie fuumlr den Einbau der Zaumlhlmarken benoumltigen und Sie werden fuumlr die Zugriffszaumlhlung mit verlagsinternen Schluumlsseln freigeschalten Ohne diese Schritte ist keine Zaumlhlung mit verlagsinternen Schluumlsseln moumlglich
Es empfiehlt sich zuerst die Zugriffszaumlhlung umzusetzen und erst dann die Meldung (siehe Kapitel 3) zu implementieren
Zum Zeitpunkt der Zugriffszaumlhlung muumlssen noch nicht alle Informationen zum Text (zB Autoreninformation) vorliegen Daher soll die Umsetzung der Zugriffszaumlhlung auf keinen Fall von solchen Faktoren abhaumlngen
214 Datenschutzerklaumlrung
Im Rahmen der Zugriffszaumlhlung werden Cookies und gegebenenfalls JavaScript - Aufrufe verwendet Es empfiehlt sich daher die Datenschutzerklaumlrung der Verlagsseite in der Zaumlhlmarken eingebaut werden um unten stehende Textbausteine zu ergaumlnzen
Cookies und Meldungen zu Zugriffszahlen
Wir setzen Session-Cookies der VG Wort Muumlnchen zur Messung von Zugriffen auf Texten ein um die Kopierwahrscheinlichkeit zu erfassen Session-Cookies sind kleine Informationseinheiten die ein Anbieter im Arbeitsspeicher des Computers des Besuchers speichert In einem Session-Cook ie wird eine zufaumlllig erzeugte eindeutige Identif ikationsnummer abgelegt eine sogenannte Session-ID Auszligerdem enthaumllt ein Cookie die Angabe uumlber seine Herkunft und die Speicherfrist Session-Cookies koumlnnen keine anderen Daten speichern Diese Messungen werden von der Kantar Germany GmbH nach dem Skalierbaren Zentralen Messverfahren (SZM) durchgefuumlhrt Sie helfen dabei die Kopierwahrscheinlichkeit einzelner Texte zur Verguumltung von gesetzlichen Anspruumlchen von Autoren und Verlagen zu ermitteln Wir erfassen keine personenbezogenen Daten uumlber Cookies
Viele unserer Seiten sind mit JavaScript-Aufrufen versehen uumlber die wir die Zugrif fe an die Verwertungsgesellschaft Wort (VG Wort) melden [BITTE UumlBERPRUumlFEN ob dies bei Ihrem Verlag der Fall ist] Wir ermoumlglichen damit dass unsere Autoren an den Ausschuumlttungen der VG Wort partizipieren die die gesetzliche Verguumltung fuumlr die Nutzungen urheberrechtlich geschuumltzter Werke gem sect 53 UrhG sicherstellen
Eine Nutzung unserer Angebote ist auch ohne Cookies moumlglich Die meisten Browser sind so eingestellt dass sie Cookies automatisch akzeptieren Sie koumlnnen das Speichern von Cookies jedoch deaktivieren oder Ihren Browser so einstellen dass er Sie benachrichtigt sobald Cookies gesendet werden
Datenschutzerklaumlrung zur Nutzung des Skalierbaren Zentralen Messverfahrens
Webangebote
Unsere Website und unser mobiles Webangebot nutzen das bdquoSkalierbare Zent rale Messverfahrenldquo (SZM) der Kantar Germany GmbH fuumlr die Ermittlung statistischer Kennwerte zur Ermittlung der Kopierwahrscheinlichkeit von Texten
Dabei werden anonyme Messwerte erhoben Die Zugrif fszahlenmessung verwendet zur Wiedererkennung von Computersystemen alternativ ein Session-Cookie oder eine Signatur die aus verschiedenen automatisch uumlbertragenen Informationen Ihres Browsers ers tel l t wird IP-Adressen werden nur in anonymisierter Form verarbeitet
Das Verfahren wurde unter der Beachtung des Datenschutzes entwickelt Einziges Ziel des Verfahrens ist es die Kopierwahrscheinlichkeit einzelner Texte zu ermitteln
Zu keinem Zeitpunkt werden einzelne Nutzer identifiziert Ihre Identitaumlt bleibt immer geschuumltzt Sie erhalten uumlber das System keine Werbung
22 Bestellen von Zaumlhlmarken
Verlage haben den Bedarf groszlige Mengen von Zaumlhlmarken auf einmal abzurufen um diese dann in den internen CMS Systemen vorraumltig zu halten Hierfuumlr gibt es zwei Varianten Eine Variante ist es die Zaumlhlmarken direkt aus dem Portal abzurufen bei der anderen Variante erfolgt der Abruf uumlber ein Web Service und kann so automatisiert werden
Grundsaumltzlich koumlnnen pro Jahr 4000 Zaumlhlmarken abgerufen werden Sollte ein Verlag mehr Zaumlhlmarken benoumltigen wird er gebeten sich per Email an metissupportvgwortde zu wenden damit die noumltigen Kapazitaumlten zur Verfuumlgung gestellt werden koumlnnen
Es empfiehlt sich immer einen Zaumlhlmarkenvorrat fuumlr zumindest eine Woche vorraumlt ig zu halten um nicht von der Verfuumlgbarkeit der METIS Anwendung abhaumlngig zu sein
Beim Einsatz von verlagsinternen Schluumlsseln als Zaumlhlmarken entfaumlllt die Bestellung der VG WORT Zaumlhlmarken
221 Bestellung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2211 orderPixelRequest
Feld Typ Beschreibung
count int Anzahl der zu bestellenden Zaumlhlmarken (gt1)
2212 orderPixelResponse
Feld Typ Beschreibung
orderDateTime string Bestelldatum + Zeit im Format bdquoYYYYMMddHHmmldquo
domain string Die Zaumlhlmarken Domaumlne Diese Domaumlne muss beim
Einbau dieser Zaumlhlmarken verwendet werden
pixels pixels Komplexer Datentyp
pixelspublicIdentificationId pixelIDType Oumlffentlicher Identifikationscode der Zaumlhlmarke
pixelsprivateIdentificationId pixelIDType Privater Identifikationscode der Zaumlhlmarke
2213 orderPixelFault
Feld Typ Beschreibung
errorcode int Der Fehlercode
errormsg string Grund fuumlr den Bestellabbruch
maxOrder Int Die maximale Anzahl die fuumlr die jeweilige Bestellung moumlglich gewesen
waumlre (wird nur bei Fehlercode bdquo1ldquo oder Fehlercode bdquo2ldquo angegeben)
22131 Fehlercodes
Fehlerfall Fehlercode maxOrder Meldung
MaxAnzahlBestellung 1 Die maximale Anzahl () an Zaumlhlmarken fuumlr diese
Bestellung wurde um uumlberschritten
MaxAnzahlJahr 2 Die maximale Anzahl () an Zaumlhlmarken fuumlr das
Jahr wurde um uumlberschritten
KeineEMailVorhanden 3 0 Es existiert keine Email-Adresse in Ihrem
Benutzerkonto bitte tragen Sie diese im Meldeportal
Nach Eingabe der benoumltigten Zaumlhlmarken und Klicken auf die Schaltflaumlche bdquoZaumlhlmarken bestellenldquo werden die Zaumlhlmarken vom System generiert Danach wird die Seite zum Download der eben bestellten Zaumlhlmarken angezeigt Falls mehr Zaumlhlmarken bestellt wurden als noch zur Verfuumlgung stehen kommt eine entsprechende Fehlermeldung In diesem Fall wenden Sie sich bitte per Email an metissupportvgwortde
Abbildung 2 Maskenbeschreibung Download der generierten Zaumlhlmarken
In der oben stehenden Maske befindet sich neben der Zaumlhldomaumlne auch Einbaubeispiele fuumlr HTML Texte Beim Klicken auf bdquoDownload der reinen Codepaare als CSV-Dateildquo koumlnnen die bestellten Zaumlhlmarken heruntergeladen werden Das Format der CSV Datei ist im folgenden Abschnitt beschrieben Beim Klicken auf bdquoDownload der vorkonfigurierten Zaumlhlmarken als CSV-Dateildquo wird eine Datei ausgegeben die alle Zaumlhlmarken als fertigen HTML Code enthaumllt
2221 CSV-Datei Format
Die CSV-Datei wird im folgenden Format erstellt (Die Spalten werden durch ein Semikolon getrennt)
Die Zaumlhlmarke ist ein transparentes (unsichtbares) Bild mit der Groumlszlige von 1 x 1 Pixel Es hat keinesfalls Einfluss auf die Ladezeit der Seite da Bilder von den Browsern separat zum Text geladen werden Das unsichtbare Bild hat auch keinen Einfluss auf das Erscheinungsbild der Seite
Einbaubeispiel VG WORT Zaumlhlmarke in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquoc5b7568d28884052a9ff92d5afd08f34rdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquovgzm970-123456789rdquo
Der korrekt formatierte verlagsinterne Schluumlssel des zu zaumlhlenden Textes
232 Fuumlr Dokumente (PDF oder EPUB Dateien)
Eine Zaumlhlmarke kann nicht direkt in eine dieser Dateien eingebaut werden Sie muss daher in die HTML Seite eingebaut werden von der aus das Dokument verlinkt wird Verlinkungen von anderen Seiten koumlnnen nicht beruumlcksichtigt werden Da eine Weiterleitung vom Zaumlhlserver auf externe Dateien aus sicherheitstechnischen Gruumlnden nicht angeboten werden kann benoumltigt man JavaScript um die Zugriffe auf eine PDF Datei zaumlhlen zu koumlnnen
In diesem Fall wird das Zaumlhlpixel (unsichtbare Bild) uumlber JavaScript in die HTML Seite eingefuumlgt sobald das Dokument (der Link auf das Dokument bleibt unveraumlndert) abgerufen wird
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquo98380ae3fc0a4daf84d6197274add99erdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquohttpwwwstepscondebeispielepubrdquo
Der Link auf das zu zaumlhlende Dokument
- LINK-Name
Name des Links
Auch dabei ist der Einsatz von verlagsinternen Schluumlsseln moumlglich In diesem Fall wird der korrekt formatierte verlagsinterne Schluumlssel anstelle vom oumlffentlichen Identifikationscode verwendet Auf ein separates Einbaubeispiel wird in diesem Dokument verzichtet
233 Base64url enkodierte Zaumlhlmarken
Die verwendbaren Zeichen in einer Zaumlhlmarke sind stark beschraumlnkt (siehe oben) Sollten verlagsinterne Schluumlssel mit nicht erlaubten Zeichen zum Einsatz kommen kann die Zaumlhlmarke Base64url (Codepage UTF-8) enkodiert werden In diesem Fall wird die encodierte Zaumlhlmarke mit Praumlf ix bdquobase64-ldquo eingebaut
Zum Thema Base64url Die Zeichen + und werden nach der Base64-Enkodierung durch - (Minus ASCII 2Dhex) und _ (Unterstrich ASCII 5Fhex) ersetzt
Einbaubeispiel verlagsinterner Schluumlssel in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Zugriffe von Texten hinter Bezahlschranken werden mit Faktor 3 multipliziert Die Aufwertung der Zaumlhlwerte hinter Bezahlschranken erfolgt mittels einer gesonderten Zaumlhlung Hierfuumlr muss der Verlag die Zaumlhlmarke beim Einbau mit einem Praumlfix versehen Dieses Praumlfix darf nur fuumlr Texte hinter Bezahlschranken verwendet werden Ist der Text frei zugaumlnglich wird die Zaumlhlmarke wie bisher (ohne Praumlf ix) eingebaut Aufgrund des Praumlfixes kann unterschieden werden ob ein Text hinter einer Bezahlschranke ist oder nicht
Um Texte hinter Bezahlschranken melden zu koumlnnen muumlssen Sie fuumlr die VG WORT zuerst einen kostenfreien Zugang auf diese Texte einrichten Dies ist uumlber die Angabe von Zugangsdaten oder uumlber die Freischaltung von IP Adressen moumlglich (im TOM Menuuml unter Zugriff auf zugangsbeschraumlnkte Inhalte erlauben)
Das Praumlf ix lautet bdquopw-ldquo bdquopwldquo steht fuumlr den englischen Begriff bdquoPaywallldquo (Bezahlschranke)
In der Vergangenheit musste bei Zaumlhlungen von https- Seiten eine separate Zaumlhldomaumlne verwendet werden Wenn Sie die Zaumlhlungen uumlber diese separate Domaumlne eingebaut haben muumlssen Sie den Einbau nicht aumlndern Diese Variante wird weiterhin unterstuumltzt
236 Potenzielle Fehlerquelle Referrer-Tag
Bestimmte Einstellungen im Quellcode koumlnnen dazu fuumlhren dass Zaumlhlungen nicht mehr zugeordnet werden koumlnnen wenn die Meldungen eingehen Es sieht dann so aus als waumlren d ie Zaumlhlungen zu einem Text falsch (zB nur uumlber eine Startseite ohne den eigentlichen Text) erfolgt Das kann dazu fuumlhren dass diese Zaumlhlungen gestrichen werden und der Mindestzugriff nicht mehr gegeben is t Um solche Probleme zu vermeiden muumlssen Sie darauf achten wie das Referrer-Metatag im Quellcode Ihrer Seite eingestellt ist
Die Zeile ltmeta name=referrer content=origingt sorgt zB dafuumlr dass eine Seite die httpswwwbeispieldemein_texthtml heiszligt nur httpswwwbeispielde sendet Damit lassen s ich dann die Zugriffe nicht mehr der richtigen Seite zuordnen
Bei weiteren Einstellungen wird das Senden der Daten vollstaumlndig unterdruumlckt Auch dies kann dazu fuumlhren dass Zaumlhlungen nicht anerkannt werden wenn weitere Faktoren darauf hindeuten dass die Zaumlhlungen nicht korrekt sein koumlnnten
Nur bei den Einstellungen ltmeta name=referrer content=no-referrer-when-downgradeldquogt oder ltmeta name=referrer content=unsafe-urlgt kann man auf gezaumlhlten Seiten 100 sicher sein dass keine Meldungen wegen nicht nachvollziehbarer Zugriffszaumlhlungen abgewiesen werden
Diese Funktion ist in bestimmten Faumlllen hoch problematisch und in anderen Faumlllen sogar zwingend erforderlich
Die Verwendung von bdquoLazy Loadldquo ist immer zu vermeiden wenn sich auf einer URL nur ein Text oder nur ein Teil eines mehrseitigen Textes befindet Hier fuumlhrt die Funktion dazu dass die Zaumlhlmarken erst geladen werden wenn die Stelle mit der Zaumlhlmarke im Browser angezeigt wird Insbesondere wenn die Zaumlhlmarke am Ende der Seite oder des Textes eingebaut wird sorgt die Funkt ion dafuumlr dass unser Zaumlhlbild nur geladen wird wenn der Leser auch an der Stelle ankommt also zB bis ganz ans Ende der Seite oder des Textes scrollt Erreicht er die Stelle nicht weil die Zaumlhlmarke zB erst unterhalb der Seite und nach Werbeeinblendungen oder Kommentaren eingebaut ist dann wird das Bild auch nicht vom Zaumlhlserver abgerufen und es erfolgt somit auch KEINE Zaumlhlung
Anders sieht es hingegen aus wenn sich viele Texte auf einer Seite befinden oder weitere Texte automatisch eingeblendet werden sobald ein Leser das Textende des ersten Textes erreicht hat Da nicht automatisch davon ausgegangen werden kann dass Texte die vom jeweil igen Nutzer nicht gesucht wurden eine Kopierwahrscheinlichkeit haben darf in diesen Faumlllen die Zaumlhlung nur erfolgen wenn der Text tatsaumlchlich ausgewaumlhlt wird Dies kann mit Hilfe von Lazy load erreicht werden Dazu baut man die jeweilige Zaumlhlmarke am besten immer ab der Mitte eines Textes ein so dass einerseits sichergestellt ist dass gezaumlhlt wird und andererseits dass nur eine Zaumlhlung erfolgt wenn wirklich ein bestimmter Text angesehen wurde und damit die notwendige Kopierwahrscheinlichkeit gegeben ist
24 Uumlberpruumlfen der Zaumlhlungen
241 Anzeige Herunterladen in der Anwendung
In der Anwendung gibt es eine Funktionalitaumlt mit der man pruumlfen kann welche Zaumlhlmarken bereits gezaumlhlt werden bzw welche Zaumlhlmarken die Mindestzugriffe uumlberschritten haben Dadurch kann man feststellen ob der Einbau dieser Zaumlhlmarken korrekt ist Diese Funktionalitaumlt kann uumlber den Menuumlpunkt bdquoZaumlhlmarkenuumlbersichtldquo abgerufen werden Siehe Abbildung unten
Abbildung 3 Maskenbeschreibung Zaumlhlerstarts
Dabei gibt es folgende Filtermoumlglichkeiten
- bdquoIdentif ikationscodeldquo Der oumlffentliche bzw private Identifikationscode oder der verlagsinterne Schluumlssel der Zaumlhlmarke
- bdquoBestelldatum (von bis)ldquo Bestelldatum der Zaumlhlmarke
- bdquoMeldung erfolgtldquo Es werden nur Zaumlhlmarken angezeigt fuumlr die bereits eine Meldung vorliegt
- bdquoZaumlhlerstart erfolgtldquo Alle Zaumlhlmarken die gezaumlhlt werden
- bdquoMindestzugriffldquo Alle Zaumlhlmarken die den Mindestzugriff oder den anteiligen Mindestzugriff uumlberschritten haben
- bdquoin Ausgeblendete Zaumlhlmarken suchenldquo Es werden auch Zaumlhlmarken gesucht die uumlber die angebotene Funktionalitaumlt ausgeblendet wurden Zaumlhlmarken sollten ausgeblendet werden wenn diese in Texten eingebaut wurden die den Kriterien der VG WORT nicht entsprechen (zB zu kurze Texte) Ansonsten scheinen diese Zaumlhlmarken weiterhin staumlndig in der Suchergebnisliste auf
Die Filtermoumlglichkeiten fuumlr den Mindestzugriff greifen sobald die ersten Zaumlhldaten fuumlr ein Kalenderjahr vorliegen Allerdings ist die Anzeige fuumlr das laufende Jahr unter Vorbehalt und erfolgt auf der Basis
des letzten bekannten Mindestzugriffes Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald der Mindestzugriff zu einem Jahr im Meldesystem eingegeben wurde (immer im Januar des Folgejahres)
Die Zaumlhlmarken koumlnnen zusaumltzlich als Liste im CSV Format heruntergeladen werden
Der Zaumlhlerstart wird mit einer Verzoumlgerung von ca 4 Tagen angezeigt Dh wenn eine Zaumlhlmarke heute eingebaut wird scheint diese in der Statistik erst in ca 4 Tagen auf
Es empfiehlt sich testweise einige wenige Zaumlhlmarken einzubauen und zu pruumlfen ob die Zaumlhlungen korrekt gestartet werden bevor man den Einbau der Zaumlhlmarken auf das gesamte Internetangebot ausrollt
242 Abruf uumlber Web Service Schnittstelle
Im Gegensatz zur Maske (siehe oben) kann man uumlber das Web Service nur die Zaumlhlmarken bdquomit Mindestzugriff ohne Meldungldquo sowie bdquomit anteiligem Mindestzugriff ohne Meldungldquo herunterladen
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2421 pixelOverviewRequest
Feld Typ Beschreibung
offset Int Wiederaufsetzpunkt Das System returniert maximal 100 Zaumlhlmarken am Stuumlck
Falls es mehr Zaumlhlmarken gibt die die Kriterien erfuumlllen koumlnnen weitere
Zaumlhlmarken uumlber den offset ausgelesen werden
Beispiel (190 Zaumlhlmarken vorhanden)
1 Abfrage (offset = 0) Die Zaumlhlmarken 1 ndash 100 werden zuruumlckgegeben
2 Abfrage (offset = 100) Die Zaumlhlmarken 101 ndash 190 werden zuruumlckgegeben
type Auswahl Entweder bdquoMINDESTZUGRIFFldquo oder bdquoANTEILIGER_MINDESTZUGRIFFldquo
2422 pixelOverviewResponse
Feld Typ Beschreibung
Amount Int Anzahl der gefundenen Zaumlhlmarken
Offset Int Der beim Request angegebene offset
privateIdentificationId pixelIDType (Liste) Privater Identifikationscode oder verlagsinterner Schluumlssel
3 Meldung Nachdem eine Zaumlhlmarke bestellt und eingebaut wurde kann eine Meldung zum jeweiligen Text erfolgen Eine Meldung soll dann gemacht werden wenn sich der Text des gemeldeten Artikels nicht mehr wesentlich aumlndert da die VG WORT in den Pruumlfmechanismen den gemeldeten Text mit dem Text der sich tatsaumlchlich im Internet befindet vergleicht
Der spaumlteste Zeitpunkt zum Melden eines Textes ist der sogenannte Meldeschlusstermin Diesen f inden Sie auf der Homepage der VG WORT unter bdquoTermineldquo Derzeit ist der Meldeschluss fuumlr Verlage der 1 Juni des auf die Zaumlhlung folgenden Jahres
In den meisten Faumlllen empfiehlt sich eine bdquoWartefristldquo von 14 Tagen bevor die Meldung erstellt wird So lange der Text noch Aumlnderungen unterzogen wird besteht die Gefahr dass die von der VG WORT durchgefuumlhrten Pruumlfmechanismen fehlschlagen
Bitte setzen Sie sich vor Meldungen zu Texten die uumlber verlagsinterne Schluumlssel gezaumlhlt werden unbedingt mit der VG WORT (per Email an metissupportvgwortde) in Verbindung
31 Anforderungen an die Meldung
Anbei f inden Sie alle Daten die bei einer Meldung angegeben werden muumlssen - Eindeutiger Identifikationscode - Alle beteiligten Autoren Uumlbersetzer und Agenturen - Kurzbeschreibung Uumlberschrift (Titel) - Text - Erscheinungsorte (Webbereiche)
311 Eindeutiger Identifikationscode
Der Identif ikationscode zur Zaumlhlmarke die in den Text eingebaut wurde Je nachdem welche Zaumlhlmarke verwendet wird ist dies der private Identifikationscode (bei VG WORT Zaumlhlmarken) oder der verlagsinterne Schluumlssel
312 Alle beteiligten Autoren Uumlbersetzer und Agenturen
Alle die am Text beteiligt sind Es gibt drei Arten wie die Autoren undoder Uumlbersetzer gemeldet werden
Vorname + Nachname + Karteinummer Die bevorzugte Variante Dabei werden von einem Autor oder einem Uumlbersetzer der Vorname der Nachname und die VG WORT Karteinummer gemeldet Eine Meldung mit Schreibweisen oder Pseudonymen ist auch moumlglich wenn diese der VG WORT bekannt sind Der Vorteil an dieser Variante ist dass ein Autor somit bei der VG WORT eindeutig identifizierbar ist und der Verlag somit keine weiteren Schritte unternehmen muss damit der jeweilige Autor zu seiner Ausschuumlttung kommt
Diese Variante beinhaltet fuumlr den Verlag zwar einen Initialaufwand da die Karteinummern aller Autoren eingesammelt werden muumlssen in der Praxis hat sich diese Variante bei den meisten teilnehmenden Verlagen aber als die einfachste Variante erwiesen
Vorname + Nachname Wenn von einem Autor die VG WORT Karteinummer nicht bekannt ist kann der Autor auch uumlber den Vornamen und den Nachnamen gemeldet werden Den Autoren steht fuumlr das Auffinden der ausschuumlttungsrelevanten Meldungen eine Suchmaske zur Verfuumlgung Allerdings muss in diesem Fall der gemeldete Name exakt mit dem uumlbereinstimmen der im Datenbestand der VG WORT vorliegt
Ist der Vorname nicht vollstaumlndig bekannt kann er in der Variante erster Buchstabe des Vornamens + Punkt angegeben werden
Urheber ohne Wahrnehmungsvertrag Hat der Urheber des zu meldenden Werkes dem meldenden Verlag fuumlr dieses Werk die von der VG WORT wahrgenommenen gesetzlichen Verguumltungsanspruumlche nach dem Urheberrechtsgesetz abgetreten kann dieser Urheber mit Namen Geburtsdatum und Adresse angegeben werden Zusaumltzlich muss bestaumltigt werden dass der Urheber die Rechte uumlbertragen hat Die uumlbertragenen Rechte werden bei der Ausschuumlttung beruumlcksichtigt
Fuumlr Agenturmeldungen bei denen die Autoren nicht bekannt sind steht eine weitere Variante zur Verfuumlgung
Die Rechte koumlnnen dem Verlag erst nach der Veroumlffentlichung des Textes uumlbertragen werden Die schriftliche Rechteuumlbertragung des jeweiligen Autors muss der VG WORT jederzeit auf Anfrage zur Verfuumlgung gestellt werden
Kuumlrzel Wenn man eine Agentur melden moumlchte dann kann das aktuell uumlber diesen Weg erfolgen Als Kuumlrzel wird die Kurzbezeichnung der jeweiligen Agentur uumlbergeben (zB bdquodpaldquo)
Namentliche bekannte Urheber koumlnnen uumlber die Angabe bdquoKuumlrzelldquo nicht gemeldet werden Diese Angabe kann ausschlieszliglich fuumlr die Meldung von Agenturtexten bzw der Miturheberschaft eines nicht namentlich bekannten Agenturautoren verwendet werden
313 Kurzbeschreibung Uumlberschrift (Titel)
Der Titel des zu meldenden Artikels
314 Text
Der Text des zu meldenden Artikels (entweder als Klartext als PDF oder im EPUB Format) Benoumltigt wird der bdquoNettotextldquo (dh der Text ohne HTML Code und ohne Menuuml oder dergleichen)
315 Erscheinungsorte (Webbereiche)
Es muumlssen alle Erscheinungsorte des Texts auf denen die Zaumlhlmarke eingebaut wurde gemeldet werden Ein Erscheinungsort definiert sich aus allen URLs die benoumltigt werden um den gesamten Text einmal zu lesen
Beispiel 1 Ein Text der sich uumlber 2 URLs erstreckt muss mit einem Webbereich (mit 2 URLs) gemel-det werden (zB httpdomain1depage1html httpdomain1depage2html)
Beispiel 2 Ein Text der sich uumlber 1 URL erstreckt aber auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils einer URL) gemeldet werden (zB httpdomain1demytexthtml und httpdomain2demytexthtml)
Beispiel 3 Ein Text der sich uumlber 2 URLs erstreckt und auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils zwei URLs) gemeldet werden (zB httpdomain1depage1html httpdomain1depage2html und httpdomain2depage1html httpdomain2depage2html)
32 Meldung uumlbermitteln
321 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
bull Es sollen nur Texte gemeldet werden die bereits bdquostabilldquo sind (dh die sich nicht mehr haumlufig aumlndern) Aus diesem Grund wird empfohlen die Texte mit einer Zeitverzoumlgerung von einigen Tagen (zB 14 Tagen) zu melden Auf die Tantieme hat das keinen Einfluss da die Ausschuumlttung erst Ende September Anfang Oktober fuumlr das Vorjahr erfolgt
bull Die Meldungen sollen taumlglich in der Nacht uumlbertragen werden Zeitfenster 2200 ndash 0300 Von 0300 bis 0600 gibt es ein allgemeines Wartungsfenster wo nicht gemeldet werden kann
bull Um eine Uumlberlastung der Server (und somit houmlhere Wartezeit) zu verhindern sollen die Meldungen sequentiell (nicht parallel) uumlbertragen werden Idealerweise soll zwischen zwei Meldungen eine Sekunde verstreichen Aus transaktionaler Sicht wird jede Meldung einzeln behandelt Dh jede erfolgreich eingehende Meldung wird gespeichert ndash unabhaumlngig davon ob die vorherige oder nachfolgende Meldung einen Fehler verursacht hat
bull Alle fachlichen Fehlercodes (ein- oder zweistellig) deuten auf einen Fehler in der Meldung hin Es ist zwecklos diese Meldung unveraumlndert noch einmal abzusenden Dreistellige Fehler (sowie der HTML ndash 500 Fehler) deuten auf technische Probleme hin Hier ist es zweckmaumlszligig dieselben Meldungen zu einem spaumlteren Zeitpunkt (zB mit den Meldungen vom naumlchsten Tag) noch einmal zu uumlbertragen
bull Die Bestaumltigung der Meldung bedeutet dass die Meldung aus technischer Sicht in Ordnung ist (dh Mindestumfang von 1800 Zeichen die Zaumlhlmarke existiert hellip) In einer spaumlteren Phase werden die Meldungen noch durch automatische Pruumlfmechanismen der VG WORT in Stichproben gepruumlft Sollten dabei Maumlngel auftreten werden die betreffenden Meldungen zuruumlckgewiesen und der Inhaber des Meldekontos bei der VG WORT wird per Email verstaumlndigt Diese Meldungen koumlnnen dann im Portal entweder geloumlscht oder manuell nachbearbeitet und erneut versendet werden
3212 newMessageRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der private
Identifikationscode (bei VG WORT Zaumlhlmarken) oder der
verlagsinterne Schluumlssel
Parties Parties Die Urheber Uumlbersetzer Agenturen der Meldung Es muss mindestens ein Autor oder ein Uumlbersetzer angegeben werden
Es koumlnnen in einer Meldung sowohl Autoren als auch
Uumlbersetzer angegeben werden
partiesauthors Authors 0 bis mehrere Autoren Beschreibung siehe separate Tabelle
partiestranslators Translators 0 bis mehrere Uumlbersetzer Beschreibung siehe separate
Tabelle
messagetext MessageText Der gemeldete Text entweder als PDF EPUB oder als Klartext
messagetextshorttext string Kurzbezeichnung Uumlberschrift vom Text
messagetexttext Text Der Text an sich Beschreibung siehe separate Tabelle
messagetextlyric boolean bdquoTrueldquo wenn es sich beim Text um Lyrik handelt ansonsten
bdquoFalseldquo
webranges Webranges Erscheinungsort(e) unter demdenen der Text gefunden werden
kann
webrangeswebrange Webrange Ein Erscheinungsort Beschreibung siehe separate Tabelle
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Um eine Tantieme zu erhalten sind pro Text nur drei Schritte noumltig
1) Zugriffszaumlhlung
2) Meldung uumlbermitteln
3) Ausschuumlttung erhalten
Die Grundlage fuumlr die Ausschuumlttung bilden die Zugriffszahlen daher ist es wichtig so schnell und so vollstaumlndig wie moumlglich mit der Zugriffszaumlhlung zu beginnen (siehe Kapitel bdquo2 Zugriffszaumlhlungldquo) Fuumlr eine spaumltere Meldung muss die dabei vergebene Zaumlhlmarke intern mit dem Text verknuumlpft werden Jeder Text muss dabei mit einer eigenen Zaumlhlmarke versehen werden
Der zweite Schritt ist die Uumlbermittlung der Meldung (siehe Kapitel bdquo3 Meldungldquo) Dabei wird der Text die Veroumlffentlichungsorte (URLs) sowie alle beteiligten Autoren und Uumlbersetzer an die VG WORT gemeldet
Nach Erstellung der Meldung pruumlft die VG WORT bei jedem Text ob er den Kriterien fuumlr die Ausschuumlttung entspricht Ist das der Fall erfolgt automatisch die Ausschuumlttung
14 Technische Grundlagen
Jeder beschriebene Schritt laumlsst sich manuell uumlber Meldemasken oder automatisiert uumlber Web Service Schnittstellen bedienen Die manuelle Variante ist fuumlr kleinere Verlage empfohlen (bis ca 100 Texte Jahr) Ansonsten empfiehlt sich eine vollautomatische Integration uumlber die Schnittstellen
2 Zugriffszaumlhlung Fuumlr die Zugriffszaumlhlung wird das bdquoskalierbare zentrale Messsystemldquo dass auch fuumlr die Werbewirtschaft (IVW) eingesetzt wird verwendet Dabei werden in HTML Seiten unsichtbare Bilder (Zaumlhlmarken) eingebaut die zu Zugriffszaumlhlungen fuumlhren
Die Zugriffszaumlhlung bildet die Basis fuumlr eine moumlgliche Ausschuumlttung Aus diesem Grund muss darauf geachtet werden moumlglichst alle Texte die fuumlr die Ausschuumlttung in Frage kommen zu zaumlhlen
Viele Artikel haben am Erscheinungstag die meisten Zugriffe Achten Sie unbedingt darauf dass Sie die Artikel sofort beim Erscheinen mit einer Zaumlhlmarke versehen da ansonsten moumlglicherweise der festgelegte Mindestzugriff nicht mehr erreicht werden kann
Bei den bisher teilnehmenden Verlagen hat es sich bewaumlhrt als Erstes mit der Zaumlhlung von neu erscheinenden Artikeln zu beginnen Erst sobald das reibungslos automatisiert funktioniert sollte man sich die Frage stellen ob man aumlltere Artikel (zB Archiv hellip) nachtraumlglich mit Zaumlhlmarken ausstatten moumlchte Eine Empfehlung dafuumlr oder dagegen kann man generell nicht aussprechen da es davon abhaumlngt wie stark solche Archivinhalte genutzt werden Das sollte im Verlag anhand von Kosten Nutzen entschieden werden
21 Grundsaumltzliches zu Zaumlhlmarken
211 Zaumlhlmarken der VG WORT
Jede Zaumlhlmarke besteht aus zwei Teilen (oumlffentlicher Identifikationscode privater Identifikationscode) Der oumlf fentliche Identifikationscode dient zum Einbau in die jeweilige HTML ndash Seite (siehe Kapitel 23 Einbau einer Zaumlhlmarke) Der private Identifikationscode wird spaumlter im Rahmen der Meldung benoumltigt
Aus diesem Grund muss der private Identifikationscode in Ihrem CMS System mit dem Artikel verknuumlpft werden
212 Verlagsinterner Schluumlssel als Zaumlhlmarke
In Verlagen werden die Artikel oftmals mit eindeutigen internen Schluumlsseln versehen Diese internen Schluumlssel koumlnnen ebenfalls als Zaumlhlmarke verwendet werden In diesem Fall wird sowohl fuumlr den oumlf fentlichen als auch fuumlr den privaten Identifikationscode der verlagsinterne Schluumlssel verwendet
Dabei gibt es folgendes zu beachten
- Ein verlagsinterner Schluumlssel setzt sich aus dem Praumlfix bdquovgzmltKarteinummergt-ldquo und einen beliebigen Schluumlssel zusammen Der Platzhalter bdquoltKarteinummergtldquo muss mit der VGWORT Karteinummer des Verlags ersetzt werden
- Der Schluumlssel darf keine Sonderzeichen enthalten (dh nur [a-z][A-Z][0-9] sowie den Punkt den Bindestrich und den Unterstrich)
- Der Schluumlssel muss innerhalb vom Verlag eindeutig sein
- DOI (httpwwwdoiorg) koumlnnen ebenfalls als verlagsinterne Schluumlssel zum Einsatz kommen Der Slash nach der Verlagskennung muss durch einen Bindestrich (-) ersetzt werden Es duumlrfen im DOI auch keine weiteren Slashes vorkommen
Beispiel vgzm970-123456789
Bitte setzen Sie sich vor Verwendung von verlagsinternen Schluumlsseln als Zaumlhlmarke unbedingt mit der VG WORT in Verbindung (per Email an metissupportvgwortde) Sie erhalten dann eine Zaumlhldomaumlne die Sie fuumlr den Einbau der Zaumlhlmarken benoumltigen und Sie werden fuumlr die Zugriffszaumlhlung mit verlagsinternen Schluumlsseln freigeschalten Ohne diese Schritte ist keine Zaumlhlung mit verlagsinternen Schluumlsseln moumlglich
Es empfiehlt sich zuerst die Zugriffszaumlhlung umzusetzen und erst dann die Meldung (siehe Kapitel 3) zu implementieren
Zum Zeitpunkt der Zugriffszaumlhlung muumlssen noch nicht alle Informationen zum Text (zB Autoreninformation) vorliegen Daher soll die Umsetzung der Zugriffszaumlhlung auf keinen Fall von solchen Faktoren abhaumlngen
214 Datenschutzerklaumlrung
Im Rahmen der Zugriffszaumlhlung werden Cookies und gegebenenfalls JavaScript - Aufrufe verwendet Es empfiehlt sich daher die Datenschutzerklaumlrung der Verlagsseite in der Zaumlhlmarken eingebaut werden um unten stehende Textbausteine zu ergaumlnzen
Cookies und Meldungen zu Zugriffszahlen
Wir setzen Session-Cookies der VG Wort Muumlnchen zur Messung von Zugriffen auf Texten ein um die Kopierwahrscheinlichkeit zu erfassen Session-Cookies sind kleine Informationseinheiten die ein Anbieter im Arbeitsspeicher des Computers des Besuchers speichert In einem Session-Cook ie wird eine zufaumlllig erzeugte eindeutige Identif ikationsnummer abgelegt eine sogenannte Session-ID Auszligerdem enthaumllt ein Cookie die Angabe uumlber seine Herkunft und die Speicherfrist Session-Cookies koumlnnen keine anderen Daten speichern Diese Messungen werden von der Kantar Germany GmbH nach dem Skalierbaren Zentralen Messverfahren (SZM) durchgefuumlhrt Sie helfen dabei die Kopierwahrscheinlichkeit einzelner Texte zur Verguumltung von gesetzlichen Anspruumlchen von Autoren und Verlagen zu ermitteln Wir erfassen keine personenbezogenen Daten uumlber Cookies
Viele unserer Seiten sind mit JavaScript-Aufrufen versehen uumlber die wir die Zugrif fe an die Verwertungsgesellschaft Wort (VG Wort) melden [BITTE UumlBERPRUumlFEN ob dies bei Ihrem Verlag der Fall ist] Wir ermoumlglichen damit dass unsere Autoren an den Ausschuumlttungen der VG Wort partizipieren die die gesetzliche Verguumltung fuumlr die Nutzungen urheberrechtlich geschuumltzter Werke gem sect 53 UrhG sicherstellen
Eine Nutzung unserer Angebote ist auch ohne Cookies moumlglich Die meisten Browser sind so eingestellt dass sie Cookies automatisch akzeptieren Sie koumlnnen das Speichern von Cookies jedoch deaktivieren oder Ihren Browser so einstellen dass er Sie benachrichtigt sobald Cookies gesendet werden
Datenschutzerklaumlrung zur Nutzung des Skalierbaren Zentralen Messverfahrens
Webangebote
Unsere Website und unser mobiles Webangebot nutzen das bdquoSkalierbare Zent rale Messverfahrenldquo (SZM) der Kantar Germany GmbH fuumlr die Ermittlung statistischer Kennwerte zur Ermittlung der Kopierwahrscheinlichkeit von Texten
Dabei werden anonyme Messwerte erhoben Die Zugrif fszahlenmessung verwendet zur Wiedererkennung von Computersystemen alternativ ein Session-Cookie oder eine Signatur die aus verschiedenen automatisch uumlbertragenen Informationen Ihres Browsers ers tel l t wird IP-Adressen werden nur in anonymisierter Form verarbeitet
Das Verfahren wurde unter der Beachtung des Datenschutzes entwickelt Einziges Ziel des Verfahrens ist es die Kopierwahrscheinlichkeit einzelner Texte zu ermitteln
Zu keinem Zeitpunkt werden einzelne Nutzer identifiziert Ihre Identitaumlt bleibt immer geschuumltzt Sie erhalten uumlber das System keine Werbung
22 Bestellen von Zaumlhlmarken
Verlage haben den Bedarf groszlige Mengen von Zaumlhlmarken auf einmal abzurufen um diese dann in den internen CMS Systemen vorraumltig zu halten Hierfuumlr gibt es zwei Varianten Eine Variante ist es die Zaumlhlmarken direkt aus dem Portal abzurufen bei der anderen Variante erfolgt der Abruf uumlber ein Web Service und kann so automatisiert werden
Grundsaumltzlich koumlnnen pro Jahr 4000 Zaumlhlmarken abgerufen werden Sollte ein Verlag mehr Zaumlhlmarken benoumltigen wird er gebeten sich per Email an metissupportvgwortde zu wenden damit die noumltigen Kapazitaumlten zur Verfuumlgung gestellt werden koumlnnen
Es empfiehlt sich immer einen Zaumlhlmarkenvorrat fuumlr zumindest eine Woche vorraumlt ig zu halten um nicht von der Verfuumlgbarkeit der METIS Anwendung abhaumlngig zu sein
Beim Einsatz von verlagsinternen Schluumlsseln als Zaumlhlmarken entfaumlllt die Bestellung der VG WORT Zaumlhlmarken
221 Bestellung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2211 orderPixelRequest
Feld Typ Beschreibung
count int Anzahl der zu bestellenden Zaumlhlmarken (gt1)
2212 orderPixelResponse
Feld Typ Beschreibung
orderDateTime string Bestelldatum + Zeit im Format bdquoYYYYMMddHHmmldquo
domain string Die Zaumlhlmarken Domaumlne Diese Domaumlne muss beim
Einbau dieser Zaumlhlmarken verwendet werden
pixels pixels Komplexer Datentyp
pixelspublicIdentificationId pixelIDType Oumlffentlicher Identifikationscode der Zaumlhlmarke
pixelsprivateIdentificationId pixelIDType Privater Identifikationscode der Zaumlhlmarke
2213 orderPixelFault
Feld Typ Beschreibung
errorcode int Der Fehlercode
errormsg string Grund fuumlr den Bestellabbruch
maxOrder Int Die maximale Anzahl die fuumlr die jeweilige Bestellung moumlglich gewesen
waumlre (wird nur bei Fehlercode bdquo1ldquo oder Fehlercode bdquo2ldquo angegeben)
22131 Fehlercodes
Fehlerfall Fehlercode maxOrder Meldung
MaxAnzahlBestellung 1 Die maximale Anzahl () an Zaumlhlmarken fuumlr diese
Bestellung wurde um uumlberschritten
MaxAnzahlJahr 2 Die maximale Anzahl () an Zaumlhlmarken fuumlr das
Jahr wurde um uumlberschritten
KeineEMailVorhanden 3 0 Es existiert keine Email-Adresse in Ihrem
Benutzerkonto bitte tragen Sie diese im Meldeportal
Nach Eingabe der benoumltigten Zaumlhlmarken und Klicken auf die Schaltflaumlche bdquoZaumlhlmarken bestellenldquo werden die Zaumlhlmarken vom System generiert Danach wird die Seite zum Download der eben bestellten Zaumlhlmarken angezeigt Falls mehr Zaumlhlmarken bestellt wurden als noch zur Verfuumlgung stehen kommt eine entsprechende Fehlermeldung In diesem Fall wenden Sie sich bitte per Email an metissupportvgwortde
Abbildung 2 Maskenbeschreibung Download der generierten Zaumlhlmarken
In der oben stehenden Maske befindet sich neben der Zaumlhldomaumlne auch Einbaubeispiele fuumlr HTML Texte Beim Klicken auf bdquoDownload der reinen Codepaare als CSV-Dateildquo koumlnnen die bestellten Zaumlhlmarken heruntergeladen werden Das Format der CSV Datei ist im folgenden Abschnitt beschrieben Beim Klicken auf bdquoDownload der vorkonfigurierten Zaumlhlmarken als CSV-Dateildquo wird eine Datei ausgegeben die alle Zaumlhlmarken als fertigen HTML Code enthaumllt
2221 CSV-Datei Format
Die CSV-Datei wird im folgenden Format erstellt (Die Spalten werden durch ein Semikolon getrennt)
Die Zaumlhlmarke ist ein transparentes (unsichtbares) Bild mit der Groumlszlige von 1 x 1 Pixel Es hat keinesfalls Einfluss auf die Ladezeit der Seite da Bilder von den Browsern separat zum Text geladen werden Das unsichtbare Bild hat auch keinen Einfluss auf das Erscheinungsbild der Seite
Einbaubeispiel VG WORT Zaumlhlmarke in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquoc5b7568d28884052a9ff92d5afd08f34rdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquovgzm970-123456789rdquo
Der korrekt formatierte verlagsinterne Schluumlssel des zu zaumlhlenden Textes
232 Fuumlr Dokumente (PDF oder EPUB Dateien)
Eine Zaumlhlmarke kann nicht direkt in eine dieser Dateien eingebaut werden Sie muss daher in die HTML Seite eingebaut werden von der aus das Dokument verlinkt wird Verlinkungen von anderen Seiten koumlnnen nicht beruumlcksichtigt werden Da eine Weiterleitung vom Zaumlhlserver auf externe Dateien aus sicherheitstechnischen Gruumlnden nicht angeboten werden kann benoumltigt man JavaScript um die Zugriffe auf eine PDF Datei zaumlhlen zu koumlnnen
In diesem Fall wird das Zaumlhlpixel (unsichtbare Bild) uumlber JavaScript in die HTML Seite eingefuumlgt sobald das Dokument (der Link auf das Dokument bleibt unveraumlndert) abgerufen wird
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquo98380ae3fc0a4daf84d6197274add99erdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquohttpwwwstepscondebeispielepubrdquo
Der Link auf das zu zaumlhlende Dokument
- LINK-Name
Name des Links
Auch dabei ist der Einsatz von verlagsinternen Schluumlsseln moumlglich In diesem Fall wird der korrekt formatierte verlagsinterne Schluumlssel anstelle vom oumlffentlichen Identifikationscode verwendet Auf ein separates Einbaubeispiel wird in diesem Dokument verzichtet
233 Base64url enkodierte Zaumlhlmarken
Die verwendbaren Zeichen in einer Zaumlhlmarke sind stark beschraumlnkt (siehe oben) Sollten verlagsinterne Schluumlssel mit nicht erlaubten Zeichen zum Einsatz kommen kann die Zaumlhlmarke Base64url (Codepage UTF-8) enkodiert werden In diesem Fall wird die encodierte Zaumlhlmarke mit Praumlf ix bdquobase64-ldquo eingebaut
Zum Thema Base64url Die Zeichen + und werden nach der Base64-Enkodierung durch - (Minus ASCII 2Dhex) und _ (Unterstrich ASCII 5Fhex) ersetzt
Einbaubeispiel verlagsinterner Schluumlssel in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Zugriffe von Texten hinter Bezahlschranken werden mit Faktor 3 multipliziert Die Aufwertung der Zaumlhlwerte hinter Bezahlschranken erfolgt mittels einer gesonderten Zaumlhlung Hierfuumlr muss der Verlag die Zaumlhlmarke beim Einbau mit einem Praumlfix versehen Dieses Praumlfix darf nur fuumlr Texte hinter Bezahlschranken verwendet werden Ist der Text frei zugaumlnglich wird die Zaumlhlmarke wie bisher (ohne Praumlf ix) eingebaut Aufgrund des Praumlfixes kann unterschieden werden ob ein Text hinter einer Bezahlschranke ist oder nicht
Um Texte hinter Bezahlschranken melden zu koumlnnen muumlssen Sie fuumlr die VG WORT zuerst einen kostenfreien Zugang auf diese Texte einrichten Dies ist uumlber die Angabe von Zugangsdaten oder uumlber die Freischaltung von IP Adressen moumlglich (im TOM Menuuml unter Zugriff auf zugangsbeschraumlnkte Inhalte erlauben)
Das Praumlf ix lautet bdquopw-ldquo bdquopwldquo steht fuumlr den englischen Begriff bdquoPaywallldquo (Bezahlschranke)
In der Vergangenheit musste bei Zaumlhlungen von https- Seiten eine separate Zaumlhldomaumlne verwendet werden Wenn Sie die Zaumlhlungen uumlber diese separate Domaumlne eingebaut haben muumlssen Sie den Einbau nicht aumlndern Diese Variante wird weiterhin unterstuumltzt
236 Potenzielle Fehlerquelle Referrer-Tag
Bestimmte Einstellungen im Quellcode koumlnnen dazu fuumlhren dass Zaumlhlungen nicht mehr zugeordnet werden koumlnnen wenn die Meldungen eingehen Es sieht dann so aus als waumlren d ie Zaumlhlungen zu einem Text falsch (zB nur uumlber eine Startseite ohne den eigentlichen Text) erfolgt Das kann dazu fuumlhren dass diese Zaumlhlungen gestrichen werden und der Mindestzugriff nicht mehr gegeben is t Um solche Probleme zu vermeiden muumlssen Sie darauf achten wie das Referrer-Metatag im Quellcode Ihrer Seite eingestellt ist
Die Zeile ltmeta name=referrer content=origingt sorgt zB dafuumlr dass eine Seite die httpswwwbeispieldemein_texthtml heiszligt nur httpswwwbeispielde sendet Damit lassen s ich dann die Zugriffe nicht mehr der richtigen Seite zuordnen
Bei weiteren Einstellungen wird das Senden der Daten vollstaumlndig unterdruumlckt Auch dies kann dazu fuumlhren dass Zaumlhlungen nicht anerkannt werden wenn weitere Faktoren darauf hindeuten dass die Zaumlhlungen nicht korrekt sein koumlnnten
Nur bei den Einstellungen ltmeta name=referrer content=no-referrer-when-downgradeldquogt oder ltmeta name=referrer content=unsafe-urlgt kann man auf gezaumlhlten Seiten 100 sicher sein dass keine Meldungen wegen nicht nachvollziehbarer Zugriffszaumlhlungen abgewiesen werden
Diese Funktion ist in bestimmten Faumlllen hoch problematisch und in anderen Faumlllen sogar zwingend erforderlich
Die Verwendung von bdquoLazy Loadldquo ist immer zu vermeiden wenn sich auf einer URL nur ein Text oder nur ein Teil eines mehrseitigen Textes befindet Hier fuumlhrt die Funktion dazu dass die Zaumlhlmarken erst geladen werden wenn die Stelle mit der Zaumlhlmarke im Browser angezeigt wird Insbesondere wenn die Zaumlhlmarke am Ende der Seite oder des Textes eingebaut wird sorgt die Funkt ion dafuumlr dass unser Zaumlhlbild nur geladen wird wenn der Leser auch an der Stelle ankommt also zB bis ganz ans Ende der Seite oder des Textes scrollt Erreicht er die Stelle nicht weil die Zaumlhlmarke zB erst unterhalb der Seite und nach Werbeeinblendungen oder Kommentaren eingebaut ist dann wird das Bild auch nicht vom Zaumlhlserver abgerufen und es erfolgt somit auch KEINE Zaumlhlung
Anders sieht es hingegen aus wenn sich viele Texte auf einer Seite befinden oder weitere Texte automatisch eingeblendet werden sobald ein Leser das Textende des ersten Textes erreicht hat Da nicht automatisch davon ausgegangen werden kann dass Texte die vom jeweil igen Nutzer nicht gesucht wurden eine Kopierwahrscheinlichkeit haben darf in diesen Faumlllen die Zaumlhlung nur erfolgen wenn der Text tatsaumlchlich ausgewaumlhlt wird Dies kann mit Hilfe von Lazy load erreicht werden Dazu baut man die jeweilige Zaumlhlmarke am besten immer ab der Mitte eines Textes ein so dass einerseits sichergestellt ist dass gezaumlhlt wird und andererseits dass nur eine Zaumlhlung erfolgt wenn wirklich ein bestimmter Text angesehen wurde und damit die notwendige Kopierwahrscheinlichkeit gegeben ist
24 Uumlberpruumlfen der Zaumlhlungen
241 Anzeige Herunterladen in der Anwendung
In der Anwendung gibt es eine Funktionalitaumlt mit der man pruumlfen kann welche Zaumlhlmarken bereits gezaumlhlt werden bzw welche Zaumlhlmarken die Mindestzugriffe uumlberschritten haben Dadurch kann man feststellen ob der Einbau dieser Zaumlhlmarken korrekt ist Diese Funktionalitaumlt kann uumlber den Menuumlpunkt bdquoZaumlhlmarkenuumlbersichtldquo abgerufen werden Siehe Abbildung unten
Abbildung 3 Maskenbeschreibung Zaumlhlerstarts
Dabei gibt es folgende Filtermoumlglichkeiten
- bdquoIdentif ikationscodeldquo Der oumlffentliche bzw private Identifikationscode oder der verlagsinterne Schluumlssel der Zaumlhlmarke
- bdquoBestelldatum (von bis)ldquo Bestelldatum der Zaumlhlmarke
- bdquoMeldung erfolgtldquo Es werden nur Zaumlhlmarken angezeigt fuumlr die bereits eine Meldung vorliegt
- bdquoZaumlhlerstart erfolgtldquo Alle Zaumlhlmarken die gezaumlhlt werden
- bdquoMindestzugriffldquo Alle Zaumlhlmarken die den Mindestzugriff oder den anteiligen Mindestzugriff uumlberschritten haben
- bdquoin Ausgeblendete Zaumlhlmarken suchenldquo Es werden auch Zaumlhlmarken gesucht die uumlber die angebotene Funktionalitaumlt ausgeblendet wurden Zaumlhlmarken sollten ausgeblendet werden wenn diese in Texten eingebaut wurden die den Kriterien der VG WORT nicht entsprechen (zB zu kurze Texte) Ansonsten scheinen diese Zaumlhlmarken weiterhin staumlndig in der Suchergebnisliste auf
Die Filtermoumlglichkeiten fuumlr den Mindestzugriff greifen sobald die ersten Zaumlhldaten fuumlr ein Kalenderjahr vorliegen Allerdings ist die Anzeige fuumlr das laufende Jahr unter Vorbehalt und erfolgt auf der Basis
des letzten bekannten Mindestzugriffes Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald der Mindestzugriff zu einem Jahr im Meldesystem eingegeben wurde (immer im Januar des Folgejahres)
Die Zaumlhlmarken koumlnnen zusaumltzlich als Liste im CSV Format heruntergeladen werden
Der Zaumlhlerstart wird mit einer Verzoumlgerung von ca 4 Tagen angezeigt Dh wenn eine Zaumlhlmarke heute eingebaut wird scheint diese in der Statistik erst in ca 4 Tagen auf
Es empfiehlt sich testweise einige wenige Zaumlhlmarken einzubauen und zu pruumlfen ob die Zaumlhlungen korrekt gestartet werden bevor man den Einbau der Zaumlhlmarken auf das gesamte Internetangebot ausrollt
242 Abruf uumlber Web Service Schnittstelle
Im Gegensatz zur Maske (siehe oben) kann man uumlber das Web Service nur die Zaumlhlmarken bdquomit Mindestzugriff ohne Meldungldquo sowie bdquomit anteiligem Mindestzugriff ohne Meldungldquo herunterladen
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2421 pixelOverviewRequest
Feld Typ Beschreibung
offset Int Wiederaufsetzpunkt Das System returniert maximal 100 Zaumlhlmarken am Stuumlck
Falls es mehr Zaumlhlmarken gibt die die Kriterien erfuumlllen koumlnnen weitere
Zaumlhlmarken uumlber den offset ausgelesen werden
Beispiel (190 Zaumlhlmarken vorhanden)
1 Abfrage (offset = 0) Die Zaumlhlmarken 1 ndash 100 werden zuruumlckgegeben
2 Abfrage (offset = 100) Die Zaumlhlmarken 101 ndash 190 werden zuruumlckgegeben
type Auswahl Entweder bdquoMINDESTZUGRIFFldquo oder bdquoANTEILIGER_MINDESTZUGRIFFldquo
2422 pixelOverviewResponse
Feld Typ Beschreibung
Amount Int Anzahl der gefundenen Zaumlhlmarken
Offset Int Der beim Request angegebene offset
privateIdentificationId pixelIDType (Liste) Privater Identifikationscode oder verlagsinterner Schluumlssel
3 Meldung Nachdem eine Zaumlhlmarke bestellt und eingebaut wurde kann eine Meldung zum jeweiligen Text erfolgen Eine Meldung soll dann gemacht werden wenn sich der Text des gemeldeten Artikels nicht mehr wesentlich aumlndert da die VG WORT in den Pruumlfmechanismen den gemeldeten Text mit dem Text der sich tatsaumlchlich im Internet befindet vergleicht
Der spaumlteste Zeitpunkt zum Melden eines Textes ist der sogenannte Meldeschlusstermin Diesen f inden Sie auf der Homepage der VG WORT unter bdquoTermineldquo Derzeit ist der Meldeschluss fuumlr Verlage der 1 Juni des auf die Zaumlhlung folgenden Jahres
In den meisten Faumlllen empfiehlt sich eine bdquoWartefristldquo von 14 Tagen bevor die Meldung erstellt wird So lange der Text noch Aumlnderungen unterzogen wird besteht die Gefahr dass die von der VG WORT durchgefuumlhrten Pruumlfmechanismen fehlschlagen
Bitte setzen Sie sich vor Meldungen zu Texten die uumlber verlagsinterne Schluumlssel gezaumlhlt werden unbedingt mit der VG WORT (per Email an metissupportvgwortde) in Verbindung
31 Anforderungen an die Meldung
Anbei f inden Sie alle Daten die bei einer Meldung angegeben werden muumlssen - Eindeutiger Identifikationscode - Alle beteiligten Autoren Uumlbersetzer und Agenturen - Kurzbeschreibung Uumlberschrift (Titel) - Text - Erscheinungsorte (Webbereiche)
311 Eindeutiger Identifikationscode
Der Identif ikationscode zur Zaumlhlmarke die in den Text eingebaut wurde Je nachdem welche Zaumlhlmarke verwendet wird ist dies der private Identifikationscode (bei VG WORT Zaumlhlmarken) oder der verlagsinterne Schluumlssel
312 Alle beteiligten Autoren Uumlbersetzer und Agenturen
Alle die am Text beteiligt sind Es gibt drei Arten wie die Autoren undoder Uumlbersetzer gemeldet werden
Vorname + Nachname + Karteinummer Die bevorzugte Variante Dabei werden von einem Autor oder einem Uumlbersetzer der Vorname der Nachname und die VG WORT Karteinummer gemeldet Eine Meldung mit Schreibweisen oder Pseudonymen ist auch moumlglich wenn diese der VG WORT bekannt sind Der Vorteil an dieser Variante ist dass ein Autor somit bei der VG WORT eindeutig identifizierbar ist und der Verlag somit keine weiteren Schritte unternehmen muss damit der jeweilige Autor zu seiner Ausschuumlttung kommt
Diese Variante beinhaltet fuumlr den Verlag zwar einen Initialaufwand da die Karteinummern aller Autoren eingesammelt werden muumlssen in der Praxis hat sich diese Variante bei den meisten teilnehmenden Verlagen aber als die einfachste Variante erwiesen
Vorname + Nachname Wenn von einem Autor die VG WORT Karteinummer nicht bekannt ist kann der Autor auch uumlber den Vornamen und den Nachnamen gemeldet werden Den Autoren steht fuumlr das Auffinden der ausschuumlttungsrelevanten Meldungen eine Suchmaske zur Verfuumlgung Allerdings muss in diesem Fall der gemeldete Name exakt mit dem uumlbereinstimmen der im Datenbestand der VG WORT vorliegt
Ist der Vorname nicht vollstaumlndig bekannt kann er in der Variante erster Buchstabe des Vornamens + Punkt angegeben werden
Urheber ohne Wahrnehmungsvertrag Hat der Urheber des zu meldenden Werkes dem meldenden Verlag fuumlr dieses Werk die von der VG WORT wahrgenommenen gesetzlichen Verguumltungsanspruumlche nach dem Urheberrechtsgesetz abgetreten kann dieser Urheber mit Namen Geburtsdatum und Adresse angegeben werden Zusaumltzlich muss bestaumltigt werden dass der Urheber die Rechte uumlbertragen hat Die uumlbertragenen Rechte werden bei der Ausschuumlttung beruumlcksichtigt
Fuumlr Agenturmeldungen bei denen die Autoren nicht bekannt sind steht eine weitere Variante zur Verfuumlgung
Die Rechte koumlnnen dem Verlag erst nach der Veroumlffentlichung des Textes uumlbertragen werden Die schriftliche Rechteuumlbertragung des jeweiligen Autors muss der VG WORT jederzeit auf Anfrage zur Verfuumlgung gestellt werden
Kuumlrzel Wenn man eine Agentur melden moumlchte dann kann das aktuell uumlber diesen Weg erfolgen Als Kuumlrzel wird die Kurzbezeichnung der jeweiligen Agentur uumlbergeben (zB bdquodpaldquo)
Namentliche bekannte Urheber koumlnnen uumlber die Angabe bdquoKuumlrzelldquo nicht gemeldet werden Diese Angabe kann ausschlieszliglich fuumlr die Meldung von Agenturtexten bzw der Miturheberschaft eines nicht namentlich bekannten Agenturautoren verwendet werden
313 Kurzbeschreibung Uumlberschrift (Titel)
Der Titel des zu meldenden Artikels
314 Text
Der Text des zu meldenden Artikels (entweder als Klartext als PDF oder im EPUB Format) Benoumltigt wird der bdquoNettotextldquo (dh der Text ohne HTML Code und ohne Menuuml oder dergleichen)
315 Erscheinungsorte (Webbereiche)
Es muumlssen alle Erscheinungsorte des Texts auf denen die Zaumlhlmarke eingebaut wurde gemeldet werden Ein Erscheinungsort definiert sich aus allen URLs die benoumltigt werden um den gesamten Text einmal zu lesen
Beispiel 1 Ein Text der sich uumlber 2 URLs erstreckt muss mit einem Webbereich (mit 2 URLs) gemel-det werden (zB httpdomain1depage1html httpdomain1depage2html)
Beispiel 2 Ein Text der sich uumlber 1 URL erstreckt aber auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils einer URL) gemeldet werden (zB httpdomain1demytexthtml und httpdomain2demytexthtml)
Beispiel 3 Ein Text der sich uumlber 2 URLs erstreckt und auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils zwei URLs) gemeldet werden (zB httpdomain1depage1html httpdomain1depage2html und httpdomain2depage1html httpdomain2depage2html)
32 Meldung uumlbermitteln
321 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
bull Es sollen nur Texte gemeldet werden die bereits bdquostabilldquo sind (dh die sich nicht mehr haumlufig aumlndern) Aus diesem Grund wird empfohlen die Texte mit einer Zeitverzoumlgerung von einigen Tagen (zB 14 Tagen) zu melden Auf die Tantieme hat das keinen Einfluss da die Ausschuumlttung erst Ende September Anfang Oktober fuumlr das Vorjahr erfolgt
bull Die Meldungen sollen taumlglich in der Nacht uumlbertragen werden Zeitfenster 2200 ndash 0300 Von 0300 bis 0600 gibt es ein allgemeines Wartungsfenster wo nicht gemeldet werden kann
bull Um eine Uumlberlastung der Server (und somit houmlhere Wartezeit) zu verhindern sollen die Meldungen sequentiell (nicht parallel) uumlbertragen werden Idealerweise soll zwischen zwei Meldungen eine Sekunde verstreichen Aus transaktionaler Sicht wird jede Meldung einzeln behandelt Dh jede erfolgreich eingehende Meldung wird gespeichert ndash unabhaumlngig davon ob die vorherige oder nachfolgende Meldung einen Fehler verursacht hat
bull Alle fachlichen Fehlercodes (ein- oder zweistellig) deuten auf einen Fehler in der Meldung hin Es ist zwecklos diese Meldung unveraumlndert noch einmal abzusenden Dreistellige Fehler (sowie der HTML ndash 500 Fehler) deuten auf technische Probleme hin Hier ist es zweckmaumlszligig dieselben Meldungen zu einem spaumlteren Zeitpunkt (zB mit den Meldungen vom naumlchsten Tag) noch einmal zu uumlbertragen
bull Die Bestaumltigung der Meldung bedeutet dass die Meldung aus technischer Sicht in Ordnung ist (dh Mindestumfang von 1800 Zeichen die Zaumlhlmarke existiert hellip) In einer spaumlteren Phase werden die Meldungen noch durch automatische Pruumlfmechanismen der VG WORT in Stichproben gepruumlft Sollten dabei Maumlngel auftreten werden die betreffenden Meldungen zuruumlckgewiesen und der Inhaber des Meldekontos bei der VG WORT wird per Email verstaumlndigt Diese Meldungen koumlnnen dann im Portal entweder geloumlscht oder manuell nachbearbeitet und erneut versendet werden
3212 newMessageRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der private
Identifikationscode (bei VG WORT Zaumlhlmarken) oder der
verlagsinterne Schluumlssel
Parties Parties Die Urheber Uumlbersetzer Agenturen der Meldung Es muss mindestens ein Autor oder ein Uumlbersetzer angegeben werden
Es koumlnnen in einer Meldung sowohl Autoren als auch
Uumlbersetzer angegeben werden
partiesauthors Authors 0 bis mehrere Autoren Beschreibung siehe separate Tabelle
partiestranslators Translators 0 bis mehrere Uumlbersetzer Beschreibung siehe separate
Tabelle
messagetext MessageText Der gemeldete Text entweder als PDF EPUB oder als Klartext
messagetextshorttext string Kurzbezeichnung Uumlberschrift vom Text
messagetexttext Text Der Text an sich Beschreibung siehe separate Tabelle
messagetextlyric boolean bdquoTrueldquo wenn es sich beim Text um Lyrik handelt ansonsten
bdquoFalseldquo
webranges Webranges Erscheinungsort(e) unter demdenen der Text gefunden werden
kann
webrangeswebrange Webrange Ein Erscheinungsort Beschreibung siehe separate Tabelle
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
2 Zugriffszaumlhlung Fuumlr die Zugriffszaumlhlung wird das bdquoskalierbare zentrale Messsystemldquo dass auch fuumlr die Werbewirtschaft (IVW) eingesetzt wird verwendet Dabei werden in HTML Seiten unsichtbare Bilder (Zaumlhlmarken) eingebaut die zu Zugriffszaumlhlungen fuumlhren
Die Zugriffszaumlhlung bildet die Basis fuumlr eine moumlgliche Ausschuumlttung Aus diesem Grund muss darauf geachtet werden moumlglichst alle Texte die fuumlr die Ausschuumlttung in Frage kommen zu zaumlhlen
Viele Artikel haben am Erscheinungstag die meisten Zugriffe Achten Sie unbedingt darauf dass Sie die Artikel sofort beim Erscheinen mit einer Zaumlhlmarke versehen da ansonsten moumlglicherweise der festgelegte Mindestzugriff nicht mehr erreicht werden kann
Bei den bisher teilnehmenden Verlagen hat es sich bewaumlhrt als Erstes mit der Zaumlhlung von neu erscheinenden Artikeln zu beginnen Erst sobald das reibungslos automatisiert funktioniert sollte man sich die Frage stellen ob man aumlltere Artikel (zB Archiv hellip) nachtraumlglich mit Zaumlhlmarken ausstatten moumlchte Eine Empfehlung dafuumlr oder dagegen kann man generell nicht aussprechen da es davon abhaumlngt wie stark solche Archivinhalte genutzt werden Das sollte im Verlag anhand von Kosten Nutzen entschieden werden
21 Grundsaumltzliches zu Zaumlhlmarken
211 Zaumlhlmarken der VG WORT
Jede Zaumlhlmarke besteht aus zwei Teilen (oumlffentlicher Identifikationscode privater Identifikationscode) Der oumlf fentliche Identifikationscode dient zum Einbau in die jeweilige HTML ndash Seite (siehe Kapitel 23 Einbau einer Zaumlhlmarke) Der private Identifikationscode wird spaumlter im Rahmen der Meldung benoumltigt
Aus diesem Grund muss der private Identifikationscode in Ihrem CMS System mit dem Artikel verknuumlpft werden
212 Verlagsinterner Schluumlssel als Zaumlhlmarke
In Verlagen werden die Artikel oftmals mit eindeutigen internen Schluumlsseln versehen Diese internen Schluumlssel koumlnnen ebenfalls als Zaumlhlmarke verwendet werden In diesem Fall wird sowohl fuumlr den oumlf fentlichen als auch fuumlr den privaten Identifikationscode der verlagsinterne Schluumlssel verwendet
Dabei gibt es folgendes zu beachten
- Ein verlagsinterner Schluumlssel setzt sich aus dem Praumlfix bdquovgzmltKarteinummergt-ldquo und einen beliebigen Schluumlssel zusammen Der Platzhalter bdquoltKarteinummergtldquo muss mit der VGWORT Karteinummer des Verlags ersetzt werden
- Der Schluumlssel darf keine Sonderzeichen enthalten (dh nur [a-z][A-Z][0-9] sowie den Punkt den Bindestrich und den Unterstrich)
- Der Schluumlssel muss innerhalb vom Verlag eindeutig sein
- DOI (httpwwwdoiorg) koumlnnen ebenfalls als verlagsinterne Schluumlssel zum Einsatz kommen Der Slash nach der Verlagskennung muss durch einen Bindestrich (-) ersetzt werden Es duumlrfen im DOI auch keine weiteren Slashes vorkommen
Beispiel vgzm970-123456789
Bitte setzen Sie sich vor Verwendung von verlagsinternen Schluumlsseln als Zaumlhlmarke unbedingt mit der VG WORT in Verbindung (per Email an metissupportvgwortde) Sie erhalten dann eine Zaumlhldomaumlne die Sie fuumlr den Einbau der Zaumlhlmarken benoumltigen und Sie werden fuumlr die Zugriffszaumlhlung mit verlagsinternen Schluumlsseln freigeschalten Ohne diese Schritte ist keine Zaumlhlung mit verlagsinternen Schluumlsseln moumlglich
Es empfiehlt sich zuerst die Zugriffszaumlhlung umzusetzen und erst dann die Meldung (siehe Kapitel 3) zu implementieren
Zum Zeitpunkt der Zugriffszaumlhlung muumlssen noch nicht alle Informationen zum Text (zB Autoreninformation) vorliegen Daher soll die Umsetzung der Zugriffszaumlhlung auf keinen Fall von solchen Faktoren abhaumlngen
214 Datenschutzerklaumlrung
Im Rahmen der Zugriffszaumlhlung werden Cookies und gegebenenfalls JavaScript - Aufrufe verwendet Es empfiehlt sich daher die Datenschutzerklaumlrung der Verlagsseite in der Zaumlhlmarken eingebaut werden um unten stehende Textbausteine zu ergaumlnzen
Cookies und Meldungen zu Zugriffszahlen
Wir setzen Session-Cookies der VG Wort Muumlnchen zur Messung von Zugriffen auf Texten ein um die Kopierwahrscheinlichkeit zu erfassen Session-Cookies sind kleine Informationseinheiten die ein Anbieter im Arbeitsspeicher des Computers des Besuchers speichert In einem Session-Cook ie wird eine zufaumlllig erzeugte eindeutige Identif ikationsnummer abgelegt eine sogenannte Session-ID Auszligerdem enthaumllt ein Cookie die Angabe uumlber seine Herkunft und die Speicherfrist Session-Cookies koumlnnen keine anderen Daten speichern Diese Messungen werden von der Kantar Germany GmbH nach dem Skalierbaren Zentralen Messverfahren (SZM) durchgefuumlhrt Sie helfen dabei die Kopierwahrscheinlichkeit einzelner Texte zur Verguumltung von gesetzlichen Anspruumlchen von Autoren und Verlagen zu ermitteln Wir erfassen keine personenbezogenen Daten uumlber Cookies
Viele unserer Seiten sind mit JavaScript-Aufrufen versehen uumlber die wir die Zugrif fe an die Verwertungsgesellschaft Wort (VG Wort) melden [BITTE UumlBERPRUumlFEN ob dies bei Ihrem Verlag der Fall ist] Wir ermoumlglichen damit dass unsere Autoren an den Ausschuumlttungen der VG Wort partizipieren die die gesetzliche Verguumltung fuumlr die Nutzungen urheberrechtlich geschuumltzter Werke gem sect 53 UrhG sicherstellen
Eine Nutzung unserer Angebote ist auch ohne Cookies moumlglich Die meisten Browser sind so eingestellt dass sie Cookies automatisch akzeptieren Sie koumlnnen das Speichern von Cookies jedoch deaktivieren oder Ihren Browser so einstellen dass er Sie benachrichtigt sobald Cookies gesendet werden
Datenschutzerklaumlrung zur Nutzung des Skalierbaren Zentralen Messverfahrens
Webangebote
Unsere Website und unser mobiles Webangebot nutzen das bdquoSkalierbare Zent rale Messverfahrenldquo (SZM) der Kantar Germany GmbH fuumlr die Ermittlung statistischer Kennwerte zur Ermittlung der Kopierwahrscheinlichkeit von Texten
Dabei werden anonyme Messwerte erhoben Die Zugrif fszahlenmessung verwendet zur Wiedererkennung von Computersystemen alternativ ein Session-Cookie oder eine Signatur die aus verschiedenen automatisch uumlbertragenen Informationen Ihres Browsers ers tel l t wird IP-Adressen werden nur in anonymisierter Form verarbeitet
Das Verfahren wurde unter der Beachtung des Datenschutzes entwickelt Einziges Ziel des Verfahrens ist es die Kopierwahrscheinlichkeit einzelner Texte zu ermitteln
Zu keinem Zeitpunkt werden einzelne Nutzer identifiziert Ihre Identitaumlt bleibt immer geschuumltzt Sie erhalten uumlber das System keine Werbung
22 Bestellen von Zaumlhlmarken
Verlage haben den Bedarf groszlige Mengen von Zaumlhlmarken auf einmal abzurufen um diese dann in den internen CMS Systemen vorraumltig zu halten Hierfuumlr gibt es zwei Varianten Eine Variante ist es die Zaumlhlmarken direkt aus dem Portal abzurufen bei der anderen Variante erfolgt der Abruf uumlber ein Web Service und kann so automatisiert werden
Grundsaumltzlich koumlnnen pro Jahr 4000 Zaumlhlmarken abgerufen werden Sollte ein Verlag mehr Zaumlhlmarken benoumltigen wird er gebeten sich per Email an metissupportvgwortde zu wenden damit die noumltigen Kapazitaumlten zur Verfuumlgung gestellt werden koumlnnen
Es empfiehlt sich immer einen Zaumlhlmarkenvorrat fuumlr zumindest eine Woche vorraumlt ig zu halten um nicht von der Verfuumlgbarkeit der METIS Anwendung abhaumlngig zu sein
Beim Einsatz von verlagsinternen Schluumlsseln als Zaumlhlmarken entfaumlllt die Bestellung der VG WORT Zaumlhlmarken
221 Bestellung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2211 orderPixelRequest
Feld Typ Beschreibung
count int Anzahl der zu bestellenden Zaumlhlmarken (gt1)
2212 orderPixelResponse
Feld Typ Beschreibung
orderDateTime string Bestelldatum + Zeit im Format bdquoYYYYMMddHHmmldquo
domain string Die Zaumlhlmarken Domaumlne Diese Domaumlne muss beim
Einbau dieser Zaumlhlmarken verwendet werden
pixels pixels Komplexer Datentyp
pixelspublicIdentificationId pixelIDType Oumlffentlicher Identifikationscode der Zaumlhlmarke
pixelsprivateIdentificationId pixelIDType Privater Identifikationscode der Zaumlhlmarke
2213 orderPixelFault
Feld Typ Beschreibung
errorcode int Der Fehlercode
errormsg string Grund fuumlr den Bestellabbruch
maxOrder Int Die maximale Anzahl die fuumlr die jeweilige Bestellung moumlglich gewesen
waumlre (wird nur bei Fehlercode bdquo1ldquo oder Fehlercode bdquo2ldquo angegeben)
22131 Fehlercodes
Fehlerfall Fehlercode maxOrder Meldung
MaxAnzahlBestellung 1 Die maximale Anzahl () an Zaumlhlmarken fuumlr diese
Bestellung wurde um uumlberschritten
MaxAnzahlJahr 2 Die maximale Anzahl () an Zaumlhlmarken fuumlr das
Jahr wurde um uumlberschritten
KeineEMailVorhanden 3 0 Es existiert keine Email-Adresse in Ihrem
Benutzerkonto bitte tragen Sie diese im Meldeportal
Nach Eingabe der benoumltigten Zaumlhlmarken und Klicken auf die Schaltflaumlche bdquoZaumlhlmarken bestellenldquo werden die Zaumlhlmarken vom System generiert Danach wird die Seite zum Download der eben bestellten Zaumlhlmarken angezeigt Falls mehr Zaumlhlmarken bestellt wurden als noch zur Verfuumlgung stehen kommt eine entsprechende Fehlermeldung In diesem Fall wenden Sie sich bitte per Email an metissupportvgwortde
Abbildung 2 Maskenbeschreibung Download der generierten Zaumlhlmarken
In der oben stehenden Maske befindet sich neben der Zaumlhldomaumlne auch Einbaubeispiele fuumlr HTML Texte Beim Klicken auf bdquoDownload der reinen Codepaare als CSV-Dateildquo koumlnnen die bestellten Zaumlhlmarken heruntergeladen werden Das Format der CSV Datei ist im folgenden Abschnitt beschrieben Beim Klicken auf bdquoDownload der vorkonfigurierten Zaumlhlmarken als CSV-Dateildquo wird eine Datei ausgegeben die alle Zaumlhlmarken als fertigen HTML Code enthaumllt
2221 CSV-Datei Format
Die CSV-Datei wird im folgenden Format erstellt (Die Spalten werden durch ein Semikolon getrennt)
Die Zaumlhlmarke ist ein transparentes (unsichtbares) Bild mit der Groumlszlige von 1 x 1 Pixel Es hat keinesfalls Einfluss auf die Ladezeit der Seite da Bilder von den Browsern separat zum Text geladen werden Das unsichtbare Bild hat auch keinen Einfluss auf das Erscheinungsbild der Seite
Einbaubeispiel VG WORT Zaumlhlmarke in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquoc5b7568d28884052a9ff92d5afd08f34rdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquovgzm970-123456789rdquo
Der korrekt formatierte verlagsinterne Schluumlssel des zu zaumlhlenden Textes
232 Fuumlr Dokumente (PDF oder EPUB Dateien)
Eine Zaumlhlmarke kann nicht direkt in eine dieser Dateien eingebaut werden Sie muss daher in die HTML Seite eingebaut werden von der aus das Dokument verlinkt wird Verlinkungen von anderen Seiten koumlnnen nicht beruumlcksichtigt werden Da eine Weiterleitung vom Zaumlhlserver auf externe Dateien aus sicherheitstechnischen Gruumlnden nicht angeboten werden kann benoumltigt man JavaScript um die Zugriffe auf eine PDF Datei zaumlhlen zu koumlnnen
In diesem Fall wird das Zaumlhlpixel (unsichtbare Bild) uumlber JavaScript in die HTML Seite eingefuumlgt sobald das Dokument (der Link auf das Dokument bleibt unveraumlndert) abgerufen wird
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquo98380ae3fc0a4daf84d6197274add99erdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquohttpwwwstepscondebeispielepubrdquo
Der Link auf das zu zaumlhlende Dokument
- LINK-Name
Name des Links
Auch dabei ist der Einsatz von verlagsinternen Schluumlsseln moumlglich In diesem Fall wird der korrekt formatierte verlagsinterne Schluumlssel anstelle vom oumlffentlichen Identifikationscode verwendet Auf ein separates Einbaubeispiel wird in diesem Dokument verzichtet
233 Base64url enkodierte Zaumlhlmarken
Die verwendbaren Zeichen in einer Zaumlhlmarke sind stark beschraumlnkt (siehe oben) Sollten verlagsinterne Schluumlssel mit nicht erlaubten Zeichen zum Einsatz kommen kann die Zaumlhlmarke Base64url (Codepage UTF-8) enkodiert werden In diesem Fall wird die encodierte Zaumlhlmarke mit Praumlf ix bdquobase64-ldquo eingebaut
Zum Thema Base64url Die Zeichen + und werden nach der Base64-Enkodierung durch - (Minus ASCII 2Dhex) und _ (Unterstrich ASCII 5Fhex) ersetzt
Einbaubeispiel verlagsinterner Schluumlssel in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Zugriffe von Texten hinter Bezahlschranken werden mit Faktor 3 multipliziert Die Aufwertung der Zaumlhlwerte hinter Bezahlschranken erfolgt mittels einer gesonderten Zaumlhlung Hierfuumlr muss der Verlag die Zaumlhlmarke beim Einbau mit einem Praumlfix versehen Dieses Praumlfix darf nur fuumlr Texte hinter Bezahlschranken verwendet werden Ist der Text frei zugaumlnglich wird die Zaumlhlmarke wie bisher (ohne Praumlf ix) eingebaut Aufgrund des Praumlfixes kann unterschieden werden ob ein Text hinter einer Bezahlschranke ist oder nicht
Um Texte hinter Bezahlschranken melden zu koumlnnen muumlssen Sie fuumlr die VG WORT zuerst einen kostenfreien Zugang auf diese Texte einrichten Dies ist uumlber die Angabe von Zugangsdaten oder uumlber die Freischaltung von IP Adressen moumlglich (im TOM Menuuml unter Zugriff auf zugangsbeschraumlnkte Inhalte erlauben)
Das Praumlf ix lautet bdquopw-ldquo bdquopwldquo steht fuumlr den englischen Begriff bdquoPaywallldquo (Bezahlschranke)
In der Vergangenheit musste bei Zaumlhlungen von https- Seiten eine separate Zaumlhldomaumlne verwendet werden Wenn Sie die Zaumlhlungen uumlber diese separate Domaumlne eingebaut haben muumlssen Sie den Einbau nicht aumlndern Diese Variante wird weiterhin unterstuumltzt
236 Potenzielle Fehlerquelle Referrer-Tag
Bestimmte Einstellungen im Quellcode koumlnnen dazu fuumlhren dass Zaumlhlungen nicht mehr zugeordnet werden koumlnnen wenn die Meldungen eingehen Es sieht dann so aus als waumlren d ie Zaumlhlungen zu einem Text falsch (zB nur uumlber eine Startseite ohne den eigentlichen Text) erfolgt Das kann dazu fuumlhren dass diese Zaumlhlungen gestrichen werden und der Mindestzugriff nicht mehr gegeben is t Um solche Probleme zu vermeiden muumlssen Sie darauf achten wie das Referrer-Metatag im Quellcode Ihrer Seite eingestellt ist
Die Zeile ltmeta name=referrer content=origingt sorgt zB dafuumlr dass eine Seite die httpswwwbeispieldemein_texthtml heiszligt nur httpswwwbeispielde sendet Damit lassen s ich dann die Zugriffe nicht mehr der richtigen Seite zuordnen
Bei weiteren Einstellungen wird das Senden der Daten vollstaumlndig unterdruumlckt Auch dies kann dazu fuumlhren dass Zaumlhlungen nicht anerkannt werden wenn weitere Faktoren darauf hindeuten dass die Zaumlhlungen nicht korrekt sein koumlnnten
Nur bei den Einstellungen ltmeta name=referrer content=no-referrer-when-downgradeldquogt oder ltmeta name=referrer content=unsafe-urlgt kann man auf gezaumlhlten Seiten 100 sicher sein dass keine Meldungen wegen nicht nachvollziehbarer Zugriffszaumlhlungen abgewiesen werden
Diese Funktion ist in bestimmten Faumlllen hoch problematisch und in anderen Faumlllen sogar zwingend erforderlich
Die Verwendung von bdquoLazy Loadldquo ist immer zu vermeiden wenn sich auf einer URL nur ein Text oder nur ein Teil eines mehrseitigen Textes befindet Hier fuumlhrt die Funktion dazu dass die Zaumlhlmarken erst geladen werden wenn die Stelle mit der Zaumlhlmarke im Browser angezeigt wird Insbesondere wenn die Zaumlhlmarke am Ende der Seite oder des Textes eingebaut wird sorgt die Funkt ion dafuumlr dass unser Zaumlhlbild nur geladen wird wenn der Leser auch an der Stelle ankommt also zB bis ganz ans Ende der Seite oder des Textes scrollt Erreicht er die Stelle nicht weil die Zaumlhlmarke zB erst unterhalb der Seite und nach Werbeeinblendungen oder Kommentaren eingebaut ist dann wird das Bild auch nicht vom Zaumlhlserver abgerufen und es erfolgt somit auch KEINE Zaumlhlung
Anders sieht es hingegen aus wenn sich viele Texte auf einer Seite befinden oder weitere Texte automatisch eingeblendet werden sobald ein Leser das Textende des ersten Textes erreicht hat Da nicht automatisch davon ausgegangen werden kann dass Texte die vom jeweil igen Nutzer nicht gesucht wurden eine Kopierwahrscheinlichkeit haben darf in diesen Faumlllen die Zaumlhlung nur erfolgen wenn der Text tatsaumlchlich ausgewaumlhlt wird Dies kann mit Hilfe von Lazy load erreicht werden Dazu baut man die jeweilige Zaumlhlmarke am besten immer ab der Mitte eines Textes ein so dass einerseits sichergestellt ist dass gezaumlhlt wird und andererseits dass nur eine Zaumlhlung erfolgt wenn wirklich ein bestimmter Text angesehen wurde und damit die notwendige Kopierwahrscheinlichkeit gegeben ist
24 Uumlberpruumlfen der Zaumlhlungen
241 Anzeige Herunterladen in der Anwendung
In der Anwendung gibt es eine Funktionalitaumlt mit der man pruumlfen kann welche Zaumlhlmarken bereits gezaumlhlt werden bzw welche Zaumlhlmarken die Mindestzugriffe uumlberschritten haben Dadurch kann man feststellen ob der Einbau dieser Zaumlhlmarken korrekt ist Diese Funktionalitaumlt kann uumlber den Menuumlpunkt bdquoZaumlhlmarkenuumlbersichtldquo abgerufen werden Siehe Abbildung unten
Abbildung 3 Maskenbeschreibung Zaumlhlerstarts
Dabei gibt es folgende Filtermoumlglichkeiten
- bdquoIdentif ikationscodeldquo Der oumlffentliche bzw private Identifikationscode oder der verlagsinterne Schluumlssel der Zaumlhlmarke
- bdquoBestelldatum (von bis)ldquo Bestelldatum der Zaumlhlmarke
- bdquoMeldung erfolgtldquo Es werden nur Zaumlhlmarken angezeigt fuumlr die bereits eine Meldung vorliegt
- bdquoZaumlhlerstart erfolgtldquo Alle Zaumlhlmarken die gezaumlhlt werden
- bdquoMindestzugriffldquo Alle Zaumlhlmarken die den Mindestzugriff oder den anteiligen Mindestzugriff uumlberschritten haben
- bdquoin Ausgeblendete Zaumlhlmarken suchenldquo Es werden auch Zaumlhlmarken gesucht die uumlber die angebotene Funktionalitaumlt ausgeblendet wurden Zaumlhlmarken sollten ausgeblendet werden wenn diese in Texten eingebaut wurden die den Kriterien der VG WORT nicht entsprechen (zB zu kurze Texte) Ansonsten scheinen diese Zaumlhlmarken weiterhin staumlndig in der Suchergebnisliste auf
Die Filtermoumlglichkeiten fuumlr den Mindestzugriff greifen sobald die ersten Zaumlhldaten fuumlr ein Kalenderjahr vorliegen Allerdings ist die Anzeige fuumlr das laufende Jahr unter Vorbehalt und erfolgt auf der Basis
des letzten bekannten Mindestzugriffes Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald der Mindestzugriff zu einem Jahr im Meldesystem eingegeben wurde (immer im Januar des Folgejahres)
Die Zaumlhlmarken koumlnnen zusaumltzlich als Liste im CSV Format heruntergeladen werden
Der Zaumlhlerstart wird mit einer Verzoumlgerung von ca 4 Tagen angezeigt Dh wenn eine Zaumlhlmarke heute eingebaut wird scheint diese in der Statistik erst in ca 4 Tagen auf
Es empfiehlt sich testweise einige wenige Zaumlhlmarken einzubauen und zu pruumlfen ob die Zaumlhlungen korrekt gestartet werden bevor man den Einbau der Zaumlhlmarken auf das gesamte Internetangebot ausrollt
242 Abruf uumlber Web Service Schnittstelle
Im Gegensatz zur Maske (siehe oben) kann man uumlber das Web Service nur die Zaumlhlmarken bdquomit Mindestzugriff ohne Meldungldquo sowie bdquomit anteiligem Mindestzugriff ohne Meldungldquo herunterladen
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2421 pixelOverviewRequest
Feld Typ Beschreibung
offset Int Wiederaufsetzpunkt Das System returniert maximal 100 Zaumlhlmarken am Stuumlck
Falls es mehr Zaumlhlmarken gibt die die Kriterien erfuumlllen koumlnnen weitere
Zaumlhlmarken uumlber den offset ausgelesen werden
Beispiel (190 Zaumlhlmarken vorhanden)
1 Abfrage (offset = 0) Die Zaumlhlmarken 1 ndash 100 werden zuruumlckgegeben
2 Abfrage (offset = 100) Die Zaumlhlmarken 101 ndash 190 werden zuruumlckgegeben
type Auswahl Entweder bdquoMINDESTZUGRIFFldquo oder bdquoANTEILIGER_MINDESTZUGRIFFldquo
2422 pixelOverviewResponse
Feld Typ Beschreibung
Amount Int Anzahl der gefundenen Zaumlhlmarken
Offset Int Der beim Request angegebene offset
privateIdentificationId pixelIDType (Liste) Privater Identifikationscode oder verlagsinterner Schluumlssel
3 Meldung Nachdem eine Zaumlhlmarke bestellt und eingebaut wurde kann eine Meldung zum jeweiligen Text erfolgen Eine Meldung soll dann gemacht werden wenn sich der Text des gemeldeten Artikels nicht mehr wesentlich aumlndert da die VG WORT in den Pruumlfmechanismen den gemeldeten Text mit dem Text der sich tatsaumlchlich im Internet befindet vergleicht
Der spaumlteste Zeitpunkt zum Melden eines Textes ist der sogenannte Meldeschlusstermin Diesen f inden Sie auf der Homepage der VG WORT unter bdquoTermineldquo Derzeit ist der Meldeschluss fuumlr Verlage der 1 Juni des auf die Zaumlhlung folgenden Jahres
In den meisten Faumlllen empfiehlt sich eine bdquoWartefristldquo von 14 Tagen bevor die Meldung erstellt wird So lange der Text noch Aumlnderungen unterzogen wird besteht die Gefahr dass die von der VG WORT durchgefuumlhrten Pruumlfmechanismen fehlschlagen
Bitte setzen Sie sich vor Meldungen zu Texten die uumlber verlagsinterne Schluumlssel gezaumlhlt werden unbedingt mit der VG WORT (per Email an metissupportvgwortde) in Verbindung
31 Anforderungen an die Meldung
Anbei f inden Sie alle Daten die bei einer Meldung angegeben werden muumlssen - Eindeutiger Identifikationscode - Alle beteiligten Autoren Uumlbersetzer und Agenturen - Kurzbeschreibung Uumlberschrift (Titel) - Text - Erscheinungsorte (Webbereiche)
311 Eindeutiger Identifikationscode
Der Identif ikationscode zur Zaumlhlmarke die in den Text eingebaut wurde Je nachdem welche Zaumlhlmarke verwendet wird ist dies der private Identifikationscode (bei VG WORT Zaumlhlmarken) oder der verlagsinterne Schluumlssel
312 Alle beteiligten Autoren Uumlbersetzer und Agenturen
Alle die am Text beteiligt sind Es gibt drei Arten wie die Autoren undoder Uumlbersetzer gemeldet werden
Vorname + Nachname + Karteinummer Die bevorzugte Variante Dabei werden von einem Autor oder einem Uumlbersetzer der Vorname der Nachname und die VG WORT Karteinummer gemeldet Eine Meldung mit Schreibweisen oder Pseudonymen ist auch moumlglich wenn diese der VG WORT bekannt sind Der Vorteil an dieser Variante ist dass ein Autor somit bei der VG WORT eindeutig identifizierbar ist und der Verlag somit keine weiteren Schritte unternehmen muss damit der jeweilige Autor zu seiner Ausschuumlttung kommt
Diese Variante beinhaltet fuumlr den Verlag zwar einen Initialaufwand da die Karteinummern aller Autoren eingesammelt werden muumlssen in der Praxis hat sich diese Variante bei den meisten teilnehmenden Verlagen aber als die einfachste Variante erwiesen
Vorname + Nachname Wenn von einem Autor die VG WORT Karteinummer nicht bekannt ist kann der Autor auch uumlber den Vornamen und den Nachnamen gemeldet werden Den Autoren steht fuumlr das Auffinden der ausschuumlttungsrelevanten Meldungen eine Suchmaske zur Verfuumlgung Allerdings muss in diesem Fall der gemeldete Name exakt mit dem uumlbereinstimmen der im Datenbestand der VG WORT vorliegt
Ist der Vorname nicht vollstaumlndig bekannt kann er in der Variante erster Buchstabe des Vornamens + Punkt angegeben werden
Urheber ohne Wahrnehmungsvertrag Hat der Urheber des zu meldenden Werkes dem meldenden Verlag fuumlr dieses Werk die von der VG WORT wahrgenommenen gesetzlichen Verguumltungsanspruumlche nach dem Urheberrechtsgesetz abgetreten kann dieser Urheber mit Namen Geburtsdatum und Adresse angegeben werden Zusaumltzlich muss bestaumltigt werden dass der Urheber die Rechte uumlbertragen hat Die uumlbertragenen Rechte werden bei der Ausschuumlttung beruumlcksichtigt
Fuumlr Agenturmeldungen bei denen die Autoren nicht bekannt sind steht eine weitere Variante zur Verfuumlgung
Die Rechte koumlnnen dem Verlag erst nach der Veroumlffentlichung des Textes uumlbertragen werden Die schriftliche Rechteuumlbertragung des jeweiligen Autors muss der VG WORT jederzeit auf Anfrage zur Verfuumlgung gestellt werden
Kuumlrzel Wenn man eine Agentur melden moumlchte dann kann das aktuell uumlber diesen Weg erfolgen Als Kuumlrzel wird die Kurzbezeichnung der jeweiligen Agentur uumlbergeben (zB bdquodpaldquo)
Namentliche bekannte Urheber koumlnnen uumlber die Angabe bdquoKuumlrzelldquo nicht gemeldet werden Diese Angabe kann ausschlieszliglich fuumlr die Meldung von Agenturtexten bzw der Miturheberschaft eines nicht namentlich bekannten Agenturautoren verwendet werden
313 Kurzbeschreibung Uumlberschrift (Titel)
Der Titel des zu meldenden Artikels
314 Text
Der Text des zu meldenden Artikels (entweder als Klartext als PDF oder im EPUB Format) Benoumltigt wird der bdquoNettotextldquo (dh der Text ohne HTML Code und ohne Menuuml oder dergleichen)
315 Erscheinungsorte (Webbereiche)
Es muumlssen alle Erscheinungsorte des Texts auf denen die Zaumlhlmarke eingebaut wurde gemeldet werden Ein Erscheinungsort definiert sich aus allen URLs die benoumltigt werden um den gesamten Text einmal zu lesen
Beispiel 1 Ein Text der sich uumlber 2 URLs erstreckt muss mit einem Webbereich (mit 2 URLs) gemel-det werden (zB httpdomain1depage1html httpdomain1depage2html)
Beispiel 2 Ein Text der sich uumlber 1 URL erstreckt aber auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils einer URL) gemeldet werden (zB httpdomain1demytexthtml und httpdomain2demytexthtml)
Beispiel 3 Ein Text der sich uumlber 2 URLs erstreckt und auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils zwei URLs) gemeldet werden (zB httpdomain1depage1html httpdomain1depage2html und httpdomain2depage1html httpdomain2depage2html)
32 Meldung uumlbermitteln
321 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
bull Es sollen nur Texte gemeldet werden die bereits bdquostabilldquo sind (dh die sich nicht mehr haumlufig aumlndern) Aus diesem Grund wird empfohlen die Texte mit einer Zeitverzoumlgerung von einigen Tagen (zB 14 Tagen) zu melden Auf die Tantieme hat das keinen Einfluss da die Ausschuumlttung erst Ende September Anfang Oktober fuumlr das Vorjahr erfolgt
bull Die Meldungen sollen taumlglich in der Nacht uumlbertragen werden Zeitfenster 2200 ndash 0300 Von 0300 bis 0600 gibt es ein allgemeines Wartungsfenster wo nicht gemeldet werden kann
bull Um eine Uumlberlastung der Server (und somit houmlhere Wartezeit) zu verhindern sollen die Meldungen sequentiell (nicht parallel) uumlbertragen werden Idealerweise soll zwischen zwei Meldungen eine Sekunde verstreichen Aus transaktionaler Sicht wird jede Meldung einzeln behandelt Dh jede erfolgreich eingehende Meldung wird gespeichert ndash unabhaumlngig davon ob die vorherige oder nachfolgende Meldung einen Fehler verursacht hat
bull Alle fachlichen Fehlercodes (ein- oder zweistellig) deuten auf einen Fehler in der Meldung hin Es ist zwecklos diese Meldung unveraumlndert noch einmal abzusenden Dreistellige Fehler (sowie der HTML ndash 500 Fehler) deuten auf technische Probleme hin Hier ist es zweckmaumlszligig dieselben Meldungen zu einem spaumlteren Zeitpunkt (zB mit den Meldungen vom naumlchsten Tag) noch einmal zu uumlbertragen
bull Die Bestaumltigung der Meldung bedeutet dass die Meldung aus technischer Sicht in Ordnung ist (dh Mindestumfang von 1800 Zeichen die Zaumlhlmarke existiert hellip) In einer spaumlteren Phase werden die Meldungen noch durch automatische Pruumlfmechanismen der VG WORT in Stichproben gepruumlft Sollten dabei Maumlngel auftreten werden die betreffenden Meldungen zuruumlckgewiesen und der Inhaber des Meldekontos bei der VG WORT wird per Email verstaumlndigt Diese Meldungen koumlnnen dann im Portal entweder geloumlscht oder manuell nachbearbeitet und erneut versendet werden
3212 newMessageRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der private
Identifikationscode (bei VG WORT Zaumlhlmarken) oder der
verlagsinterne Schluumlssel
Parties Parties Die Urheber Uumlbersetzer Agenturen der Meldung Es muss mindestens ein Autor oder ein Uumlbersetzer angegeben werden
Es koumlnnen in einer Meldung sowohl Autoren als auch
Uumlbersetzer angegeben werden
partiesauthors Authors 0 bis mehrere Autoren Beschreibung siehe separate Tabelle
partiestranslators Translators 0 bis mehrere Uumlbersetzer Beschreibung siehe separate
Tabelle
messagetext MessageText Der gemeldete Text entweder als PDF EPUB oder als Klartext
messagetextshorttext string Kurzbezeichnung Uumlberschrift vom Text
messagetexttext Text Der Text an sich Beschreibung siehe separate Tabelle
messagetextlyric boolean bdquoTrueldquo wenn es sich beim Text um Lyrik handelt ansonsten
bdquoFalseldquo
webranges Webranges Erscheinungsort(e) unter demdenen der Text gefunden werden
kann
webrangeswebrange Webrange Ein Erscheinungsort Beschreibung siehe separate Tabelle
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Es empfiehlt sich zuerst die Zugriffszaumlhlung umzusetzen und erst dann die Meldung (siehe Kapitel 3) zu implementieren
Zum Zeitpunkt der Zugriffszaumlhlung muumlssen noch nicht alle Informationen zum Text (zB Autoreninformation) vorliegen Daher soll die Umsetzung der Zugriffszaumlhlung auf keinen Fall von solchen Faktoren abhaumlngen
214 Datenschutzerklaumlrung
Im Rahmen der Zugriffszaumlhlung werden Cookies und gegebenenfalls JavaScript - Aufrufe verwendet Es empfiehlt sich daher die Datenschutzerklaumlrung der Verlagsseite in der Zaumlhlmarken eingebaut werden um unten stehende Textbausteine zu ergaumlnzen
Cookies und Meldungen zu Zugriffszahlen
Wir setzen Session-Cookies der VG Wort Muumlnchen zur Messung von Zugriffen auf Texten ein um die Kopierwahrscheinlichkeit zu erfassen Session-Cookies sind kleine Informationseinheiten die ein Anbieter im Arbeitsspeicher des Computers des Besuchers speichert In einem Session-Cook ie wird eine zufaumlllig erzeugte eindeutige Identif ikationsnummer abgelegt eine sogenannte Session-ID Auszligerdem enthaumllt ein Cookie die Angabe uumlber seine Herkunft und die Speicherfrist Session-Cookies koumlnnen keine anderen Daten speichern Diese Messungen werden von der Kantar Germany GmbH nach dem Skalierbaren Zentralen Messverfahren (SZM) durchgefuumlhrt Sie helfen dabei die Kopierwahrscheinlichkeit einzelner Texte zur Verguumltung von gesetzlichen Anspruumlchen von Autoren und Verlagen zu ermitteln Wir erfassen keine personenbezogenen Daten uumlber Cookies
Viele unserer Seiten sind mit JavaScript-Aufrufen versehen uumlber die wir die Zugrif fe an die Verwertungsgesellschaft Wort (VG Wort) melden [BITTE UumlBERPRUumlFEN ob dies bei Ihrem Verlag der Fall ist] Wir ermoumlglichen damit dass unsere Autoren an den Ausschuumlttungen der VG Wort partizipieren die die gesetzliche Verguumltung fuumlr die Nutzungen urheberrechtlich geschuumltzter Werke gem sect 53 UrhG sicherstellen
Eine Nutzung unserer Angebote ist auch ohne Cookies moumlglich Die meisten Browser sind so eingestellt dass sie Cookies automatisch akzeptieren Sie koumlnnen das Speichern von Cookies jedoch deaktivieren oder Ihren Browser so einstellen dass er Sie benachrichtigt sobald Cookies gesendet werden
Datenschutzerklaumlrung zur Nutzung des Skalierbaren Zentralen Messverfahrens
Webangebote
Unsere Website und unser mobiles Webangebot nutzen das bdquoSkalierbare Zent rale Messverfahrenldquo (SZM) der Kantar Germany GmbH fuumlr die Ermittlung statistischer Kennwerte zur Ermittlung der Kopierwahrscheinlichkeit von Texten
Dabei werden anonyme Messwerte erhoben Die Zugrif fszahlenmessung verwendet zur Wiedererkennung von Computersystemen alternativ ein Session-Cookie oder eine Signatur die aus verschiedenen automatisch uumlbertragenen Informationen Ihres Browsers ers tel l t wird IP-Adressen werden nur in anonymisierter Form verarbeitet
Das Verfahren wurde unter der Beachtung des Datenschutzes entwickelt Einziges Ziel des Verfahrens ist es die Kopierwahrscheinlichkeit einzelner Texte zu ermitteln
Zu keinem Zeitpunkt werden einzelne Nutzer identifiziert Ihre Identitaumlt bleibt immer geschuumltzt Sie erhalten uumlber das System keine Werbung
22 Bestellen von Zaumlhlmarken
Verlage haben den Bedarf groszlige Mengen von Zaumlhlmarken auf einmal abzurufen um diese dann in den internen CMS Systemen vorraumltig zu halten Hierfuumlr gibt es zwei Varianten Eine Variante ist es die Zaumlhlmarken direkt aus dem Portal abzurufen bei der anderen Variante erfolgt der Abruf uumlber ein Web Service und kann so automatisiert werden
Grundsaumltzlich koumlnnen pro Jahr 4000 Zaumlhlmarken abgerufen werden Sollte ein Verlag mehr Zaumlhlmarken benoumltigen wird er gebeten sich per Email an metissupportvgwortde zu wenden damit die noumltigen Kapazitaumlten zur Verfuumlgung gestellt werden koumlnnen
Es empfiehlt sich immer einen Zaumlhlmarkenvorrat fuumlr zumindest eine Woche vorraumlt ig zu halten um nicht von der Verfuumlgbarkeit der METIS Anwendung abhaumlngig zu sein
Beim Einsatz von verlagsinternen Schluumlsseln als Zaumlhlmarken entfaumlllt die Bestellung der VG WORT Zaumlhlmarken
221 Bestellung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2211 orderPixelRequest
Feld Typ Beschreibung
count int Anzahl der zu bestellenden Zaumlhlmarken (gt1)
2212 orderPixelResponse
Feld Typ Beschreibung
orderDateTime string Bestelldatum + Zeit im Format bdquoYYYYMMddHHmmldquo
domain string Die Zaumlhlmarken Domaumlne Diese Domaumlne muss beim
Einbau dieser Zaumlhlmarken verwendet werden
pixels pixels Komplexer Datentyp
pixelspublicIdentificationId pixelIDType Oumlffentlicher Identifikationscode der Zaumlhlmarke
pixelsprivateIdentificationId pixelIDType Privater Identifikationscode der Zaumlhlmarke
2213 orderPixelFault
Feld Typ Beschreibung
errorcode int Der Fehlercode
errormsg string Grund fuumlr den Bestellabbruch
maxOrder Int Die maximale Anzahl die fuumlr die jeweilige Bestellung moumlglich gewesen
waumlre (wird nur bei Fehlercode bdquo1ldquo oder Fehlercode bdquo2ldquo angegeben)
22131 Fehlercodes
Fehlerfall Fehlercode maxOrder Meldung
MaxAnzahlBestellung 1 Die maximale Anzahl () an Zaumlhlmarken fuumlr diese
Bestellung wurde um uumlberschritten
MaxAnzahlJahr 2 Die maximale Anzahl () an Zaumlhlmarken fuumlr das
Jahr wurde um uumlberschritten
KeineEMailVorhanden 3 0 Es existiert keine Email-Adresse in Ihrem
Benutzerkonto bitte tragen Sie diese im Meldeportal
Nach Eingabe der benoumltigten Zaumlhlmarken und Klicken auf die Schaltflaumlche bdquoZaumlhlmarken bestellenldquo werden die Zaumlhlmarken vom System generiert Danach wird die Seite zum Download der eben bestellten Zaumlhlmarken angezeigt Falls mehr Zaumlhlmarken bestellt wurden als noch zur Verfuumlgung stehen kommt eine entsprechende Fehlermeldung In diesem Fall wenden Sie sich bitte per Email an metissupportvgwortde
Abbildung 2 Maskenbeschreibung Download der generierten Zaumlhlmarken
In der oben stehenden Maske befindet sich neben der Zaumlhldomaumlne auch Einbaubeispiele fuumlr HTML Texte Beim Klicken auf bdquoDownload der reinen Codepaare als CSV-Dateildquo koumlnnen die bestellten Zaumlhlmarken heruntergeladen werden Das Format der CSV Datei ist im folgenden Abschnitt beschrieben Beim Klicken auf bdquoDownload der vorkonfigurierten Zaumlhlmarken als CSV-Dateildquo wird eine Datei ausgegeben die alle Zaumlhlmarken als fertigen HTML Code enthaumllt
2221 CSV-Datei Format
Die CSV-Datei wird im folgenden Format erstellt (Die Spalten werden durch ein Semikolon getrennt)
Die Zaumlhlmarke ist ein transparentes (unsichtbares) Bild mit der Groumlszlige von 1 x 1 Pixel Es hat keinesfalls Einfluss auf die Ladezeit der Seite da Bilder von den Browsern separat zum Text geladen werden Das unsichtbare Bild hat auch keinen Einfluss auf das Erscheinungsbild der Seite
Einbaubeispiel VG WORT Zaumlhlmarke in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquoc5b7568d28884052a9ff92d5afd08f34rdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquovgzm970-123456789rdquo
Der korrekt formatierte verlagsinterne Schluumlssel des zu zaumlhlenden Textes
232 Fuumlr Dokumente (PDF oder EPUB Dateien)
Eine Zaumlhlmarke kann nicht direkt in eine dieser Dateien eingebaut werden Sie muss daher in die HTML Seite eingebaut werden von der aus das Dokument verlinkt wird Verlinkungen von anderen Seiten koumlnnen nicht beruumlcksichtigt werden Da eine Weiterleitung vom Zaumlhlserver auf externe Dateien aus sicherheitstechnischen Gruumlnden nicht angeboten werden kann benoumltigt man JavaScript um die Zugriffe auf eine PDF Datei zaumlhlen zu koumlnnen
In diesem Fall wird das Zaumlhlpixel (unsichtbare Bild) uumlber JavaScript in die HTML Seite eingefuumlgt sobald das Dokument (der Link auf das Dokument bleibt unveraumlndert) abgerufen wird
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquo98380ae3fc0a4daf84d6197274add99erdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquohttpwwwstepscondebeispielepubrdquo
Der Link auf das zu zaumlhlende Dokument
- LINK-Name
Name des Links
Auch dabei ist der Einsatz von verlagsinternen Schluumlsseln moumlglich In diesem Fall wird der korrekt formatierte verlagsinterne Schluumlssel anstelle vom oumlffentlichen Identifikationscode verwendet Auf ein separates Einbaubeispiel wird in diesem Dokument verzichtet
233 Base64url enkodierte Zaumlhlmarken
Die verwendbaren Zeichen in einer Zaumlhlmarke sind stark beschraumlnkt (siehe oben) Sollten verlagsinterne Schluumlssel mit nicht erlaubten Zeichen zum Einsatz kommen kann die Zaumlhlmarke Base64url (Codepage UTF-8) enkodiert werden In diesem Fall wird die encodierte Zaumlhlmarke mit Praumlf ix bdquobase64-ldquo eingebaut
Zum Thema Base64url Die Zeichen + und werden nach der Base64-Enkodierung durch - (Minus ASCII 2Dhex) und _ (Unterstrich ASCII 5Fhex) ersetzt
Einbaubeispiel verlagsinterner Schluumlssel in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Zugriffe von Texten hinter Bezahlschranken werden mit Faktor 3 multipliziert Die Aufwertung der Zaumlhlwerte hinter Bezahlschranken erfolgt mittels einer gesonderten Zaumlhlung Hierfuumlr muss der Verlag die Zaumlhlmarke beim Einbau mit einem Praumlfix versehen Dieses Praumlfix darf nur fuumlr Texte hinter Bezahlschranken verwendet werden Ist der Text frei zugaumlnglich wird die Zaumlhlmarke wie bisher (ohne Praumlf ix) eingebaut Aufgrund des Praumlfixes kann unterschieden werden ob ein Text hinter einer Bezahlschranke ist oder nicht
Um Texte hinter Bezahlschranken melden zu koumlnnen muumlssen Sie fuumlr die VG WORT zuerst einen kostenfreien Zugang auf diese Texte einrichten Dies ist uumlber die Angabe von Zugangsdaten oder uumlber die Freischaltung von IP Adressen moumlglich (im TOM Menuuml unter Zugriff auf zugangsbeschraumlnkte Inhalte erlauben)
Das Praumlf ix lautet bdquopw-ldquo bdquopwldquo steht fuumlr den englischen Begriff bdquoPaywallldquo (Bezahlschranke)
In der Vergangenheit musste bei Zaumlhlungen von https- Seiten eine separate Zaumlhldomaumlne verwendet werden Wenn Sie die Zaumlhlungen uumlber diese separate Domaumlne eingebaut haben muumlssen Sie den Einbau nicht aumlndern Diese Variante wird weiterhin unterstuumltzt
236 Potenzielle Fehlerquelle Referrer-Tag
Bestimmte Einstellungen im Quellcode koumlnnen dazu fuumlhren dass Zaumlhlungen nicht mehr zugeordnet werden koumlnnen wenn die Meldungen eingehen Es sieht dann so aus als waumlren d ie Zaumlhlungen zu einem Text falsch (zB nur uumlber eine Startseite ohne den eigentlichen Text) erfolgt Das kann dazu fuumlhren dass diese Zaumlhlungen gestrichen werden und der Mindestzugriff nicht mehr gegeben is t Um solche Probleme zu vermeiden muumlssen Sie darauf achten wie das Referrer-Metatag im Quellcode Ihrer Seite eingestellt ist
Die Zeile ltmeta name=referrer content=origingt sorgt zB dafuumlr dass eine Seite die httpswwwbeispieldemein_texthtml heiszligt nur httpswwwbeispielde sendet Damit lassen s ich dann die Zugriffe nicht mehr der richtigen Seite zuordnen
Bei weiteren Einstellungen wird das Senden der Daten vollstaumlndig unterdruumlckt Auch dies kann dazu fuumlhren dass Zaumlhlungen nicht anerkannt werden wenn weitere Faktoren darauf hindeuten dass die Zaumlhlungen nicht korrekt sein koumlnnten
Nur bei den Einstellungen ltmeta name=referrer content=no-referrer-when-downgradeldquogt oder ltmeta name=referrer content=unsafe-urlgt kann man auf gezaumlhlten Seiten 100 sicher sein dass keine Meldungen wegen nicht nachvollziehbarer Zugriffszaumlhlungen abgewiesen werden
Diese Funktion ist in bestimmten Faumlllen hoch problematisch und in anderen Faumlllen sogar zwingend erforderlich
Die Verwendung von bdquoLazy Loadldquo ist immer zu vermeiden wenn sich auf einer URL nur ein Text oder nur ein Teil eines mehrseitigen Textes befindet Hier fuumlhrt die Funktion dazu dass die Zaumlhlmarken erst geladen werden wenn die Stelle mit der Zaumlhlmarke im Browser angezeigt wird Insbesondere wenn die Zaumlhlmarke am Ende der Seite oder des Textes eingebaut wird sorgt die Funkt ion dafuumlr dass unser Zaumlhlbild nur geladen wird wenn der Leser auch an der Stelle ankommt also zB bis ganz ans Ende der Seite oder des Textes scrollt Erreicht er die Stelle nicht weil die Zaumlhlmarke zB erst unterhalb der Seite und nach Werbeeinblendungen oder Kommentaren eingebaut ist dann wird das Bild auch nicht vom Zaumlhlserver abgerufen und es erfolgt somit auch KEINE Zaumlhlung
Anders sieht es hingegen aus wenn sich viele Texte auf einer Seite befinden oder weitere Texte automatisch eingeblendet werden sobald ein Leser das Textende des ersten Textes erreicht hat Da nicht automatisch davon ausgegangen werden kann dass Texte die vom jeweil igen Nutzer nicht gesucht wurden eine Kopierwahrscheinlichkeit haben darf in diesen Faumlllen die Zaumlhlung nur erfolgen wenn der Text tatsaumlchlich ausgewaumlhlt wird Dies kann mit Hilfe von Lazy load erreicht werden Dazu baut man die jeweilige Zaumlhlmarke am besten immer ab der Mitte eines Textes ein so dass einerseits sichergestellt ist dass gezaumlhlt wird und andererseits dass nur eine Zaumlhlung erfolgt wenn wirklich ein bestimmter Text angesehen wurde und damit die notwendige Kopierwahrscheinlichkeit gegeben ist
24 Uumlberpruumlfen der Zaumlhlungen
241 Anzeige Herunterladen in der Anwendung
In der Anwendung gibt es eine Funktionalitaumlt mit der man pruumlfen kann welche Zaumlhlmarken bereits gezaumlhlt werden bzw welche Zaumlhlmarken die Mindestzugriffe uumlberschritten haben Dadurch kann man feststellen ob der Einbau dieser Zaumlhlmarken korrekt ist Diese Funktionalitaumlt kann uumlber den Menuumlpunkt bdquoZaumlhlmarkenuumlbersichtldquo abgerufen werden Siehe Abbildung unten
Abbildung 3 Maskenbeschreibung Zaumlhlerstarts
Dabei gibt es folgende Filtermoumlglichkeiten
- bdquoIdentif ikationscodeldquo Der oumlffentliche bzw private Identifikationscode oder der verlagsinterne Schluumlssel der Zaumlhlmarke
- bdquoBestelldatum (von bis)ldquo Bestelldatum der Zaumlhlmarke
- bdquoMeldung erfolgtldquo Es werden nur Zaumlhlmarken angezeigt fuumlr die bereits eine Meldung vorliegt
- bdquoZaumlhlerstart erfolgtldquo Alle Zaumlhlmarken die gezaumlhlt werden
- bdquoMindestzugriffldquo Alle Zaumlhlmarken die den Mindestzugriff oder den anteiligen Mindestzugriff uumlberschritten haben
- bdquoin Ausgeblendete Zaumlhlmarken suchenldquo Es werden auch Zaumlhlmarken gesucht die uumlber die angebotene Funktionalitaumlt ausgeblendet wurden Zaumlhlmarken sollten ausgeblendet werden wenn diese in Texten eingebaut wurden die den Kriterien der VG WORT nicht entsprechen (zB zu kurze Texte) Ansonsten scheinen diese Zaumlhlmarken weiterhin staumlndig in der Suchergebnisliste auf
Die Filtermoumlglichkeiten fuumlr den Mindestzugriff greifen sobald die ersten Zaumlhldaten fuumlr ein Kalenderjahr vorliegen Allerdings ist die Anzeige fuumlr das laufende Jahr unter Vorbehalt und erfolgt auf der Basis
des letzten bekannten Mindestzugriffes Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald der Mindestzugriff zu einem Jahr im Meldesystem eingegeben wurde (immer im Januar des Folgejahres)
Die Zaumlhlmarken koumlnnen zusaumltzlich als Liste im CSV Format heruntergeladen werden
Der Zaumlhlerstart wird mit einer Verzoumlgerung von ca 4 Tagen angezeigt Dh wenn eine Zaumlhlmarke heute eingebaut wird scheint diese in der Statistik erst in ca 4 Tagen auf
Es empfiehlt sich testweise einige wenige Zaumlhlmarken einzubauen und zu pruumlfen ob die Zaumlhlungen korrekt gestartet werden bevor man den Einbau der Zaumlhlmarken auf das gesamte Internetangebot ausrollt
242 Abruf uumlber Web Service Schnittstelle
Im Gegensatz zur Maske (siehe oben) kann man uumlber das Web Service nur die Zaumlhlmarken bdquomit Mindestzugriff ohne Meldungldquo sowie bdquomit anteiligem Mindestzugriff ohne Meldungldquo herunterladen
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2421 pixelOverviewRequest
Feld Typ Beschreibung
offset Int Wiederaufsetzpunkt Das System returniert maximal 100 Zaumlhlmarken am Stuumlck
Falls es mehr Zaumlhlmarken gibt die die Kriterien erfuumlllen koumlnnen weitere
Zaumlhlmarken uumlber den offset ausgelesen werden
Beispiel (190 Zaumlhlmarken vorhanden)
1 Abfrage (offset = 0) Die Zaumlhlmarken 1 ndash 100 werden zuruumlckgegeben
2 Abfrage (offset = 100) Die Zaumlhlmarken 101 ndash 190 werden zuruumlckgegeben
type Auswahl Entweder bdquoMINDESTZUGRIFFldquo oder bdquoANTEILIGER_MINDESTZUGRIFFldquo
2422 pixelOverviewResponse
Feld Typ Beschreibung
Amount Int Anzahl der gefundenen Zaumlhlmarken
Offset Int Der beim Request angegebene offset
privateIdentificationId pixelIDType (Liste) Privater Identifikationscode oder verlagsinterner Schluumlssel
3 Meldung Nachdem eine Zaumlhlmarke bestellt und eingebaut wurde kann eine Meldung zum jeweiligen Text erfolgen Eine Meldung soll dann gemacht werden wenn sich der Text des gemeldeten Artikels nicht mehr wesentlich aumlndert da die VG WORT in den Pruumlfmechanismen den gemeldeten Text mit dem Text der sich tatsaumlchlich im Internet befindet vergleicht
Der spaumlteste Zeitpunkt zum Melden eines Textes ist der sogenannte Meldeschlusstermin Diesen f inden Sie auf der Homepage der VG WORT unter bdquoTermineldquo Derzeit ist der Meldeschluss fuumlr Verlage der 1 Juni des auf die Zaumlhlung folgenden Jahres
In den meisten Faumlllen empfiehlt sich eine bdquoWartefristldquo von 14 Tagen bevor die Meldung erstellt wird So lange der Text noch Aumlnderungen unterzogen wird besteht die Gefahr dass die von der VG WORT durchgefuumlhrten Pruumlfmechanismen fehlschlagen
Bitte setzen Sie sich vor Meldungen zu Texten die uumlber verlagsinterne Schluumlssel gezaumlhlt werden unbedingt mit der VG WORT (per Email an metissupportvgwortde) in Verbindung
31 Anforderungen an die Meldung
Anbei f inden Sie alle Daten die bei einer Meldung angegeben werden muumlssen - Eindeutiger Identifikationscode - Alle beteiligten Autoren Uumlbersetzer und Agenturen - Kurzbeschreibung Uumlberschrift (Titel) - Text - Erscheinungsorte (Webbereiche)
311 Eindeutiger Identifikationscode
Der Identif ikationscode zur Zaumlhlmarke die in den Text eingebaut wurde Je nachdem welche Zaumlhlmarke verwendet wird ist dies der private Identifikationscode (bei VG WORT Zaumlhlmarken) oder der verlagsinterne Schluumlssel
312 Alle beteiligten Autoren Uumlbersetzer und Agenturen
Alle die am Text beteiligt sind Es gibt drei Arten wie die Autoren undoder Uumlbersetzer gemeldet werden
Vorname + Nachname + Karteinummer Die bevorzugte Variante Dabei werden von einem Autor oder einem Uumlbersetzer der Vorname der Nachname und die VG WORT Karteinummer gemeldet Eine Meldung mit Schreibweisen oder Pseudonymen ist auch moumlglich wenn diese der VG WORT bekannt sind Der Vorteil an dieser Variante ist dass ein Autor somit bei der VG WORT eindeutig identifizierbar ist und der Verlag somit keine weiteren Schritte unternehmen muss damit der jeweilige Autor zu seiner Ausschuumlttung kommt
Diese Variante beinhaltet fuumlr den Verlag zwar einen Initialaufwand da die Karteinummern aller Autoren eingesammelt werden muumlssen in der Praxis hat sich diese Variante bei den meisten teilnehmenden Verlagen aber als die einfachste Variante erwiesen
Vorname + Nachname Wenn von einem Autor die VG WORT Karteinummer nicht bekannt ist kann der Autor auch uumlber den Vornamen und den Nachnamen gemeldet werden Den Autoren steht fuumlr das Auffinden der ausschuumlttungsrelevanten Meldungen eine Suchmaske zur Verfuumlgung Allerdings muss in diesem Fall der gemeldete Name exakt mit dem uumlbereinstimmen der im Datenbestand der VG WORT vorliegt
Ist der Vorname nicht vollstaumlndig bekannt kann er in der Variante erster Buchstabe des Vornamens + Punkt angegeben werden
Urheber ohne Wahrnehmungsvertrag Hat der Urheber des zu meldenden Werkes dem meldenden Verlag fuumlr dieses Werk die von der VG WORT wahrgenommenen gesetzlichen Verguumltungsanspruumlche nach dem Urheberrechtsgesetz abgetreten kann dieser Urheber mit Namen Geburtsdatum und Adresse angegeben werden Zusaumltzlich muss bestaumltigt werden dass der Urheber die Rechte uumlbertragen hat Die uumlbertragenen Rechte werden bei der Ausschuumlttung beruumlcksichtigt
Fuumlr Agenturmeldungen bei denen die Autoren nicht bekannt sind steht eine weitere Variante zur Verfuumlgung
Die Rechte koumlnnen dem Verlag erst nach der Veroumlffentlichung des Textes uumlbertragen werden Die schriftliche Rechteuumlbertragung des jeweiligen Autors muss der VG WORT jederzeit auf Anfrage zur Verfuumlgung gestellt werden
Kuumlrzel Wenn man eine Agentur melden moumlchte dann kann das aktuell uumlber diesen Weg erfolgen Als Kuumlrzel wird die Kurzbezeichnung der jeweiligen Agentur uumlbergeben (zB bdquodpaldquo)
Namentliche bekannte Urheber koumlnnen uumlber die Angabe bdquoKuumlrzelldquo nicht gemeldet werden Diese Angabe kann ausschlieszliglich fuumlr die Meldung von Agenturtexten bzw der Miturheberschaft eines nicht namentlich bekannten Agenturautoren verwendet werden
313 Kurzbeschreibung Uumlberschrift (Titel)
Der Titel des zu meldenden Artikels
314 Text
Der Text des zu meldenden Artikels (entweder als Klartext als PDF oder im EPUB Format) Benoumltigt wird der bdquoNettotextldquo (dh der Text ohne HTML Code und ohne Menuuml oder dergleichen)
315 Erscheinungsorte (Webbereiche)
Es muumlssen alle Erscheinungsorte des Texts auf denen die Zaumlhlmarke eingebaut wurde gemeldet werden Ein Erscheinungsort definiert sich aus allen URLs die benoumltigt werden um den gesamten Text einmal zu lesen
Beispiel 1 Ein Text der sich uumlber 2 URLs erstreckt muss mit einem Webbereich (mit 2 URLs) gemel-det werden (zB httpdomain1depage1html httpdomain1depage2html)
Beispiel 2 Ein Text der sich uumlber 1 URL erstreckt aber auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils einer URL) gemeldet werden (zB httpdomain1demytexthtml und httpdomain2demytexthtml)
Beispiel 3 Ein Text der sich uumlber 2 URLs erstreckt und auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils zwei URLs) gemeldet werden (zB httpdomain1depage1html httpdomain1depage2html und httpdomain2depage1html httpdomain2depage2html)
32 Meldung uumlbermitteln
321 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
bull Es sollen nur Texte gemeldet werden die bereits bdquostabilldquo sind (dh die sich nicht mehr haumlufig aumlndern) Aus diesem Grund wird empfohlen die Texte mit einer Zeitverzoumlgerung von einigen Tagen (zB 14 Tagen) zu melden Auf die Tantieme hat das keinen Einfluss da die Ausschuumlttung erst Ende September Anfang Oktober fuumlr das Vorjahr erfolgt
bull Die Meldungen sollen taumlglich in der Nacht uumlbertragen werden Zeitfenster 2200 ndash 0300 Von 0300 bis 0600 gibt es ein allgemeines Wartungsfenster wo nicht gemeldet werden kann
bull Um eine Uumlberlastung der Server (und somit houmlhere Wartezeit) zu verhindern sollen die Meldungen sequentiell (nicht parallel) uumlbertragen werden Idealerweise soll zwischen zwei Meldungen eine Sekunde verstreichen Aus transaktionaler Sicht wird jede Meldung einzeln behandelt Dh jede erfolgreich eingehende Meldung wird gespeichert ndash unabhaumlngig davon ob die vorherige oder nachfolgende Meldung einen Fehler verursacht hat
bull Alle fachlichen Fehlercodes (ein- oder zweistellig) deuten auf einen Fehler in der Meldung hin Es ist zwecklos diese Meldung unveraumlndert noch einmal abzusenden Dreistellige Fehler (sowie der HTML ndash 500 Fehler) deuten auf technische Probleme hin Hier ist es zweckmaumlszligig dieselben Meldungen zu einem spaumlteren Zeitpunkt (zB mit den Meldungen vom naumlchsten Tag) noch einmal zu uumlbertragen
bull Die Bestaumltigung der Meldung bedeutet dass die Meldung aus technischer Sicht in Ordnung ist (dh Mindestumfang von 1800 Zeichen die Zaumlhlmarke existiert hellip) In einer spaumlteren Phase werden die Meldungen noch durch automatische Pruumlfmechanismen der VG WORT in Stichproben gepruumlft Sollten dabei Maumlngel auftreten werden die betreffenden Meldungen zuruumlckgewiesen und der Inhaber des Meldekontos bei der VG WORT wird per Email verstaumlndigt Diese Meldungen koumlnnen dann im Portal entweder geloumlscht oder manuell nachbearbeitet und erneut versendet werden
3212 newMessageRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der private
Identifikationscode (bei VG WORT Zaumlhlmarken) oder der
verlagsinterne Schluumlssel
Parties Parties Die Urheber Uumlbersetzer Agenturen der Meldung Es muss mindestens ein Autor oder ein Uumlbersetzer angegeben werden
Es koumlnnen in einer Meldung sowohl Autoren als auch
Uumlbersetzer angegeben werden
partiesauthors Authors 0 bis mehrere Autoren Beschreibung siehe separate Tabelle
partiestranslators Translators 0 bis mehrere Uumlbersetzer Beschreibung siehe separate
Tabelle
messagetext MessageText Der gemeldete Text entweder als PDF EPUB oder als Klartext
messagetextshorttext string Kurzbezeichnung Uumlberschrift vom Text
messagetexttext Text Der Text an sich Beschreibung siehe separate Tabelle
messagetextlyric boolean bdquoTrueldquo wenn es sich beim Text um Lyrik handelt ansonsten
bdquoFalseldquo
webranges Webranges Erscheinungsort(e) unter demdenen der Text gefunden werden
kann
webrangeswebrange Webrange Ein Erscheinungsort Beschreibung siehe separate Tabelle
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Grundsaumltzlich koumlnnen pro Jahr 4000 Zaumlhlmarken abgerufen werden Sollte ein Verlag mehr Zaumlhlmarken benoumltigen wird er gebeten sich per Email an metissupportvgwortde zu wenden damit die noumltigen Kapazitaumlten zur Verfuumlgung gestellt werden koumlnnen
Es empfiehlt sich immer einen Zaumlhlmarkenvorrat fuumlr zumindest eine Woche vorraumlt ig zu halten um nicht von der Verfuumlgbarkeit der METIS Anwendung abhaumlngig zu sein
Beim Einsatz von verlagsinternen Schluumlsseln als Zaumlhlmarken entfaumlllt die Bestellung der VG WORT Zaumlhlmarken
221 Bestellung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2211 orderPixelRequest
Feld Typ Beschreibung
count int Anzahl der zu bestellenden Zaumlhlmarken (gt1)
2212 orderPixelResponse
Feld Typ Beschreibung
orderDateTime string Bestelldatum + Zeit im Format bdquoYYYYMMddHHmmldquo
domain string Die Zaumlhlmarken Domaumlne Diese Domaumlne muss beim
Einbau dieser Zaumlhlmarken verwendet werden
pixels pixels Komplexer Datentyp
pixelspublicIdentificationId pixelIDType Oumlffentlicher Identifikationscode der Zaumlhlmarke
pixelsprivateIdentificationId pixelIDType Privater Identifikationscode der Zaumlhlmarke
2213 orderPixelFault
Feld Typ Beschreibung
errorcode int Der Fehlercode
errormsg string Grund fuumlr den Bestellabbruch
maxOrder Int Die maximale Anzahl die fuumlr die jeweilige Bestellung moumlglich gewesen
waumlre (wird nur bei Fehlercode bdquo1ldquo oder Fehlercode bdquo2ldquo angegeben)
22131 Fehlercodes
Fehlerfall Fehlercode maxOrder Meldung
MaxAnzahlBestellung 1 Die maximale Anzahl () an Zaumlhlmarken fuumlr diese
Bestellung wurde um uumlberschritten
MaxAnzahlJahr 2 Die maximale Anzahl () an Zaumlhlmarken fuumlr das
Jahr wurde um uumlberschritten
KeineEMailVorhanden 3 0 Es existiert keine Email-Adresse in Ihrem
Benutzerkonto bitte tragen Sie diese im Meldeportal
Nach Eingabe der benoumltigten Zaumlhlmarken und Klicken auf die Schaltflaumlche bdquoZaumlhlmarken bestellenldquo werden die Zaumlhlmarken vom System generiert Danach wird die Seite zum Download der eben bestellten Zaumlhlmarken angezeigt Falls mehr Zaumlhlmarken bestellt wurden als noch zur Verfuumlgung stehen kommt eine entsprechende Fehlermeldung In diesem Fall wenden Sie sich bitte per Email an metissupportvgwortde
Abbildung 2 Maskenbeschreibung Download der generierten Zaumlhlmarken
In der oben stehenden Maske befindet sich neben der Zaumlhldomaumlne auch Einbaubeispiele fuumlr HTML Texte Beim Klicken auf bdquoDownload der reinen Codepaare als CSV-Dateildquo koumlnnen die bestellten Zaumlhlmarken heruntergeladen werden Das Format der CSV Datei ist im folgenden Abschnitt beschrieben Beim Klicken auf bdquoDownload der vorkonfigurierten Zaumlhlmarken als CSV-Dateildquo wird eine Datei ausgegeben die alle Zaumlhlmarken als fertigen HTML Code enthaumllt
2221 CSV-Datei Format
Die CSV-Datei wird im folgenden Format erstellt (Die Spalten werden durch ein Semikolon getrennt)
Die Zaumlhlmarke ist ein transparentes (unsichtbares) Bild mit der Groumlszlige von 1 x 1 Pixel Es hat keinesfalls Einfluss auf die Ladezeit der Seite da Bilder von den Browsern separat zum Text geladen werden Das unsichtbare Bild hat auch keinen Einfluss auf das Erscheinungsbild der Seite
Einbaubeispiel VG WORT Zaumlhlmarke in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquoc5b7568d28884052a9ff92d5afd08f34rdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquovgzm970-123456789rdquo
Der korrekt formatierte verlagsinterne Schluumlssel des zu zaumlhlenden Textes
232 Fuumlr Dokumente (PDF oder EPUB Dateien)
Eine Zaumlhlmarke kann nicht direkt in eine dieser Dateien eingebaut werden Sie muss daher in die HTML Seite eingebaut werden von der aus das Dokument verlinkt wird Verlinkungen von anderen Seiten koumlnnen nicht beruumlcksichtigt werden Da eine Weiterleitung vom Zaumlhlserver auf externe Dateien aus sicherheitstechnischen Gruumlnden nicht angeboten werden kann benoumltigt man JavaScript um die Zugriffe auf eine PDF Datei zaumlhlen zu koumlnnen
In diesem Fall wird das Zaumlhlpixel (unsichtbare Bild) uumlber JavaScript in die HTML Seite eingefuumlgt sobald das Dokument (der Link auf das Dokument bleibt unveraumlndert) abgerufen wird
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquo98380ae3fc0a4daf84d6197274add99erdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquohttpwwwstepscondebeispielepubrdquo
Der Link auf das zu zaumlhlende Dokument
- LINK-Name
Name des Links
Auch dabei ist der Einsatz von verlagsinternen Schluumlsseln moumlglich In diesem Fall wird der korrekt formatierte verlagsinterne Schluumlssel anstelle vom oumlffentlichen Identifikationscode verwendet Auf ein separates Einbaubeispiel wird in diesem Dokument verzichtet
233 Base64url enkodierte Zaumlhlmarken
Die verwendbaren Zeichen in einer Zaumlhlmarke sind stark beschraumlnkt (siehe oben) Sollten verlagsinterne Schluumlssel mit nicht erlaubten Zeichen zum Einsatz kommen kann die Zaumlhlmarke Base64url (Codepage UTF-8) enkodiert werden In diesem Fall wird die encodierte Zaumlhlmarke mit Praumlf ix bdquobase64-ldquo eingebaut
Zum Thema Base64url Die Zeichen + und werden nach der Base64-Enkodierung durch - (Minus ASCII 2Dhex) und _ (Unterstrich ASCII 5Fhex) ersetzt
Einbaubeispiel verlagsinterner Schluumlssel in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Zugriffe von Texten hinter Bezahlschranken werden mit Faktor 3 multipliziert Die Aufwertung der Zaumlhlwerte hinter Bezahlschranken erfolgt mittels einer gesonderten Zaumlhlung Hierfuumlr muss der Verlag die Zaumlhlmarke beim Einbau mit einem Praumlfix versehen Dieses Praumlfix darf nur fuumlr Texte hinter Bezahlschranken verwendet werden Ist der Text frei zugaumlnglich wird die Zaumlhlmarke wie bisher (ohne Praumlf ix) eingebaut Aufgrund des Praumlfixes kann unterschieden werden ob ein Text hinter einer Bezahlschranke ist oder nicht
Um Texte hinter Bezahlschranken melden zu koumlnnen muumlssen Sie fuumlr die VG WORT zuerst einen kostenfreien Zugang auf diese Texte einrichten Dies ist uumlber die Angabe von Zugangsdaten oder uumlber die Freischaltung von IP Adressen moumlglich (im TOM Menuuml unter Zugriff auf zugangsbeschraumlnkte Inhalte erlauben)
Das Praumlf ix lautet bdquopw-ldquo bdquopwldquo steht fuumlr den englischen Begriff bdquoPaywallldquo (Bezahlschranke)
In der Vergangenheit musste bei Zaumlhlungen von https- Seiten eine separate Zaumlhldomaumlne verwendet werden Wenn Sie die Zaumlhlungen uumlber diese separate Domaumlne eingebaut haben muumlssen Sie den Einbau nicht aumlndern Diese Variante wird weiterhin unterstuumltzt
236 Potenzielle Fehlerquelle Referrer-Tag
Bestimmte Einstellungen im Quellcode koumlnnen dazu fuumlhren dass Zaumlhlungen nicht mehr zugeordnet werden koumlnnen wenn die Meldungen eingehen Es sieht dann so aus als waumlren d ie Zaumlhlungen zu einem Text falsch (zB nur uumlber eine Startseite ohne den eigentlichen Text) erfolgt Das kann dazu fuumlhren dass diese Zaumlhlungen gestrichen werden und der Mindestzugriff nicht mehr gegeben is t Um solche Probleme zu vermeiden muumlssen Sie darauf achten wie das Referrer-Metatag im Quellcode Ihrer Seite eingestellt ist
Die Zeile ltmeta name=referrer content=origingt sorgt zB dafuumlr dass eine Seite die httpswwwbeispieldemein_texthtml heiszligt nur httpswwwbeispielde sendet Damit lassen s ich dann die Zugriffe nicht mehr der richtigen Seite zuordnen
Bei weiteren Einstellungen wird das Senden der Daten vollstaumlndig unterdruumlckt Auch dies kann dazu fuumlhren dass Zaumlhlungen nicht anerkannt werden wenn weitere Faktoren darauf hindeuten dass die Zaumlhlungen nicht korrekt sein koumlnnten
Nur bei den Einstellungen ltmeta name=referrer content=no-referrer-when-downgradeldquogt oder ltmeta name=referrer content=unsafe-urlgt kann man auf gezaumlhlten Seiten 100 sicher sein dass keine Meldungen wegen nicht nachvollziehbarer Zugriffszaumlhlungen abgewiesen werden
Diese Funktion ist in bestimmten Faumlllen hoch problematisch und in anderen Faumlllen sogar zwingend erforderlich
Die Verwendung von bdquoLazy Loadldquo ist immer zu vermeiden wenn sich auf einer URL nur ein Text oder nur ein Teil eines mehrseitigen Textes befindet Hier fuumlhrt die Funktion dazu dass die Zaumlhlmarken erst geladen werden wenn die Stelle mit der Zaumlhlmarke im Browser angezeigt wird Insbesondere wenn die Zaumlhlmarke am Ende der Seite oder des Textes eingebaut wird sorgt die Funkt ion dafuumlr dass unser Zaumlhlbild nur geladen wird wenn der Leser auch an der Stelle ankommt also zB bis ganz ans Ende der Seite oder des Textes scrollt Erreicht er die Stelle nicht weil die Zaumlhlmarke zB erst unterhalb der Seite und nach Werbeeinblendungen oder Kommentaren eingebaut ist dann wird das Bild auch nicht vom Zaumlhlserver abgerufen und es erfolgt somit auch KEINE Zaumlhlung
Anders sieht es hingegen aus wenn sich viele Texte auf einer Seite befinden oder weitere Texte automatisch eingeblendet werden sobald ein Leser das Textende des ersten Textes erreicht hat Da nicht automatisch davon ausgegangen werden kann dass Texte die vom jeweil igen Nutzer nicht gesucht wurden eine Kopierwahrscheinlichkeit haben darf in diesen Faumlllen die Zaumlhlung nur erfolgen wenn der Text tatsaumlchlich ausgewaumlhlt wird Dies kann mit Hilfe von Lazy load erreicht werden Dazu baut man die jeweilige Zaumlhlmarke am besten immer ab der Mitte eines Textes ein so dass einerseits sichergestellt ist dass gezaumlhlt wird und andererseits dass nur eine Zaumlhlung erfolgt wenn wirklich ein bestimmter Text angesehen wurde und damit die notwendige Kopierwahrscheinlichkeit gegeben ist
24 Uumlberpruumlfen der Zaumlhlungen
241 Anzeige Herunterladen in der Anwendung
In der Anwendung gibt es eine Funktionalitaumlt mit der man pruumlfen kann welche Zaumlhlmarken bereits gezaumlhlt werden bzw welche Zaumlhlmarken die Mindestzugriffe uumlberschritten haben Dadurch kann man feststellen ob der Einbau dieser Zaumlhlmarken korrekt ist Diese Funktionalitaumlt kann uumlber den Menuumlpunkt bdquoZaumlhlmarkenuumlbersichtldquo abgerufen werden Siehe Abbildung unten
Abbildung 3 Maskenbeschreibung Zaumlhlerstarts
Dabei gibt es folgende Filtermoumlglichkeiten
- bdquoIdentif ikationscodeldquo Der oumlffentliche bzw private Identifikationscode oder der verlagsinterne Schluumlssel der Zaumlhlmarke
- bdquoBestelldatum (von bis)ldquo Bestelldatum der Zaumlhlmarke
- bdquoMeldung erfolgtldquo Es werden nur Zaumlhlmarken angezeigt fuumlr die bereits eine Meldung vorliegt
- bdquoZaumlhlerstart erfolgtldquo Alle Zaumlhlmarken die gezaumlhlt werden
- bdquoMindestzugriffldquo Alle Zaumlhlmarken die den Mindestzugriff oder den anteiligen Mindestzugriff uumlberschritten haben
- bdquoin Ausgeblendete Zaumlhlmarken suchenldquo Es werden auch Zaumlhlmarken gesucht die uumlber die angebotene Funktionalitaumlt ausgeblendet wurden Zaumlhlmarken sollten ausgeblendet werden wenn diese in Texten eingebaut wurden die den Kriterien der VG WORT nicht entsprechen (zB zu kurze Texte) Ansonsten scheinen diese Zaumlhlmarken weiterhin staumlndig in der Suchergebnisliste auf
Die Filtermoumlglichkeiten fuumlr den Mindestzugriff greifen sobald die ersten Zaumlhldaten fuumlr ein Kalenderjahr vorliegen Allerdings ist die Anzeige fuumlr das laufende Jahr unter Vorbehalt und erfolgt auf der Basis
des letzten bekannten Mindestzugriffes Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald der Mindestzugriff zu einem Jahr im Meldesystem eingegeben wurde (immer im Januar des Folgejahres)
Die Zaumlhlmarken koumlnnen zusaumltzlich als Liste im CSV Format heruntergeladen werden
Der Zaumlhlerstart wird mit einer Verzoumlgerung von ca 4 Tagen angezeigt Dh wenn eine Zaumlhlmarke heute eingebaut wird scheint diese in der Statistik erst in ca 4 Tagen auf
Es empfiehlt sich testweise einige wenige Zaumlhlmarken einzubauen und zu pruumlfen ob die Zaumlhlungen korrekt gestartet werden bevor man den Einbau der Zaumlhlmarken auf das gesamte Internetangebot ausrollt
242 Abruf uumlber Web Service Schnittstelle
Im Gegensatz zur Maske (siehe oben) kann man uumlber das Web Service nur die Zaumlhlmarken bdquomit Mindestzugriff ohne Meldungldquo sowie bdquomit anteiligem Mindestzugriff ohne Meldungldquo herunterladen
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2421 pixelOverviewRequest
Feld Typ Beschreibung
offset Int Wiederaufsetzpunkt Das System returniert maximal 100 Zaumlhlmarken am Stuumlck
Falls es mehr Zaumlhlmarken gibt die die Kriterien erfuumlllen koumlnnen weitere
Zaumlhlmarken uumlber den offset ausgelesen werden
Beispiel (190 Zaumlhlmarken vorhanden)
1 Abfrage (offset = 0) Die Zaumlhlmarken 1 ndash 100 werden zuruumlckgegeben
2 Abfrage (offset = 100) Die Zaumlhlmarken 101 ndash 190 werden zuruumlckgegeben
type Auswahl Entweder bdquoMINDESTZUGRIFFldquo oder bdquoANTEILIGER_MINDESTZUGRIFFldquo
2422 pixelOverviewResponse
Feld Typ Beschreibung
Amount Int Anzahl der gefundenen Zaumlhlmarken
Offset Int Der beim Request angegebene offset
privateIdentificationId pixelIDType (Liste) Privater Identifikationscode oder verlagsinterner Schluumlssel
3 Meldung Nachdem eine Zaumlhlmarke bestellt und eingebaut wurde kann eine Meldung zum jeweiligen Text erfolgen Eine Meldung soll dann gemacht werden wenn sich der Text des gemeldeten Artikels nicht mehr wesentlich aumlndert da die VG WORT in den Pruumlfmechanismen den gemeldeten Text mit dem Text der sich tatsaumlchlich im Internet befindet vergleicht
Der spaumlteste Zeitpunkt zum Melden eines Textes ist der sogenannte Meldeschlusstermin Diesen f inden Sie auf der Homepage der VG WORT unter bdquoTermineldquo Derzeit ist der Meldeschluss fuumlr Verlage der 1 Juni des auf die Zaumlhlung folgenden Jahres
In den meisten Faumlllen empfiehlt sich eine bdquoWartefristldquo von 14 Tagen bevor die Meldung erstellt wird So lange der Text noch Aumlnderungen unterzogen wird besteht die Gefahr dass die von der VG WORT durchgefuumlhrten Pruumlfmechanismen fehlschlagen
Bitte setzen Sie sich vor Meldungen zu Texten die uumlber verlagsinterne Schluumlssel gezaumlhlt werden unbedingt mit der VG WORT (per Email an metissupportvgwortde) in Verbindung
31 Anforderungen an die Meldung
Anbei f inden Sie alle Daten die bei einer Meldung angegeben werden muumlssen - Eindeutiger Identifikationscode - Alle beteiligten Autoren Uumlbersetzer und Agenturen - Kurzbeschreibung Uumlberschrift (Titel) - Text - Erscheinungsorte (Webbereiche)
311 Eindeutiger Identifikationscode
Der Identif ikationscode zur Zaumlhlmarke die in den Text eingebaut wurde Je nachdem welche Zaumlhlmarke verwendet wird ist dies der private Identifikationscode (bei VG WORT Zaumlhlmarken) oder der verlagsinterne Schluumlssel
312 Alle beteiligten Autoren Uumlbersetzer und Agenturen
Alle die am Text beteiligt sind Es gibt drei Arten wie die Autoren undoder Uumlbersetzer gemeldet werden
Vorname + Nachname + Karteinummer Die bevorzugte Variante Dabei werden von einem Autor oder einem Uumlbersetzer der Vorname der Nachname und die VG WORT Karteinummer gemeldet Eine Meldung mit Schreibweisen oder Pseudonymen ist auch moumlglich wenn diese der VG WORT bekannt sind Der Vorteil an dieser Variante ist dass ein Autor somit bei der VG WORT eindeutig identifizierbar ist und der Verlag somit keine weiteren Schritte unternehmen muss damit der jeweilige Autor zu seiner Ausschuumlttung kommt
Diese Variante beinhaltet fuumlr den Verlag zwar einen Initialaufwand da die Karteinummern aller Autoren eingesammelt werden muumlssen in der Praxis hat sich diese Variante bei den meisten teilnehmenden Verlagen aber als die einfachste Variante erwiesen
Vorname + Nachname Wenn von einem Autor die VG WORT Karteinummer nicht bekannt ist kann der Autor auch uumlber den Vornamen und den Nachnamen gemeldet werden Den Autoren steht fuumlr das Auffinden der ausschuumlttungsrelevanten Meldungen eine Suchmaske zur Verfuumlgung Allerdings muss in diesem Fall der gemeldete Name exakt mit dem uumlbereinstimmen der im Datenbestand der VG WORT vorliegt
Ist der Vorname nicht vollstaumlndig bekannt kann er in der Variante erster Buchstabe des Vornamens + Punkt angegeben werden
Urheber ohne Wahrnehmungsvertrag Hat der Urheber des zu meldenden Werkes dem meldenden Verlag fuumlr dieses Werk die von der VG WORT wahrgenommenen gesetzlichen Verguumltungsanspruumlche nach dem Urheberrechtsgesetz abgetreten kann dieser Urheber mit Namen Geburtsdatum und Adresse angegeben werden Zusaumltzlich muss bestaumltigt werden dass der Urheber die Rechte uumlbertragen hat Die uumlbertragenen Rechte werden bei der Ausschuumlttung beruumlcksichtigt
Fuumlr Agenturmeldungen bei denen die Autoren nicht bekannt sind steht eine weitere Variante zur Verfuumlgung
Die Rechte koumlnnen dem Verlag erst nach der Veroumlffentlichung des Textes uumlbertragen werden Die schriftliche Rechteuumlbertragung des jeweiligen Autors muss der VG WORT jederzeit auf Anfrage zur Verfuumlgung gestellt werden
Kuumlrzel Wenn man eine Agentur melden moumlchte dann kann das aktuell uumlber diesen Weg erfolgen Als Kuumlrzel wird die Kurzbezeichnung der jeweiligen Agentur uumlbergeben (zB bdquodpaldquo)
Namentliche bekannte Urheber koumlnnen uumlber die Angabe bdquoKuumlrzelldquo nicht gemeldet werden Diese Angabe kann ausschlieszliglich fuumlr die Meldung von Agenturtexten bzw der Miturheberschaft eines nicht namentlich bekannten Agenturautoren verwendet werden
313 Kurzbeschreibung Uumlberschrift (Titel)
Der Titel des zu meldenden Artikels
314 Text
Der Text des zu meldenden Artikels (entweder als Klartext als PDF oder im EPUB Format) Benoumltigt wird der bdquoNettotextldquo (dh der Text ohne HTML Code und ohne Menuuml oder dergleichen)
315 Erscheinungsorte (Webbereiche)
Es muumlssen alle Erscheinungsorte des Texts auf denen die Zaumlhlmarke eingebaut wurde gemeldet werden Ein Erscheinungsort definiert sich aus allen URLs die benoumltigt werden um den gesamten Text einmal zu lesen
Beispiel 1 Ein Text der sich uumlber 2 URLs erstreckt muss mit einem Webbereich (mit 2 URLs) gemel-det werden (zB httpdomain1depage1html httpdomain1depage2html)
Beispiel 2 Ein Text der sich uumlber 1 URL erstreckt aber auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils einer URL) gemeldet werden (zB httpdomain1demytexthtml und httpdomain2demytexthtml)
Beispiel 3 Ein Text der sich uumlber 2 URLs erstreckt und auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils zwei URLs) gemeldet werden (zB httpdomain1depage1html httpdomain1depage2html und httpdomain2depage1html httpdomain2depage2html)
32 Meldung uumlbermitteln
321 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
bull Es sollen nur Texte gemeldet werden die bereits bdquostabilldquo sind (dh die sich nicht mehr haumlufig aumlndern) Aus diesem Grund wird empfohlen die Texte mit einer Zeitverzoumlgerung von einigen Tagen (zB 14 Tagen) zu melden Auf die Tantieme hat das keinen Einfluss da die Ausschuumlttung erst Ende September Anfang Oktober fuumlr das Vorjahr erfolgt
bull Die Meldungen sollen taumlglich in der Nacht uumlbertragen werden Zeitfenster 2200 ndash 0300 Von 0300 bis 0600 gibt es ein allgemeines Wartungsfenster wo nicht gemeldet werden kann
bull Um eine Uumlberlastung der Server (und somit houmlhere Wartezeit) zu verhindern sollen die Meldungen sequentiell (nicht parallel) uumlbertragen werden Idealerweise soll zwischen zwei Meldungen eine Sekunde verstreichen Aus transaktionaler Sicht wird jede Meldung einzeln behandelt Dh jede erfolgreich eingehende Meldung wird gespeichert ndash unabhaumlngig davon ob die vorherige oder nachfolgende Meldung einen Fehler verursacht hat
bull Alle fachlichen Fehlercodes (ein- oder zweistellig) deuten auf einen Fehler in der Meldung hin Es ist zwecklos diese Meldung unveraumlndert noch einmal abzusenden Dreistellige Fehler (sowie der HTML ndash 500 Fehler) deuten auf technische Probleme hin Hier ist es zweckmaumlszligig dieselben Meldungen zu einem spaumlteren Zeitpunkt (zB mit den Meldungen vom naumlchsten Tag) noch einmal zu uumlbertragen
bull Die Bestaumltigung der Meldung bedeutet dass die Meldung aus technischer Sicht in Ordnung ist (dh Mindestumfang von 1800 Zeichen die Zaumlhlmarke existiert hellip) In einer spaumlteren Phase werden die Meldungen noch durch automatische Pruumlfmechanismen der VG WORT in Stichproben gepruumlft Sollten dabei Maumlngel auftreten werden die betreffenden Meldungen zuruumlckgewiesen und der Inhaber des Meldekontos bei der VG WORT wird per Email verstaumlndigt Diese Meldungen koumlnnen dann im Portal entweder geloumlscht oder manuell nachbearbeitet und erneut versendet werden
3212 newMessageRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der private
Identifikationscode (bei VG WORT Zaumlhlmarken) oder der
verlagsinterne Schluumlssel
Parties Parties Die Urheber Uumlbersetzer Agenturen der Meldung Es muss mindestens ein Autor oder ein Uumlbersetzer angegeben werden
Es koumlnnen in einer Meldung sowohl Autoren als auch
Uumlbersetzer angegeben werden
partiesauthors Authors 0 bis mehrere Autoren Beschreibung siehe separate Tabelle
partiestranslators Translators 0 bis mehrere Uumlbersetzer Beschreibung siehe separate
Tabelle
messagetext MessageText Der gemeldete Text entweder als PDF EPUB oder als Klartext
messagetextshorttext string Kurzbezeichnung Uumlberschrift vom Text
messagetexttext Text Der Text an sich Beschreibung siehe separate Tabelle
messagetextlyric boolean bdquoTrueldquo wenn es sich beim Text um Lyrik handelt ansonsten
bdquoFalseldquo
webranges Webranges Erscheinungsort(e) unter demdenen der Text gefunden werden
kann
webrangeswebrange Webrange Ein Erscheinungsort Beschreibung siehe separate Tabelle
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Nach Eingabe der benoumltigten Zaumlhlmarken und Klicken auf die Schaltflaumlche bdquoZaumlhlmarken bestellenldquo werden die Zaumlhlmarken vom System generiert Danach wird die Seite zum Download der eben bestellten Zaumlhlmarken angezeigt Falls mehr Zaumlhlmarken bestellt wurden als noch zur Verfuumlgung stehen kommt eine entsprechende Fehlermeldung In diesem Fall wenden Sie sich bitte per Email an metissupportvgwortde
Abbildung 2 Maskenbeschreibung Download der generierten Zaumlhlmarken
In der oben stehenden Maske befindet sich neben der Zaumlhldomaumlne auch Einbaubeispiele fuumlr HTML Texte Beim Klicken auf bdquoDownload der reinen Codepaare als CSV-Dateildquo koumlnnen die bestellten Zaumlhlmarken heruntergeladen werden Das Format der CSV Datei ist im folgenden Abschnitt beschrieben Beim Klicken auf bdquoDownload der vorkonfigurierten Zaumlhlmarken als CSV-Dateildquo wird eine Datei ausgegeben die alle Zaumlhlmarken als fertigen HTML Code enthaumllt
2221 CSV-Datei Format
Die CSV-Datei wird im folgenden Format erstellt (Die Spalten werden durch ein Semikolon getrennt)
Die Zaumlhlmarke ist ein transparentes (unsichtbares) Bild mit der Groumlszlige von 1 x 1 Pixel Es hat keinesfalls Einfluss auf die Ladezeit der Seite da Bilder von den Browsern separat zum Text geladen werden Das unsichtbare Bild hat auch keinen Einfluss auf das Erscheinungsbild der Seite
Einbaubeispiel VG WORT Zaumlhlmarke in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquoc5b7568d28884052a9ff92d5afd08f34rdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquovgzm970-123456789rdquo
Der korrekt formatierte verlagsinterne Schluumlssel des zu zaumlhlenden Textes
232 Fuumlr Dokumente (PDF oder EPUB Dateien)
Eine Zaumlhlmarke kann nicht direkt in eine dieser Dateien eingebaut werden Sie muss daher in die HTML Seite eingebaut werden von der aus das Dokument verlinkt wird Verlinkungen von anderen Seiten koumlnnen nicht beruumlcksichtigt werden Da eine Weiterleitung vom Zaumlhlserver auf externe Dateien aus sicherheitstechnischen Gruumlnden nicht angeboten werden kann benoumltigt man JavaScript um die Zugriffe auf eine PDF Datei zaumlhlen zu koumlnnen
In diesem Fall wird das Zaumlhlpixel (unsichtbare Bild) uumlber JavaScript in die HTML Seite eingefuumlgt sobald das Dokument (der Link auf das Dokument bleibt unveraumlndert) abgerufen wird
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquo98380ae3fc0a4daf84d6197274add99erdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquohttpwwwstepscondebeispielepubrdquo
Der Link auf das zu zaumlhlende Dokument
- LINK-Name
Name des Links
Auch dabei ist der Einsatz von verlagsinternen Schluumlsseln moumlglich In diesem Fall wird der korrekt formatierte verlagsinterne Schluumlssel anstelle vom oumlffentlichen Identifikationscode verwendet Auf ein separates Einbaubeispiel wird in diesem Dokument verzichtet
233 Base64url enkodierte Zaumlhlmarken
Die verwendbaren Zeichen in einer Zaumlhlmarke sind stark beschraumlnkt (siehe oben) Sollten verlagsinterne Schluumlssel mit nicht erlaubten Zeichen zum Einsatz kommen kann die Zaumlhlmarke Base64url (Codepage UTF-8) enkodiert werden In diesem Fall wird die encodierte Zaumlhlmarke mit Praumlf ix bdquobase64-ldquo eingebaut
Zum Thema Base64url Die Zeichen + und werden nach der Base64-Enkodierung durch - (Minus ASCII 2Dhex) und _ (Unterstrich ASCII 5Fhex) ersetzt
Einbaubeispiel verlagsinterner Schluumlssel in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Zugriffe von Texten hinter Bezahlschranken werden mit Faktor 3 multipliziert Die Aufwertung der Zaumlhlwerte hinter Bezahlschranken erfolgt mittels einer gesonderten Zaumlhlung Hierfuumlr muss der Verlag die Zaumlhlmarke beim Einbau mit einem Praumlfix versehen Dieses Praumlfix darf nur fuumlr Texte hinter Bezahlschranken verwendet werden Ist der Text frei zugaumlnglich wird die Zaumlhlmarke wie bisher (ohne Praumlf ix) eingebaut Aufgrund des Praumlfixes kann unterschieden werden ob ein Text hinter einer Bezahlschranke ist oder nicht
Um Texte hinter Bezahlschranken melden zu koumlnnen muumlssen Sie fuumlr die VG WORT zuerst einen kostenfreien Zugang auf diese Texte einrichten Dies ist uumlber die Angabe von Zugangsdaten oder uumlber die Freischaltung von IP Adressen moumlglich (im TOM Menuuml unter Zugriff auf zugangsbeschraumlnkte Inhalte erlauben)
Das Praumlf ix lautet bdquopw-ldquo bdquopwldquo steht fuumlr den englischen Begriff bdquoPaywallldquo (Bezahlschranke)
In der Vergangenheit musste bei Zaumlhlungen von https- Seiten eine separate Zaumlhldomaumlne verwendet werden Wenn Sie die Zaumlhlungen uumlber diese separate Domaumlne eingebaut haben muumlssen Sie den Einbau nicht aumlndern Diese Variante wird weiterhin unterstuumltzt
236 Potenzielle Fehlerquelle Referrer-Tag
Bestimmte Einstellungen im Quellcode koumlnnen dazu fuumlhren dass Zaumlhlungen nicht mehr zugeordnet werden koumlnnen wenn die Meldungen eingehen Es sieht dann so aus als waumlren d ie Zaumlhlungen zu einem Text falsch (zB nur uumlber eine Startseite ohne den eigentlichen Text) erfolgt Das kann dazu fuumlhren dass diese Zaumlhlungen gestrichen werden und der Mindestzugriff nicht mehr gegeben is t Um solche Probleme zu vermeiden muumlssen Sie darauf achten wie das Referrer-Metatag im Quellcode Ihrer Seite eingestellt ist
Die Zeile ltmeta name=referrer content=origingt sorgt zB dafuumlr dass eine Seite die httpswwwbeispieldemein_texthtml heiszligt nur httpswwwbeispielde sendet Damit lassen s ich dann die Zugriffe nicht mehr der richtigen Seite zuordnen
Bei weiteren Einstellungen wird das Senden der Daten vollstaumlndig unterdruumlckt Auch dies kann dazu fuumlhren dass Zaumlhlungen nicht anerkannt werden wenn weitere Faktoren darauf hindeuten dass die Zaumlhlungen nicht korrekt sein koumlnnten
Nur bei den Einstellungen ltmeta name=referrer content=no-referrer-when-downgradeldquogt oder ltmeta name=referrer content=unsafe-urlgt kann man auf gezaumlhlten Seiten 100 sicher sein dass keine Meldungen wegen nicht nachvollziehbarer Zugriffszaumlhlungen abgewiesen werden
Diese Funktion ist in bestimmten Faumlllen hoch problematisch und in anderen Faumlllen sogar zwingend erforderlich
Die Verwendung von bdquoLazy Loadldquo ist immer zu vermeiden wenn sich auf einer URL nur ein Text oder nur ein Teil eines mehrseitigen Textes befindet Hier fuumlhrt die Funktion dazu dass die Zaumlhlmarken erst geladen werden wenn die Stelle mit der Zaumlhlmarke im Browser angezeigt wird Insbesondere wenn die Zaumlhlmarke am Ende der Seite oder des Textes eingebaut wird sorgt die Funkt ion dafuumlr dass unser Zaumlhlbild nur geladen wird wenn der Leser auch an der Stelle ankommt also zB bis ganz ans Ende der Seite oder des Textes scrollt Erreicht er die Stelle nicht weil die Zaumlhlmarke zB erst unterhalb der Seite und nach Werbeeinblendungen oder Kommentaren eingebaut ist dann wird das Bild auch nicht vom Zaumlhlserver abgerufen und es erfolgt somit auch KEINE Zaumlhlung
Anders sieht es hingegen aus wenn sich viele Texte auf einer Seite befinden oder weitere Texte automatisch eingeblendet werden sobald ein Leser das Textende des ersten Textes erreicht hat Da nicht automatisch davon ausgegangen werden kann dass Texte die vom jeweil igen Nutzer nicht gesucht wurden eine Kopierwahrscheinlichkeit haben darf in diesen Faumlllen die Zaumlhlung nur erfolgen wenn der Text tatsaumlchlich ausgewaumlhlt wird Dies kann mit Hilfe von Lazy load erreicht werden Dazu baut man die jeweilige Zaumlhlmarke am besten immer ab der Mitte eines Textes ein so dass einerseits sichergestellt ist dass gezaumlhlt wird und andererseits dass nur eine Zaumlhlung erfolgt wenn wirklich ein bestimmter Text angesehen wurde und damit die notwendige Kopierwahrscheinlichkeit gegeben ist
24 Uumlberpruumlfen der Zaumlhlungen
241 Anzeige Herunterladen in der Anwendung
In der Anwendung gibt es eine Funktionalitaumlt mit der man pruumlfen kann welche Zaumlhlmarken bereits gezaumlhlt werden bzw welche Zaumlhlmarken die Mindestzugriffe uumlberschritten haben Dadurch kann man feststellen ob der Einbau dieser Zaumlhlmarken korrekt ist Diese Funktionalitaumlt kann uumlber den Menuumlpunkt bdquoZaumlhlmarkenuumlbersichtldquo abgerufen werden Siehe Abbildung unten
Abbildung 3 Maskenbeschreibung Zaumlhlerstarts
Dabei gibt es folgende Filtermoumlglichkeiten
- bdquoIdentif ikationscodeldquo Der oumlffentliche bzw private Identifikationscode oder der verlagsinterne Schluumlssel der Zaumlhlmarke
- bdquoBestelldatum (von bis)ldquo Bestelldatum der Zaumlhlmarke
- bdquoMeldung erfolgtldquo Es werden nur Zaumlhlmarken angezeigt fuumlr die bereits eine Meldung vorliegt
- bdquoZaumlhlerstart erfolgtldquo Alle Zaumlhlmarken die gezaumlhlt werden
- bdquoMindestzugriffldquo Alle Zaumlhlmarken die den Mindestzugriff oder den anteiligen Mindestzugriff uumlberschritten haben
- bdquoin Ausgeblendete Zaumlhlmarken suchenldquo Es werden auch Zaumlhlmarken gesucht die uumlber die angebotene Funktionalitaumlt ausgeblendet wurden Zaumlhlmarken sollten ausgeblendet werden wenn diese in Texten eingebaut wurden die den Kriterien der VG WORT nicht entsprechen (zB zu kurze Texte) Ansonsten scheinen diese Zaumlhlmarken weiterhin staumlndig in der Suchergebnisliste auf
Die Filtermoumlglichkeiten fuumlr den Mindestzugriff greifen sobald die ersten Zaumlhldaten fuumlr ein Kalenderjahr vorliegen Allerdings ist die Anzeige fuumlr das laufende Jahr unter Vorbehalt und erfolgt auf der Basis
des letzten bekannten Mindestzugriffes Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald der Mindestzugriff zu einem Jahr im Meldesystem eingegeben wurde (immer im Januar des Folgejahres)
Die Zaumlhlmarken koumlnnen zusaumltzlich als Liste im CSV Format heruntergeladen werden
Der Zaumlhlerstart wird mit einer Verzoumlgerung von ca 4 Tagen angezeigt Dh wenn eine Zaumlhlmarke heute eingebaut wird scheint diese in der Statistik erst in ca 4 Tagen auf
Es empfiehlt sich testweise einige wenige Zaumlhlmarken einzubauen und zu pruumlfen ob die Zaumlhlungen korrekt gestartet werden bevor man den Einbau der Zaumlhlmarken auf das gesamte Internetangebot ausrollt
242 Abruf uumlber Web Service Schnittstelle
Im Gegensatz zur Maske (siehe oben) kann man uumlber das Web Service nur die Zaumlhlmarken bdquomit Mindestzugriff ohne Meldungldquo sowie bdquomit anteiligem Mindestzugriff ohne Meldungldquo herunterladen
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2421 pixelOverviewRequest
Feld Typ Beschreibung
offset Int Wiederaufsetzpunkt Das System returniert maximal 100 Zaumlhlmarken am Stuumlck
Falls es mehr Zaumlhlmarken gibt die die Kriterien erfuumlllen koumlnnen weitere
Zaumlhlmarken uumlber den offset ausgelesen werden
Beispiel (190 Zaumlhlmarken vorhanden)
1 Abfrage (offset = 0) Die Zaumlhlmarken 1 ndash 100 werden zuruumlckgegeben
2 Abfrage (offset = 100) Die Zaumlhlmarken 101 ndash 190 werden zuruumlckgegeben
type Auswahl Entweder bdquoMINDESTZUGRIFFldquo oder bdquoANTEILIGER_MINDESTZUGRIFFldquo
2422 pixelOverviewResponse
Feld Typ Beschreibung
Amount Int Anzahl der gefundenen Zaumlhlmarken
Offset Int Der beim Request angegebene offset
privateIdentificationId pixelIDType (Liste) Privater Identifikationscode oder verlagsinterner Schluumlssel
3 Meldung Nachdem eine Zaumlhlmarke bestellt und eingebaut wurde kann eine Meldung zum jeweiligen Text erfolgen Eine Meldung soll dann gemacht werden wenn sich der Text des gemeldeten Artikels nicht mehr wesentlich aumlndert da die VG WORT in den Pruumlfmechanismen den gemeldeten Text mit dem Text der sich tatsaumlchlich im Internet befindet vergleicht
Der spaumlteste Zeitpunkt zum Melden eines Textes ist der sogenannte Meldeschlusstermin Diesen f inden Sie auf der Homepage der VG WORT unter bdquoTermineldquo Derzeit ist der Meldeschluss fuumlr Verlage der 1 Juni des auf die Zaumlhlung folgenden Jahres
In den meisten Faumlllen empfiehlt sich eine bdquoWartefristldquo von 14 Tagen bevor die Meldung erstellt wird So lange der Text noch Aumlnderungen unterzogen wird besteht die Gefahr dass die von der VG WORT durchgefuumlhrten Pruumlfmechanismen fehlschlagen
Bitte setzen Sie sich vor Meldungen zu Texten die uumlber verlagsinterne Schluumlssel gezaumlhlt werden unbedingt mit der VG WORT (per Email an metissupportvgwortde) in Verbindung
31 Anforderungen an die Meldung
Anbei f inden Sie alle Daten die bei einer Meldung angegeben werden muumlssen - Eindeutiger Identifikationscode - Alle beteiligten Autoren Uumlbersetzer und Agenturen - Kurzbeschreibung Uumlberschrift (Titel) - Text - Erscheinungsorte (Webbereiche)
311 Eindeutiger Identifikationscode
Der Identif ikationscode zur Zaumlhlmarke die in den Text eingebaut wurde Je nachdem welche Zaumlhlmarke verwendet wird ist dies der private Identifikationscode (bei VG WORT Zaumlhlmarken) oder der verlagsinterne Schluumlssel
312 Alle beteiligten Autoren Uumlbersetzer und Agenturen
Alle die am Text beteiligt sind Es gibt drei Arten wie die Autoren undoder Uumlbersetzer gemeldet werden
Vorname + Nachname + Karteinummer Die bevorzugte Variante Dabei werden von einem Autor oder einem Uumlbersetzer der Vorname der Nachname und die VG WORT Karteinummer gemeldet Eine Meldung mit Schreibweisen oder Pseudonymen ist auch moumlglich wenn diese der VG WORT bekannt sind Der Vorteil an dieser Variante ist dass ein Autor somit bei der VG WORT eindeutig identifizierbar ist und der Verlag somit keine weiteren Schritte unternehmen muss damit der jeweilige Autor zu seiner Ausschuumlttung kommt
Diese Variante beinhaltet fuumlr den Verlag zwar einen Initialaufwand da die Karteinummern aller Autoren eingesammelt werden muumlssen in der Praxis hat sich diese Variante bei den meisten teilnehmenden Verlagen aber als die einfachste Variante erwiesen
Vorname + Nachname Wenn von einem Autor die VG WORT Karteinummer nicht bekannt ist kann der Autor auch uumlber den Vornamen und den Nachnamen gemeldet werden Den Autoren steht fuumlr das Auffinden der ausschuumlttungsrelevanten Meldungen eine Suchmaske zur Verfuumlgung Allerdings muss in diesem Fall der gemeldete Name exakt mit dem uumlbereinstimmen der im Datenbestand der VG WORT vorliegt
Ist der Vorname nicht vollstaumlndig bekannt kann er in der Variante erster Buchstabe des Vornamens + Punkt angegeben werden
Urheber ohne Wahrnehmungsvertrag Hat der Urheber des zu meldenden Werkes dem meldenden Verlag fuumlr dieses Werk die von der VG WORT wahrgenommenen gesetzlichen Verguumltungsanspruumlche nach dem Urheberrechtsgesetz abgetreten kann dieser Urheber mit Namen Geburtsdatum und Adresse angegeben werden Zusaumltzlich muss bestaumltigt werden dass der Urheber die Rechte uumlbertragen hat Die uumlbertragenen Rechte werden bei der Ausschuumlttung beruumlcksichtigt
Fuumlr Agenturmeldungen bei denen die Autoren nicht bekannt sind steht eine weitere Variante zur Verfuumlgung
Die Rechte koumlnnen dem Verlag erst nach der Veroumlffentlichung des Textes uumlbertragen werden Die schriftliche Rechteuumlbertragung des jeweiligen Autors muss der VG WORT jederzeit auf Anfrage zur Verfuumlgung gestellt werden
Kuumlrzel Wenn man eine Agentur melden moumlchte dann kann das aktuell uumlber diesen Weg erfolgen Als Kuumlrzel wird die Kurzbezeichnung der jeweiligen Agentur uumlbergeben (zB bdquodpaldquo)
Namentliche bekannte Urheber koumlnnen uumlber die Angabe bdquoKuumlrzelldquo nicht gemeldet werden Diese Angabe kann ausschlieszliglich fuumlr die Meldung von Agenturtexten bzw der Miturheberschaft eines nicht namentlich bekannten Agenturautoren verwendet werden
313 Kurzbeschreibung Uumlberschrift (Titel)
Der Titel des zu meldenden Artikels
314 Text
Der Text des zu meldenden Artikels (entweder als Klartext als PDF oder im EPUB Format) Benoumltigt wird der bdquoNettotextldquo (dh der Text ohne HTML Code und ohne Menuuml oder dergleichen)
315 Erscheinungsorte (Webbereiche)
Es muumlssen alle Erscheinungsorte des Texts auf denen die Zaumlhlmarke eingebaut wurde gemeldet werden Ein Erscheinungsort definiert sich aus allen URLs die benoumltigt werden um den gesamten Text einmal zu lesen
Beispiel 1 Ein Text der sich uumlber 2 URLs erstreckt muss mit einem Webbereich (mit 2 URLs) gemel-det werden (zB httpdomain1depage1html httpdomain1depage2html)
Beispiel 2 Ein Text der sich uumlber 1 URL erstreckt aber auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils einer URL) gemeldet werden (zB httpdomain1demytexthtml und httpdomain2demytexthtml)
Beispiel 3 Ein Text der sich uumlber 2 URLs erstreckt und auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils zwei URLs) gemeldet werden (zB httpdomain1depage1html httpdomain1depage2html und httpdomain2depage1html httpdomain2depage2html)
32 Meldung uumlbermitteln
321 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
bull Es sollen nur Texte gemeldet werden die bereits bdquostabilldquo sind (dh die sich nicht mehr haumlufig aumlndern) Aus diesem Grund wird empfohlen die Texte mit einer Zeitverzoumlgerung von einigen Tagen (zB 14 Tagen) zu melden Auf die Tantieme hat das keinen Einfluss da die Ausschuumlttung erst Ende September Anfang Oktober fuumlr das Vorjahr erfolgt
bull Die Meldungen sollen taumlglich in der Nacht uumlbertragen werden Zeitfenster 2200 ndash 0300 Von 0300 bis 0600 gibt es ein allgemeines Wartungsfenster wo nicht gemeldet werden kann
bull Um eine Uumlberlastung der Server (und somit houmlhere Wartezeit) zu verhindern sollen die Meldungen sequentiell (nicht parallel) uumlbertragen werden Idealerweise soll zwischen zwei Meldungen eine Sekunde verstreichen Aus transaktionaler Sicht wird jede Meldung einzeln behandelt Dh jede erfolgreich eingehende Meldung wird gespeichert ndash unabhaumlngig davon ob die vorherige oder nachfolgende Meldung einen Fehler verursacht hat
bull Alle fachlichen Fehlercodes (ein- oder zweistellig) deuten auf einen Fehler in der Meldung hin Es ist zwecklos diese Meldung unveraumlndert noch einmal abzusenden Dreistellige Fehler (sowie der HTML ndash 500 Fehler) deuten auf technische Probleme hin Hier ist es zweckmaumlszligig dieselben Meldungen zu einem spaumlteren Zeitpunkt (zB mit den Meldungen vom naumlchsten Tag) noch einmal zu uumlbertragen
bull Die Bestaumltigung der Meldung bedeutet dass die Meldung aus technischer Sicht in Ordnung ist (dh Mindestumfang von 1800 Zeichen die Zaumlhlmarke existiert hellip) In einer spaumlteren Phase werden die Meldungen noch durch automatische Pruumlfmechanismen der VG WORT in Stichproben gepruumlft Sollten dabei Maumlngel auftreten werden die betreffenden Meldungen zuruumlckgewiesen und der Inhaber des Meldekontos bei der VG WORT wird per Email verstaumlndigt Diese Meldungen koumlnnen dann im Portal entweder geloumlscht oder manuell nachbearbeitet und erneut versendet werden
3212 newMessageRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der private
Identifikationscode (bei VG WORT Zaumlhlmarken) oder der
verlagsinterne Schluumlssel
Parties Parties Die Urheber Uumlbersetzer Agenturen der Meldung Es muss mindestens ein Autor oder ein Uumlbersetzer angegeben werden
Es koumlnnen in einer Meldung sowohl Autoren als auch
Uumlbersetzer angegeben werden
partiesauthors Authors 0 bis mehrere Autoren Beschreibung siehe separate Tabelle
partiestranslators Translators 0 bis mehrere Uumlbersetzer Beschreibung siehe separate
Tabelle
messagetext MessageText Der gemeldete Text entweder als PDF EPUB oder als Klartext
messagetextshorttext string Kurzbezeichnung Uumlberschrift vom Text
messagetexttext Text Der Text an sich Beschreibung siehe separate Tabelle
messagetextlyric boolean bdquoTrueldquo wenn es sich beim Text um Lyrik handelt ansonsten
bdquoFalseldquo
webranges Webranges Erscheinungsort(e) unter demdenen der Text gefunden werden
kann
webrangeswebrange Webrange Ein Erscheinungsort Beschreibung siehe separate Tabelle
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Die Zaumlhlmarke ist ein transparentes (unsichtbares) Bild mit der Groumlszlige von 1 x 1 Pixel Es hat keinesfalls Einfluss auf die Ladezeit der Seite da Bilder von den Browsern separat zum Text geladen werden Das unsichtbare Bild hat auch keinen Einfluss auf das Erscheinungsbild der Seite
Einbaubeispiel VG WORT Zaumlhlmarke in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquoc5b7568d28884052a9ff92d5afd08f34rdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquovgzm970-123456789rdquo
Der korrekt formatierte verlagsinterne Schluumlssel des zu zaumlhlenden Textes
232 Fuumlr Dokumente (PDF oder EPUB Dateien)
Eine Zaumlhlmarke kann nicht direkt in eine dieser Dateien eingebaut werden Sie muss daher in die HTML Seite eingebaut werden von der aus das Dokument verlinkt wird Verlinkungen von anderen Seiten koumlnnen nicht beruumlcksichtigt werden Da eine Weiterleitung vom Zaumlhlserver auf externe Dateien aus sicherheitstechnischen Gruumlnden nicht angeboten werden kann benoumltigt man JavaScript um die Zugriffe auf eine PDF Datei zaumlhlen zu koumlnnen
In diesem Fall wird das Zaumlhlpixel (unsichtbare Bild) uumlber JavaScript in die HTML Seite eingefuumlgt sobald das Dokument (der Link auf das Dokument bleibt unveraumlndert) abgerufen wird
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquo98380ae3fc0a4daf84d6197274add99erdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquohttpwwwstepscondebeispielepubrdquo
Der Link auf das zu zaumlhlende Dokument
- LINK-Name
Name des Links
Auch dabei ist der Einsatz von verlagsinternen Schluumlsseln moumlglich In diesem Fall wird der korrekt formatierte verlagsinterne Schluumlssel anstelle vom oumlffentlichen Identifikationscode verwendet Auf ein separates Einbaubeispiel wird in diesem Dokument verzichtet
233 Base64url enkodierte Zaumlhlmarken
Die verwendbaren Zeichen in einer Zaumlhlmarke sind stark beschraumlnkt (siehe oben) Sollten verlagsinterne Schluumlssel mit nicht erlaubten Zeichen zum Einsatz kommen kann die Zaumlhlmarke Base64url (Codepage UTF-8) enkodiert werden In diesem Fall wird die encodierte Zaumlhlmarke mit Praumlf ix bdquobase64-ldquo eingebaut
Zum Thema Base64url Die Zeichen + und werden nach der Base64-Enkodierung durch - (Minus ASCII 2Dhex) und _ (Unterstrich ASCII 5Fhex) ersetzt
Einbaubeispiel verlagsinterner Schluumlssel in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Zugriffe von Texten hinter Bezahlschranken werden mit Faktor 3 multipliziert Die Aufwertung der Zaumlhlwerte hinter Bezahlschranken erfolgt mittels einer gesonderten Zaumlhlung Hierfuumlr muss der Verlag die Zaumlhlmarke beim Einbau mit einem Praumlfix versehen Dieses Praumlfix darf nur fuumlr Texte hinter Bezahlschranken verwendet werden Ist der Text frei zugaumlnglich wird die Zaumlhlmarke wie bisher (ohne Praumlf ix) eingebaut Aufgrund des Praumlfixes kann unterschieden werden ob ein Text hinter einer Bezahlschranke ist oder nicht
Um Texte hinter Bezahlschranken melden zu koumlnnen muumlssen Sie fuumlr die VG WORT zuerst einen kostenfreien Zugang auf diese Texte einrichten Dies ist uumlber die Angabe von Zugangsdaten oder uumlber die Freischaltung von IP Adressen moumlglich (im TOM Menuuml unter Zugriff auf zugangsbeschraumlnkte Inhalte erlauben)
Das Praumlf ix lautet bdquopw-ldquo bdquopwldquo steht fuumlr den englischen Begriff bdquoPaywallldquo (Bezahlschranke)
In der Vergangenheit musste bei Zaumlhlungen von https- Seiten eine separate Zaumlhldomaumlne verwendet werden Wenn Sie die Zaumlhlungen uumlber diese separate Domaumlne eingebaut haben muumlssen Sie den Einbau nicht aumlndern Diese Variante wird weiterhin unterstuumltzt
236 Potenzielle Fehlerquelle Referrer-Tag
Bestimmte Einstellungen im Quellcode koumlnnen dazu fuumlhren dass Zaumlhlungen nicht mehr zugeordnet werden koumlnnen wenn die Meldungen eingehen Es sieht dann so aus als waumlren d ie Zaumlhlungen zu einem Text falsch (zB nur uumlber eine Startseite ohne den eigentlichen Text) erfolgt Das kann dazu fuumlhren dass diese Zaumlhlungen gestrichen werden und der Mindestzugriff nicht mehr gegeben is t Um solche Probleme zu vermeiden muumlssen Sie darauf achten wie das Referrer-Metatag im Quellcode Ihrer Seite eingestellt ist
Die Zeile ltmeta name=referrer content=origingt sorgt zB dafuumlr dass eine Seite die httpswwwbeispieldemein_texthtml heiszligt nur httpswwwbeispielde sendet Damit lassen s ich dann die Zugriffe nicht mehr der richtigen Seite zuordnen
Bei weiteren Einstellungen wird das Senden der Daten vollstaumlndig unterdruumlckt Auch dies kann dazu fuumlhren dass Zaumlhlungen nicht anerkannt werden wenn weitere Faktoren darauf hindeuten dass die Zaumlhlungen nicht korrekt sein koumlnnten
Nur bei den Einstellungen ltmeta name=referrer content=no-referrer-when-downgradeldquogt oder ltmeta name=referrer content=unsafe-urlgt kann man auf gezaumlhlten Seiten 100 sicher sein dass keine Meldungen wegen nicht nachvollziehbarer Zugriffszaumlhlungen abgewiesen werden
Diese Funktion ist in bestimmten Faumlllen hoch problematisch und in anderen Faumlllen sogar zwingend erforderlich
Die Verwendung von bdquoLazy Loadldquo ist immer zu vermeiden wenn sich auf einer URL nur ein Text oder nur ein Teil eines mehrseitigen Textes befindet Hier fuumlhrt die Funktion dazu dass die Zaumlhlmarken erst geladen werden wenn die Stelle mit der Zaumlhlmarke im Browser angezeigt wird Insbesondere wenn die Zaumlhlmarke am Ende der Seite oder des Textes eingebaut wird sorgt die Funkt ion dafuumlr dass unser Zaumlhlbild nur geladen wird wenn der Leser auch an der Stelle ankommt also zB bis ganz ans Ende der Seite oder des Textes scrollt Erreicht er die Stelle nicht weil die Zaumlhlmarke zB erst unterhalb der Seite und nach Werbeeinblendungen oder Kommentaren eingebaut ist dann wird das Bild auch nicht vom Zaumlhlserver abgerufen und es erfolgt somit auch KEINE Zaumlhlung
Anders sieht es hingegen aus wenn sich viele Texte auf einer Seite befinden oder weitere Texte automatisch eingeblendet werden sobald ein Leser das Textende des ersten Textes erreicht hat Da nicht automatisch davon ausgegangen werden kann dass Texte die vom jeweil igen Nutzer nicht gesucht wurden eine Kopierwahrscheinlichkeit haben darf in diesen Faumlllen die Zaumlhlung nur erfolgen wenn der Text tatsaumlchlich ausgewaumlhlt wird Dies kann mit Hilfe von Lazy load erreicht werden Dazu baut man die jeweilige Zaumlhlmarke am besten immer ab der Mitte eines Textes ein so dass einerseits sichergestellt ist dass gezaumlhlt wird und andererseits dass nur eine Zaumlhlung erfolgt wenn wirklich ein bestimmter Text angesehen wurde und damit die notwendige Kopierwahrscheinlichkeit gegeben ist
24 Uumlberpruumlfen der Zaumlhlungen
241 Anzeige Herunterladen in der Anwendung
In der Anwendung gibt es eine Funktionalitaumlt mit der man pruumlfen kann welche Zaumlhlmarken bereits gezaumlhlt werden bzw welche Zaumlhlmarken die Mindestzugriffe uumlberschritten haben Dadurch kann man feststellen ob der Einbau dieser Zaumlhlmarken korrekt ist Diese Funktionalitaumlt kann uumlber den Menuumlpunkt bdquoZaumlhlmarkenuumlbersichtldquo abgerufen werden Siehe Abbildung unten
Abbildung 3 Maskenbeschreibung Zaumlhlerstarts
Dabei gibt es folgende Filtermoumlglichkeiten
- bdquoIdentif ikationscodeldquo Der oumlffentliche bzw private Identifikationscode oder der verlagsinterne Schluumlssel der Zaumlhlmarke
- bdquoBestelldatum (von bis)ldquo Bestelldatum der Zaumlhlmarke
- bdquoMeldung erfolgtldquo Es werden nur Zaumlhlmarken angezeigt fuumlr die bereits eine Meldung vorliegt
- bdquoZaumlhlerstart erfolgtldquo Alle Zaumlhlmarken die gezaumlhlt werden
- bdquoMindestzugriffldquo Alle Zaumlhlmarken die den Mindestzugriff oder den anteiligen Mindestzugriff uumlberschritten haben
- bdquoin Ausgeblendete Zaumlhlmarken suchenldquo Es werden auch Zaumlhlmarken gesucht die uumlber die angebotene Funktionalitaumlt ausgeblendet wurden Zaumlhlmarken sollten ausgeblendet werden wenn diese in Texten eingebaut wurden die den Kriterien der VG WORT nicht entsprechen (zB zu kurze Texte) Ansonsten scheinen diese Zaumlhlmarken weiterhin staumlndig in der Suchergebnisliste auf
Die Filtermoumlglichkeiten fuumlr den Mindestzugriff greifen sobald die ersten Zaumlhldaten fuumlr ein Kalenderjahr vorliegen Allerdings ist die Anzeige fuumlr das laufende Jahr unter Vorbehalt und erfolgt auf der Basis
des letzten bekannten Mindestzugriffes Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald der Mindestzugriff zu einem Jahr im Meldesystem eingegeben wurde (immer im Januar des Folgejahres)
Die Zaumlhlmarken koumlnnen zusaumltzlich als Liste im CSV Format heruntergeladen werden
Der Zaumlhlerstart wird mit einer Verzoumlgerung von ca 4 Tagen angezeigt Dh wenn eine Zaumlhlmarke heute eingebaut wird scheint diese in der Statistik erst in ca 4 Tagen auf
Es empfiehlt sich testweise einige wenige Zaumlhlmarken einzubauen und zu pruumlfen ob die Zaumlhlungen korrekt gestartet werden bevor man den Einbau der Zaumlhlmarken auf das gesamte Internetangebot ausrollt
242 Abruf uumlber Web Service Schnittstelle
Im Gegensatz zur Maske (siehe oben) kann man uumlber das Web Service nur die Zaumlhlmarken bdquomit Mindestzugriff ohne Meldungldquo sowie bdquomit anteiligem Mindestzugriff ohne Meldungldquo herunterladen
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2421 pixelOverviewRequest
Feld Typ Beschreibung
offset Int Wiederaufsetzpunkt Das System returniert maximal 100 Zaumlhlmarken am Stuumlck
Falls es mehr Zaumlhlmarken gibt die die Kriterien erfuumlllen koumlnnen weitere
Zaumlhlmarken uumlber den offset ausgelesen werden
Beispiel (190 Zaumlhlmarken vorhanden)
1 Abfrage (offset = 0) Die Zaumlhlmarken 1 ndash 100 werden zuruumlckgegeben
2 Abfrage (offset = 100) Die Zaumlhlmarken 101 ndash 190 werden zuruumlckgegeben
type Auswahl Entweder bdquoMINDESTZUGRIFFldquo oder bdquoANTEILIGER_MINDESTZUGRIFFldquo
2422 pixelOverviewResponse
Feld Typ Beschreibung
Amount Int Anzahl der gefundenen Zaumlhlmarken
Offset Int Der beim Request angegebene offset
privateIdentificationId pixelIDType (Liste) Privater Identifikationscode oder verlagsinterner Schluumlssel
3 Meldung Nachdem eine Zaumlhlmarke bestellt und eingebaut wurde kann eine Meldung zum jeweiligen Text erfolgen Eine Meldung soll dann gemacht werden wenn sich der Text des gemeldeten Artikels nicht mehr wesentlich aumlndert da die VG WORT in den Pruumlfmechanismen den gemeldeten Text mit dem Text der sich tatsaumlchlich im Internet befindet vergleicht
Der spaumlteste Zeitpunkt zum Melden eines Textes ist der sogenannte Meldeschlusstermin Diesen f inden Sie auf der Homepage der VG WORT unter bdquoTermineldquo Derzeit ist der Meldeschluss fuumlr Verlage der 1 Juni des auf die Zaumlhlung folgenden Jahres
In den meisten Faumlllen empfiehlt sich eine bdquoWartefristldquo von 14 Tagen bevor die Meldung erstellt wird So lange der Text noch Aumlnderungen unterzogen wird besteht die Gefahr dass die von der VG WORT durchgefuumlhrten Pruumlfmechanismen fehlschlagen
Bitte setzen Sie sich vor Meldungen zu Texten die uumlber verlagsinterne Schluumlssel gezaumlhlt werden unbedingt mit der VG WORT (per Email an metissupportvgwortde) in Verbindung
31 Anforderungen an die Meldung
Anbei f inden Sie alle Daten die bei einer Meldung angegeben werden muumlssen - Eindeutiger Identifikationscode - Alle beteiligten Autoren Uumlbersetzer und Agenturen - Kurzbeschreibung Uumlberschrift (Titel) - Text - Erscheinungsorte (Webbereiche)
311 Eindeutiger Identifikationscode
Der Identif ikationscode zur Zaumlhlmarke die in den Text eingebaut wurde Je nachdem welche Zaumlhlmarke verwendet wird ist dies der private Identifikationscode (bei VG WORT Zaumlhlmarken) oder der verlagsinterne Schluumlssel
312 Alle beteiligten Autoren Uumlbersetzer und Agenturen
Alle die am Text beteiligt sind Es gibt drei Arten wie die Autoren undoder Uumlbersetzer gemeldet werden
Vorname + Nachname + Karteinummer Die bevorzugte Variante Dabei werden von einem Autor oder einem Uumlbersetzer der Vorname der Nachname und die VG WORT Karteinummer gemeldet Eine Meldung mit Schreibweisen oder Pseudonymen ist auch moumlglich wenn diese der VG WORT bekannt sind Der Vorteil an dieser Variante ist dass ein Autor somit bei der VG WORT eindeutig identifizierbar ist und der Verlag somit keine weiteren Schritte unternehmen muss damit der jeweilige Autor zu seiner Ausschuumlttung kommt
Diese Variante beinhaltet fuumlr den Verlag zwar einen Initialaufwand da die Karteinummern aller Autoren eingesammelt werden muumlssen in der Praxis hat sich diese Variante bei den meisten teilnehmenden Verlagen aber als die einfachste Variante erwiesen
Vorname + Nachname Wenn von einem Autor die VG WORT Karteinummer nicht bekannt ist kann der Autor auch uumlber den Vornamen und den Nachnamen gemeldet werden Den Autoren steht fuumlr das Auffinden der ausschuumlttungsrelevanten Meldungen eine Suchmaske zur Verfuumlgung Allerdings muss in diesem Fall der gemeldete Name exakt mit dem uumlbereinstimmen der im Datenbestand der VG WORT vorliegt
Ist der Vorname nicht vollstaumlndig bekannt kann er in der Variante erster Buchstabe des Vornamens + Punkt angegeben werden
Urheber ohne Wahrnehmungsvertrag Hat der Urheber des zu meldenden Werkes dem meldenden Verlag fuumlr dieses Werk die von der VG WORT wahrgenommenen gesetzlichen Verguumltungsanspruumlche nach dem Urheberrechtsgesetz abgetreten kann dieser Urheber mit Namen Geburtsdatum und Adresse angegeben werden Zusaumltzlich muss bestaumltigt werden dass der Urheber die Rechte uumlbertragen hat Die uumlbertragenen Rechte werden bei der Ausschuumlttung beruumlcksichtigt
Fuumlr Agenturmeldungen bei denen die Autoren nicht bekannt sind steht eine weitere Variante zur Verfuumlgung
Die Rechte koumlnnen dem Verlag erst nach der Veroumlffentlichung des Textes uumlbertragen werden Die schriftliche Rechteuumlbertragung des jeweiligen Autors muss der VG WORT jederzeit auf Anfrage zur Verfuumlgung gestellt werden
Kuumlrzel Wenn man eine Agentur melden moumlchte dann kann das aktuell uumlber diesen Weg erfolgen Als Kuumlrzel wird die Kurzbezeichnung der jeweiligen Agentur uumlbergeben (zB bdquodpaldquo)
Namentliche bekannte Urheber koumlnnen uumlber die Angabe bdquoKuumlrzelldquo nicht gemeldet werden Diese Angabe kann ausschlieszliglich fuumlr die Meldung von Agenturtexten bzw der Miturheberschaft eines nicht namentlich bekannten Agenturautoren verwendet werden
313 Kurzbeschreibung Uumlberschrift (Titel)
Der Titel des zu meldenden Artikels
314 Text
Der Text des zu meldenden Artikels (entweder als Klartext als PDF oder im EPUB Format) Benoumltigt wird der bdquoNettotextldquo (dh der Text ohne HTML Code und ohne Menuuml oder dergleichen)
315 Erscheinungsorte (Webbereiche)
Es muumlssen alle Erscheinungsorte des Texts auf denen die Zaumlhlmarke eingebaut wurde gemeldet werden Ein Erscheinungsort definiert sich aus allen URLs die benoumltigt werden um den gesamten Text einmal zu lesen
Beispiel 1 Ein Text der sich uumlber 2 URLs erstreckt muss mit einem Webbereich (mit 2 URLs) gemel-det werden (zB httpdomain1depage1html httpdomain1depage2html)
Beispiel 2 Ein Text der sich uumlber 1 URL erstreckt aber auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils einer URL) gemeldet werden (zB httpdomain1demytexthtml und httpdomain2demytexthtml)
Beispiel 3 Ein Text der sich uumlber 2 URLs erstreckt und auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils zwei URLs) gemeldet werden (zB httpdomain1depage1html httpdomain1depage2html und httpdomain2depage1html httpdomain2depage2html)
32 Meldung uumlbermitteln
321 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
bull Es sollen nur Texte gemeldet werden die bereits bdquostabilldquo sind (dh die sich nicht mehr haumlufig aumlndern) Aus diesem Grund wird empfohlen die Texte mit einer Zeitverzoumlgerung von einigen Tagen (zB 14 Tagen) zu melden Auf die Tantieme hat das keinen Einfluss da die Ausschuumlttung erst Ende September Anfang Oktober fuumlr das Vorjahr erfolgt
bull Die Meldungen sollen taumlglich in der Nacht uumlbertragen werden Zeitfenster 2200 ndash 0300 Von 0300 bis 0600 gibt es ein allgemeines Wartungsfenster wo nicht gemeldet werden kann
bull Um eine Uumlberlastung der Server (und somit houmlhere Wartezeit) zu verhindern sollen die Meldungen sequentiell (nicht parallel) uumlbertragen werden Idealerweise soll zwischen zwei Meldungen eine Sekunde verstreichen Aus transaktionaler Sicht wird jede Meldung einzeln behandelt Dh jede erfolgreich eingehende Meldung wird gespeichert ndash unabhaumlngig davon ob die vorherige oder nachfolgende Meldung einen Fehler verursacht hat
bull Alle fachlichen Fehlercodes (ein- oder zweistellig) deuten auf einen Fehler in der Meldung hin Es ist zwecklos diese Meldung unveraumlndert noch einmal abzusenden Dreistellige Fehler (sowie der HTML ndash 500 Fehler) deuten auf technische Probleme hin Hier ist es zweckmaumlszligig dieselben Meldungen zu einem spaumlteren Zeitpunkt (zB mit den Meldungen vom naumlchsten Tag) noch einmal zu uumlbertragen
bull Die Bestaumltigung der Meldung bedeutet dass die Meldung aus technischer Sicht in Ordnung ist (dh Mindestumfang von 1800 Zeichen die Zaumlhlmarke existiert hellip) In einer spaumlteren Phase werden die Meldungen noch durch automatische Pruumlfmechanismen der VG WORT in Stichproben gepruumlft Sollten dabei Maumlngel auftreten werden die betreffenden Meldungen zuruumlckgewiesen und der Inhaber des Meldekontos bei der VG WORT wird per Email verstaumlndigt Diese Meldungen koumlnnen dann im Portal entweder geloumlscht oder manuell nachbearbeitet und erneut versendet werden
3212 newMessageRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der private
Identifikationscode (bei VG WORT Zaumlhlmarken) oder der
verlagsinterne Schluumlssel
Parties Parties Die Urheber Uumlbersetzer Agenturen der Meldung Es muss mindestens ein Autor oder ein Uumlbersetzer angegeben werden
Es koumlnnen in einer Meldung sowohl Autoren als auch
Uumlbersetzer angegeben werden
partiesauthors Authors 0 bis mehrere Autoren Beschreibung siehe separate Tabelle
partiestranslators Translators 0 bis mehrere Uumlbersetzer Beschreibung siehe separate
Tabelle
messagetext MessageText Der gemeldete Text entweder als PDF EPUB oder als Klartext
messagetextshorttext string Kurzbezeichnung Uumlberschrift vom Text
messagetexttext Text Der Text an sich Beschreibung siehe separate Tabelle
messagetextlyric boolean bdquoTrueldquo wenn es sich beim Text um Lyrik handelt ansonsten
bdquoFalseldquo
webranges Webranges Erscheinungsort(e) unter demdenen der Text gefunden werden
kann
webrangeswebrange Webrange Ein Erscheinungsort Beschreibung siehe separate Tabelle
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Die Zaumlhldomaumlne Diese muss durch die bei der Bestellung der Zaumlhlmarken erhaltenen Zaumlhldomaumlne ersetzt werden
- ldquonardquo
Fixer Bestandteil der Zaumlhlmarke Darf nicht weggelassen werden
- ldquo98380ae3fc0a4daf84d6197274add99erdquo
Der bdquooumlf fentliche Identifikationscodeldquo der Zaumlhlmarke
- ldquohttpwwwstepscondebeispielepubrdquo
Der Link auf das zu zaumlhlende Dokument
- LINK-Name
Name des Links
Auch dabei ist der Einsatz von verlagsinternen Schluumlsseln moumlglich In diesem Fall wird der korrekt formatierte verlagsinterne Schluumlssel anstelle vom oumlffentlichen Identifikationscode verwendet Auf ein separates Einbaubeispiel wird in diesem Dokument verzichtet
233 Base64url enkodierte Zaumlhlmarken
Die verwendbaren Zeichen in einer Zaumlhlmarke sind stark beschraumlnkt (siehe oben) Sollten verlagsinterne Schluumlssel mit nicht erlaubten Zeichen zum Einsatz kommen kann die Zaumlhlmarke Base64url (Codepage UTF-8) enkodiert werden In diesem Fall wird die encodierte Zaumlhlmarke mit Praumlf ix bdquobase64-ldquo eingebaut
Zum Thema Base64url Die Zeichen + und werden nach der Base64-Enkodierung durch - (Minus ASCII 2Dhex) und _ (Unterstrich ASCII 5Fhex) ersetzt
Einbaubeispiel verlagsinterner Schluumlssel in HTML (irgendwo zwischen ltbodygt und ltbodygt)
Zugriffe von Texten hinter Bezahlschranken werden mit Faktor 3 multipliziert Die Aufwertung der Zaumlhlwerte hinter Bezahlschranken erfolgt mittels einer gesonderten Zaumlhlung Hierfuumlr muss der Verlag die Zaumlhlmarke beim Einbau mit einem Praumlfix versehen Dieses Praumlfix darf nur fuumlr Texte hinter Bezahlschranken verwendet werden Ist der Text frei zugaumlnglich wird die Zaumlhlmarke wie bisher (ohne Praumlf ix) eingebaut Aufgrund des Praumlfixes kann unterschieden werden ob ein Text hinter einer Bezahlschranke ist oder nicht
Um Texte hinter Bezahlschranken melden zu koumlnnen muumlssen Sie fuumlr die VG WORT zuerst einen kostenfreien Zugang auf diese Texte einrichten Dies ist uumlber die Angabe von Zugangsdaten oder uumlber die Freischaltung von IP Adressen moumlglich (im TOM Menuuml unter Zugriff auf zugangsbeschraumlnkte Inhalte erlauben)
Das Praumlf ix lautet bdquopw-ldquo bdquopwldquo steht fuumlr den englischen Begriff bdquoPaywallldquo (Bezahlschranke)
In der Vergangenheit musste bei Zaumlhlungen von https- Seiten eine separate Zaumlhldomaumlne verwendet werden Wenn Sie die Zaumlhlungen uumlber diese separate Domaumlne eingebaut haben muumlssen Sie den Einbau nicht aumlndern Diese Variante wird weiterhin unterstuumltzt
236 Potenzielle Fehlerquelle Referrer-Tag
Bestimmte Einstellungen im Quellcode koumlnnen dazu fuumlhren dass Zaumlhlungen nicht mehr zugeordnet werden koumlnnen wenn die Meldungen eingehen Es sieht dann so aus als waumlren d ie Zaumlhlungen zu einem Text falsch (zB nur uumlber eine Startseite ohne den eigentlichen Text) erfolgt Das kann dazu fuumlhren dass diese Zaumlhlungen gestrichen werden und der Mindestzugriff nicht mehr gegeben is t Um solche Probleme zu vermeiden muumlssen Sie darauf achten wie das Referrer-Metatag im Quellcode Ihrer Seite eingestellt ist
Die Zeile ltmeta name=referrer content=origingt sorgt zB dafuumlr dass eine Seite die httpswwwbeispieldemein_texthtml heiszligt nur httpswwwbeispielde sendet Damit lassen s ich dann die Zugriffe nicht mehr der richtigen Seite zuordnen
Bei weiteren Einstellungen wird das Senden der Daten vollstaumlndig unterdruumlckt Auch dies kann dazu fuumlhren dass Zaumlhlungen nicht anerkannt werden wenn weitere Faktoren darauf hindeuten dass die Zaumlhlungen nicht korrekt sein koumlnnten
Nur bei den Einstellungen ltmeta name=referrer content=no-referrer-when-downgradeldquogt oder ltmeta name=referrer content=unsafe-urlgt kann man auf gezaumlhlten Seiten 100 sicher sein dass keine Meldungen wegen nicht nachvollziehbarer Zugriffszaumlhlungen abgewiesen werden
Diese Funktion ist in bestimmten Faumlllen hoch problematisch und in anderen Faumlllen sogar zwingend erforderlich
Die Verwendung von bdquoLazy Loadldquo ist immer zu vermeiden wenn sich auf einer URL nur ein Text oder nur ein Teil eines mehrseitigen Textes befindet Hier fuumlhrt die Funktion dazu dass die Zaumlhlmarken erst geladen werden wenn die Stelle mit der Zaumlhlmarke im Browser angezeigt wird Insbesondere wenn die Zaumlhlmarke am Ende der Seite oder des Textes eingebaut wird sorgt die Funkt ion dafuumlr dass unser Zaumlhlbild nur geladen wird wenn der Leser auch an der Stelle ankommt also zB bis ganz ans Ende der Seite oder des Textes scrollt Erreicht er die Stelle nicht weil die Zaumlhlmarke zB erst unterhalb der Seite und nach Werbeeinblendungen oder Kommentaren eingebaut ist dann wird das Bild auch nicht vom Zaumlhlserver abgerufen und es erfolgt somit auch KEINE Zaumlhlung
Anders sieht es hingegen aus wenn sich viele Texte auf einer Seite befinden oder weitere Texte automatisch eingeblendet werden sobald ein Leser das Textende des ersten Textes erreicht hat Da nicht automatisch davon ausgegangen werden kann dass Texte die vom jeweil igen Nutzer nicht gesucht wurden eine Kopierwahrscheinlichkeit haben darf in diesen Faumlllen die Zaumlhlung nur erfolgen wenn der Text tatsaumlchlich ausgewaumlhlt wird Dies kann mit Hilfe von Lazy load erreicht werden Dazu baut man die jeweilige Zaumlhlmarke am besten immer ab der Mitte eines Textes ein so dass einerseits sichergestellt ist dass gezaumlhlt wird und andererseits dass nur eine Zaumlhlung erfolgt wenn wirklich ein bestimmter Text angesehen wurde und damit die notwendige Kopierwahrscheinlichkeit gegeben ist
24 Uumlberpruumlfen der Zaumlhlungen
241 Anzeige Herunterladen in der Anwendung
In der Anwendung gibt es eine Funktionalitaumlt mit der man pruumlfen kann welche Zaumlhlmarken bereits gezaumlhlt werden bzw welche Zaumlhlmarken die Mindestzugriffe uumlberschritten haben Dadurch kann man feststellen ob der Einbau dieser Zaumlhlmarken korrekt ist Diese Funktionalitaumlt kann uumlber den Menuumlpunkt bdquoZaumlhlmarkenuumlbersichtldquo abgerufen werden Siehe Abbildung unten
Abbildung 3 Maskenbeschreibung Zaumlhlerstarts
Dabei gibt es folgende Filtermoumlglichkeiten
- bdquoIdentif ikationscodeldquo Der oumlffentliche bzw private Identifikationscode oder der verlagsinterne Schluumlssel der Zaumlhlmarke
- bdquoBestelldatum (von bis)ldquo Bestelldatum der Zaumlhlmarke
- bdquoMeldung erfolgtldquo Es werden nur Zaumlhlmarken angezeigt fuumlr die bereits eine Meldung vorliegt
- bdquoZaumlhlerstart erfolgtldquo Alle Zaumlhlmarken die gezaumlhlt werden
- bdquoMindestzugriffldquo Alle Zaumlhlmarken die den Mindestzugriff oder den anteiligen Mindestzugriff uumlberschritten haben
- bdquoin Ausgeblendete Zaumlhlmarken suchenldquo Es werden auch Zaumlhlmarken gesucht die uumlber die angebotene Funktionalitaumlt ausgeblendet wurden Zaumlhlmarken sollten ausgeblendet werden wenn diese in Texten eingebaut wurden die den Kriterien der VG WORT nicht entsprechen (zB zu kurze Texte) Ansonsten scheinen diese Zaumlhlmarken weiterhin staumlndig in der Suchergebnisliste auf
Die Filtermoumlglichkeiten fuumlr den Mindestzugriff greifen sobald die ersten Zaumlhldaten fuumlr ein Kalenderjahr vorliegen Allerdings ist die Anzeige fuumlr das laufende Jahr unter Vorbehalt und erfolgt auf der Basis
des letzten bekannten Mindestzugriffes Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald der Mindestzugriff zu einem Jahr im Meldesystem eingegeben wurde (immer im Januar des Folgejahres)
Die Zaumlhlmarken koumlnnen zusaumltzlich als Liste im CSV Format heruntergeladen werden
Der Zaumlhlerstart wird mit einer Verzoumlgerung von ca 4 Tagen angezeigt Dh wenn eine Zaumlhlmarke heute eingebaut wird scheint diese in der Statistik erst in ca 4 Tagen auf
Es empfiehlt sich testweise einige wenige Zaumlhlmarken einzubauen und zu pruumlfen ob die Zaumlhlungen korrekt gestartet werden bevor man den Einbau der Zaumlhlmarken auf das gesamte Internetangebot ausrollt
242 Abruf uumlber Web Service Schnittstelle
Im Gegensatz zur Maske (siehe oben) kann man uumlber das Web Service nur die Zaumlhlmarken bdquomit Mindestzugriff ohne Meldungldquo sowie bdquomit anteiligem Mindestzugriff ohne Meldungldquo herunterladen
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2421 pixelOverviewRequest
Feld Typ Beschreibung
offset Int Wiederaufsetzpunkt Das System returniert maximal 100 Zaumlhlmarken am Stuumlck
Falls es mehr Zaumlhlmarken gibt die die Kriterien erfuumlllen koumlnnen weitere
Zaumlhlmarken uumlber den offset ausgelesen werden
Beispiel (190 Zaumlhlmarken vorhanden)
1 Abfrage (offset = 0) Die Zaumlhlmarken 1 ndash 100 werden zuruumlckgegeben
2 Abfrage (offset = 100) Die Zaumlhlmarken 101 ndash 190 werden zuruumlckgegeben
type Auswahl Entweder bdquoMINDESTZUGRIFFldquo oder bdquoANTEILIGER_MINDESTZUGRIFFldquo
2422 pixelOverviewResponse
Feld Typ Beschreibung
Amount Int Anzahl der gefundenen Zaumlhlmarken
Offset Int Der beim Request angegebene offset
privateIdentificationId pixelIDType (Liste) Privater Identifikationscode oder verlagsinterner Schluumlssel
3 Meldung Nachdem eine Zaumlhlmarke bestellt und eingebaut wurde kann eine Meldung zum jeweiligen Text erfolgen Eine Meldung soll dann gemacht werden wenn sich der Text des gemeldeten Artikels nicht mehr wesentlich aumlndert da die VG WORT in den Pruumlfmechanismen den gemeldeten Text mit dem Text der sich tatsaumlchlich im Internet befindet vergleicht
Der spaumlteste Zeitpunkt zum Melden eines Textes ist der sogenannte Meldeschlusstermin Diesen f inden Sie auf der Homepage der VG WORT unter bdquoTermineldquo Derzeit ist der Meldeschluss fuumlr Verlage der 1 Juni des auf die Zaumlhlung folgenden Jahres
In den meisten Faumlllen empfiehlt sich eine bdquoWartefristldquo von 14 Tagen bevor die Meldung erstellt wird So lange der Text noch Aumlnderungen unterzogen wird besteht die Gefahr dass die von der VG WORT durchgefuumlhrten Pruumlfmechanismen fehlschlagen
Bitte setzen Sie sich vor Meldungen zu Texten die uumlber verlagsinterne Schluumlssel gezaumlhlt werden unbedingt mit der VG WORT (per Email an metissupportvgwortde) in Verbindung
31 Anforderungen an die Meldung
Anbei f inden Sie alle Daten die bei einer Meldung angegeben werden muumlssen - Eindeutiger Identifikationscode - Alle beteiligten Autoren Uumlbersetzer und Agenturen - Kurzbeschreibung Uumlberschrift (Titel) - Text - Erscheinungsorte (Webbereiche)
311 Eindeutiger Identifikationscode
Der Identif ikationscode zur Zaumlhlmarke die in den Text eingebaut wurde Je nachdem welche Zaumlhlmarke verwendet wird ist dies der private Identifikationscode (bei VG WORT Zaumlhlmarken) oder der verlagsinterne Schluumlssel
312 Alle beteiligten Autoren Uumlbersetzer und Agenturen
Alle die am Text beteiligt sind Es gibt drei Arten wie die Autoren undoder Uumlbersetzer gemeldet werden
Vorname + Nachname + Karteinummer Die bevorzugte Variante Dabei werden von einem Autor oder einem Uumlbersetzer der Vorname der Nachname und die VG WORT Karteinummer gemeldet Eine Meldung mit Schreibweisen oder Pseudonymen ist auch moumlglich wenn diese der VG WORT bekannt sind Der Vorteil an dieser Variante ist dass ein Autor somit bei der VG WORT eindeutig identifizierbar ist und der Verlag somit keine weiteren Schritte unternehmen muss damit der jeweilige Autor zu seiner Ausschuumlttung kommt
Diese Variante beinhaltet fuumlr den Verlag zwar einen Initialaufwand da die Karteinummern aller Autoren eingesammelt werden muumlssen in der Praxis hat sich diese Variante bei den meisten teilnehmenden Verlagen aber als die einfachste Variante erwiesen
Vorname + Nachname Wenn von einem Autor die VG WORT Karteinummer nicht bekannt ist kann der Autor auch uumlber den Vornamen und den Nachnamen gemeldet werden Den Autoren steht fuumlr das Auffinden der ausschuumlttungsrelevanten Meldungen eine Suchmaske zur Verfuumlgung Allerdings muss in diesem Fall der gemeldete Name exakt mit dem uumlbereinstimmen der im Datenbestand der VG WORT vorliegt
Ist der Vorname nicht vollstaumlndig bekannt kann er in der Variante erster Buchstabe des Vornamens + Punkt angegeben werden
Urheber ohne Wahrnehmungsvertrag Hat der Urheber des zu meldenden Werkes dem meldenden Verlag fuumlr dieses Werk die von der VG WORT wahrgenommenen gesetzlichen Verguumltungsanspruumlche nach dem Urheberrechtsgesetz abgetreten kann dieser Urheber mit Namen Geburtsdatum und Adresse angegeben werden Zusaumltzlich muss bestaumltigt werden dass der Urheber die Rechte uumlbertragen hat Die uumlbertragenen Rechte werden bei der Ausschuumlttung beruumlcksichtigt
Fuumlr Agenturmeldungen bei denen die Autoren nicht bekannt sind steht eine weitere Variante zur Verfuumlgung
Die Rechte koumlnnen dem Verlag erst nach der Veroumlffentlichung des Textes uumlbertragen werden Die schriftliche Rechteuumlbertragung des jeweiligen Autors muss der VG WORT jederzeit auf Anfrage zur Verfuumlgung gestellt werden
Kuumlrzel Wenn man eine Agentur melden moumlchte dann kann das aktuell uumlber diesen Weg erfolgen Als Kuumlrzel wird die Kurzbezeichnung der jeweiligen Agentur uumlbergeben (zB bdquodpaldquo)
Namentliche bekannte Urheber koumlnnen uumlber die Angabe bdquoKuumlrzelldquo nicht gemeldet werden Diese Angabe kann ausschlieszliglich fuumlr die Meldung von Agenturtexten bzw der Miturheberschaft eines nicht namentlich bekannten Agenturautoren verwendet werden
313 Kurzbeschreibung Uumlberschrift (Titel)
Der Titel des zu meldenden Artikels
314 Text
Der Text des zu meldenden Artikels (entweder als Klartext als PDF oder im EPUB Format) Benoumltigt wird der bdquoNettotextldquo (dh der Text ohne HTML Code und ohne Menuuml oder dergleichen)
315 Erscheinungsorte (Webbereiche)
Es muumlssen alle Erscheinungsorte des Texts auf denen die Zaumlhlmarke eingebaut wurde gemeldet werden Ein Erscheinungsort definiert sich aus allen URLs die benoumltigt werden um den gesamten Text einmal zu lesen
Beispiel 1 Ein Text der sich uumlber 2 URLs erstreckt muss mit einem Webbereich (mit 2 URLs) gemel-det werden (zB httpdomain1depage1html httpdomain1depage2html)
Beispiel 2 Ein Text der sich uumlber 1 URL erstreckt aber auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils einer URL) gemeldet werden (zB httpdomain1demytexthtml und httpdomain2demytexthtml)
Beispiel 3 Ein Text der sich uumlber 2 URLs erstreckt und auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils zwei URLs) gemeldet werden (zB httpdomain1depage1html httpdomain1depage2html und httpdomain2depage1html httpdomain2depage2html)
32 Meldung uumlbermitteln
321 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
bull Es sollen nur Texte gemeldet werden die bereits bdquostabilldquo sind (dh die sich nicht mehr haumlufig aumlndern) Aus diesem Grund wird empfohlen die Texte mit einer Zeitverzoumlgerung von einigen Tagen (zB 14 Tagen) zu melden Auf die Tantieme hat das keinen Einfluss da die Ausschuumlttung erst Ende September Anfang Oktober fuumlr das Vorjahr erfolgt
bull Die Meldungen sollen taumlglich in der Nacht uumlbertragen werden Zeitfenster 2200 ndash 0300 Von 0300 bis 0600 gibt es ein allgemeines Wartungsfenster wo nicht gemeldet werden kann
bull Um eine Uumlberlastung der Server (und somit houmlhere Wartezeit) zu verhindern sollen die Meldungen sequentiell (nicht parallel) uumlbertragen werden Idealerweise soll zwischen zwei Meldungen eine Sekunde verstreichen Aus transaktionaler Sicht wird jede Meldung einzeln behandelt Dh jede erfolgreich eingehende Meldung wird gespeichert ndash unabhaumlngig davon ob die vorherige oder nachfolgende Meldung einen Fehler verursacht hat
bull Alle fachlichen Fehlercodes (ein- oder zweistellig) deuten auf einen Fehler in der Meldung hin Es ist zwecklos diese Meldung unveraumlndert noch einmal abzusenden Dreistellige Fehler (sowie der HTML ndash 500 Fehler) deuten auf technische Probleme hin Hier ist es zweckmaumlszligig dieselben Meldungen zu einem spaumlteren Zeitpunkt (zB mit den Meldungen vom naumlchsten Tag) noch einmal zu uumlbertragen
bull Die Bestaumltigung der Meldung bedeutet dass die Meldung aus technischer Sicht in Ordnung ist (dh Mindestumfang von 1800 Zeichen die Zaumlhlmarke existiert hellip) In einer spaumlteren Phase werden die Meldungen noch durch automatische Pruumlfmechanismen der VG WORT in Stichproben gepruumlft Sollten dabei Maumlngel auftreten werden die betreffenden Meldungen zuruumlckgewiesen und der Inhaber des Meldekontos bei der VG WORT wird per Email verstaumlndigt Diese Meldungen koumlnnen dann im Portal entweder geloumlscht oder manuell nachbearbeitet und erneut versendet werden
3212 newMessageRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der private
Identifikationscode (bei VG WORT Zaumlhlmarken) oder der
verlagsinterne Schluumlssel
Parties Parties Die Urheber Uumlbersetzer Agenturen der Meldung Es muss mindestens ein Autor oder ein Uumlbersetzer angegeben werden
Es koumlnnen in einer Meldung sowohl Autoren als auch
Uumlbersetzer angegeben werden
partiesauthors Authors 0 bis mehrere Autoren Beschreibung siehe separate Tabelle
partiestranslators Translators 0 bis mehrere Uumlbersetzer Beschreibung siehe separate
Tabelle
messagetext MessageText Der gemeldete Text entweder als PDF EPUB oder als Klartext
messagetextshorttext string Kurzbezeichnung Uumlberschrift vom Text
messagetexttext Text Der Text an sich Beschreibung siehe separate Tabelle
messagetextlyric boolean bdquoTrueldquo wenn es sich beim Text um Lyrik handelt ansonsten
bdquoFalseldquo
webranges Webranges Erscheinungsort(e) unter demdenen der Text gefunden werden
kann
webrangeswebrange Webrange Ein Erscheinungsort Beschreibung siehe separate Tabelle
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
In der Vergangenheit musste bei Zaumlhlungen von https- Seiten eine separate Zaumlhldomaumlne verwendet werden Wenn Sie die Zaumlhlungen uumlber diese separate Domaumlne eingebaut haben muumlssen Sie den Einbau nicht aumlndern Diese Variante wird weiterhin unterstuumltzt
236 Potenzielle Fehlerquelle Referrer-Tag
Bestimmte Einstellungen im Quellcode koumlnnen dazu fuumlhren dass Zaumlhlungen nicht mehr zugeordnet werden koumlnnen wenn die Meldungen eingehen Es sieht dann so aus als waumlren d ie Zaumlhlungen zu einem Text falsch (zB nur uumlber eine Startseite ohne den eigentlichen Text) erfolgt Das kann dazu fuumlhren dass diese Zaumlhlungen gestrichen werden und der Mindestzugriff nicht mehr gegeben is t Um solche Probleme zu vermeiden muumlssen Sie darauf achten wie das Referrer-Metatag im Quellcode Ihrer Seite eingestellt ist
Die Zeile ltmeta name=referrer content=origingt sorgt zB dafuumlr dass eine Seite die httpswwwbeispieldemein_texthtml heiszligt nur httpswwwbeispielde sendet Damit lassen s ich dann die Zugriffe nicht mehr der richtigen Seite zuordnen
Bei weiteren Einstellungen wird das Senden der Daten vollstaumlndig unterdruumlckt Auch dies kann dazu fuumlhren dass Zaumlhlungen nicht anerkannt werden wenn weitere Faktoren darauf hindeuten dass die Zaumlhlungen nicht korrekt sein koumlnnten
Nur bei den Einstellungen ltmeta name=referrer content=no-referrer-when-downgradeldquogt oder ltmeta name=referrer content=unsafe-urlgt kann man auf gezaumlhlten Seiten 100 sicher sein dass keine Meldungen wegen nicht nachvollziehbarer Zugriffszaumlhlungen abgewiesen werden
Diese Funktion ist in bestimmten Faumlllen hoch problematisch und in anderen Faumlllen sogar zwingend erforderlich
Die Verwendung von bdquoLazy Loadldquo ist immer zu vermeiden wenn sich auf einer URL nur ein Text oder nur ein Teil eines mehrseitigen Textes befindet Hier fuumlhrt die Funktion dazu dass die Zaumlhlmarken erst geladen werden wenn die Stelle mit der Zaumlhlmarke im Browser angezeigt wird Insbesondere wenn die Zaumlhlmarke am Ende der Seite oder des Textes eingebaut wird sorgt die Funkt ion dafuumlr dass unser Zaumlhlbild nur geladen wird wenn der Leser auch an der Stelle ankommt also zB bis ganz ans Ende der Seite oder des Textes scrollt Erreicht er die Stelle nicht weil die Zaumlhlmarke zB erst unterhalb der Seite und nach Werbeeinblendungen oder Kommentaren eingebaut ist dann wird das Bild auch nicht vom Zaumlhlserver abgerufen und es erfolgt somit auch KEINE Zaumlhlung
Anders sieht es hingegen aus wenn sich viele Texte auf einer Seite befinden oder weitere Texte automatisch eingeblendet werden sobald ein Leser das Textende des ersten Textes erreicht hat Da nicht automatisch davon ausgegangen werden kann dass Texte die vom jeweil igen Nutzer nicht gesucht wurden eine Kopierwahrscheinlichkeit haben darf in diesen Faumlllen die Zaumlhlung nur erfolgen wenn der Text tatsaumlchlich ausgewaumlhlt wird Dies kann mit Hilfe von Lazy load erreicht werden Dazu baut man die jeweilige Zaumlhlmarke am besten immer ab der Mitte eines Textes ein so dass einerseits sichergestellt ist dass gezaumlhlt wird und andererseits dass nur eine Zaumlhlung erfolgt wenn wirklich ein bestimmter Text angesehen wurde und damit die notwendige Kopierwahrscheinlichkeit gegeben ist
24 Uumlberpruumlfen der Zaumlhlungen
241 Anzeige Herunterladen in der Anwendung
In der Anwendung gibt es eine Funktionalitaumlt mit der man pruumlfen kann welche Zaumlhlmarken bereits gezaumlhlt werden bzw welche Zaumlhlmarken die Mindestzugriffe uumlberschritten haben Dadurch kann man feststellen ob der Einbau dieser Zaumlhlmarken korrekt ist Diese Funktionalitaumlt kann uumlber den Menuumlpunkt bdquoZaumlhlmarkenuumlbersichtldquo abgerufen werden Siehe Abbildung unten
Abbildung 3 Maskenbeschreibung Zaumlhlerstarts
Dabei gibt es folgende Filtermoumlglichkeiten
- bdquoIdentif ikationscodeldquo Der oumlffentliche bzw private Identifikationscode oder der verlagsinterne Schluumlssel der Zaumlhlmarke
- bdquoBestelldatum (von bis)ldquo Bestelldatum der Zaumlhlmarke
- bdquoMeldung erfolgtldquo Es werden nur Zaumlhlmarken angezeigt fuumlr die bereits eine Meldung vorliegt
- bdquoZaumlhlerstart erfolgtldquo Alle Zaumlhlmarken die gezaumlhlt werden
- bdquoMindestzugriffldquo Alle Zaumlhlmarken die den Mindestzugriff oder den anteiligen Mindestzugriff uumlberschritten haben
- bdquoin Ausgeblendete Zaumlhlmarken suchenldquo Es werden auch Zaumlhlmarken gesucht die uumlber die angebotene Funktionalitaumlt ausgeblendet wurden Zaumlhlmarken sollten ausgeblendet werden wenn diese in Texten eingebaut wurden die den Kriterien der VG WORT nicht entsprechen (zB zu kurze Texte) Ansonsten scheinen diese Zaumlhlmarken weiterhin staumlndig in der Suchergebnisliste auf
Die Filtermoumlglichkeiten fuumlr den Mindestzugriff greifen sobald die ersten Zaumlhldaten fuumlr ein Kalenderjahr vorliegen Allerdings ist die Anzeige fuumlr das laufende Jahr unter Vorbehalt und erfolgt auf der Basis
des letzten bekannten Mindestzugriffes Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald der Mindestzugriff zu einem Jahr im Meldesystem eingegeben wurde (immer im Januar des Folgejahres)
Die Zaumlhlmarken koumlnnen zusaumltzlich als Liste im CSV Format heruntergeladen werden
Der Zaumlhlerstart wird mit einer Verzoumlgerung von ca 4 Tagen angezeigt Dh wenn eine Zaumlhlmarke heute eingebaut wird scheint diese in der Statistik erst in ca 4 Tagen auf
Es empfiehlt sich testweise einige wenige Zaumlhlmarken einzubauen und zu pruumlfen ob die Zaumlhlungen korrekt gestartet werden bevor man den Einbau der Zaumlhlmarken auf das gesamte Internetangebot ausrollt
242 Abruf uumlber Web Service Schnittstelle
Im Gegensatz zur Maske (siehe oben) kann man uumlber das Web Service nur die Zaumlhlmarken bdquomit Mindestzugriff ohne Meldungldquo sowie bdquomit anteiligem Mindestzugriff ohne Meldungldquo herunterladen
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2421 pixelOverviewRequest
Feld Typ Beschreibung
offset Int Wiederaufsetzpunkt Das System returniert maximal 100 Zaumlhlmarken am Stuumlck
Falls es mehr Zaumlhlmarken gibt die die Kriterien erfuumlllen koumlnnen weitere
Zaumlhlmarken uumlber den offset ausgelesen werden
Beispiel (190 Zaumlhlmarken vorhanden)
1 Abfrage (offset = 0) Die Zaumlhlmarken 1 ndash 100 werden zuruumlckgegeben
2 Abfrage (offset = 100) Die Zaumlhlmarken 101 ndash 190 werden zuruumlckgegeben
type Auswahl Entweder bdquoMINDESTZUGRIFFldquo oder bdquoANTEILIGER_MINDESTZUGRIFFldquo
2422 pixelOverviewResponse
Feld Typ Beschreibung
Amount Int Anzahl der gefundenen Zaumlhlmarken
Offset Int Der beim Request angegebene offset
privateIdentificationId pixelIDType (Liste) Privater Identifikationscode oder verlagsinterner Schluumlssel
3 Meldung Nachdem eine Zaumlhlmarke bestellt und eingebaut wurde kann eine Meldung zum jeweiligen Text erfolgen Eine Meldung soll dann gemacht werden wenn sich der Text des gemeldeten Artikels nicht mehr wesentlich aumlndert da die VG WORT in den Pruumlfmechanismen den gemeldeten Text mit dem Text der sich tatsaumlchlich im Internet befindet vergleicht
Der spaumlteste Zeitpunkt zum Melden eines Textes ist der sogenannte Meldeschlusstermin Diesen f inden Sie auf der Homepage der VG WORT unter bdquoTermineldquo Derzeit ist der Meldeschluss fuumlr Verlage der 1 Juni des auf die Zaumlhlung folgenden Jahres
In den meisten Faumlllen empfiehlt sich eine bdquoWartefristldquo von 14 Tagen bevor die Meldung erstellt wird So lange der Text noch Aumlnderungen unterzogen wird besteht die Gefahr dass die von der VG WORT durchgefuumlhrten Pruumlfmechanismen fehlschlagen
Bitte setzen Sie sich vor Meldungen zu Texten die uumlber verlagsinterne Schluumlssel gezaumlhlt werden unbedingt mit der VG WORT (per Email an metissupportvgwortde) in Verbindung
31 Anforderungen an die Meldung
Anbei f inden Sie alle Daten die bei einer Meldung angegeben werden muumlssen - Eindeutiger Identifikationscode - Alle beteiligten Autoren Uumlbersetzer und Agenturen - Kurzbeschreibung Uumlberschrift (Titel) - Text - Erscheinungsorte (Webbereiche)
311 Eindeutiger Identifikationscode
Der Identif ikationscode zur Zaumlhlmarke die in den Text eingebaut wurde Je nachdem welche Zaumlhlmarke verwendet wird ist dies der private Identifikationscode (bei VG WORT Zaumlhlmarken) oder der verlagsinterne Schluumlssel
312 Alle beteiligten Autoren Uumlbersetzer und Agenturen
Alle die am Text beteiligt sind Es gibt drei Arten wie die Autoren undoder Uumlbersetzer gemeldet werden
Vorname + Nachname + Karteinummer Die bevorzugte Variante Dabei werden von einem Autor oder einem Uumlbersetzer der Vorname der Nachname und die VG WORT Karteinummer gemeldet Eine Meldung mit Schreibweisen oder Pseudonymen ist auch moumlglich wenn diese der VG WORT bekannt sind Der Vorteil an dieser Variante ist dass ein Autor somit bei der VG WORT eindeutig identifizierbar ist und der Verlag somit keine weiteren Schritte unternehmen muss damit der jeweilige Autor zu seiner Ausschuumlttung kommt
Diese Variante beinhaltet fuumlr den Verlag zwar einen Initialaufwand da die Karteinummern aller Autoren eingesammelt werden muumlssen in der Praxis hat sich diese Variante bei den meisten teilnehmenden Verlagen aber als die einfachste Variante erwiesen
Vorname + Nachname Wenn von einem Autor die VG WORT Karteinummer nicht bekannt ist kann der Autor auch uumlber den Vornamen und den Nachnamen gemeldet werden Den Autoren steht fuumlr das Auffinden der ausschuumlttungsrelevanten Meldungen eine Suchmaske zur Verfuumlgung Allerdings muss in diesem Fall der gemeldete Name exakt mit dem uumlbereinstimmen der im Datenbestand der VG WORT vorliegt
Ist der Vorname nicht vollstaumlndig bekannt kann er in der Variante erster Buchstabe des Vornamens + Punkt angegeben werden
Urheber ohne Wahrnehmungsvertrag Hat der Urheber des zu meldenden Werkes dem meldenden Verlag fuumlr dieses Werk die von der VG WORT wahrgenommenen gesetzlichen Verguumltungsanspruumlche nach dem Urheberrechtsgesetz abgetreten kann dieser Urheber mit Namen Geburtsdatum und Adresse angegeben werden Zusaumltzlich muss bestaumltigt werden dass der Urheber die Rechte uumlbertragen hat Die uumlbertragenen Rechte werden bei der Ausschuumlttung beruumlcksichtigt
Fuumlr Agenturmeldungen bei denen die Autoren nicht bekannt sind steht eine weitere Variante zur Verfuumlgung
Die Rechte koumlnnen dem Verlag erst nach der Veroumlffentlichung des Textes uumlbertragen werden Die schriftliche Rechteuumlbertragung des jeweiligen Autors muss der VG WORT jederzeit auf Anfrage zur Verfuumlgung gestellt werden
Kuumlrzel Wenn man eine Agentur melden moumlchte dann kann das aktuell uumlber diesen Weg erfolgen Als Kuumlrzel wird die Kurzbezeichnung der jeweiligen Agentur uumlbergeben (zB bdquodpaldquo)
Namentliche bekannte Urheber koumlnnen uumlber die Angabe bdquoKuumlrzelldquo nicht gemeldet werden Diese Angabe kann ausschlieszliglich fuumlr die Meldung von Agenturtexten bzw der Miturheberschaft eines nicht namentlich bekannten Agenturautoren verwendet werden
313 Kurzbeschreibung Uumlberschrift (Titel)
Der Titel des zu meldenden Artikels
314 Text
Der Text des zu meldenden Artikels (entweder als Klartext als PDF oder im EPUB Format) Benoumltigt wird der bdquoNettotextldquo (dh der Text ohne HTML Code und ohne Menuuml oder dergleichen)
315 Erscheinungsorte (Webbereiche)
Es muumlssen alle Erscheinungsorte des Texts auf denen die Zaumlhlmarke eingebaut wurde gemeldet werden Ein Erscheinungsort definiert sich aus allen URLs die benoumltigt werden um den gesamten Text einmal zu lesen
Beispiel 1 Ein Text der sich uumlber 2 URLs erstreckt muss mit einem Webbereich (mit 2 URLs) gemel-det werden (zB httpdomain1depage1html httpdomain1depage2html)
Beispiel 2 Ein Text der sich uumlber 1 URL erstreckt aber auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils einer URL) gemeldet werden (zB httpdomain1demytexthtml und httpdomain2demytexthtml)
Beispiel 3 Ein Text der sich uumlber 2 URLs erstreckt und auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils zwei URLs) gemeldet werden (zB httpdomain1depage1html httpdomain1depage2html und httpdomain2depage1html httpdomain2depage2html)
32 Meldung uumlbermitteln
321 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
bull Es sollen nur Texte gemeldet werden die bereits bdquostabilldquo sind (dh die sich nicht mehr haumlufig aumlndern) Aus diesem Grund wird empfohlen die Texte mit einer Zeitverzoumlgerung von einigen Tagen (zB 14 Tagen) zu melden Auf die Tantieme hat das keinen Einfluss da die Ausschuumlttung erst Ende September Anfang Oktober fuumlr das Vorjahr erfolgt
bull Die Meldungen sollen taumlglich in der Nacht uumlbertragen werden Zeitfenster 2200 ndash 0300 Von 0300 bis 0600 gibt es ein allgemeines Wartungsfenster wo nicht gemeldet werden kann
bull Um eine Uumlberlastung der Server (und somit houmlhere Wartezeit) zu verhindern sollen die Meldungen sequentiell (nicht parallel) uumlbertragen werden Idealerweise soll zwischen zwei Meldungen eine Sekunde verstreichen Aus transaktionaler Sicht wird jede Meldung einzeln behandelt Dh jede erfolgreich eingehende Meldung wird gespeichert ndash unabhaumlngig davon ob die vorherige oder nachfolgende Meldung einen Fehler verursacht hat
bull Alle fachlichen Fehlercodes (ein- oder zweistellig) deuten auf einen Fehler in der Meldung hin Es ist zwecklos diese Meldung unveraumlndert noch einmal abzusenden Dreistellige Fehler (sowie der HTML ndash 500 Fehler) deuten auf technische Probleme hin Hier ist es zweckmaumlszligig dieselben Meldungen zu einem spaumlteren Zeitpunkt (zB mit den Meldungen vom naumlchsten Tag) noch einmal zu uumlbertragen
bull Die Bestaumltigung der Meldung bedeutet dass die Meldung aus technischer Sicht in Ordnung ist (dh Mindestumfang von 1800 Zeichen die Zaumlhlmarke existiert hellip) In einer spaumlteren Phase werden die Meldungen noch durch automatische Pruumlfmechanismen der VG WORT in Stichproben gepruumlft Sollten dabei Maumlngel auftreten werden die betreffenden Meldungen zuruumlckgewiesen und der Inhaber des Meldekontos bei der VG WORT wird per Email verstaumlndigt Diese Meldungen koumlnnen dann im Portal entweder geloumlscht oder manuell nachbearbeitet und erneut versendet werden
3212 newMessageRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der private
Identifikationscode (bei VG WORT Zaumlhlmarken) oder der
verlagsinterne Schluumlssel
Parties Parties Die Urheber Uumlbersetzer Agenturen der Meldung Es muss mindestens ein Autor oder ein Uumlbersetzer angegeben werden
Es koumlnnen in einer Meldung sowohl Autoren als auch
Uumlbersetzer angegeben werden
partiesauthors Authors 0 bis mehrere Autoren Beschreibung siehe separate Tabelle
partiestranslators Translators 0 bis mehrere Uumlbersetzer Beschreibung siehe separate
Tabelle
messagetext MessageText Der gemeldete Text entweder als PDF EPUB oder als Klartext
messagetextshorttext string Kurzbezeichnung Uumlberschrift vom Text
messagetexttext Text Der Text an sich Beschreibung siehe separate Tabelle
messagetextlyric boolean bdquoTrueldquo wenn es sich beim Text um Lyrik handelt ansonsten
bdquoFalseldquo
webranges Webranges Erscheinungsort(e) unter demdenen der Text gefunden werden
kann
webrangeswebrange Webrange Ein Erscheinungsort Beschreibung siehe separate Tabelle
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Diese Funktion ist in bestimmten Faumlllen hoch problematisch und in anderen Faumlllen sogar zwingend erforderlich
Die Verwendung von bdquoLazy Loadldquo ist immer zu vermeiden wenn sich auf einer URL nur ein Text oder nur ein Teil eines mehrseitigen Textes befindet Hier fuumlhrt die Funktion dazu dass die Zaumlhlmarken erst geladen werden wenn die Stelle mit der Zaumlhlmarke im Browser angezeigt wird Insbesondere wenn die Zaumlhlmarke am Ende der Seite oder des Textes eingebaut wird sorgt die Funkt ion dafuumlr dass unser Zaumlhlbild nur geladen wird wenn der Leser auch an der Stelle ankommt also zB bis ganz ans Ende der Seite oder des Textes scrollt Erreicht er die Stelle nicht weil die Zaumlhlmarke zB erst unterhalb der Seite und nach Werbeeinblendungen oder Kommentaren eingebaut ist dann wird das Bild auch nicht vom Zaumlhlserver abgerufen und es erfolgt somit auch KEINE Zaumlhlung
Anders sieht es hingegen aus wenn sich viele Texte auf einer Seite befinden oder weitere Texte automatisch eingeblendet werden sobald ein Leser das Textende des ersten Textes erreicht hat Da nicht automatisch davon ausgegangen werden kann dass Texte die vom jeweil igen Nutzer nicht gesucht wurden eine Kopierwahrscheinlichkeit haben darf in diesen Faumlllen die Zaumlhlung nur erfolgen wenn der Text tatsaumlchlich ausgewaumlhlt wird Dies kann mit Hilfe von Lazy load erreicht werden Dazu baut man die jeweilige Zaumlhlmarke am besten immer ab der Mitte eines Textes ein so dass einerseits sichergestellt ist dass gezaumlhlt wird und andererseits dass nur eine Zaumlhlung erfolgt wenn wirklich ein bestimmter Text angesehen wurde und damit die notwendige Kopierwahrscheinlichkeit gegeben ist
24 Uumlberpruumlfen der Zaumlhlungen
241 Anzeige Herunterladen in der Anwendung
In der Anwendung gibt es eine Funktionalitaumlt mit der man pruumlfen kann welche Zaumlhlmarken bereits gezaumlhlt werden bzw welche Zaumlhlmarken die Mindestzugriffe uumlberschritten haben Dadurch kann man feststellen ob der Einbau dieser Zaumlhlmarken korrekt ist Diese Funktionalitaumlt kann uumlber den Menuumlpunkt bdquoZaumlhlmarkenuumlbersichtldquo abgerufen werden Siehe Abbildung unten
Abbildung 3 Maskenbeschreibung Zaumlhlerstarts
Dabei gibt es folgende Filtermoumlglichkeiten
- bdquoIdentif ikationscodeldquo Der oumlffentliche bzw private Identifikationscode oder der verlagsinterne Schluumlssel der Zaumlhlmarke
- bdquoBestelldatum (von bis)ldquo Bestelldatum der Zaumlhlmarke
- bdquoMeldung erfolgtldquo Es werden nur Zaumlhlmarken angezeigt fuumlr die bereits eine Meldung vorliegt
- bdquoZaumlhlerstart erfolgtldquo Alle Zaumlhlmarken die gezaumlhlt werden
- bdquoMindestzugriffldquo Alle Zaumlhlmarken die den Mindestzugriff oder den anteiligen Mindestzugriff uumlberschritten haben
- bdquoin Ausgeblendete Zaumlhlmarken suchenldquo Es werden auch Zaumlhlmarken gesucht die uumlber die angebotene Funktionalitaumlt ausgeblendet wurden Zaumlhlmarken sollten ausgeblendet werden wenn diese in Texten eingebaut wurden die den Kriterien der VG WORT nicht entsprechen (zB zu kurze Texte) Ansonsten scheinen diese Zaumlhlmarken weiterhin staumlndig in der Suchergebnisliste auf
Die Filtermoumlglichkeiten fuumlr den Mindestzugriff greifen sobald die ersten Zaumlhldaten fuumlr ein Kalenderjahr vorliegen Allerdings ist die Anzeige fuumlr das laufende Jahr unter Vorbehalt und erfolgt auf der Basis
des letzten bekannten Mindestzugriffes Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald der Mindestzugriff zu einem Jahr im Meldesystem eingegeben wurde (immer im Januar des Folgejahres)
Die Zaumlhlmarken koumlnnen zusaumltzlich als Liste im CSV Format heruntergeladen werden
Der Zaumlhlerstart wird mit einer Verzoumlgerung von ca 4 Tagen angezeigt Dh wenn eine Zaumlhlmarke heute eingebaut wird scheint diese in der Statistik erst in ca 4 Tagen auf
Es empfiehlt sich testweise einige wenige Zaumlhlmarken einzubauen und zu pruumlfen ob die Zaumlhlungen korrekt gestartet werden bevor man den Einbau der Zaumlhlmarken auf das gesamte Internetangebot ausrollt
242 Abruf uumlber Web Service Schnittstelle
Im Gegensatz zur Maske (siehe oben) kann man uumlber das Web Service nur die Zaumlhlmarken bdquomit Mindestzugriff ohne Meldungldquo sowie bdquomit anteiligem Mindestzugriff ohne Meldungldquo herunterladen
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2421 pixelOverviewRequest
Feld Typ Beschreibung
offset Int Wiederaufsetzpunkt Das System returniert maximal 100 Zaumlhlmarken am Stuumlck
Falls es mehr Zaumlhlmarken gibt die die Kriterien erfuumlllen koumlnnen weitere
Zaumlhlmarken uumlber den offset ausgelesen werden
Beispiel (190 Zaumlhlmarken vorhanden)
1 Abfrage (offset = 0) Die Zaumlhlmarken 1 ndash 100 werden zuruumlckgegeben
2 Abfrage (offset = 100) Die Zaumlhlmarken 101 ndash 190 werden zuruumlckgegeben
type Auswahl Entweder bdquoMINDESTZUGRIFFldquo oder bdquoANTEILIGER_MINDESTZUGRIFFldquo
2422 pixelOverviewResponse
Feld Typ Beschreibung
Amount Int Anzahl der gefundenen Zaumlhlmarken
Offset Int Der beim Request angegebene offset
privateIdentificationId pixelIDType (Liste) Privater Identifikationscode oder verlagsinterner Schluumlssel
3 Meldung Nachdem eine Zaumlhlmarke bestellt und eingebaut wurde kann eine Meldung zum jeweiligen Text erfolgen Eine Meldung soll dann gemacht werden wenn sich der Text des gemeldeten Artikels nicht mehr wesentlich aumlndert da die VG WORT in den Pruumlfmechanismen den gemeldeten Text mit dem Text der sich tatsaumlchlich im Internet befindet vergleicht
Der spaumlteste Zeitpunkt zum Melden eines Textes ist der sogenannte Meldeschlusstermin Diesen f inden Sie auf der Homepage der VG WORT unter bdquoTermineldquo Derzeit ist der Meldeschluss fuumlr Verlage der 1 Juni des auf die Zaumlhlung folgenden Jahres
In den meisten Faumlllen empfiehlt sich eine bdquoWartefristldquo von 14 Tagen bevor die Meldung erstellt wird So lange der Text noch Aumlnderungen unterzogen wird besteht die Gefahr dass die von der VG WORT durchgefuumlhrten Pruumlfmechanismen fehlschlagen
Bitte setzen Sie sich vor Meldungen zu Texten die uumlber verlagsinterne Schluumlssel gezaumlhlt werden unbedingt mit der VG WORT (per Email an metissupportvgwortde) in Verbindung
31 Anforderungen an die Meldung
Anbei f inden Sie alle Daten die bei einer Meldung angegeben werden muumlssen - Eindeutiger Identifikationscode - Alle beteiligten Autoren Uumlbersetzer und Agenturen - Kurzbeschreibung Uumlberschrift (Titel) - Text - Erscheinungsorte (Webbereiche)
311 Eindeutiger Identifikationscode
Der Identif ikationscode zur Zaumlhlmarke die in den Text eingebaut wurde Je nachdem welche Zaumlhlmarke verwendet wird ist dies der private Identifikationscode (bei VG WORT Zaumlhlmarken) oder der verlagsinterne Schluumlssel
312 Alle beteiligten Autoren Uumlbersetzer und Agenturen
Alle die am Text beteiligt sind Es gibt drei Arten wie die Autoren undoder Uumlbersetzer gemeldet werden
Vorname + Nachname + Karteinummer Die bevorzugte Variante Dabei werden von einem Autor oder einem Uumlbersetzer der Vorname der Nachname und die VG WORT Karteinummer gemeldet Eine Meldung mit Schreibweisen oder Pseudonymen ist auch moumlglich wenn diese der VG WORT bekannt sind Der Vorteil an dieser Variante ist dass ein Autor somit bei der VG WORT eindeutig identifizierbar ist und der Verlag somit keine weiteren Schritte unternehmen muss damit der jeweilige Autor zu seiner Ausschuumlttung kommt
Diese Variante beinhaltet fuumlr den Verlag zwar einen Initialaufwand da die Karteinummern aller Autoren eingesammelt werden muumlssen in der Praxis hat sich diese Variante bei den meisten teilnehmenden Verlagen aber als die einfachste Variante erwiesen
Vorname + Nachname Wenn von einem Autor die VG WORT Karteinummer nicht bekannt ist kann der Autor auch uumlber den Vornamen und den Nachnamen gemeldet werden Den Autoren steht fuumlr das Auffinden der ausschuumlttungsrelevanten Meldungen eine Suchmaske zur Verfuumlgung Allerdings muss in diesem Fall der gemeldete Name exakt mit dem uumlbereinstimmen der im Datenbestand der VG WORT vorliegt
Ist der Vorname nicht vollstaumlndig bekannt kann er in der Variante erster Buchstabe des Vornamens + Punkt angegeben werden
Urheber ohne Wahrnehmungsvertrag Hat der Urheber des zu meldenden Werkes dem meldenden Verlag fuumlr dieses Werk die von der VG WORT wahrgenommenen gesetzlichen Verguumltungsanspruumlche nach dem Urheberrechtsgesetz abgetreten kann dieser Urheber mit Namen Geburtsdatum und Adresse angegeben werden Zusaumltzlich muss bestaumltigt werden dass der Urheber die Rechte uumlbertragen hat Die uumlbertragenen Rechte werden bei der Ausschuumlttung beruumlcksichtigt
Fuumlr Agenturmeldungen bei denen die Autoren nicht bekannt sind steht eine weitere Variante zur Verfuumlgung
Die Rechte koumlnnen dem Verlag erst nach der Veroumlffentlichung des Textes uumlbertragen werden Die schriftliche Rechteuumlbertragung des jeweiligen Autors muss der VG WORT jederzeit auf Anfrage zur Verfuumlgung gestellt werden
Kuumlrzel Wenn man eine Agentur melden moumlchte dann kann das aktuell uumlber diesen Weg erfolgen Als Kuumlrzel wird die Kurzbezeichnung der jeweiligen Agentur uumlbergeben (zB bdquodpaldquo)
Namentliche bekannte Urheber koumlnnen uumlber die Angabe bdquoKuumlrzelldquo nicht gemeldet werden Diese Angabe kann ausschlieszliglich fuumlr die Meldung von Agenturtexten bzw der Miturheberschaft eines nicht namentlich bekannten Agenturautoren verwendet werden
313 Kurzbeschreibung Uumlberschrift (Titel)
Der Titel des zu meldenden Artikels
314 Text
Der Text des zu meldenden Artikels (entweder als Klartext als PDF oder im EPUB Format) Benoumltigt wird der bdquoNettotextldquo (dh der Text ohne HTML Code und ohne Menuuml oder dergleichen)
315 Erscheinungsorte (Webbereiche)
Es muumlssen alle Erscheinungsorte des Texts auf denen die Zaumlhlmarke eingebaut wurde gemeldet werden Ein Erscheinungsort definiert sich aus allen URLs die benoumltigt werden um den gesamten Text einmal zu lesen
Beispiel 1 Ein Text der sich uumlber 2 URLs erstreckt muss mit einem Webbereich (mit 2 URLs) gemel-det werden (zB httpdomain1depage1html httpdomain1depage2html)
Beispiel 2 Ein Text der sich uumlber 1 URL erstreckt aber auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils einer URL) gemeldet werden (zB httpdomain1demytexthtml und httpdomain2demytexthtml)
Beispiel 3 Ein Text der sich uumlber 2 URLs erstreckt und auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils zwei URLs) gemeldet werden (zB httpdomain1depage1html httpdomain1depage2html und httpdomain2depage1html httpdomain2depage2html)
32 Meldung uumlbermitteln
321 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
bull Es sollen nur Texte gemeldet werden die bereits bdquostabilldquo sind (dh die sich nicht mehr haumlufig aumlndern) Aus diesem Grund wird empfohlen die Texte mit einer Zeitverzoumlgerung von einigen Tagen (zB 14 Tagen) zu melden Auf die Tantieme hat das keinen Einfluss da die Ausschuumlttung erst Ende September Anfang Oktober fuumlr das Vorjahr erfolgt
bull Die Meldungen sollen taumlglich in der Nacht uumlbertragen werden Zeitfenster 2200 ndash 0300 Von 0300 bis 0600 gibt es ein allgemeines Wartungsfenster wo nicht gemeldet werden kann
bull Um eine Uumlberlastung der Server (und somit houmlhere Wartezeit) zu verhindern sollen die Meldungen sequentiell (nicht parallel) uumlbertragen werden Idealerweise soll zwischen zwei Meldungen eine Sekunde verstreichen Aus transaktionaler Sicht wird jede Meldung einzeln behandelt Dh jede erfolgreich eingehende Meldung wird gespeichert ndash unabhaumlngig davon ob die vorherige oder nachfolgende Meldung einen Fehler verursacht hat
bull Alle fachlichen Fehlercodes (ein- oder zweistellig) deuten auf einen Fehler in der Meldung hin Es ist zwecklos diese Meldung unveraumlndert noch einmal abzusenden Dreistellige Fehler (sowie der HTML ndash 500 Fehler) deuten auf technische Probleme hin Hier ist es zweckmaumlszligig dieselben Meldungen zu einem spaumlteren Zeitpunkt (zB mit den Meldungen vom naumlchsten Tag) noch einmal zu uumlbertragen
bull Die Bestaumltigung der Meldung bedeutet dass die Meldung aus technischer Sicht in Ordnung ist (dh Mindestumfang von 1800 Zeichen die Zaumlhlmarke existiert hellip) In einer spaumlteren Phase werden die Meldungen noch durch automatische Pruumlfmechanismen der VG WORT in Stichproben gepruumlft Sollten dabei Maumlngel auftreten werden die betreffenden Meldungen zuruumlckgewiesen und der Inhaber des Meldekontos bei der VG WORT wird per Email verstaumlndigt Diese Meldungen koumlnnen dann im Portal entweder geloumlscht oder manuell nachbearbeitet und erneut versendet werden
3212 newMessageRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der private
Identifikationscode (bei VG WORT Zaumlhlmarken) oder der
verlagsinterne Schluumlssel
Parties Parties Die Urheber Uumlbersetzer Agenturen der Meldung Es muss mindestens ein Autor oder ein Uumlbersetzer angegeben werden
Es koumlnnen in einer Meldung sowohl Autoren als auch
Uumlbersetzer angegeben werden
partiesauthors Authors 0 bis mehrere Autoren Beschreibung siehe separate Tabelle
partiestranslators Translators 0 bis mehrere Uumlbersetzer Beschreibung siehe separate
Tabelle
messagetext MessageText Der gemeldete Text entweder als PDF EPUB oder als Klartext
messagetextshorttext string Kurzbezeichnung Uumlberschrift vom Text
messagetexttext Text Der Text an sich Beschreibung siehe separate Tabelle
messagetextlyric boolean bdquoTrueldquo wenn es sich beim Text um Lyrik handelt ansonsten
bdquoFalseldquo
webranges Webranges Erscheinungsort(e) unter demdenen der Text gefunden werden
kann
webrangeswebrange Webrange Ein Erscheinungsort Beschreibung siehe separate Tabelle
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
des letzten bekannten Mindestzugriffes Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald der Mindestzugriff zu einem Jahr im Meldesystem eingegeben wurde (immer im Januar des Folgejahres)
Die Zaumlhlmarken koumlnnen zusaumltzlich als Liste im CSV Format heruntergeladen werden
Der Zaumlhlerstart wird mit einer Verzoumlgerung von ca 4 Tagen angezeigt Dh wenn eine Zaumlhlmarke heute eingebaut wird scheint diese in der Statistik erst in ca 4 Tagen auf
Es empfiehlt sich testweise einige wenige Zaumlhlmarken einzubauen und zu pruumlfen ob die Zaumlhlungen korrekt gestartet werden bevor man den Einbau der Zaumlhlmarken auf das gesamte Internetangebot ausrollt
242 Abruf uumlber Web Service Schnittstelle
Im Gegensatz zur Maske (siehe oben) kann man uumlber das Web Service nur die Zaumlhlmarken bdquomit Mindestzugriff ohne Meldungldquo sowie bdquomit anteiligem Mindestzugriff ohne Meldungldquo herunterladen
Web Service Request URL httpstomvgwortdeservices10PixelService XSD Definition httpstomvgwortdeservices10pixelServicexsd WSDL Definition httpstomvgwortdeservices10pixelServicewsdl
2421 pixelOverviewRequest
Feld Typ Beschreibung
offset Int Wiederaufsetzpunkt Das System returniert maximal 100 Zaumlhlmarken am Stuumlck
Falls es mehr Zaumlhlmarken gibt die die Kriterien erfuumlllen koumlnnen weitere
Zaumlhlmarken uumlber den offset ausgelesen werden
Beispiel (190 Zaumlhlmarken vorhanden)
1 Abfrage (offset = 0) Die Zaumlhlmarken 1 ndash 100 werden zuruumlckgegeben
2 Abfrage (offset = 100) Die Zaumlhlmarken 101 ndash 190 werden zuruumlckgegeben
type Auswahl Entweder bdquoMINDESTZUGRIFFldquo oder bdquoANTEILIGER_MINDESTZUGRIFFldquo
2422 pixelOverviewResponse
Feld Typ Beschreibung
Amount Int Anzahl der gefundenen Zaumlhlmarken
Offset Int Der beim Request angegebene offset
privateIdentificationId pixelIDType (Liste) Privater Identifikationscode oder verlagsinterner Schluumlssel
3 Meldung Nachdem eine Zaumlhlmarke bestellt und eingebaut wurde kann eine Meldung zum jeweiligen Text erfolgen Eine Meldung soll dann gemacht werden wenn sich der Text des gemeldeten Artikels nicht mehr wesentlich aumlndert da die VG WORT in den Pruumlfmechanismen den gemeldeten Text mit dem Text der sich tatsaumlchlich im Internet befindet vergleicht
Der spaumlteste Zeitpunkt zum Melden eines Textes ist der sogenannte Meldeschlusstermin Diesen f inden Sie auf der Homepage der VG WORT unter bdquoTermineldquo Derzeit ist der Meldeschluss fuumlr Verlage der 1 Juni des auf die Zaumlhlung folgenden Jahres
In den meisten Faumlllen empfiehlt sich eine bdquoWartefristldquo von 14 Tagen bevor die Meldung erstellt wird So lange der Text noch Aumlnderungen unterzogen wird besteht die Gefahr dass die von der VG WORT durchgefuumlhrten Pruumlfmechanismen fehlschlagen
Bitte setzen Sie sich vor Meldungen zu Texten die uumlber verlagsinterne Schluumlssel gezaumlhlt werden unbedingt mit der VG WORT (per Email an metissupportvgwortde) in Verbindung
31 Anforderungen an die Meldung
Anbei f inden Sie alle Daten die bei einer Meldung angegeben werden muumlssen - Eindeutiger Identifikationscode - Alle beteiligten Autoren Uumlbersetzer und Agenturen - Kurzbeschreibung Uumlberschrift (Titel) - Text - Erscheinungsorte (Webbereiche)
311 Eindeutiger Identifikationscode
Der Identif ikationscode zur Zaumlhlmarke die in den Text eingebaut wurde Je nachdem welche Zaumlhlmarke verwendet wird ist dies der private Identifikationscode (bei VG WORT Zaumlhlmarken) oder der verlagsinterne Schluumlssel
312 Alle beteiligten Autoren Uumlbersetzer und Agenturen
Alle die am Text beteiligt sind Es gibt drei Arten wie die Autoren undoder Uumlbersetzer gemeldet werden
Vorname + Nachname + Karteinummer Die bevorzugte Variante Dabei werden von einem Autor oder einem Uumlbersetzer der Vorname der Nachname und die VG WORT Karteinummer gemeldet Eine Meldung mit Schreibweisen oder Pseudonymen ist auch moumlglich wenn diese der VG WORT bekannt sind Der Vorteil an dieser Variante ist dass ein Autor somit bei der VG WORT eindeutig identifizierbar ist und der Verlag somit keine weiteren Schritte unternehmen muss damit der jeweilige Autor zu seiner Ausschuumlttung kommt
Diese Variante beinhaltet fuumlr den Verlag zwar einen Initialaufwand da die Karteinummern aller Autoren eingesammelt werden muumlssen in der Praxis hat sich diese Variante bei den meisten teilnehmenden Verlagen aber als die einfachste Variante erwiesen
Vorname + Nachname Wenn von einem Autor die VG WORT Karteinummer nicht bekannt ist kann der Autor auch uumlber den Vornamen und den Nachnamen gemeldet werden Den Autoren steht fuumlr das Auffinden der ausschuumlttungsrelevanten Meldungen eine Suchmaske zur Verfuumlgung Allerdings muss in diesem Fall der gemeldete Name exakt mit dem uumlbereinstimmen der im Datenbestand der VG WORT vorliegt
Ist der Vorname nicht vollstaumlndig bekannt kann er in der Variante erster Buchstabe des Vornamens + Punkt angegeben werden
Urheber ohne Wahrnehmungsvertrag Hat der Urheber des zu meldenden Werkes dem meldenden Verlag fuumlr dieses Werk die von der VG WORT wahrgenommenen gesetzlichen Verguumltungsanspruumlche nach dem Urheberrechtsgesetz abgetreten kann dieser Urheber mit Namen Geburtsdatum und Adresse angegeben werden Zusaumltzlich muss bestaumltigt werden dass der Urheber die Rechte uumlbertragen hat Die uumlbertragenen Rechte werden bei der Ausschuumlttung beruumlcksichtigt
Fuumlr Agenturmeldungen bei denen die Autoren nicht bekannt sind steht eine weitere Variante zur Verfuumlgung
Die Rechte koumlnnen dem Verlag erst nach der Veroumlffentlichung des Textes uumlbertragen werden Die schriftliche Rechteuumlbertragung des jeweiligen Autors muss der VG WORT jederzeit auf Anfrage zur Verfuumlgung gestellt werden
Kuumlrzel Wenn man eine Agentur melden moumlchte dann kann das aktuell uumlber diesen Weg erfolgen Als Kuumlrzel wird die Kurzbezeichnung der jeweiligen Agentur uumlbergeben (zB bdquodpaldquo)
Namentliche bekannte Urheber koumlnnen uumlber die Angabe bdquoKuumlrzelldquo nicht gemeldet werden Diese Angabe kann ausschlieszliglich fuumlr die Meldung von Agenturtexten bzw der Miturheberschaft eines nicht namentlich bekannten Agenturautoren verwendet werden
313 Kurzbeschreibung Uumlberschrift (Titel)
Der Titel des zu meldenden Artikels
314 Text
Der Text des zu meldenden Artikels (entweder als Klartext als PDF oder im EPUB Format) Benoumltigt wird der bdquoNettotextldquo (dh der Text ohne HTML Code und ohne Menuuml oder dergleichen)
315 Erscheinungsorte (Webbereiche)
Es muumlssen alle Erscheinungsorte des Texts auf denen die Zaumlhlmarke eingebaut wurde gemeldet werden Ein Erscheinungsort definiert sich aus allen URLs die benoumltigt werden um den gesamten Text einmal zu lesen
Beispiel 1 Ein Text der sich uumlber 2 URLs erstreckt muss mit einem Webbereich (mit 2 URLs) gemel-det werden (zB httpdomain1depage1html httpdomain1depage2html)
Beispiel 2 Ein Text der sich uumlber 1 URL erstreckt aber auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils einer URL) gemeldet werden (zB httpdomain1demytexthtml und httpdomain2demytexthtml)
Beispiel 3 Ein Text der sich uumlber 2 URLs erstreckt und auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils zwei URLs) gemeldet werden (zB httpdomain1depage1html httpdomain1depage2html und httpdomain2depage1html httpdomain2depage2html)
32 Meldung uumlbermitteln
321 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
bull Es sollen nur Texte gemeldet werden die bereits bdquostabilldquo sind (dh die sich nicht mehr haumlufig aumlndern) Aus diesem Grund wird empfohlen die Texte mit einer Zeitverzoumlgerung von einigen Tagen (zB 14 Tagen) zu melden Auf die Tantieme hat das keinen Einfluss da die Ausschuumlttung erst Ende September Anfang Oktober fuumlr das Vorjahr erfolgt
bull Die Meldungen sollen taumlglich in der Nacht uumlbertragen werden Zeitfenster 2200 ndash 0300 Von 0300 bis 0600 gibt es ein allgemeines Wartungsfenster wo nicht gemeldet werden kann
bull Um eine Uumlberlastung der Server (und somit houmlhere Wartezeit) zu verhindern sollen die Meldungen sequentiell (nicht parallel) uumlbertragen werden Idealerweise soll zwischen zwei Meldungen eine Sekunde verstreichen Aus transaktionaler Sicht wird jede Meldung einzeln behandelt Dh jede erfolgreich eingehende Meldung wird gespeichert ndash unabhaumlngig davon ob die vorherige oder nachfolgende Meldung einen Fehler verursacht hat
bull Alle fachlichen Fehlercodes (ein- oder zweistellig) deuten auf einen Fehler in der Meldung hin Es ist zwecklos diese Meldung unveraumlndert noch einmal abzusenden Dreistellige Fehler (sowie der HTML ndash 500 Fehler) deuten auf technische Probleme hin Hier ist es zweckmaumlszligig dieselben Meldungen zu einem spaumlteren Zeitpunkt (zB mit den Meldungen vom naumlchsten Tag) noch einmal zu uumlbertragen
bull Die Bestaumltigung der Meldung bedeutet dass die Meldung aus technischer Sicht in Ordnung ist (dh Mindestumfang von 1800 Zeichen die Zaumlhlmarke existiert hellip) In einer spaumlteren Phase werden die Meldungen noch durch automatische Pruumlfmechanismen der VG WORT in Stichproben gepruumlft Sollten dabei Maumlngel auftreten werden die betreffenden Meldungen zuruumlckgewiesen und der Inhaber des Meldekontos bei der VG WORT wird per Email verstaumlndigt Diese Meldungen koumlnnen dann im Portal entweder geloumlscht oder manuell nachbearbeitet und erneut versendet werden
3212 newMessageRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der private
Identifikationscode (bei VG WORT Zaumlhlmarken) oder der
verlagsinterne Schluumlssel
Parties Parties Die Urheber Uumlbersetzer Agenturen der Meldung Es muss mindestens ein Autor oder ein Uumlbersetzer angegeben werden
Es koumlnnen in einer Meldung sowohl Autoren als auch
Uumlbersetzer angegeben werden
partiesauthors Authors 0 bis mehrere Autoren Beschreibung siehe separate Tabelle
partiestranslators Translators 0 bis mehrere Uumlbersetzer Beschreibung siehe separate
Tabelle
messagetext MessageText Der gemeldete Text entweder als PDF EPUB oder als Klartext
messagetextshorttext string Kurzbezeichnung Uumlberschrift vom Text
messagetexttext Text Der Text an sich Beschreibung siehe separate Tabelle
messagetextlyric boolean bdquoTrueldquo wenn es sich beim Text um Lyrik handelt ansonsten
bdquoFalseldquo
webranges Webranges Erscheinungsort(e) unter demdenen der Text gefunden werden
kann
webrangeswebrange Webrange Ein Erscheinungsort Beschreibung siehe separate Tabelle
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
3 Meldung Nachdem eine Zaumlhlmarke bestellt und eingebaut wurde kann eine Meldung zum jeweiligen Text erfolgen Eine Meldung soll dann gemacht werden wenn sich der Text des gemeldeten Artikels nicht mehr wesentlich aumlndert da die VG WORT in den Pruumlfmechanismen den gemeldeten Text mit dem Text der sich tatsaumlchlich im Internet befindet vergleicht
Der spaumlteste Zeitpunkt zum Melden eines Textes ist der sogenannte Meldeschlusstermin Diesen f inden Sie auf der Homepage der VG WORT unter bdquoTermineldquo Derzeit ist der Meldeschluss fuumlr Verlage der 1 Juni des auf die Zaumlhlung folgenden Jahres
In den meisten Faumlllen empfiehlt sich eine bdquoWartefristldquo von 14 Tagen bevor die Meldung erstellt wird So lange der Text noch Aumlnderungen unterzogen wird besteht die Gefahr dass die von der VG WORT durchgefuumlhrten Pruumlfmechanismen fehlschlagen
Bitte setzen Sie sich vor Meldungen zu Texten die uumlber verlagsinterne Schluumlssel gezaumlhlt werden unbedingt mit der VG WORT (per Email an metissupportvgwortde) in Verbindung
31 Anforderungen an die Meldung
Anbei f inden Sie alle Daten die bei einer Meldung angegeben werden muumlssen - Eindeutiger Identifikationscode - Alle beteiligten Autoren Uumlbersetzer und Agenturen - Kurzbeschreibung Uumlberschrift (Titel) - Text - Erscheinungsorte (Webbereiche)
311 Eindeutiger Identifikationscode
Der Identif ikationscode zur Zaumlhlmarke die in den Text eingebaut wurde Je nachdem welche Zaumlhlmarke verwendet wird ist dies der private Identifikationscode (bei VG WORT Zaumlhlmarken) oder der verlagsinterne Schluumlssel
312 Alle beteiligten Autoren Uumlbersetzer und Agenturen
Alle die am Text beteiligt sind Es gibt drei Arten wie die Autoren undoder Uumlbersetzer gemeldet werden
Vorname + Nachname + Karteinummer Die bevorzugte Variante Dabei werden von einem Autor oder einem Uumlbersetzer der Vorname der Nachname und die VG WORT Karteinummer gemeldet Eine Meldung mit Schreibweisen oder Pseudonymen ist auch moumlglich wenn diese der VG WORT bekannt sind Der Vorteil an dieser Variante ist dass ein Autor somit bei der VG WORT eindeutig identifizierbar ist und der Verlag somit keine weiteren Schritte unternehmen muss damit der jeweilige Autor zu seiner Ausschuumlttung kommt
Diese Variante beinhaltet fuumlr den Verlag zwar einen Initialaufwand da die Karteinummern aller Autoren eingesammelt werden muumlssen in der Praxis hat sich diese Variante bei den meisten teilnehmenden Verlagen aber als die einfachste Variante erwiesen
Vorname + Nachname Wenn von einem Autor die VG WORT Karteinummer nicht bekannt ist kann der Autor auch uumlber den Vornamen und den Nachnamen gemeldet werden Den Autoren steht fuumlr das Auffinden der ausschuumlttungsrelevanten Meldungen eine Suchmaske zur Verfuumlgung Allerdings muss in diesem Fall der gemeldete Name exakt mit dem uumlbereinstimmen der im Datenbestand der VG WORT vorliegt
Ist der Vorname nicht vollstaumlndig bekannt kann er in der Variante erster Buchstabe des Vornamens + Punkt angegeben werden
Urheber ohne Wahrnehmungsvertrag Hat der Urheber des zu meldenden Werkes dem meldenden Verlag fuumlr dieses Werk die von der VG WORT wahrgenommenen gesetzlichen Verguumltungsanspruumlche nach dem Urheberrechtsgesetz abgetreten kann dieser Urheber mit Namen Geburtsdatum und Adresse angegeben werden Zusaumltzlich muss bestaumltigt werden dass der Urheber die Rechte uumlbertragen hat Die uumlbertragenen Rechte werden bei der Ausschuumlttung beruumlcksichtigt
Fuumlr Agenturmeldungen bei denen die Autoren nicht bekannt sind steht eine weitere Variante zur Verfuumlgung
Die Rechte koumlnnen dem Verlag erst nach der Veroumlffentlichung des Textes uumlbertragen werden Die schriftliche Rechteuumlbertragung des jeweiligen Autors muss der VG WORT jederzeit auf Anfrage zur Verfuumlgung gestellt werden
Kuumlrzel Wenn man eine Agentur melden moumlchte dann kann das aktuell uumlber diesen Weg erfolgen Als Kuumlrzel wird die Kurzbezeichnung der jeweiligen Agentur uumlbergeben (zB bdquodpaldquo)
Namentliche bekannte Urheber koumlnnen uumlber die Angabe bdquoKuumlrzelldquo nicht gemeldet werden Diese Angabe kann ausschlieszliglich fuumlr die Meldung von Agenturtexten bzw der Miturheberschaft eines nicht namentlich bekannten Agenturautoren verwendet werden
313 Kurzbeschreibung Uumlberschrift (Titel)
Der Titel des zu meldenden Artikels
314 Text
Der Text des zu meldenden Artikels (entweder als Klartext als PDF oder im EPUB Format) Benoumltigt wird der bdquoNettotextldquo (dh der Text ohne HTML Code und ohne Menuuml oder dergleichen)
315 Erscheinungsorte (Webbereiche)
Es muumlssen alle Erscheinungsorte des Texts auf denen die Zaumlhlmarke eingebaut wurde gemeldet werden Ein Erscheinungsort definiert sich aus allen URLs die benoumltigt werden um den gesamten Text einmal zu lesen
Beispiel 1 Ein Text der sich uumlber 2 URLs erstreckt muss mit einem Webbereich (mit 2 URLs) gemel-det werden (zB httpdomain1depage1html httpdomain1depage2html)
Beispiel 2 Ein Text der sich uumlber 1 URL erstreckt aber auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils einer URL) gemeldet werden (zB httpdomain1demytexthtml und httpdomain2demytexthtml)
Beispiel 3 Ein Text der sich uumlber 2 URLs erstreckt und auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils zwei URLs) gemeldet werden (zB httpdomain1depage1html httpdomain1depage2html und httpdomain2depage1html httpdomain2depage2html)
32 Meldung uumlbermitteln
321 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
bull Es sollen nur Texte gemeldet werden die bereits bdquostabilldquo sind (dh die sich nicht mehr haumlufig aumlndern) Aus diesem Grund wird empfohlen die Texte mit einer Zeitverzoumlgerung von einigen Tagen (zB 14 Tagen) zu melden Auf die Tantieme hat das keinen Einfluss da die Ausschuumlttung erst Ende September Anfang Oktober fuumlr das Vorjahr erfolgt
bull Die Meldungen sollen taumlglich in der Nacht uumlbertragen werden Zeitfenster 2200 ndash 0300 Von 0300 bis 0600 gibt es ein allgemeines Wartungsfenster wo nicht gemeldet werden kann
bull Um eine Uumlberlastung der Server (und somit houmlhere Wartezeit) zu verhindern sollen die Meldungen sequentiell (nicht parallel) uumlbertragen werden Idealerweise soll zwischen zwei Meldungen eine Sekunde verstreichen Aus transaktionaler Sicht wird jede Meldung einzeln behandelt Dh jede erfolgreich eingehende Meldung wird gespeichert ndash unabhaumlngig davon ob die vorherige oder nachfolgende Meldung einen Fehler verursacht hat
bull Alle fachlichen Fehlercodes (ein- oder zweistellig) deuten auf einen Fehler in der Meldung hin Es ist zwecklos diese Meldung unveraumlndert noch einmal abzusenden Dreistellige Fehler (sowie der HTML ndash 500 Fehler) deuten auf technische Probleme hin Hier ist es zweckmaumlszligig dieselben Meldungen zu einem spaumlteren Zeitpunkt (zB mit den Meldungen vom naumlchsten Tag) noch einmal zu uumlbertragen
bull Die Bestaumltigung der Meldung bedeutet dass die Meldung aus technischer Sicht in Ordnung ist (dh Mindestumfang von 1800 Zeichen die Zaumlhlmarke existiert hellip) In einer spaumlteren Phase werden die Meldungen noch durch automatische Pruumlfmechanismen der VG WORT in Stichproben gepruumlft Sollten dabei Maumlngel auftreten werden die betreffenden Meldungen zuruumlckgewiesen und der Inhaber des Meldekontos bei der VG WORT wird per Email verstaumlndigt Diese Meldungen koumlnnen dann im Portal entweder geloumlscht oder manuell nachbearbeitet und erneut versendet werden
3212 newMessageRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der private
Identifikationscode (bei VG WORT Zaumlhlmarken) oder der
verlagsinterne Schluumlssel
Parties Parties Die Urheber Uumlbersetzer Agenturen der Meldung Es muss mindestens ein Autor oder ein Uumlbersetzer angegeben werden
Es koumlnnen in einer Meldung sowohl Autoren als auch
Uumlbersetzer angegeben werden
partiesauthors Authors 0 bis mehrere Autoren Beschreibung siehe separate Tabelle
partiestranslators Translators 0 bis mehrere Uumlbersetzer Beschreibung siehe separate
Tabelle
messagetext MessageText Der gemeldete Text entweder als PDF EPUB oder als Klartext
messagetextshorttext string Kurzbezeichnung Uumlberschrift vom Text
messagetexttext Text Der Text an sich Beschreibung siehe separate Tabelle
messagetextlyric boolean bdquoTrueldquo wenn es sich beim Text um Lyrik handelt ansonsten
bdquoFalseldquo
webranges Webranges Erscheinungsort(e) unter demdenen der Text gefunden werden
kann
webrangeswebrange Webrange Ein Erscheinungsort Beschreibung siehe separate Tabelle
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Urheber ohne Wahrnehmungsvertrag Hat der Urheber des zu meldenden Werkes dem meldenden Verlag fuumlr dieses Werk die von der VG WORT wahrgenommenen gesetzlichen Verguumltungsanspruumlche nach dem Urheberrechtsgesetz abgetreten kann dieser Urheber mit Namen Geburtsdatum und Adresse angegeben werden Zusaumltzlich muss bestaumltigt werden dass der Urheber die Rechte uumlbertragen hat Die uumlbertragenen Rechte werden bei der Ausschuumlttung beruumlcksichtigt
Fuumlr Agenturmeldungen bei denen die Autoren nicht bekannt sind steht eine weitere Variante zur Verfuumlgung
Die Rechte koumlnnen dem Verlag erst nach der Veroumlffentlichung des Textes uumlbertragen werden Die schriftliche Rechteuumlbertragung des jeweiligen Autors muss der VG WORT jederzeit auf Anfrage zur Verfuumlgung gestellt werden
Kuumlrzel Wenn man eine Agentur melden moumlchte dann kann das aktuell uumlber diesen Weg erfolgen Als Kuumlrzel wird die Kurzbezeichnung der jeweiligen Agentur uumlbergeben (zB bdquodpaldquo)
Namentliche bekannte Urheber koumlnnen uumlber die Angabe bdquoKuumlrzelldquo nicht gemeldet werden Diese Angabe kann ausschlieszliglich fuumlr die Meldung von Agenturtexten bzw der Miturheberschaft eines nicht namentlich bekannten Agenturautoren verwendet werden
313 Kurzbeschreibung Uumlberschrift (Titel)
Der Titel des zu meldenden Artikels
314 Text
Der Text des zu meldenden Artikels (entweder als Klartext als PDF oder im EPUB Format) Benoumltigt wird der bdquoNettotextldquo (dh der Text ohne HTML Code und ohne Menuuml oder dergleichen)
315 Erscheinungsorte (Webbereiche)
Es muumlssen alle Erscheinungsorte des Texts auf denen die Zaumlhlmarke eingebaut wurde gemeldet werden Ein Erscheinungsort definiert sich aus allen URLs die benoumltigt werden um den gesamten Text einmal zu lesen
Beispiel 1 Ein Text der sich uumlber 2 URLs erstreckt muss mit einem Webbereich (mit 2 URLs) gemel-det werden (zB httpdomain1depage1html httpdomain1depage2html)
Beispiel 2 Ein Text der sich uumlber 1 URL erstreckt aber auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils einer URL) gemeldet werden (zB httpdomain1demytexthtml und httpdomain2demytexthtml)
Beispiel 3 Ein Text der sich uumlber 2 URLs erstreckt und auf zwei unterschiedlichen Seiten erscheint muss mit zwei Webbereichen (mit jeweils zwei URLs) gemeldet werden (zB httpdomain1depage1html httpdomain1depage2html und httpdomain2depage1html httpdomain2depage2html)
32 Meldung uumlbermitteln
321 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
bull Es sollen nur Texte gemeldet werden die bereits bdquostabilldquo sind (dh die sich nicht mehr haumlufig aumlndern) Aus diesem Grund wird empfohlen die Texte mit einer Zeitverzoumlgerung von einigen Tagen (zB 14 Tagen) zu melden Auf die Tantieme hat das keinen Einfluss da die Ausschuumlttung erst Ende September Anfang Oktober fuumlr das Vorjahr erfolgt
bull Die Meldungen sollen taumlglich in der Nacht uumlbertragen werden Zeitfenster 2200 ndash 0300 Von 0300 bis 0600 gibt es ein allgemeines Wartungsfenster wo nicht gemeldet werden kann
bull Um eine Uumlberlastung der Server (und somit houmlhere Wartezeit) zu verhindern sollen die Meldungen sequentiell (nicht parallel) uumlbertragen werden Idealerweise soll zwischen zwei Meldungen eine Sekunde verstreichen Aus transaktionaler Sicht wird jede Meldung einzeln behandelt Dh jede erfolgreich eingehende Meldung wird gespeichert ndash unabhaumlngig davon ob die vorherige oder nachfolgende Meldung einen Fehler verursacht hat
bull Alle fachlichen Fehlercodes (ein- oder zweistellig) deuten auf einen Fehler in der Meldung hin Es ist zwecklos diese Meldung unveraumlndert noch einmal abzusenden Dreistellige Fehler (sowie der HTML ndash 500 Fehler) deuten auf technische Probleme hin Hier ist es zweckmaumlszligig dieselben Meldungen zu einem spaumlteren Zeitpunkt (zB mit den Meldungen vom naumlchsten Tag) noch einmal zu uumlbertragen
bull Die Bestaumltigung der Meldung bedeutet dass die Meldung aus technischer Sicht in Ordnung ist (dh Mindestumfang von 1800 Zeichen die Zaumlhlmarke existiert hellip) In einer spaumlteren Phase werden die Meldungen noch durch automatische Pruumlfmechanismen der VG WORT in Stichproben gepruumlft Sollten dabei Maumlngel auftreten werden die betreffenden Meldungen zuruumlckgewiesen und der Inhaber des Meldekontos bei der VG WORT wird per Email verstaumlndigt Diese Meldungen koumlnnen dann im Portal entweder geloumlscht oder manuell nachbearbeitet und erneut versendet werden
3212 newMessageRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der private
Identifikationscode (bei VG WORT Zaumlhlmarken) oder der
verlagsinterne Schluumlssel
Parties Parties Die Urheber Uumlbersetzer Agenturen der Meldung Es muss mindestens ein Autor oder ein Uumlbersetzer angegeben werden
Es koumlnnen in einer Meldung sowohl Autoren als auch
Uumlbersetzer angegeben werden
partiesauthors Authors 0 bis mehrere Autoren Beschreibung siehe separate Tabelle
partiestranslators Translators 0 bis mehrere Uumlbersetzer Beschreibung siehe separate
Tabelle
messagetext MessageText Der gemeldete Text entweder als PDF EPUB oder als Klartext
messagetextshorttext string Kurzbezeichnung Uumlberschrift vom Text
messagetexttext Text Der Text an sich Beschreibung siehe separate Tabelle
messagetextlyric boolean bdquoTrueldquo wenn es sich beim Text um Lyrik handelt ansonsten
bdquoFalseldquo
webranges Webranges Erscheinungsort(e) unter demdenen der Text gefunden werden
kann
webrangeswebrange Webrange Ein Erscheinungsort Beschreibung siehe separate Tabelle
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
bull Es sollen nur Texte gemeldet werden die bereits bdquostabilldquo sind (dh die sich nicht mehr haumlufig aumlndern) Aus diesem Grund wird empfohlen die Texte mit einer Zeitverzoumlgerung von einigen Tagen (zB 14 Tagen) zu melden Auf die Tantieme hat das keinen Einfluss da die Ausschuumlttung erst Ende September Anfang Oktober fuumlr das Vorjahr erfolgt
bull Die Meldungen sollen taumlglich in der Nacht uumlbertragen werden Zeitfenster 2200 ndash 0300 Von 0300 bis 0600 gibt es ein allgemeines Wartungsfenster wo nicht gemeldet werden kann
bull Um eine Uumlberlastung der Server (und somit houmlhere Wartezeit) zu verhindern sollen die Meldungen sequentiell (nicht parallel) uumlbertragen werden Idealerweise soll zwischen zwei Meldungen eine Sekunde verstreichen Aus transaktionaler Sicht wird jede Meldung einzeln behandelt Dh jede erfolgreich eingehende Meldung wird gespeichert ndash unabhaumlngig davon ob die vorherige oder nachfolgende Meldung einen Fehler verursacht hat
bull Alle fachlichen Fehlercodes (ein- oder zweistellig) deuten auf einen Fehler in der Meldung hin Es ist zwecklos diese Meldung unveraumlndert noch einmal abzusenden Dreistellige Fehler (sowie der HTML ndash 500 Fehler) deuten auf technische Probleme hin Hier ist es zweckmaumlszligig dieselben Meldungen zu einem spaumlteren Zeitpunkt (zB mit den Meldungen vom naumlchsten Tag) noch einmal zu uumlbertragen
bull Die Bestaumltigung der Meldung bedeutet dass die Meldung aus technischer Sicht in Ordnung ist (dh Mindestumfang von 1800 Zeichen die Zaumlhlmarke existiert hellip) In einer spaumlteren Phase werden die Meldungen noch durch automatische Pruumlfmechanismen der VG WORT in Stichproben gepruumlft Sollten dabei Maumlngel auftreten werden die betreffenden Meldungen zuruumlckgewiesen und der Inhaber des Meldekontos bei der VG WORT wird per Email verstaumlndigt Diese Meldungen koumlnnen dann im Portal entweder geloumlscht oder manuell nachbearbeitet und erneut versendet werden
3212 newMessageRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der private
Identifikationscode (bei VG WORT Zaumlhlmarken) oder der
verlagsinterne Schluumlssel
Parties Parties Die Urheber Uumlbersetzer Agenturen der Meldung Es muss mindestens ein Autor oder ein Uumlbersetzer angegeben werden
Es koumlnnen in einer Meldung sowohl Autoren als auch
Uumlbersetzer angegeben werden
partiesauthors Authors 0 bis mehrere Autoren Beschreibung siehe separate Tabelle
partiestranslators Translators 0 bis mehrere Uumlbersetzer Beschreibung siehe separate
Tabelle
messagetext MessageText Der gemeldete Text entweder als PDF EPUB oder als Klartext
messagetextshorttext string Kurzbezeichnung Uumlberschrift vom Text
messagetexttext Text Der Text an sich Beschreibung siehe separate Tabelle
messagetextlyric boolean bdquoTrueldquo wenn es sich beim Text um Lyrik handelt ansonsten
bdquoFalseldquo
webranges Webranges Erscheinungsort(e) unter demdenen der Text gefunden werden
kann
webrangeswebrange Webrange Ein Erscheinungsort Beschreibung siehe separate Tabelle
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Geburtsdatum besitzt einen Wahrnehmungsvertrag mit der
VG WORT Bitte aumlndern Sie die Art der Beteiligung
Der angegebene Urheber ohne Wahrnehmungsvertrag hat
einen Wahrnehmungsvertrag mit
einer Schwesterngesellschaft
der VG WORT
26 Der Beteiligte Vorname Nachname mit GebDat Geburtsdatum besitzt einen Wahrnehmungsvertrag mit einer
Schwesterngesellschaft der VG WORT Bitte aumlndern Sie die
Art der Beteiligung
Der angegebene Urheber ohne
Wahrnehmungsvertrag hat
einen Vertrag mit der VG WORT
27 Der Beteiligte Vorname Nachname mit GebDat
Geburtsdatum besitzt einen Vertrag mit der VG WORT Bitte
aumlndern Sie die Art der Beteiligung
Im Feld bdquotransferOfRightsldquo steht
n icht bdquotrueldquo 28 Sie muumlssen bestaumltigen dass der Autor bzw Uumlbersetzer
Vorname Nachname mit GebDat Geburtsdatum die
Rechte des Werkes an Ihren Verlag uumlbertragen hat
Im Feld bdquocountryCodeldquo steht kein
Laumlndercode nach ISO-3166
ALPHA-2
29 Das zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene Land konnte nicht gefunden
werden
Das Feld bdquocountryCodeldquo
beinhaltet den Wert bdquoDEldquo es
wurde jedoch keine 5-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben bzw das Feld
bdquocountryCodeldquo beinhaltet den
Wert bdquoATldquo oder bdquoCHldquo es wurde
jedoch keine 4-stellige
Postleitzahl im Feld bdquopostCodeldquo
angegeben
30 Die zum Beteiligten Vorname Nachname mit GebDat
Geburtsdatum angegebene PLZ ist nicht im richtigen Format
(fuumlr Land muss eine Laumlnge der Postleitzahl-stellige PLZ
angegeben werden)
Ein angegebener Urheber wird
mehrfach unter den
Beteiligungen angegeben
31 Beteiligte Der angegebene Name Vorname Nachname
kann nicht doppelt gemeldet werden
Kein Beteiligter ist der Autor 32 Beteiligte Es muss mindestens ein Autor am Werk beteiligt
sein
Der gemeldete Text wurde
doppelt Base64 encodiert
39 Der gemeldete Text wurde doppelt mit Base64 encodiert
Technischer Fehler 100 Technischer Fehler
Der im Kapitel Fehler Verweisquelle konnte nicht gefunden werden vorgestellte Web Service Client erspart gerade bei der Meldungsschnittstelle einige Tage Entwicklungsaufwand und bietet zudem eine fehlerlose und getestete Anbindung
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Nachdem der Verlag die Meldungen ordnungsgemaumlszlig durchgefuumlhrt hat muumlssen die beteiligten Autoren und Uumlbersetzer noch mit der Meldung in Verbindung gebracht werden um an der Ausschuumlttung teilnehmen zu koumlnnen Die Autoren koumlnnen erst melden sobald der Mindestzugriff fuumlr das jeweilige Kalenderjahr feststeht (im Mai des Folgejahres) und wenn der jeweilige Text den Mindestzugriff erreicht hat
Um an der Ausschuumlttung teilnehmen zu koumlnnen muumlssen Urheber neben einer VG WORT-Karteinummer auch uumlber eine Meldesystemregistrierung bei der VG WORT verfuumlgen (Registrierung unter httptomvgwortde)
Falls der Verlag bei der Meldung der Autoren und Uumlbersetzer bereits die Karteinummer uumlbermittelt hat erfolgt die Verstaumlndigung des jeweiligen Autors Uumlbersetzers durch die VG WORT Da die Person durch die VG WORT eindeutig zugewiesen werden kann ist es fuumlr den jeweiligen Autor Uumlbersetzer nur noch noumltig seine Meldungen in einer Liste zu bestaumltigen um seine Anteile zu sichern
Kann der Verlag Urheber nur mit deren Namen (Vornamen + Nachnamen) anmelden so koumlnnen die Urheber solche Meldungen unter dem Menuumlpunkt bdquoHinzufuumlgen zu einer Verlagsmeldungldquo recherchieren sobald die Meldung vom Verlag eingereicht der Mindestzugriff fuumlr ein Kalenderjahr festgelegt und sofern der jeweilige Mindestzugriff vom Text erreicht wurde Allerdings funktioniert diese Suche fuumlr Urheber nur wenn in der Verlagsmeldung der bdquoKlarnameldquo des Urhebers in identischer Schreibweise zu den der VG WORT bekannten Daten angegeben wurde Ist dies nicht moumlglich weil zB ein Pseudonym (ohne Karteinummer) in der Meldung angegeben wurde hat der Urheber Anspruch auf Zusendung des Identifikationscodes zur betreffenden Meldung um damit seinen Anspruch geltend zu machen
Sollte ein Verlag den Urhebern es generell nicht ermoumlglichen an der Ausschuumlttung teilzunehmen wird er von der Ausschuumlttung ausgeschlossen
35 Pruumlfung der Karteinummer
Bei der Uumlbermittlung einer Verlagsmeldung wird gepruumlft ob die Kombination bdquoKarteinummer Nachname bzw SchreibweisePseudonymldquo fuumlr einen Urheber guumlltig ist Das bdquoEinsammelnldquo von Karteinummern hat sich in der Vergangenheit fuumlr Verlage als schwierig erwiesen da man immer wieder mit Zifferndrehern konfrontiert war die erst zum Zeitpunkt der Meldung festgestellt werden konnten Um die Verlage bereits beim Einpflegen der Karteinummern in den internen Urheberbestand zu unterstuumltzen gibt es ein Web Service mit dem man pruumlfen kann ob die Kombination bdquoKarteinummer buumlrgerlicher Nachnameldquo bzw die Kombination bdquoKarteinummer PseudonymSchreiweiseldquo guumlltig ist Zur Pruumlfung mit Pseudonymen bzw Schreibweisen ist die Angabe des Vornamens zwingend erforderlich
351 Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3511 checkAuthorRequest
Feld Typ Beschreibung
cardNumber cardNumberType Karteinummer des Urhebers
surName String Nachname des Urhebers
firstName String Vorname des Urhebers (optional) Wird zur Pruumlfung von
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Valid boolean Wenn die Kombination Karteinummer und Nachname guumlltig ist
wird bdquotrueldquo zuruumlckgegeben ansonsten bdquofalseldquo
3513 checkAuthorFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode In diesem Fall kann nur ein technischer Fehler
(Fehlercode 100) auftreten
Errormsg string Grund fuumlr den technischen Fehler
36 Ergaumlnzung gemeldeter Beteiligter
Alle Beteiligten die ein Verlag gemeldet hat kann dieser uumlber die Ergaumlnzung gemeldet Beteiligter f inden und die Karteinummer ergaumlnzen oder die Daten fuumlr Urheber ohne Wahrnehmungsvertrag einpf legen
Es koumlnnen nur Beteiligte ergaumlnzt werden die nicht mit Karteinummer und nicht als Urheber ohne Wahrnehmungsvertrag gemeldet wurden
Es koumlnnen nur Beteiligte mit gleichem Namen gleichzeitig bearbeitet werden
361 Meldung uumlber Web Service Schnittstelle
Web Service Request URL httpstomvgwortdeservices113MessageService XSD Definition httpstomvgwortdeservices113messageServicexsd WSDL Definition httpstomvgwortdeservices113messageServicewsdl
3611 updateMessageParticipantRequest
Feld Typ Beschreibung
privateidentificationid pixelIDType Identifikationscode der Zaumlhlmarke Entweder der
private Identifikationscode (bei VG WORT
Zaumlhlmarken) oder der verlagsinterne Schluumlssel
participants participants Die Beteiligten zu einer Meldung
participantsparticipant participantWithCardNumber 1 bis mehrere Beteiligte Beschreibung siehe
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Status okType Status OK Wird im Erfolgsfall immer zuruumlckgeliefert Im Fehlerfall
wird updateMessageParticipantFault gesendet
3613 updateMessageParticipantFault
Feld Typ Beschreibung
Errorcode int Der Fehlercode
Errormsg string Grund fuumlr den Fehler
36131 Fehlercodes
Fehlerfall Fehler-code
Meldung
Es konnte keine Zaumlhlmarke
gefunden werden 1 Privater Identifikationscode Fuumlr den eingegebenen Wert
existiert keine Zaumlhlmarke
Karteinummer und Nachname
stimmt nicht uumlberein 4 Beteiligte Der zur Karteinummer cardNumber angegebene
Name surName firstName] stimmt nicht mit dem Namen
des Urhebers uumlberein
Die Zaumlhlmarke ist einem
anderen Benutzer zugeordnet 6 Privater Identifikationscode Die Zaumlhlmarke ist einem anderen
Benutzer zugeordnet Eine Webbereichsmeldung ist nur durch
diesen Benutzer moumlglich
Beteiligter darf kein Verlag sein 10 Beteiligte Der zur Karteinummer 0 angegebene Name 1 2
ist kein Autor Es koumlnnen nur Autoren gemeldet werden
Falsche Zaumlhlmarke 16 Privater Identifikationscode Die Zaumlhlmarke ist keine
Zaumlhlmarke fuumlr einen Text sondern fuumlr ein Groszligwerk
Fuumlr diese Meldung existiert
bereits eine Beteiligtenmeldung
zu dieser Karteinummer
47 Karteinummer Fuumlr diese Meldung existiert bereits eine
Beteiligtenmeldung zu dieser Karteinummer
Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
48 Privater Identifikationscode Die Zaumlhlmarke ist zu keiner
Meldung zugeordnet
Der angegebene Name existiert
nicht in der Beteiligtenmeldung
49 Beteiligte Der angegebene Name Nachname Vorname
existiert nicht in der Beteiligtenmeldung
Der angegebene Urheber ist
bereits an der Meldung beteiligt
51 Der Urheber Nachname(Vorname) ist bereits an der
Meldung mit privatem Identifikationscode Private ID des
Pixels beteiligt und kann nicht erneut hinzugefuumlgt werden
Die Meldung zu der
Privatidentifikationsnummer
kann nicht mehr bearbeitet
werden
52 Die Meldung kann nicht mehr bearbeitet werden da der
Benutzer sie bestaumltigt verworfen hat
Die Karteinummer gehoumlrt zu
keinem Verlag
53 Karteinummer Die eingegebene Karteinummer gehoumlrt einem
Urheber
Die angegebene Kombination
(Name + Karteinummer) weicht
von den vorhandenen Daten
54 Beteiligte Der angegebene Name und Karteinummer
Vorname Nachname angegebene Karteinummer weichen
von den existierenden Daten existierende Karteinummer ab
Technischer Fehler 100 Technischer Fehler
362 Uumlber Maske
Die Ergaumlnzung gemeldeter Beteiligter steht uumlber eine Maske (Menuumlpunkt bdquoErgaumlnzung gemeldeter Beteiligterldquo - bdquoMETIS-Meldungldquo) zur Verfuumlgung
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Durch die Auswahl mind eines Beteiligten und das Betaumltigen der Schaltflaumlche bdquoBeteiligte bearbei tenldquo gelangt man zur Maske fuumlr die Eingabe der Karteinummer
Abbildung 7 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber mit Karteinummer
Um die Daten von Urhebern ohne Wahrnehmungsvertrag einzugeben muss bdquoRechte uumlbertragenldquo ausgewaumlhlt werden
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Abbildung 8 Maskenbeschreibung Ergaumlnzung gemeldeter Beteiligter ndash Urheber ohne Wahrnehmungsvertag
37 Qualitaumltskontrolle
Den Verlagen wird ermoumlglicht festzustellen ob die Umsetzung korrekt erfolgt ist Dafuumlr bietet die VG WORT eine Qualitaumltskontrolle an Dabei werden zwei allgemeine Daten zur Verfuumlgung gestellt
- Anzahl der bestellten Zaumlhlmarken (Tagesaktuell) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (Verzoumlgerung ca 4 Tage) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (Verzoumlgerung ca 4 Tage)
Daruumlber hinaus kann man pro Kalendermonat (fuumlr die letzten 12 Monate) folgende Daten abrufen - Anzahl bestellte Zaumlhlmarken (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - gesamt (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - frei zugaumlnglich (bis inkl dem jeweiligen Monat) - Anzahl der gezaumlhlten Zaumlhlmarken - hinter Bezahlschranke (bis inkl dem jeweiligen Monat) - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - gesamt - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die in dem jeweiligen Jahr voraussichtlich den Mindestzugriff
erreichen - hinter Bezahlschranke - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - gesamt - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - f rei zugaumlnglich - Anzahl der Zaumlhlmarken die voraussichtlich den Mindestzugriff erreichen aber fuumlr die es noch
keine Meldung gibt - hinter Bezahlschranke
Die Daten fuumlr ein Monat werden erst gegen Mitte des Folgemonats berechnet und zur Verfuumlgung gestellt
Grundlage fuumlr die Berechnung der Zaumlhlmarken die den Mindestzugriff erreichen erfolgt im laufenden Jahr unter Vorbehalt da die Berechnung nur auf der Basis des letzten bekannten Wertes moumlglich ist Die Zuordnung ohne Vorbehalt kann erst erfolgen sobald
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Texte auf zugangsbeschraumlnkten Seiten (mit und ohne Bezahlschranke) koumlnnen gezaumlhlt gemeldet und gegebenenfalls verguumltet werden Es ist in diesem Fall allerdings zwingend erforderlich dass der VG WORT ein f reier Zugang auf die fraglichen Seiten gewaumlhrt wird
Der Zugang kann entweder uumlber ein entsprechendes Benutzerkonto mit vorheriger Anmeldung oder durch die Freischaltung der Texte fuumlr Zugriffe aus einem definierten Computernetzwerk gewaumlhrt werden
Das Verfahren kann vom Verlag uumlber den Menuumlpunkt bdquoZugriff auf zugangsbeschraumlnkte Inhalte erlaubenldquo selbst gewaumlhlt werden (es koumlnnen auch beide Verfahren nebeneinander bestehen)
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Abbildung 10 Maskenbeschreibung Zugriff auf zugangsbeschraumlnkte Inhalte erlauben
Die Meldung von Texten hinter einer Bezahlschranke ist ohne Anlage eines Benutzerkontos nicht moumlglich
Um der VG WORT zu Pruumlfungszwecken den Zugriff auf die kostenpflichtigen Texte zu ermoumlglichen muss der VG WORT ein passendes Benutzerkonto bekannt gemacht werden oder der Verlag muss die VG WORT auf technischer Ebene fuumlr den Zugriff freischalten (zB IP Adresse)
Unabhaumlngig von der Wahl des Zuganges muss der Verlag sicherstellen dass die VG WORT damit auf alle gezaumlhlten bzw gemeldeten Inhalte zugreifen kann Bei der Auswahl bdquoBenutzerkontoldquo ist zu beruumlcksichtigen dass pro Verlag nur ein Zugang angegeben werden kann
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Die Authentifizierung fuumlr das Web Service erfolgt uumlber den Standard bdquoRFC 2617 HTTP Authentication Basic and Digest Accessldquo (siehe httpwwwietforgrfcrfc2617txt) Es wird das einfache bdquoBasicldquo Verfahren verwendet wobei der Benutzername und das Passwort in Klartext mit dem Request gesendet werden Da aber die Verbindung ausschlieszliglich uumlber das SSL-Protokoll laumluft (siehe 42 Datensicherheit) werden diese Felder ohnehin geschuumltzt (verschluumlsselt)
411 Autorisierungs- Authentifizierungsfehler
Wie im TOM Portal unterscheidet man ob ein Benutzer wirklich der Benutzer ist fuumlr den er sich ausgibt (Authentifizierung HTML-Fehlercode 401) und welche Rechte ein Benutzer hat (Autorisierung HTML-Fehlercode 403) In beiden Faumlllen wird vom System der zugehoumlrige HTML-Fehlercode an den Client zuruumlckgesendet
42 Datensicherheit
Um die Daten die waumlhrend der Aktion uumlbermittelt werden zu schuumltzen ist das Web Service nur uumlber den Standard HTTP SSL-Port erreichbar Hierbei werden alle ausgetauschten Daten verschluumlsselt uumlbermittelt Die Authentifizierung des Servers gegenuumlber dem Client geschieht uumlber ein Zertifikat
43 Versionierung
Sollte es Erweiterungen in der Schnittstelle geben wird eine neue Version der entsprechenden Schnittstelle bereitgestellt ndash die alte Version wird jedenfalls weiter unterstuumltzt Die Versionierung des Web Services erfolgt uumlber die URL Im Fall der pixelOrder wuumlrde Version 10 unter folgenden Adresse erreichbar sein
ltDomaumlnennamegtservices10pixelOrder
Version 11
ltDomaumlnennamegtservices11pixelOrder
44 Nachrichten Ablauf
Grundsaumltzlich unterscheidet man bei einem Web Service zwischen 3 Nachrichten Typen - Request - Response - Fault
Ein Request beinhaltet alle Parameter die fuumlr den Aufruf einer Operation notwendig sind Ein Response beinhaltet das Resultat welches fuumlr eine Operation definiert ist Tritt ein Fehler (falsche Parameter Client bzw Server Probleme) waumlhrend der Operation auf wird ein Fault gesendet
Der Ablauf ist in unten stehendem Diagramm noch einmal an Hand einer Zaumlhlmarkenbestellung skizziert
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel
Die Antwort (Response oder Fault) von einem Web Service Aufruf muss immer abgewartet werden bevor ein neuer Aufruf gemacht wird Ansonsten kommt es zu technischen Fehlern Beispiel Abwarten des Response einer Zaumlhlmarkenbestellung bevor eine weitere Bestellung abgesendet wird
45 Testsystem
Falls Sie die Schnittstellen vor Inbetriebnahme testen moumlchten wenden Sie sich bitte an metissupportvgwortde um einen temporaumlren Zugriff auf ein Testsystem zu erhalten
Die Daten des Testsystems werden periodisch geloumlscht Zaumlhlmarken die im Testsystem bestellt werden sind unguumlltig und koumlnnen nicht zu einer Ausschuumlttung fuumlhren
46 Probleme im Umgang mit Apache AXIS (ADB)
Im Zusammenhang mit Apache AXIS hat es in der Vergangenheit vermehrt Probleme gegeben Daher wird fuumlr Apache AXIS eine eigene WSDL zur Verfuumlgung gestellt die unter dem Menuumlpunkt bdquoWebServicesldquo heruntergeladen werden kann Diese WSDL beinhaltet folgende Pruumlfungen nicht mehr (diese muumlssen selbst implementiert werden da ansonsten ein serverseitiger Fehler auftritt)
- Es muss mindestens ein Autor oder ein Uumlbersetzer pro Text angegeben werden - Jeder Autor Uumlbersetzer muss entweder uumlber Kuumlrzel oder Vorname + Nachname oder
Vorname + Nachname + Karteinummer gemeldet werden
Wenn Java Klassen mit Apache AXIS aus der WSDL automatisch generiert werden so ist darauf zu achten dass beim Generieren unbedingt die Option bdquo-wldquo mitgegeben wird da ansonsten die Strukturen durch AXIS vereinfacht werden und nicht mehr funktionieren
47 Beispiele fuumlr Web Service Aufrufe
In diesem Kapitel finden Sie pro Web Service ein SOAP XML Beispiel