SAPUI5_ABAP_InstGuide

UI development toolkit for HTML5 Installation Guide UI development toolkit for HTML5 1.6

2012-11-05

2012 SAP AG. All rights reserved.SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAPBusinessObjects Explorer, StreamWork, SAP HANA and other SAP products and services mentioned

Copyright

herein as well as their respective logos are trademarks or registered trademarks of SAP AG inGermany and other countries.Business Objects and the Business Objects logo, BusinessObjects,Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects productsand services mentioned herein as well as their respective logos are trademarks or registeredtrademarks of Business Objects Software Ltd. Business Objects is an SAP company.Sybase andAdaptive Server, iAnywhere, Sybase 365, SQL Anywhere, and other Sybase products and servicesmentioned herein as well as their respective logos are trademarks or registered trademarks of Sybase,Inc. Sybase is an SAP company. Crossgate, m@gic EDDY, B2B 360, B2B 360 Services areregistered trademarks of Crossgate AG in Germany and other countries. Crossgate is an SAPcompany. All other product and service names mentioned are the trademarks of their respectivecompanies. Data contained in this document serves informational purposes only. National productspecifications may vary.These materials are subject to change without notice. These materials areprovided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only,without representation or warranty of any kind, and SAP Group shall not be liable for errors oromissions with respect to the materials. The only warranties for SAP Group products and servicesare those that are set forth in the express warranty statements accompanying such products andservices, if any. Nothing herein should be construed as constituting an additional warranty.

2012-11-05

Contents

UI development toolkit for HTML5 Installation Guide.............................................................5Chapter 1

Introduction..............................................................................................................................51.1

About this Document...............................................................................................................51.2

Before you Start......................................................................................................................61.3

SAP Notes for the Installation..................................................................................................61.3.1

Related Information..................................................................................................................71.3.2

Support and Maintenance Strategy..........................................................................................71.4

Preparation..............................................................................................................................91.5

Installation Prerequisites for SAPUI5 Tools............................................................................101.5.1

Installation Prerequisites for SAPUI5 Runtime........................................................................121.5.2

Installation..............................................................................................................................121.6

Installing SAPUI5 Runtime......................................................................................................131.6.1

Installing SAPUI5 Tools..........................................................................................................141.6.2

Upgrading SAPUI5 Tools.......................................................................................................141.7

Additional Information.............................................................................................................151.8

Uninstalling SAPUI5 Tools......................................................................................................151.8.1

Versioning of SAPUI5............................................................................................................161.8.2

Documentation.......................................................................................................................161.8.3

2012-11-053

2012-11-054

Contents

UI development toolkit for HTML5 Installation Guide

1.1 Introduction

The UI development toolkit for HTML5 (SAPUI5) is a library and a framework, which is designed toenable developers to easily create and extend state-of-the-art user interfaces. SAPUI5 is based onHTML5 and bases on the the jQuery library. It supports CSS3, which allows you to adapt themes toyour company's branding in an effective manner. SAPUI5 is Open AJAX-compliant and can be usedtogether with other standard JavaScript libraries. The client-side rendering library provides a rich setof controls. You can extend the existing controls, or develop new custom controls.

The UI development tools are part of SAPUI5. They are a set of eclipse-based tools and editors, whichsupport you in developing applications and controls. Wizards help you to create application projectsand views according to the model view controller concept. It also provides additional features, such asthe JavaScript code completion and the In-place application preview. The SAPUI5 ABAP team providerfunctionality supports you in developing on an ABAP backend system.

A Web application, which has been developed in the SAPUI5 framework can run on the followingplatforms:

SAP NetWeaver ABAP Server SAP NetWeaver Java Server SAP NetWeaver Cloud Open Source Java Application Server Static Open Source Web Server

For more information about the required deployment steps, see the corresponding platform documentationin the SAP Service Marketplace at service.sap.com/instguides.

Caution:SAPUI5 can be used on different platforms. For SAPUI5, the license and maintenance conditions ofthe respective platform apply, on which SAPUI5 is used. For example, if you use SAPUI5 tools on SAPNetWeaver Cloud, the license and maintenance conditions of SAP NetWeaver Cloud apply.

1.2 About this Document

2012-11-055


This document guides administrators through the required steps to install, configure, and maintain theUI development toolkit for HTML 5 (SAPUI5).

