Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

...

SchalterOptional Bedeutung/WertAnmerkung
portal.imports.importer-enabledNtrue/falseDe-/Aktivierung des Importers
portal.imports.import-points[0].nameN'Auftragsbearbeitung'

Der Name für den Importpoint 

portal.imports.import-points[0].component-nameNAdvertImportModuleKlassenname des Importmoduls
portal.imports.import-points[0].initial-delayJ15Wartezeit in Sekunden bevor der erste Import startet
portal.imports.import-points[0].intervalJ20Poll-Abstand in Sekunden
portal.imports.import-points[0].parameters.input-directoryN
Eingangs-/Poll-Verzeichnis für Gestaltungsaufträge (*.xml) und Motivdateien
portal.imports.import-points[0].parameters.error-directoryN


Fehlerverzeichnis; Neben den Dateien aus dem Eingangsverzeichnis wird hier eine
Datei mit den Fehlermeldungen erzeugt, welche den Namen der XML-Datei mit der 
Endung "_error.txt" besitzt.
portal.imports.import-points[0].parameters.archive-directoryN
Archivverzeichnis
portal.imports.import-points[0].parameters.xsl-transformationJ
Transformationsvorschrift (.xsl) vom Eingangsformat zum Importformat

...

  • Import / Update einer Anzeige
    • POST
    • Body-Content-Typ:  multipart/formdata
      • Text-Part "advert"  als JSON (application/json)  oder XML-Format (application/xml)
      • Array von File-Parts "assetData" für Motive

        Die Dateinamen müssen mit den Attributen NormalAssetFileName, TabletAssetFileName und MobileAssetFileName in der XML- bzw. JSON-Struktur korrespondieren.

  • Stornierung einer Anzeige
    • DELETE
    • Parameter: orderNo 

Attributen der Importstruktur

JSON-AttributXMLDatentyp / Wertebereich / FormatPflichtBeschreibung
cancelledAttribut von Advertbooleannein Default false, Wenn true wird nur das Attribut orderNo ausgewertet und die Anzeige storniert. Dieses Attribut ist für die XML-Datei-Schnittstelle vorsehen, funktioniert aber auch bei der POST-Methode über Rest als Alternative zu DELETE 
orderNoAdvert.OrderNoStringja

Freitext; Auftrags bzw. Anzeigennummer; Diese muss eindeutig sein.

descriptionAdvert.DescriptionStringjaFreitext; Beschreibung
customerAdvert.CustomerStringneinFreitext; Kundenname
startDate
Advert.StartDate"yyyy-MM-dd"neinStartdatum für Gültigskeitszeitraum
endDateAdvert.EndDate

"yyyy-MM-dd"

nein

Enddatum für Gültigskeitszeitraum

priority
Advert.Priority

int (0 -100)

ja

Priorität

maxImpressions
Advert.MaxImpressions

int (>= 0)

nein

Maximale

Anzahl

der

Impressions

maxClicksAdvert.MaxClicks

int (>= 0)

nein

Maximale

Anzahl

der

Klicks

advertTypes[]
Advert.AdvertTypes.AdvertType

Mögliche Werte:

"BANNER", "BUTTON", "TITLE_HEADER", "VERTICAL_BANNER"

nein

Array / Liste von Anzeigentypen

Zugeordnete Anzeigentypen im Portal

validTags[]
Advert.ValidTags.Tag

String (Tagname)

nein

Anzeigekriterien

für

Stichworte

der

Seite

invalidTags[]
Advert.InvalidTags.Tag

String (Tagname)

nein

Ausschlusskriterien

für

Stichworte

der

Seite

validDepartments[]
Advert.ValidDepartments.Department

String (Ressortname)

nein

Anzeigekriterien

für

Ressorts

der

Seite

invalidDepartments[]
Advert.InalidDepartments.Department

String (Ressortname)

nein

Ausschlusskriterien

für

Ressorts

der

Seite

validLocations[]
Advert.ValidLocations.Location

String (Ortsname)

nein

Anzeigekriterien

für

Orte

der

Seite

invalidLocations[]
Advert.InvalidLocations.Location

String (Ortsname)

nein

Ausschlusskriterien

für

Orte

der

Seite

validGeoRegions[]
Advert.ValidGeoRegions.GeoRegion

String (Name der Region)

nein

Anzeigekriterien

für

Regionen

der

Seite

validGeoRegions[]Advert.ValidGeoRegions.GeoRegion

String (Name der Region)

nein

Ausschlusskriterien

für

Regionen

der

Seite

linkUrl
Advert.LinkUrl

String (URL)

ja

Link der Anzeige

normalAssetFileName
Advert.NormalAssetFileName

String

ja

Dateiname der Standardmotivs

tabletAssetFileName
Advert.TabletAssetFileName

String

nein

Dateiname des Motivs für Tabletts

mobileAssetFileName
Advert.MobileAssetFileName

String

nein

Dateiname des Motivs für Smartphones

XML-Format

Schemadefinition XSL:

...