Het SCS-object

De JavaScript-controller maakt gebruik van variabelen en eigenschappen die zijn gedefinieerd in het algemene SCS-object om de webpagina weer te geven. Het algemene JavaScript-object moet zijn gedefinieerd in het controllerbestand vóór de opname van het bestand controller.js. Het SCS-object bevat twee primaire eigenschappen die kunnen worden gebruikt voor aanpassingen:

SCS.sitePrefix

Met de variabele SCS.sitePrefix wordt het padprefix van de online site gedefinieerd. De standaardwaarde is gewoonlijk site/<sitenaam>/.

Deze waarde wordt door de JavaScript-controller gebruikt om te bepalen welke webpagina moet worden weergegeven. Bijvoorbeeld: als de pagina op /site/SampleSite/products/index.html door de browser wordt aangevraagd, kan de JavaScript-controller aan de hand van de siteprefix /site/SampleSite/ berekenen dat de pagina products/index.html in de site moet worden weergegeven. De siteprefix moet een stringwaarde zijn die begint en eindigt met het teken '/'.

Als er een proxy of andere infrastructuur is toegevoegd, zoals Akamai en URL-toewijzingsregels, kan het siteprefix worden aangepast door deze variabele te wijzigen. Bijvoorbeeld: als u het siteprefix instelt op /intranet/ExampleSite/ kan de webpagina met die padnaam worden weergeven in de browser in plaats van de webpagina met het standaardpadprefix /site/SampleSite/.

Opmerking:

Als de URL in de browser niet overeenkomt met de siteprefix, wordt in de JavaScript-standaardcontroller '/' als siteprefix gebruikt. Zo kan de site worden weergegeven met een vanity-domein zonder aanpassingen.

SCS.preInitRendering

Als SCS.preInitRendering is gedefinieerd, wordt deze functie aangeroepen door de JavaScript-controllercode voordat de bijbehorende rekenlogica wordt uitgevoerd. Dit is een handige functie om te definiëren in aangepaste controllerbestanden als u basisbewerkingen van de JavaScript-controller wilt overschrijven.

Als SCS.preInitRendering is gedefinieerd, moet het een functie zijn. Deze wordt aangeroepen zonder argumenten en er wordt geen retourwaarde verwacht of verwerkt.

SCS.getDeviceInfo

Met de functie SCS.getDeviceInfo is aanpassing van de apparaatdetectielogica in de JavaScript-controller mogelijk. Deze detectie wordt gebruikt om te bepalen of een mobiele of responsieve versie van een pagina moet worden weergegeven.

U kunt geen argumenten opgeven voor SCS.getDeviceInfo en de functie retourneert een JavaScript-object met twee eigenschappen.

  • isMobile: een Boole-eigenschap waarmee wordt aangegeven dat het huidige apparaat een mobiele client is, zoals een smartphone.

  • isIOS: een Boole-eigenschap waarmee wordt aangegeven dat het huidige apparaat draait onder een iOS-besturingssysteem.

Als SCS.getDeviceInfo niet wordt overschreven door de aangepaste controller, wordt de ingebouwde standaardimplementatie gebruikt.