Geeft één of meerdere RSS-feeds op in de backoffice.
RSS Funnel geeft url terug op basis van funnel GUID/ Kanaal GUID.
Tags uit de RSS-feed kunnen als parameter worden meegegeven in de url.
RSS Funnel toont alleen de berichten die voldoen aan de parameters in de url.
Feed wordt gesorteerd op de tag die wordt meegegeven, default is datum.
Zowel tags als sorteer parameters zijn optioneel.
Indien er een tag opgegeven is die niet bekend is in de feed wordt deze parameter genegeerd.
Encoding van vreemde tekens is noodzakelijk in verband met letterlijk matchen.

Aanroepen van RSS

Het kanaal is aan te roepen via:

https://rssfunnel.ternair.com/[KanaalGUID]

KanaalGUID

Uniek ID van het kanaal, deze is terug te vinden in de backoffice applicatie

Deze feed kan uitgelezen worden door alle standaard RSS-readers.

Output-funnel

Voorbeeld

https://rssfunnel.ternair.com/[KanaalGUID]?[tag]=[waarde]&[tag]=[waarde]&sort=[tag]&sort_order=asc&max_items=5

Dus:

https://rssfunnel.ternair.com/1957C25-AD5E-4B3B-86F6-E31A328F07E4?max_items=2&category=Algemeen&sort_order=asc

Meerdere tags op kunnen geven als parameter, deze worden als een AND opgevolgd (moet aan alle parameter waardes voldoen)
Parameter ‘sort’ moet gesorteerd worden
- sort_order heeft 3 varianten desc (van Z naar A/ van hoog naar laag), asc (van A naar Z/ van laag naar hoog) of random (random/willekeurig), desc wordt standaard toegepast.
max_items geeft het maximum aantal teruggegeven aantal records aan
dedupe ontdubbelt de resultaatlijst op basis van één of meer velden (tags), nadat er gesorteerd is en vóórdat max_items wordt toegepast. Zo bepaalt de sortering welk item van een duplicaat-groep blijft staan, en levert max_items ook echt dat aantal unieke items op.

IN-functionaliteit

Het is mogelijk om parameters te voorzien van meerdere waardes t.b.v. filtering door deze met komma’s van elkaar te scheiden. (moet aan minimaal één parameter waarde voldoen).

Voorbeeld

https://https://rssfunnel.ternair.com/[KanaalGUID]?[tag]=[waarde1],[waarde2],[waarde3]

Dus:

https://rssfunnel.ternair.com/ 1957C25-AD5E-4B3B-86F6-E31A328F07E4?category=Aardappelen,Melk,Graan

Resultaat:

Alle items waar de tag “category” één van de volgende waardes bevat:

Aardappelen
Melk
Graan

NOT-functionaliteit

Het is mogelijk om parameters te voorzien van waardes die uitgesloten moeten worden van de resultaten. Hiervoor gebruik je een uitroepteken; [tag]=![waarde].

Voorbeeld

https://rssfunnel.ternair.com/[KanaalGUID]?[tag]=![waarde1]

Dus:

https://rssfunnel.ternair.com/ 1957C25-AD5E-4B3B-86F6-E31A328F07E4?category=!Boeren

Resultaat:

Alle items waar de tag “category” de waarde “Boeren” bevat, worden uitgesloten.

Dit kan in combinatie met de IN-functionaliteit gebruikt worden. Je krijgt dan:

Voorbeeld

https://rssfunnel.ternair.com/[KanaalGUID]?[tag]=[waarde1],[waarde2],[waarde3]

Dus:

https://rssfunnel.ternair.com/ 1957C25-AD5E-4B3B-86F6-E31A328F07E4?category=!Aardappelen,Melk,Graan

Resultaat:

Alle items waar de tag “category” geen van de volgende waardes bevat:

Aardappelen
Melk
Graan

Dedupe-functionaliteit

Het is mogelijk om de resultaatlijst te ontdubbelen op basis van één of meer velden. Er zijn twee varianten, afhankelijk van het scheidingsteken:

Komma-gescheiden dedupe=[veld1],[veld2] de velden vormen samen 1 sleutel. Een item is pas een duplicaat als alle opgegeven velden gelijk zijn aan een eerder item.
Pipe-gescheiden dedupe=[veld1]|[veld2] elk veld telt apart. Een item is al een duplicaat zodra één van de opgegeven velden overeenkomt met een eerder behouden item.

Als een item voor een opgegeven veld geen waarde heeft (bijv. geen <description>), telt dat veld niet mee als ontdubbelsleutel en blijft het item staan.

Elk veld dat ook voor filteren/sorteren gebruikt kan worden is bruikbaar, bijvoorbeeld title, guid, description, pubdate of een eigen tag uit de feed (zoals category).

Voorbeeld: combinatie van velden (AND)

https://rssfunnel.ternair.com/[KanaalGUID]?dedupe=guid,link

Resultaat: items met exact dezelfde combinatie van guid én link worden ontdubbeld; van elke combinatie blijft alleen het eerst gesorteerde item over.

Voorbeeld: los per veld (OR)

https://rssfunnel.ternair.com/[KanaalGUID]?dedupe=guid|link

Resultaat: zodra een item dezelfde guid óf dezelfde link heeft als een eerder behouden item, wordt het uitgesloten.

Dedupe is te combineren met de overige parameters, bijvoorbeeld:

https://rssfunnel.ternair.com/[KanaalGUID]?sort=pubdate&sort_order=desc&dedupe=guid&max_items=5

Invoer RSS

Een Feed wordt ingevuld in de RSS-funnel Backoffice en moet voldoen aan de RSS standaarden.

Een bericht (<item>) moet minimaal onderstaande velden bevatten.

Element	Omschrijving
<title>	Titel van het item
<description>	Omschrijving van het item
<link>	Hyperlink om het item te openen

Input funnel

RSS url
Max. records
Actief ja/nee

RSS Reader

Elke browser heeft een eigen RSS-reader. Ook online readers (bijvoorbeeld: http://feedreader.com/online/) of reader tools kunnen gebruikt worden om de feed te lezen.

In dit artikel

RSS Funnel Proces Aanroepen van RSS Output-funnel IN-functionaliteit NOT-functionaliteit Dedupe-functionaliteit Invoer RSS