Extensies, externe applicaties of plugins zijn softwarecomponenten die extra functionaliteit aan een bestaande, vaak grotere applicatie toevoegen en die de software zo aanpassen voor specifieke doeleinden. Zo gebruiken webbrowsers gewoonlijk extensies om videobestanden af te spelen of om webpagina's op virussen te scannen. Ook WGP biedt de mogelijkheid om extensies toe te voegen. In dit geval zijn extensies algemene geografische webapplicaties die in WGP extra functies implementeren. Je kunt deze extensies aan een WGP-kaart toevoegen door het URL-adres van de webservice op te geven en een knop voor de extensie te definiëren.

De volgende paragrafen beschrijven hoe je de extensies van WGP beheert en configureert:

Extensies beheren

Je opent pagina Extensies met de optie Extensies van het Themakaart-menu (submenu Custom). Op deze pagina kun je je eigen geografische extensies (externe geo-applicaties) configureren. Je kunt hier nieuwe extensies configureren of de beschikbare extensies, die al eerder zijn geconfigureerd, aanpassen of verwijderen.

De extensies die worden aangeroepen bieden extra functionaliteit voor de interactieve WGP-kaarten die je kunt raadplegen in de WGP Viewer (of kaartwidget). Je roept de extensies aan door op de menubalk op een knop te drukken. Het resultaat van de aangeroepen toepassing verschijnt in een apart popup- of browservenster.

De volgende afbeelding toont pagina Extensies:

De pagina bevat een lijst Beschikbare extensies met alle geografische extensies die al eerder voor gebruik in WGP zijn geconfigureerd. Door in de lijst op Wijzigen te klikken kun je de configuratie van een extensie aanpassen. Door op Verwijderen te klikken verwijder je de extensie uit WGP Beheer. Met een apart selectievakje kun je aangeven welke extensies je in de huidige kaart wilt opnemen (optie Actief in huidige themakaart). Met Selecteren kun je een extensie voor een aantal kaarten beschikbaar maken (vergeet dan niet om met Opslaan af te sluiten). Met de knop Nieuwe extensie, onder de lijst, configureer je een nieuwe extensie in WGP.

Toevoegen van een nieuwe extensie aan WGP

Je kunt op de volgende manier een nieuwe extensie in WGP configureren:

1. Druk op knop Nieuwe extensie (op pagina Extensies). Pagina Extensies - Extensie configureren verschijnt.
   
   
2. Vul voor de configuratie van de nieuwe extensie op de tabbladen Algemeen, Popup, Dialog en Geavanceerd de instellingen van de externe geo-applicatie in. Met deze instellingen geef je de extensie binnen WGP een naam en definieer je welke webservice je wilt aanroepen door het URL-adres van de service op te geven. Verder geef je aan wanneer de service wordt aangeroepen, hoe dat gebeurt en waar het resultaat van de aanroep verschijnt (instelling Presentatie). Ten slotte definieer je een aantal geografische gegevens die als variabelen aan de URL moeten worden toegevoegd om ze zo aan de webapplicatie door te geven (zie onderdeel 'URL-parameters').
   
   
3. Klik Opslaan. Het formulier Extensie configureren verdwijnt en de nieuwe extensie verschijnt onder de opgegeven naam in de lijst Beschikbare extensies.

Wijzigen van de configuratie van een extensie

Je kunt op de volgende manier een beschikbare extensie-configuratie wijzigen:

1. Klik in de lijst Beschikbare extensies op pagina Extensies bij de betreffende extensie op Wijzigen. De tabbladen met de ingevulde parameters verschijnen.
   
   
2. Verander de instellingen van de extensieconfiguratie. Alleen de naam en de URL kun je niet veranderen omdat dit de identificatie van de extensie vormt. Alle andere instellingen kun je wijzigen.
   
   
3. Klik Opslaan. De tabbladen met de instellingen verdwijnen en een gewijzigde versie van de extensieconfiguratie verschijnt in de lijst Beschikbare extensies.

Verwijderen van een extensie uit WGP

Je kunt op de volgende manier een extensie uit WGP verwijderen:

1. Klik in de lijst Beschikbare extensies op pagina Extensies bij de betreffende extensie op Verwijderen. Een berichtvenster verschijnt waarin je gevraagd wordt of je de extensie echt wil verwijderen.
   
   
2. Klik in dit venster op OK.
   
   
3. De extensie verdwijnt uit de lijst Beschikbare extensies en wordt van de WGP-server verwijderd.