The Installation Guide comprises the following main sections:

Before you Start: This section provides links to SAP Notes and other information that is relevant forthe installation of SAPUI5.

"Support and Maintenance Strategy": This section provides information about the support andmaintenance strategy for SAPUI5.

Preparation: This section provides information about the installation prerequisites and the requiredsoftware components for SAPUI5 tools and SAPUI5 runtime.

Installation: This section provides information about the steps required to install SAPUI5 tools andSAPUI5 runtime.

Additional Information: This section provides information about how to uninstall SAPUI5 tools, theversioning of SAPUI5, and links to additional information.

For security related issues, refer to the "Security Guide".

1.3 Before you Start

The following sections provide information about:

SAP Notes for the Installation Related Information

1.3.1 SAP Notes for the Installation

You must read the following SAP Notes before you start the installation:

DescriptionTitleNote Number

If you use the SAPUI5 ABAP team provider function in the UIadd-on in an SAP NetWeaver 7.03/7.31 system and want touse the translation feature, this note must be implemented inthe translation system to enable the translation of SAPUI5 textelements.

Translation Object forSAPUI5 (ABAP)

1686090

Collection of information about SAPUI5SAPUI51747308

Make sure that you have the up-to-date version of each SAP Note, which you can find in the SAPService Marketplace at http://service.sap.com/notes.

2012-11-056


1.3.2 Related Information

For more information about topics not covered in this guide, see the following content:

SAP NetWeaver Library at http://help.sap.com > SAP NetWeaver Platform Product Availability Matrix at http://help.sap.com/pam

Important SAP NotesMake sure that you have the up-to-date version of each SAP Note, which you can find on SAP ServiceMarketplace at http://service.sap.com/notes.

DescriptionTitleNote Number

Describes the installation of the ABAP components of UIadd-on for SAP NetWeaver

Installing UI add-ons forSAP NetWeaver

1666368

Contains information about add-on support packages forUI add-on for SAP NetWeaver

SPs for UI add-ons forSAP NetWeaver

1666369

1.4 Support and Maintenance Strategy

ServerSAP UI development toolkit for HTML5 (SAPUI5) is comprised of a server and a client component forboth the SAPUI5 tools and runtime. The support and maintenance strategy of both parts differs fromthe general SAPNetWeaver support andmaintenance strategy, see http://service.sap.com/maintenance> SAP Maintenance Strategy. SAPUI5 components are downward-compatible software componentsand follow the same strategy as the SAP GUI. They can be replaced by a higher software componentversion during the lifetime of the software product version they are built into, without adaptations orchanges to other software component versions within the relevant software product version. Therefore,the SAPUI5 software component versions are usually not maintained for the entire maintenance periodof the software product version they are built into. Instead, they have to be replaced by a higher softwarecomponent version.

Downward-compatible means, for example, for SAPNetWeaver ABAP that starting with SAPNetWeaverUI extensions add-on SP01, the most current client version of SAPUI5 runtime and tools will alwaysbe compatible with all future SAP NetWeaver support packages. Thus, SAP strongly recommends thatcustomers apply the most recent client updates of SAPUI5 tools and runtime on a regular basis. As theSAPUI5 tools client has many dependencies, this may require additional updates on the PC which willbe listed in the following client section.

2012-11-057


ClientSAPUI5 tools depend on Eclipse. SAPUI5 tools will not be shipped as a bundle with Eclipse but separatelyas an Eclipse p2 repository. Eclipse is supported for different individual platforms. The support ofindividual platforms also depends on the support of the operating systems by the manufacturers. SAPcannot provide support for a platform or for an operating system which is no longer supported by itsvendor or manufacturer. In the same sense SAP cannot provide support for an Eclipse version or anyother Open Source software version, which is no longer supported by the Eclipse Foundation or theOpen Source community.

Support Platform MatrixSAPUI5 tools is only supported for a subset of the individual platform and operating system versionsthat are also supported by Eclipse. The list of different individual operating system versions, JavaRuntime versions, Eclipse versions, and Browser versions that are supported by SAPUI5 tools isprovided in the SAPUI5 tools Support Platform Matrix (SPM). SAP does not support to run SAPUI5tools on operating system versions, Java Runtime versions, Eclipse versions, and Browser versionsthat are not listed in the SAPUI5 tools SPM.

