Mobile ToolkitMobile Toolkit

Troia Platformu, sistem'e rest web service'ler aracılığıyla erişen ve business application katmanında bazı temel function'lar gerçekleştiren "Mobile Toolkit" adlı IOS ve Android için bir mobile application içerir. Bu bölüm, Mobile Toolkit'i tanıtmayı ve nasıl aktive edileceğini açıklamayı amaçlar.Troia Platform includes a mobile application for IOS and Android called “Mobile Toolkit” that access the system via rest web services and performs some basic functions in the business application layer. This section aims to introduce Mobile Toolkit and explaion how to activate it.

Mobile Toolkit Nedir?What is Mobile Toolkit?

Mobile toolkit, BPM process'leri, KPI'lar, calendar management, leave management gibi Canias ERP'nin bazı kişisel function'larını sağlamayı hedefleyen, React Native tabanlı bir mobile application'dır.Mobile toolkit is an React Native based, mobile application that targets to provide some personal functions of Canias ERP such as BPM processes, KPI’s, calendar management, leave management etc.

TROIA Application Server'larıyla, sanki üçüncü taraf bir application'mış gibi restful web service gibi sabit bir interface üzerinden iletişim kurar. Restful service, Mobile Toolkit için hazırlanmış SYSMOBILETOOLKIT adlı bir TROIA class'ını çağırır ve business katmanındaki çeşitli process'leri mobile cihaza aktarır. Mobile Toolkit, diğer business katmanı class'larıyla doğrudan iletişim kurmaz.It communicates with TROIA Application Servers as if it were a third-party application via a fixed interface such as a restful web service. The restful service calls a TROIA class called SYSMOBILETOOLKIT prepared for Mobile Toolkit and transfers various processes in the business layer to the mobile device. Mobile Toolkit does not communicate other business layer classes directly.

İletişim Kanalı: Restful ServiceCommunication Channel: Restful Service

Daha önce belirtildiği gibi, sistem Mobile Toolkit ve application server'lar arasında data aktarırken restful web service'ler kullanır. Bu yüzden kurulumunuzda düzgün çalışan restful web service'leriniz olduğundan kesinlikle emin olmalısınız ve bu service'lerin, client'larınızın Mobile Toolkit kullandığı herhangi bir network environment'ından erişilebilir olması gerekir.As mentioned before, system uses restful web services while transferring data between Mobile Toolkit and application servers.So you must definitely have a properly running restful web services in your installation and these services neet to be accessible from any network environment that your clients uses Mobile Toolkit.

Düzgün çalışan restful web service deployment'ına sahip olmak bu bölümün konusu değildir, ama bir web client deployment'ınız varsa muhtemelen bir restful deployment'ınız vardır. Çünkü restful web service ve web client bir pakettir. Tarayıcınızla {your_webclient_url}/rest/stateless/v1/ url'sini ziyaret ederseniz ve aşağıdaki gibi bir mesaj görürseniz muhtemelen restful service deployment'ınız vardır.To have properly running restful web services deployment is not the subject of this section but if you have an web client deployment you probably have an restfull depoloyment. Because restful web service and web client are a bundle. If you visit a url {your_webclient_url}/rest/stateless/v1/ with your browser and see some message like below probably you have restful service deployment.

{{

"response": "", "response": "",

"error": "service name is missing" "error": "service name is missing"

}}

TROIA restful web service'leri hakkında daha fazla bilgi için lütfen ilgili bölümü okuyun veya sistem danışmanınızla iletişime geçin.For more information about TROIA restful web services please read the related section or contact with your system consultant.

Mobile Toolkit DesteğiMobile Toolkit Support

Mobile Toolkit'i çalıştırmak için, Mobile Toolkit infrastructure'ını destekleyen bir TROIA Platform build'ine sahip olmalısınız. 25.04.20-01'den sonraki build'ler mobile toolkit'i ve gerekli restful service'leri destekler. Build'iniz 25.04.20-01'den eskiyse, önce uygun build'e yükseltmelisiniz.To run Mobile Toolkit, you must have a TROIA Platform build that supports Mobile Toolkit infrastructure. Builds after 25.04.20-01 support mobile toolkit and required restful services. If your build is older than 25.04.20-01, firstly you must upgrade to proper build.

