Workshop 5 TMC 2016 Gregor Glinka Begrüßung und Prüfen ob alle sehen und hören können Vorstellungsrunde 2016

Agenda Workshop 1 – TMC Prerequisites System Architecture Basic Setup Database structure and triggers Server-side development Client-side development Broker Service development Active Directory integration Goals: Developer can build and test new releases Developer finds relevant internal documentation Duration: 3 hours presentation 1 hour questions & answers

1. Prerequisites 1 SAP Business One environment with VariAdd Project plus Addon Microsoft SQL Server 2008 R2 / 2012 / 2014 2014 recommended; not Express Edition SAP Business One 9.2 PL04 (SQL) You can follow with 9.1 PL13 as well, but we will use 9.2 for demonstration. Installed and running Addon “VariAdd Project plus” Based on source code from 2016-09-07 Besonders der aktuelle Source Code ist wichtig

1. Prerequisites 2 For VariApp TMC Broker Development (SAP-TMC interface) Visual Studio 2013 Professional or Enterprise Edition; Community/Express Edition is not enough VS 2015 should also work, but we have not tested it yet. Wix Tool Set For generating a TMC Broker Service Installer file. Recommended Version  “WiX v3.10.3 (Stable)” http://wixtoolset.org/releases/ SAP HANA Client The SAP HANA Client must be installed on the Windows PC where the Broker will be running/debugged. Version 112.03 (32 and 64 Bit) VariApp TMC Broker Service source code from 2016-09-08 Besonders der aktuelle Source Code ist wichtig

1. Prerequisites 3 For VariApp TMC Web Application development SAP HANA Server SPS09 or later(including XS packages); SAP B1 does not need to be installed on this server. You need the SYSTEM user access to the HANA Server. Java SE Development Kit 8 in 32 bit and 64 bit http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html SAP HANA Studio or Eclipse (4.5) “Mars” with SAP HANA tools Follow this link for installation details: https://tools.hana.ondemand.com/ VariApp TMC source code from 2016-09-08 (as HANA delivery unit) VariApp TMC documentation from 2016-10-05 Besonders der aktuelle Source Code ist wichtig

2. TMC System Architecture Documentation in \vtmc-docs-2016-10-05\ TMC TRANSITION\02 - Design\VariApp TMC System Architecture - 00 - Overview.pdf VariApp TMC Web Application Based on SAPUI5/OpenUI5 Framework HTML5/JavaScript Runs in web browser (Chrome/Firefox) Web Services Server side JavaScript (XSJS) REST services (CRUD) Provides data for TMC Web Application (AJAX calls) VariApp TMC Broker Service BrokerService C# Application Runs as windows service Synchronizes data between SAP/VariAdd Project plus and TMC database (ProfileVproTmc.dll) Developer Guide zeigen Verzeichnisstruktur des Quellcodes Hinweis auf Setup Entwicklungsumgebung / Tools / etc.

3. Basic Setup - Import TMC Connect to HANA with SYSTEM user Create administrative user XSADMIN Import TMC Sources via Hana Studio Create repository “workspace” (e.g “c:\dev\tmc\workspace”) Copy TMC sources from “vtmcx-src-2016-09-08.7z“ to this folder Repositories > Activate “variatec” folder Check out and Import Projects on “variatec” folder Option: Import TMC Sources via Hana Cockpit (from Delivery Unit) Requires administrative user XSADMIN Login to Admin cockpit (pw change may be required) https://<your-hana-server-name>:4300/sap/hana/admin/cockpit/ XSADMIN : <your secret> Select “Manage Products and delivery units > Delivery Units > Import” \vtmc-docs-2016-10-05\TMC TRANSITION\06 - Release\v8.0\VariApp TMC Hana DeliveryUnit VARIATEC_TMC_v8.00.tgz Import SQL scripts (TMC_COMMON) Open SQL console and import all SQL scripts from “vtmcx-src-2016-09-08\sql-scripts\” Scripts to be updated: 0101_create_tmc-roles.hana.sql 0150_create_schema.hana.sql Alle Teilnehmer Release bauen lassen; im Hintergrund weitermachen. Nach Build-Ende: Registriert Trimergo COMponent Ggf. Fehlermeldungen kurz gemeinsam prüfen/fixen Jetzt könnt ihr bauen!

3. Basic Setup – Create TMC Instance Open Template in text editor from package “vtmc-docs-2016-10-05” \TMC TRANSITION\05 - Deployment\SQL Templates\create instance.hana.sql Set Customer ID (e.g. 99999) Set Broker Password Add TMC Employee User “No SAML” : (e.g. C99999_1) Execute Script in SQL console Test TMC Access https://<your-hana-server>:4300/variatec/variapp/tmc/app/WebContent/ User: C99999_1 https://sv-ger-p-hana5.cloudiax.com:4300/variatec/variapp/tmc/app/WebContent/ Alle Teilnehmer Release bauen lassen; im Hintergrund weitermachen. Nach Build-Ende: Registriert Trimergo COMponent Ggf. Fehlermeldungen kurz gemeinsam prüfen/fixen Jetzt könnt ihr bauen!