Instellingen extensies

De volgende tabel beschrijft de verschillende instellingen op tabbladen Algemeen, Popup, Dialoog en Geavanceerd waarmee je een externe geografische extensie in WGP configureert:

http://externe.applicatie.com/?appcode=utrecht&x=569646&y=6815507&srid=EPSG:900913

URL-parameters

URL-parameters zijn variabelen die bij de aanroep van een webapplicatie aan de URL zijn toegevoegd om aanvullende informatie aan de server door te geven en de aanroep zo verder te speci ficeren. Ze worden gebruikt om de inhoud van een webpagina te filteren, te sorteren of toe te spitsen op een bepaald object of een specifieke locatie. Wanneer je bijvoorbeeld op de kaart van de Buienradar klikt om hierop in te zoomen zul je met de URL-parameters de aangeklikte locatie aan de server doorgeven.

De URL-parameters staan achter de URL van de webapplicatie. Ze beginnen met een ? en worden gescheiden door een &-teken. Je gebruikt deze parameters in de aanroep van de externe geo-applicatie om de aanroep verder te specificeren. Bijvoorbeeld wanneer je na het aanklikken van een locatie in Cyclomedia een foto van een bepaalde locatie wilt zien, wordt de locatie aangeduid door de volgende parameters achter de URL te zetten: ?x=569646&y=6815507.

De standaard URL-parameters in WGP zijn die voor de XY-coördinaten en die voor de kaartprojectie. Met deze parameters geef je aan de externe geo-applicatie de aangeklikte locatie of de huidige extent van de kaart door en de kaartprojectie van de kaart waar vanuit je de applicatie aanroept. Naast deze standaard parameters kun je bij het aanroepen van een externe geo-applicatie ook andere URL-parameters meegeven. Die krijgen dan een vaste, voorgedefinieerde waarde. Voor deze overige parameters geef je in de configuratie van de externe geo-applicatie de naam en de waarde van de parameter op.

De niet-standaard URL parameters worden op de volgende manier gedefinieerd:

1. Selecteer bij URL Parameter Selectie een URL parameter:
   • selecteer een bestaande parameter uit de lijst bij Huidige selectie, of
   • maak hier een nieuwe parameter aan door bij Parameter de naam van de parameter op te geven en vervolgens op Toevoegen te klikken.
     
     
2. Vul bij Waarde de waarde van de URL-parameter in.
   
   
3. Geef met het selectievakje Javascript Waarde aan of het om een javascriptwaarde gaat.
   
   
4. Klik bij URL Parameter Selectie op de knop Toevoegen.

Tool type

Bij de extensie-instelling Tool type geef je met een type-aanduiding aan hoe WGP moet reageren wanneer de externe invoegtoepassing wordt aangeroepen. Je kunt tussen de volgende twee reacties kiezen:

• On Extent
  De aanroep heeft betrekking op de hele extent van het huidige kaartbeeld en WGP roept de externe toepassing aan zodra je in de WGP Viewer (of een kaartwidget) op de extensie-knop drukt. WGP geeft op basis van de huidige extent direct de URL Parameters door.
  
  
• On Click
  De aanroep heeft betrekking op de locatie die je op de kaart met de muis aanklikt. Wanneer je op de extensie-knop drukt wordt de externe toepassing nog niet direct aangeroepen. Dat gebeurt pas wanneer je daarna met de muis op de kaart klikt. WGP geeft dan op basis van de aangeklikte locatie de URL Parameters aan de toepassing door.

Kaartprojectie

Bij het aanroepen van een externe geo-applicatie kun je de projectie van de kaart waarin de applicatie wordt gebruikt in de aanroep als URL-parameter meegeven. Hiervoor vul je de volgende velden in:

• SRID/Prefix,
  het voorvoegsel van de code van de kaartprojectie, bijvoorbeeld EPSG.
  
  
• SRID parameternaam,
  de naam van de URL-parameter die voor de kaartprojectie wordt gebruikt. Wanneer je niets invult, wordt de naam 'SRID' gebruikt.

Indien je geen kaartprojectie wilt of hoeft mee te geven, vul je bij SRID/Prefix de waarde 'SRID parameter niet doorgeven' in. Zie onderdeel 'URL-parameters' voor een voorbeeld.