Mobile Toolkit'in ayrıca business katmanı function'ları da vardır, bu yüzden business katmanında bazı gereksinimleri vardır. Canias sürümünüz 9.03'ten eskiyse mobile toolkit'i çalıştırmak mümkün değildir, çünkü 9.03, Mobile Toolkit'i destekleyen ilk Canias sürümüdür. Ayrıca, business katmanı function'larını düzgün çalıştırmak için sisteminizin Canias Module'leri için ilgili business katmanı patch'lerine sahip olması gerekir, çünkü mobile toolkit tarafından istenen data, Canias'ta tanımlanan class'lar tarafından sağlanır. Belirtildiği gibi, en önemli TROIA Katmanı class'ı SYSMOBILETOOLKIT'tir, çünkü mobile cihazınız ve business katmanı application'ları arasında bir tür gateway'dir.Mobile Toolkit has also business layer functions so it has some requirements on business layer. If your Canias version is older than 9.03 it is not possible to run mobile toolkit, because 9.03 is the first Canias version that supports Mobile Toolkit. Additionally, to run business layer functions properly your system must have related business layer patches for Canias Modules, because the data requested by mobile toolkit is provided by classes defined in Canias. As mentioned, the most important TROIA Layer class is SYSMOBILETOOLKIT, because is a kind of gateway between your mobile device and business layer applications.

Mobile Toolkit Nasıl EtkinleştirilirHow to Enable Mobile Toolkit

Mobile Toolkit erişimini etkinleştirmenin iki seviyesi vardır. İlki, application ve server'larınız arasında bir kanal açan Rest URL configuration'ıdır. İkinci seviye user permission'larıyla ilgilidir.Enabling Mobile Toolkit access, there are two levels of operations. First one is Rest URL configuration which opens a channel between the application and your servers. Second level is about user permissions.

Mobile Toolkit URL'ini Configure EtmeConfiguring Mobile Toolkit URL

Restful web service configuration'ınızı etkinleştirdikten sonra, server configuration dosyanızda (bu dosya genellikle "ServerSettings" dosyası olarak adlandırılır) bir mobile toolkit erişim URL'i configure etmeniz gerekir. Bunu yapmak için, server configuration dosyanızın [System] bölümü altına MobileToolkitRestURL keyword'ünü eklemelisiniz. İşte syntax:After enabling your restful web service configuration, you need to configure a mobile toolkit access URL on your server configuration file (this file is usually called “ServerSettings” file). To do this you must add MobileToolkitRestURL keyword under [System] section of your server configuration file. Here is the syntax:

MobileToolkitRestURL = {your_webclient_url}/rest/stateless/v1/?profile={profile_name}MobileToolkitRestURL = {your_webclient_url}/rest/stateless/v1/?profile={profile_name}

URL, Mobile Toolkit'in kullanıldığı herhangi bir network environment'ından erişilebilir olmalıdır. Ve verilen profile ({profile_name}) ismi, web client'ınızdaki client-profiles.cfg dosyanızda tanımlanmalıdır. Lütfen verilen profile'ın Application Server veya Load Balancer adresini doğru içerdiğinden emin olun.URL must be accessible from any network environment that Mobile Toolkit is used on. And given profile ( {profile_name} ) name must be defined in your client-profiles.cfg file in your web client. Please be sure that given profile contains Application Server or Load Balancer addresss correctly.

User Permission'larıUser Permissions

