Sobre o Objeto SCS

O JavaScript do controlador usa variáveis e propriedades definidas no objeto SCS global para renderizar a página web. O objeto JavaScript global deve ser definido no arquivo do controlador antes da inclusão do arquivo controller.js. Há duas propriedades principais no objeto SCS que podem ser usadas para personalização:

SCS.sitePrefix

A variável SCS.sitePrefix define o prefixo de caminho do site on-line. Normalmente, isso é padronizado como site/<siteName>/.

O JavaScript do controlador usa esse valor para determinar qual página web exibir. Por exemplo, se o browser estiver solicitando a página em /site/SampleSite/products/index.html, o sitePrefix /site/SampleSite/ permitirá que o JavaScript calcule se a página products/index.html do site deve ser exibida. Observe que o sitePrefix deve ser um valor de string que comece e termine com um caractere "/".

Se um proxy ou outra infraestrutura, como Akamai, e regras de mapeamento de URL estiverem em vigor, a modificação dessa variável permitirá que o prefixo do site seja personalizado. Por exemplo, a definição do sitePrefix como /intranet/ExampleSite/ permitiria que o site fosse entregue com esse nome de caminho no browser, em vez do prefixo de caminho /site/SampleSite/ padrão.

Nota:

Internamente, o JavaScript do controlador padrão usará "/" como sitePrefix se o URL no browser não corresponder ao prefixo do site. Isso permite que o site seja oferecido usando um domínio personalizado sem personalização.

SCS.preInitRendering

Se definida, a função SCS.preInitRendering será chamada pelo código JavaScript do controlador antes da execução de qualquer lógica computacional. Essa é uma função útil a ser definida nos arquivos do controlador personalizados para substituir as operações básicas do JavaScript do controlador.

Se definida, SCS.preInitRendering deverá ser uma função. Ela é chamada sem qualquer argumento e nenhum valor de retorno é esperado ou processado.

SCS.getDeviceInfo

A função SCS.getDeviceInfo permite a personalização da lógica de detecção de dispositivo dentro do JavaScript do controlador. Essa detecção é usada para determinar se uma versão móvel ou responsiva de uma página deve ser entregue.

A função SCS.getDeviceInfo não assume qualquer argumento e retorna um Objeto JavaScript que tem duas propriedades:

  • isMobile—uma propriedade booliana indicando que o dispositivo atual é um cliente móvel, como um smartphone.

  • isIOS—uma propriedade booliana indicando que o dispositivo atual está em execução em um sistema operacional baseado no iOS.

Se o controlador personalizado não substituir SCS.getDeviceInfo, a implementação padrão interna será usada.