The following table gives an overview of the supported platforms and operating systems:

Windows XP, Vista 7 (32- or 64-Bit)Operating System

JRE 1.6, 32/64-BitJava Runtime

Internet Explorer 9.0 or higherBrowser

When using the SAPUI5 ABAP Team Provider, the Support Platform Matrixof ABAP Development Tools for SAP NetWeaver applies

ABAP Tools for SAPNetWeaver

Eclipse Indigo 3.7 or Juno 3.8 or Juno 4.2Eclipse platform

The SAPUI5 runtime supports the browsers that are listed in the Product Availability Matrix for the UIadd-on for SAP NetWeaver, see http://service.sap.com/~form/handler?_APP=00200682500000001303&_EVENT=DISP_NEW&00200682500000002804=01200314690900004969.

Special Terms for Operating SystemsSAP recommends that you always use a current Support Package (SP) for the relevant operatingsystem as listed on the SAPUI5 tools SPM. An operating system, which is no longer supported by theoperating system's manufacturer should no longer be used in conjunction with SAPUI5 tools. If an issueoccurs only on an unsupported operating system, SAP will not analyse nor solve the issue, but insteadreply by recommending an update of the operating system. Additionally, SAP does not test SAPUI5tools on such operating systems anymore.

Special Terms for Java Runtime versionsSAP recommends that you always use a current Java Runtime version as listed on the SAPUI5 toolsSPM. A Java Runtime version, which is no longer supported by the Java Runtime version manufacturershould no longer be used in conjunction with SAPUI5 tools. If an issue occurs only on an unsupportedJava Runtime version SAP will not analyse nor solve the issue, but instead reply by recommending anupgrade of the Java Runtime version. Additionally, SAP does not test SAPUI5 tools on such JavaRuntime versions anymore.

2012-11-058


Special Terms for Eclipse versionsSAP recommends that you always use a current Eclipse version as listed on the SAPUI5 tools SPM.An Eclipse version, which is no longer supported by the Eclipse foundation should no longer be usedin conjunction with SAPUI5 tools. If an issue occurs only on an unsupported Eclipse version SAP willnot analyse nor solve the issue, but instead reply by recommending an upgrade of the Eclipse version.Additionally, SAP does not test UI5 tools on such Eclipse versions anymore.

Special Terms for Browser versionsSAP recommends that you always use a current Browser version as listed on the SAPUI5 tools SPM.A Browser version which is no longer supported by the Browser manufacturer should no longer be usedin conjunction with UI5 tools. If an issue occurs only on an unsupported Browser version SAP will notanalyse nor solve the issue, but instead reply by recommending an upgrade of the Browser version.Additionally, SAP does not test SAPUI5 tools on such Browser versions anymore.

Language SupportIf the SAPUI5 ABAP TeamProvider is used, the SAPUI5 tools are released in English language only.

SAP Shipment Channel and License AgreementThe use of SAPUI5 is subject to the terms and conditions of your license agreement with SAP whichis directly related to the SAP shipment channel where SAPUI5 has been initially been downloaded andinstalled from. SAP does not support to update SAPUI5 with software from a different SAP shipmentchannel than the initial installation of SAPUI5 has been done. Example: An update of an older SAPUI5installation which has originally been downloaded and installed from the SAP Service Marketplace witha newer SAPUI5version which is provided on the SAP Developer Center is not recommended and notsupported by SAP.

DisclaimerSome components of this product are based on Java. Any code change in these components maycause unpredictable and severe malfunctions and is therefore expressly prohibited, as is anydecompilation of these components.

Any Java Source Code delivered with this product is only to be used by SAP's Support Services andmay not be modified or altered in any way.

1.5 Preparation

This section describes the prerequisites for installing UI5 development toolkit for HTML5 (SAPUI5): Installation Prerequisites for SAPUI5 Tools Installation Prerequisites for SAPUI5 Runtime

2012-11-059


1.5.1 Installation Prerequisites for SAPUI5 Tools

To install and run SAPUI5 tools, the following software has to be installed:

User interface add-on for SAP NetWeaver 1.0 support package 01

Java Runtime environment: JRE 1.6, 32/64-Bit (same as Eclipse)

