Interface Import

Dove posso trovare le specifiche dell'interfaccia di importazione?

21. ottobre 2020

Interfaccia Importazione| XML | Json

L'interfaccia di importazione ti offre la possibilità di trasferire i contenuti desiderati dal tuo sistema come record di dati a Guidle:

Formato/Struttura
Tu fornisci i dati come XML nella struttura StandardImportInterface di Guidle. Sotto "Download" troverete la descrizione dell'interfaccia, il file dello schema e un file di esempio

Mode
L'interfaccia di importazione funziona in modalità FULL. Lei ci fornisce sempre un set di dati completo. Il processo di importazione della guida si occupa di creare e aggiornare correttamente gli annunci.
In casi eccezionali l'interfaccia di importazione supporta un modo DELTA. Tuttavia, questo può essere usato solo in consultazione con Guidle. Si prega di contattare il supporto di Guidle per questo.

Campo guidle:sourceOfferId
Questo campo è usato per identificare univocamente un annuncio durante il processo di importazione e deve essere unico in tutto il feed di dati. Dopo che l'evento è stato trasmesso a Guidle, questo ID non deve cambiare per un annuncio. Idealmente, un ID evento interno al database viene utilizzato per questo scopo.

Campo guidle:sourceOfferId e guidle:bpId
Questi campi sono individuali per ogni interfaccia di importazione. Si prega di chiedere al supporto di Guidle l'ID da utilizzare.

Trasmissione di annunci da istituzioni diverse
Nel caso in cui la tua interfaccia di importazione trasmetta a Guidle annunci da istituzioni diverse, il contenitore "guidle:customBusinessPartner" deve essere usato. In esso, ci dici per ogni annuncio a quale istituzione appartiene. Idealmente, i seguenti quattro campi dovrebbero essere trasmessi a noi:

> guidle:ownerReferenceId
> guidle:ownerReferenceName
> guidle:ownerReferenceZip
> guidle:ownerReferenceCity

Tuttavia, il campo guidle:ownerReferenceId è anche sufficiente. È importante notare che la combinazione dei campi permette un'identificazione unica di un'istituzione.
Se il contenitore "guidle:customBusinessPartner" è usato, il campo "guidle:bpId" (vedi sezione precedente) deve essere rimosso dal feed di dati.

Categorizzazione
Usando guidle:customClassification, puoi inviarci la categorizzazione appropriata dal tuo sistema di origine per ogni contenuto. guidle trasferisce questa categorizzazione alla categoria appropriata di guidle durante il processo di importazione usando la mappatura delle categorie.

Fornitura di dati
Ci fornisca l'XML via URL. In consultazione con voi, Guidle definisce quando e quanto spesso i dati vengono recuperati da questo link.


Downloads

• Specifica dell'interfaccia Interfaccia di importazione standard
• File di schema
• File di esempio

Nota: Questo testo è stato tradotto da un software di traduzione automatica e non da un traduttore umano. Può contenere errori di traduzione.