[0-4] INBOUND Drag&Drop

Inhaltsverzeichnis

Funktionalitäten des/der [Schnittstelle]

• Drag&Drop aus huGO direkt in den Bild-Bereich auf der Seite oder im Artikel

• Alternativ: Drag&Drop aus huGO in den Artikel in CREATE

• Übernahme der huGO-ID (wird in Eigenschaft “BildArchivId” geschrieben)

• IPTC Infos werden mitübernommen.

• NGen bzw. Create importiert das HR und generiert beim Import LR, MR, TN dazu.

Austauschformat und Übertragung der Daten

Workflow beim Importieren der Bilder nach NGen und Create

Arbeitsweise in NGen

cc:huGO bietet die Möglichkeit, Bilder per Drag & Drop in NGen einzubinden.

Um Bilder nach NGen zu importieren, kann in NGen in der Default-Werkzeugleiste folgender Button angeklickt werden:

Damit öffnet sich ein externes Chrome-Browserfenster mit der Seite zu zum Login in huGO bzw. die Startseite in huGO. Nach dem Login können Bilder in huGO recherchiert werden und anschließend per Drag&Drop in den NGen Client gezogen werden.

Um Bilder nach NGen zu importieren, stehen dem User folgende Möglichkeiten zur Verfügung:

• D&D in einen Bildbereich auf einer Seite

• D&D in einen Bildbereich eines Artikels

• D&D oben in das Programm neben/über den Werkzeugleisten

• D&D in eine Mappe

Arbeitsweise in CREATE

Um Bilder aus huGO per Drag & Drop nach Create zu importieren, muss der Benutzer auf beiden Seiten eingeloggt sein. 

In huGO kann nach Bildern recherchiert werden und eins oder mehrere selektiert werden. Per Drag & Drop können ausgewählte Bilder in den Editor von Create gezogen werden. Bilder können derzeit nur in bestehende Text-Bereiche oder zwischen bestehende Bereiche gezogen werden. Für gezogene Bilder wird im Editor ein Bild-Container angelegt und gefüllt. Sind mehrere Bilder selektiert, wird eine Bildergalerie angelegt. 

Aufbau der Schnittstelle

In folgender Abbildung ist schematisch der Workflow der Drag&Drop-API dargestellt:

Beim Drag&Drop werden lediglich XML-Daten ausgetauscht, die URLs gemäß huGOAPI:resource

enthalten, unter denen die Metadaten der Bilder angefordert werden können.

Der Datenaustausch erfolgt in folgenden Schritten:

1. Drag&Drop XML (siehe nachfolgend)

2. Die Anforderung eines Bildes erfolgt per http GET Request auf eine resource-URL der huGOAPI:resource. (siehe nachfolgend)

3. Im Response auf einen Request werden alle Metadaten eines Bildes im XML-Format geliefert. (siehe nachfolgend)

4. In den Metadaten angegebene Ablageorte von Files können per https angefragt werden. (siehe nachfolgend)

XML-Struktur und Beispieldaten

Drag&Drop XML

Aus einer cc:huGO Trefferliste können ein oder mehrere Bilder selektiert werden und mittels nativem Drag&Drop nach NGen bzw. Create übertragen werden. Hierbei werden hugo-resource Urls im Drag&Drop Event übertragen, die für einen folgenden Request auf huGOAPI:resource, benutzt werden müssen. Für einen gültigen Request muss hierbei die customerId ergänzt werden.

Beispiel (2 Bilder):

<?xml version="1.0" encoding="ISO-8859-1" ?>
<hugo-resources>
    <hugo-resource type="picture" id="99">
    http://somewhere/picture-99?user=FUP&amp;signature=da39a3ee5e6b4b0d3255bfef
    </hugo-resource>
    <hugo-resource type="picture" id="11">
    http://somewhere/picture-11?user=FUP&amp;signature=85ca65f92c71456cddbf8b2
    </hugo-resource>
</hugo-resources>

huGOAPI:resource Request

Ein Request wird per http GET gestellt. Hierbei sind folgende Parameter angegeben:

• ID des Archivobjekts (<objekt-id>)
  <objekt-id> :=
  picture-<huGOID> für Bilder

• cc:hugo Benutzername (?user=<username>)
  Hier muss ein gültiger cc:huGO Benutzername angegeben werden, mit dessen Rechten der Zugriff auf das angeforderte Archivobjekt geprüft wird. z.B.: user=HANS

• Bezeichnung des Abnehmers NGen (&customer=ngen)
  “ngen” dient zur Identifikation des abrufenden Systems. Dieser Parameter wird geloggt und steht in den Protokollen der huGO GUIs zur Ansicht zur Verfügung

