Differences

This shows you the differences between two versions of the page.

--- cobi.wms:architecture [2021/07/21 18:43] – tkammer
+++ cobi.wms:architecture [2023/08/01 05:00] (current) – tkammer
@@ Line 1: / Line 1: @@
-====== COBI.wms Architecture ======
+====== Architecture Overview ======
 The COBI.wms Android app can receive its configuration from various sources, and it can connect to SAP Business One through various methods, as explained in the following sections.
@@ Line 9: / Line 9: @@
 ==== Management Database ====
-In the Settings screen of the app, you can find the tab **Central DB** at the top.  Under this tab, you can enter the IP address (or host-name) of an MS SQL Server or SAP HANA installation, on which you've created the COBI.wms Management Database.  Usually, entering the IP address, database user, and database password should be enough to connect.
+In the Settings screen of the app, you can find the tab **Management DB** at the top.  Under this tab, you can enter the IP address (or host-name) of an MS SQL Server or SAP HANA installation, on which you've created the [[Management Database|COBI.wms Management Database]].
-When you set up the app this way, the actual configuration will be received from the [[Management Database]].  Please see the linked page for details on how to set up and use the COBI.wms Management Database.
+Usually, entering the IP address, database user, and database password should be enough to connect; leave the other fields empty unless really needed.
+When you set up the app this way, the actual configuration will be received from the [[Management Database]].  Please see the linked page for details on how to set it up correctly.
 ==== In-app company list ====
@@ Line 30: / Line 32: @@
 This option should only be used when Service Layer is not available.
+Note that if you're using SAP HANA, you must install [[HANA Proxy]] to allow the app to use direct DB queries.
 ==== Direct DB connection + Service Layer ====
@@ Line 36: / Line 40: @@
 This is the most preferable connection method.  It should be used if a direct database connection can be established (on-premises or private cloud deployment) and Service Layer is available.
+Note that if you're using SAP HANA, you must install [[HANA Proxy]] to allow the app to use direct DB queries.
 ==== Service Layer only ====
-The app will use Service Layer for all communication with SAP Business One.  Reading data through Service Layer does not offer the same performance as direct database queries, so this connection method should only be used when a direct database connection cannot be established.
+In this variant, the app will use Service Layer for all communication with SAP Business One.  Reading data through Service Layer does not offer the same performance as direct database queries, so this connection method should only be used when a direct database connection cannot be established.
+===== Diagrams =====
+The following diagrams might help you in better understanding the architecture of COBI.wms with regard to configuration deployment and SAP Business One connection.
+==== On-premises (or private cloud) with MS SQL Server ====
+{{architecture-onprem-mssql.svg}}
+==== On-premises (or private cloud) with SAP HANA ====
+{{architecture-onprem-hana.svg}}