If you install the SAPUI5 ABAP team provider together with ABAP development tools for SAPNetWeaver in a version below 1.0 Patch 07, you need to use the 32 Bit versions.

Operating system: Windows Vista, Windows 7 (32- or 64-Bit)

Browser: Not relevant, except for Internet Explorer 9.0 or higher for embedded application preview

Eclipse Platform for SAPUI5 tools:

SAPUI5 tools run on Eclipse Indigo 3.7 or Juno 3.8 / 4.2. There are two options for the Eclipseplatform: Either an 'Eclipse IDE for Java EE Developers' bundle or an 'Eclipse Classic 4.2' bundle.Depending on the bundle you choose, you may be required to install additional features accordingto this list:

Contained inEclipse ClassicBundle

Contained inEclipse JEEBundle

Min. ver-sionTechnical IDEName

YesYes3.6.0org.eclipse.platformEclipse Platform

NoYes3.2.0org.eclipse.wst.com-mon.fproj

Eclipse Faceted ProjectFramework

NoYes3.2.0org.eclipse.jst.com-mon.fproj.enable-ment.jdt

Eclipse Faceted ProjectFramework JDTEnablement

YesYes3.6.0org.eclipse.jdtEclipse Java DevelopmentTools

NoYes3.2.0org.eclipse.jst.enter-prise_ui.feature

Eclipse Java EE DeveloperTools

NoYes3.2.0org.eclipse.jst.web_ui.fea-ture

Eclipse Java Web Develop-er Tools / JST Web UI

NoYes2.4.2org.eclipse.emfEMF - Eclipse ModelingFramework Runtime andTools

NoYes3.6.0org.eclipse.gefGraphical Editing Frame-work GEF

2012-11-0510


Contained inEclipse ClassicBundle

Contained inEclipse JEEBundle

Min. ver-sionTechnical IDEName

NoYes1.2.0org.eclipse.wst.js-dt.feature

Java Script DevelopmentTools

NoYes3.2.0org.eclipse.wst.com-mon_core.feature

WST Common Core

NoNo8.0.0org.eclipse.jetty.coreJetty-Core: Servlets andWebapps (as of Juno)

Note:

For the SAPUI5 application preview, you require the Jetty feature. This needs to be installedexplicitely as of Juno release.

If your Eclipse installation contains the feature org.eclipse.wst.jsdt.feature in version1.3.1, we recommend to update to a current version. Invoking the JavaScript code completionin version 1.3.1 may cause a system crash of Eclipse.

SAPUI5 ABAP team provider to connect to an ABAP backend system on SAP NetWeaver 7.31

If you want to use the SAPUI5 ABAP team provider to connect to an ABAP backend system, thefollowing additional prerequisites are required:

User interface add-on for SAP NetWeaver 1.0 support package 01 with SAP Basis SAP_BASIS7.03/7.31 support package 04 (as an exception to SAP Basis SAP_BASIS support package 02,which is required for user interface add-on for SAP NetWeaver 1.0).

AiE Communication Framework

The AIE Communication Framework is part of the ABAP development tools for SAP NetWeaver.Install the complete ABAP development tools according to the installation procedure in theInstallation Guide for the ABAP Development Tools, see SAP Note 1718399.

1.5.1.1 Software Component Download for SAPUI5 Tools

Before you start the installation of UI development toolkit for HTML5 (SAPUI5), download the softwarecomponents for SAPUI5 tools:

For the UI add-on installation, download SAPUI5 from SAP Service Marketplace as follows:

1. Launch the SAP Software Download Center on the SAP Service Marketplace (http://service.sap.com/swdc).

2. Search for SAPUI5 TOOLS IDE PLUGIN 1.00 and SAPUI5 TEAM PROV IDE 1.00.3. Add both packages to the download basket.4. Download the corresponding archive files (zip) to a local directory.

For SAP NetWeaver Cloud:

2012-11-0511


SAPUI5 tools are part of the SAP NetWeaver Cloud Tools and can be installed as described inhttps://tools.netweaver.ondemand.com.

1.5.2 Installation Prerequisites for SAPUI5 Runtime

One of the following platforms is required for the installation of SAPUI5 runtime:

SAP NetWeaver 7.00, 7.01, 7.02, or 7.31 SAP NetWeaver Cloud SAP NetWeaver Java

1.5.2.1 Software Component Download for SAPUI5 Runtime

Before you start the installation of UI development toolkit for HTML5, download the required softwarecomponents for SAPUI5 runtime from SAP Service Marketplace:

User interface add-on 1.0 for SAP NetWeaver

For more information, see https://help.sap.com > SAP NetWeaver > User Interface Add-On forSAP NetWeaver.

SAP NetWeaver Java SPs 7.30 and 7.31

For more information, see https://service.sap.com > SAP NetWeaver > SAP NetWeaver 7.3.

SAP NetWeaver Cloud

For more information, see https://help.netweaver.ondemand.com

1.6 Installation

The following sections describe the installation steps that are required to install UI development toolkitfor HTML5:

1. Installing UI5 runtime2. Installing UI5 tools

2012-11-0512


1.6.1 Installing SAPUI5 Runtime

The user interface add-on for SAP NetWeaver provides a number of tools and services enabling theimplementation and lifecycle of HTML5 applications and user interface integration services providing,for example, role-dependent content and its integration with and navigation to existing applications.One of its major assets is the UI development toolkit for HTML5 (SAPUI5) runtime that is part of theuser interface add-on for SAP NetWeaver.

You can install SAPUI5 runtime on different platforms. The following sections describe the installationprocedures for the respective platforms.

SAP NetWeaver ABAP

The UI add-on is installed on an existing SAP NetWeaver release and can be used on the SAPNetWeaver release versions 7.00, 7.01, 7.02, and 7.31

To install SAPUI5 runtime on SAP NetWeaver ABAP, proceed as follows:

1. Import the UI add-on from service.sap.com by using transaction SAINT. For more information aboutthe installation and the prerequisites for the UI add-on, see SAP note 1666368 on service.sap.com/notes.

2. To check whether the installation of UI add-on and SAPUI5 has been successful, open your webbrowser with the following URL: http://:/sap/public/bc/ui5_ui5/index.html. Replace and with the respective host name and port number of your SAPNetWeaver applicationserver. You can get this information via the ICM Monitor (transaction code SMICM) by choosingGoto > Services.

If the installation was succesful, the browser dislays the index page with the versions of the installedlibraries and the SAPUI5 script tag that needs to be used in an HTML page to upload SAPUI5 inyour browser.

SAP NetWeaver Cloud

To install the UI add-on on SAP NetWeaver Cloud, make sure that you have the required account. Formore information, see the SAP NetWeaver Cloud documentation on https://help.netweaver.ondemand.com under Getting Started > Getting an Account.

If you use your SAPUI5-based Cloud application in a web browser other than Microsoft's InternetExplorer, you can use SAPUI5 directly in your web application by using a tag, which referencesto https://sapui5.netweaver.ondemand.com/resources/sap.ui.core.js. The documentation of SAPUI5 isthen also immediately available as part of the DemoKit.

If you use advanced IDE functionality and/or want to use the SAPUI5-based Cloud application in abrowser other than Microsoft's Internet Explorer, you need to download and set up the necessary Eclipsetools for SAP NetWeaver Cloud, which also include the SAPUI5 tools for Eclipse. You can then createa SAPUI5 application in Eclipse and directly deploy the application to SAP NetWeaver Cloud.

2012-11-0513


For more information, see https://tools.netweaver.ondemand.com and the SAP NetWeaver Clouddocumentation on https://help.netweaver.ondemand.com under Getting Started > Setting Up theTools.

1.6.2 Installing SAPUI5 Tools

For the prerequisites for installing SAPUI5 tools, see Installation Prerequisites for SAPUI5 Tools.

Follow this procedure for each SAPUI5 tools package:

1. Launch you Eclipse workbench.2. Open the installation wizard by choosing Help > Install New Software.3. In theWork with field of the installation wizard, specify the target directory of the package.

To add the new installation directory, choose Add and then choose Archive to specify the location.Enter a name for your local software site.

4. Select all UI development toolkit for HTML5 features and choose Next.5. Review the feature groups to be installed and choose Next.6. Accept the terms of the license agreement and choose Finish to initiate the installation of selected

feature groups.7. In the Certificates dialog confirm the certificates from Eclipse.org and SAP with OK.8. To apply the changes of the installation procedure, restart the Eclipse workbench.9. To check, whether the installation has been succesful, proceed as follows:

a. For SAPUI5 application development open the Eclipse IDE and choose File > New > Other ...>SAPUI5 ApplicationDevelopment >Application Project. If the installation has been succesful,the New Application Project wizard opens.

b. For the SAPUI5 ABAP repository team provider open the Eclipse IDE and choose File > New >Other ... > SAPUI5 Application Development > Application Project. Select the new projectand choose Context Menu > Team > Share Project.... If the installation has been succesful,SAPUI5 ABAP Repository appears in the list.

1.7 Upgrading SAPUI5 Tools

To upgrade SAPUI5 tools, download the new version of the SAPUI5 tools package from SAP ServiceMarketplace.

For information about the prerequisites for installing and upgrading SAPUI5 tools, see InstallationPrerequisites for SAPUI5 Tools.

Proceed as follows:

1. Launch your Eclipse workbench.

2012-11-0514


2. If you have downloaded the new version with a different name and/or stored at a different locationinstead of exchanging the old version with the new version, you have to update the list of availablesoftware sites in Eclipse to refer to the new location before you can start the update. Proceed asfollows:a. ChooseWindow > Preferences.b. Choose Install/Update > Available Software Sites.c. Select the entries that you have added for the installation or the last update and adjust them for

the new version.d. Confirm your changes.

3. Continue with the update as follows:a. To open the Updates wizard, choose Help > Check for Updatesb. In the Available Updates list, select all UI development toolkit for HTML5 features and choose

Next.c. Review the feature groups to be installed and choose Next.d. Accept the terms of the licence agreement and choose Finish to start the installation of the

selected feature groups.e. In the Certificates dialog, confirm the certificates of Eclipse.org and SAP.

1.8 Additional Information

The following sections provide additional information about the following topics: Uninstalling SAPUI5 Tools Versioning of SAPUI5 Documentation

1.8.1 Uninstalling SAPUI5 Tools

To uninstall all frontend components required for UI5 tools, proceed as follows:

1. Launch your Eclipse workbench.2. Choose Help > About .3. Choose Installation Details.4. Select the SAPUI5 node and choose Uninstall.

The Uninstall Details page displays a list of feature groups that will be uninstalled.

5. To start the uninstall function, choose Finish.

2012-11-0515


1.8.2 Versioning of SAPUI5

With SAPUI5 1.6 there is a close coupling of SAPUI5 core/runtime and SAPUI5 tools: It is required thatwithin a running system both have the same version, that is, have the same major and minor version.For example, SAPUI5 core/runtime 1.6.1 works together with SAPUI5 tools 1.6.2, but not with SAPUItools 1.8. For a future release it is planned to have a more lose coupling here with regards to the minorand micro version. Please note that with SAPUI5 1.6 we can only support customers, which follow thisrule in their system landscapes.

1.8.3 Documentation

The following documentation is available for UI development toolkit for HTML5:

ABAP Server:

To access the SAPUI5 DemoKit use this URL, replacing with your host name and with your port number:

http://:/sap/public/bc/ui5_ui5/demokit/#docs/guide/Documentation.html

SAP Java Server:

To access the UI5 DemoKit use the respective URL, replacing with your host name and with your port number.

SAP NetWeaver Cloud:

https://sapui5.netweaver.ondemand.com/sdk/

Note:This is the current version of the SAPUI5 DemoKit on the SAP NetWeaver Cloud. It might not bethe version of your local installation.

2012-11-0516


UI development toolkit for HTML5 Installation GuideContentsUI development toolkit for HTML5 Installation GuideIntroductionAbout this DocumentBefore you StartSAP Notes for the InstallationRelated Information

Support and Maintenance StrategyPreparationInstallation Prerequisites for SAPUI5 ToolsSoftware Component Download for SAPUI5 Tools

Installation Prerequisites for SAPUI5 RuntimeSoftware Component Download for SAPUI5 Runtime

InstallationInstalling SAPUI5 RuntimeInstalling SAPUI5 Tools

Upgrading SAPUI5 ToolsAdditional InformationUninstalling SAPUI5 ToolsVersioning of SAPUI5Documentation

Documents

SAPUI5_ABAP_InstGuide