Mobile toolkit erişim url'ini görüntülemek için, kullanıcıların "MOBILETOOLKIT" transaction hakkına sahip olması gerekir. Bu hak, "SYST03 - System Users" transaction'ında kullanıcılar ve profile'lar için tanımlanabilir. Bu yüzden Mobile Toolkit kullanıcılarını, bir application server'dan erişilebilen kullanıcıları, profile'ları ve database'leri dikkate alarak yönetmek mümkündür.To view mobile toolkit access url, users must have “MOBILETOOLKIT” transaction right. This right can be defined for users and profiles on “SYST03 - System Users” transaction. So it is possible to manage Mobile Toolkit users considering users, profiles and databases that can be accessed from an application server.

Mobile Toolkit Mobile Cihazlara Nasıl KurulurHow to Install Mobile Toolkit to Mobile Devices

Application'ı Android cihazlarınız için Google Play'den veya IOS cihazlarınız için Apple Store'dan indirip kurabilirsiniz. Bunu yapmak için bu platformlarda "Canias Mobile Tooolkit" arayabilirsiniz. Ayrıca, ana web ve desktop client'taki Settings-> Mobile Toolkit sayfasındaki link'leri kullanarak veya barkodları tarayarak application'a erişebilirsiniz.You can download and install the application on Google Play for your Android devices, or on Apple Store for your IOS devices. To do this you can search “Canias Mobile Tooolkit” on these platforms. Also, you can access the application by using the links or scanning the barcodes on Settings-> Mobile Toolkit page on main web and desktop client.

Application'ı mobile cihazınıza indirmeniz, sisteminize hemen erişebileceğiniz anlamına gelmez. Application'ı kullanmaya başlamak için, system administrator'ınızın Mobile Toolkit üzerinden bağlanmanıza izin vermesi gerekir.Downloading the app to your mobile device does not mean that you can access your system immediately. To start using the application, your system administrator must allow you to connect via the Mobile Toolkit.

Desktop/web client'ta Settings->Mobile Toolkit tab'ına erişebiliyorsanız ve "Personal Mobile Toolkit Access Code"unuzu QR olarak görüyorsanız, bu mobile toolkit üzerinden erişim izniniz olduğu anlamına gelir. Aksi halde lütfen system administrator'ınızla iletişime geçin.If you can access the Settings->Mobile Toolkit tab on desktop/web client and see your “Personal Mobile Toolkit Access Code” as QR, that means you have access permission via the mobile toolkit. Otherwise please contact with your system administrator.

"Personal Mobile Toolkit Access Code", server'larınızla iletişime geçmek için gerekli bilgiyi içerir, bu yüzden kullanıcıların bu kodu Mobile Toolkit application'ıyla bir kez taraması gerekir. Mobile toolkit, kullanıcıya rehberlik etmek için bazı basit adımlara sahiptir, bu yüzden application'ı kullanmak için application'daki talimatları takip etmek yeterlidir.“Personal Mobile Toolkit Access Code” contains required info to contact with your servers, so users have to scan this code with the Mobile Toolkit application for once. Mobile toolkit has some simple steps to guide the user, so it is enough to follow the instructions on the application to use the application.

Temel Function'lar ve CustomizationBasic Functions and Customization

Mobile Toolkit, business katmanı module'lerinin en çok ihtiyaç duyulan function'larını mobile cihazlarda erişilebilir hale getirmek için tasarlanmıştır. Bu function'lar Canias'ın standart sürümüyle uyumludur ve customer'a özgü customization'lar dahil değildir. Bu function'lar, kullanılan application'ın sürümüne bağlı olarak zamanla değişecektir. Mobile Toolkit'in güncel function'ları için aşağıdaki listeyi inceleyebilirsiniz:Mobile Toolkit is designed to make the most needed functions of the business layer modules accessible on mobile devices. These functions are compatible with the standard version of Canias and customer-specific customizations are not included. These functions will change over time depending on the version of the application used. You can review the list below for the current functions of Mobile Toolkit:

• User Push Notification'larıUser Push Notifications
• KPI List'iKPI List
• BPM Process'leriBPM Processes

Mobile Toolkit üzerinde UI, temel işlevsellik gibi herhangi bir seviyede customization yapmak mümkün değildir.It is not possible to make customizations on Mobile Toolkit for any level such as UI, basic functionality etc.