4. Data Structure – TMC Broker Role TMC_BROKER General TMC Broker role C99999_BROKER Customer specific TMC Broker role grants from TMC_BROKER C99999_BS Customer specific TMC Broker User grants from C99999_BROKER role Danach Addon in SAP installieren und testen, dass es funktioniert. Dabei wird auch DB initialisiert/aktualisiert

4. Data Structure– TMC Employee User TMC_EMPLOYEE General TMC Emplyoee user role C99999_EMPLOYEE Customer specific TMC Emplyoee user role grants from TMC_EMPLOYEE C99999_1 Customer specific TMC Employee User grants from C99999_EMPLOYEE role Danach Addon in SAP installieren und testen, dass es funktioniert. Dabei wird auch DB initialisiert/aktualisiert

4. Data Structure and Triggers Database Mapping (SAP/VariAdd Project - TMC) Documentation : “vtmc-docs-2016-10-05.7z” \TMC TRANSITION\03 - Database\VariApp TMC Data Mapping to SAP+VPRO v8.pdf VariApp TMC Broker Service Requires a database user to read/write data in SAP Reads data from SAP/VariAdd Project tables and writes it to TMC Reads booking data from TMC and writes it into VariAdd Project table HANA: BxPro_work_pdc_xxxx SQL: trimergo.work_pdc_xxxx Holds settings and temporary data in own tables vprotmc_appsettings: application settings vprotmc_deltas: logs changes in SAP to be synchronized to TMC vprotmc_mapping: stores primary key mappings SAP <-> TMC 2 Synchronization Modes Initial synchronization Pushes all relevant data from SAP to TMC Delta synchronization Uses database triggers to follow changes in SAP DB Triggers are created by TMC Broker Service during first startup Naming convention for triggers: vprotmc_xxxxxxx Alle Teilnehmer Release bauen lassen; im Hintergrund weitermachen. Nach Build-Ende: Registriert Trimergo COMponent Ggf. Fehlermeldungen kurz gemeinsam prüfen/fixen Jetzt könnt ihr bauen!

5. Server-side development General project structure Data endpoints are located in “variatec > variapp > tmc > xs“ Folder “services”: contains all data endpoints (XSJS files) Folder “services\lib”: contains database access helper Documentation: TMC TRANSITION\04 - Implementation\VariApp TMC Service Interface v4.pdf Work with Web IDE Login to Web IDE http://<your-server-name>.8000/sap/hana/ide/editor User: XSADMIN Ensure the XSADMIN user has Developer/Admin privileges Debugging works best in Web IDE Warum als Administrator starten: DLL-Registrierung; Zugriff auf fremden SAP-Prozess Framework einmal kompilieren und dann vergessen Tipps für Visual Studio, zum Beispiel: Resharper Debugging von Framework-Dateien in Client-Solution etc. Prüfen dass addon in SAP läuft Hinweis auf Lizenz, die nicht benötigt wird. Breakpoint setzen und dort anhalten lassen

6. Client-side development TMC Web Application is located in “variatec > variapp > tmc > app HTML5/JavaScript Application Structure: “WebContent” is applications main folder “index.html” is entry point for application start SAPUI5 Framework is loaded from HANA resources Debugging in Browser (preferred Chrome) Warum als Administrator starten: DLL-Registrierung; Zugriff auf fremden SAP-Prozess Framework einmal kompilieren und dann vergessen Tipps für Visual Studio, zum Beispiel: Resharper Debugging von Framework-Dateien in Client-Solution etc. Prüfen dass addon in SAP läuft Hinweis auf Lizenz, die nicht benötigt wird. Breakpoint setzen und dort anhalten lassen

7. Broker Service development TMC Broker Service C# application Structure BrokerService: main service application BrokerUpdate: automatic update manager Common: General library Configuration: Configuration UI tool ProfileVproTmc: Worker library for TMC synchronization Dependency: WIX: library for building “Setup.msi” SAP HANA Client: for DB connection Nunit: Unit testing Warum als Administrator starten: DLL-Registrierung; Zugriff auf fremden SAP-Prozess Framework einmal kompilieren und dann vergessen Tipps für Visual Studio, zum Beispiel: Resharper Debugging von Framework-Dateien in Client-Solution etc. Prüfen dass addon in SAP läuft Hinweis auf Lizenz, die nicht benötigt wird. Breakpoint setzen und dort anhalten lassen

8. Active Directory integration TMC User Authentication is done by Microsoft Active Directory Federation Services (ADFS) In case to use, additional setup is required HANA > Setup SAML Identity Provider (IdP) https://<your-server-name>:4300/sap/hana/xs/admin Customize Employee User to authenticate via SAML Setup Application Authentication method to SAML ADFS (Active Directory Federation Services) Setup HANA as trusted service provider (SP) Manage users Warum als Administrator starten: DLL-Registrierung; Zugriff auf fremden SAP-Prozess Framework einmal kompilieren und dann vergessen Tipps für Visual Studio, zum Beispiel: Resharper Debugging von Framework-Dateien in Client-Solution etc. Prüfen dass addon in SAP läuft Hinweis auf Lizenz, die nicht benötigt wird. Breakpoint setzen und dort anhalten lassen

Thank you! Questions?