• Signatur (&signature=<signatur>])
  Optional kann man einen Request mit einer Signatur authentifizieren.
  Die Signatur verschlüsselt die Requestparameter gemäß hmac auf basis sha-1 unter Verwendung folgender Parameter:

  • input: <vollständige objekt-id inklusive Asstetyp-Prefix> + username

  • secret key: wird von Sternwald pro Kundeninstallation vergeben

  • Beispiel:
    input: picture-11FUP 
    secret key: ABC
    → signature: 85ca65f92c71456cddbf8b2777705704de049574
    

Im Header des Requests ist der Wert für Accept auf text/xml gesetzt.

Beispiel-Request

GET http://somewhere/picture-11?user=HANS&signature=85ca65f92&customer=ngen

huGOAPI:resource Response

Folgende http Status Codes werden zurückgegeben:

Beispiel-Response:

<?xml version="1.0" encoding="UTF-8" ?>
<picture xmlns="http://www.finkundpartner.de/huGOAPI/resource/1.1"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" accessId="1231315"
xsi:schemaLocation="http://www.finkundpartner.de/huGOAPI/resource/1.1 hugoapi-resource.xsd">
    <hugoId>picture-1234</hugoId>
    <creationTS>2011-06-14T14:24:20</creationTS>
    <note>just a note</note>
    <archiveFlag>N</archiveFlag>
    <lockFlag>false</lockFlag>
    <origIdent>ag-rt-xcv232.jpg</origIdent>
    <productionType>external</productionType>
    <thumbnailURL>http://somewhere/thumbnail/1234.jpg</thumbnailURL>
    <previewURL>http://somewhere/preview/1234.jpg</previewURL>
    <previewPath>\\UNC\somwhere\preview\123.jpg</previewPath>
    <lowresURL>http://somewhere/lowres/1234.jpg</lowresURL>
    <highresHeight>222</highresHeight>
    <highresWidth>1111</highresWidth>
    <highresPath>\\UNC\somewhere\highres\1234.jpg</highresPath>
    <highresURL>http://somewhere/lowres/highres/1234.jpg</highresURL>
    <group>IMP_B_AGT_DPA</group>
    <groupDescription>Agentur DPA</groupDescription>
    <objectName>ag-rt-xcv232</objectName>
    <urgency>1</urgency>
    <category>Politik</category>
    <suppCategory>Innenpolitik</suppCategory>
    <keywords>Politik, Regierung</keywords>
    <instruction>some special instruction</instruction>
    <contentCreated>2011-06-14T14:24:20</contentCreated>
    <author>Hans Mustermann</author>
    <byTitle>byTitle</byTitle>
    <location>
    <name>Berlin</name>
    <state>Germany</state>
    <country>Berlin</country>
    </location>
    <origRef>ag-rt-xcv232</origRef>
    <title>Berlin will Piratenabwehr privatisieren</title>
    <credit>dpa</credit>
    <source>dpa</source>
    <copyright>DPA</copyright>
    <caption>Anstelle von Polizisten oder Bundeswehrsoldaten sollen nach Ansicht der Bundesregierung Sicherheitsfirmen Handelsschiffe vor dem Überfall durch Piraten absichern. Gleichzeitig wäre eine Änderung des Waffenrechts erforderlich</caption>
    <descriptionWriter>Hans Mustermann</descriptionWriter>
</picture>

Abholen der Bild-Dateien

Die Bild-Dateien werden per https unter dem in der huGOAPI:resource Response angegebenen URL abgeholt. NGen bzw. Create ruft hier den URL des High-Res-Bildes auf (im Tag highresURL angegeben). 

Im Beispiel oben ist dies folgender URL: http://somewhere/lowres/highres/1234.jpg

Anleitung zum Set-up

Verweis auf Core Dokumentation

Dies ist eine Ergänzung zur Dokumentation dieser Schnittstelle und befindet sich im Core-Bereich. Sie ist somit exklusiv für berechtigte Nutzer:innen vorbehalten.

Rechtlicher Hinweis

Für die vorliegende Systemübersicht/Publikation behalten wir uns alle Rechte vor. Nachdruck, Vervielfältigung und Verbreitung (auch auszugsweise) nur mit schriftlicher Genehmigung der multicom GmbH. Wir behalten uns vor, die Systemübersicht/Publikation jederzeit ohne vorherige Ankündigung zu ändern und/oder zu erweitern.

Die vorliegenden Angaben dienen lediglich Informationszwecken. Die multicom GmbH übernimmt keinerlei Haftung und/oder Garantie für Fehler und/oder unvollständige Angaben in der Systemübersicht/Publikation mit Ausnahme von vorsätzlich falschen oder arglistig verschwiegenen Angaben.

Da unsere Software laufend weiter entwickelt wird, handelt es sich bei den vorliegenden nur um allgemeine Angaben. Es handelt sich weder um eine Zusicherung von Mindestvertragsinhalten, noch um Beschaffenheitsgarantien im Sinne des § 443 BGB.

Verwandte Seiten

Historie