Skip to content

Commit e41bfe4

Browse files
I545182I545182
committed
ssam app create 260226.0002
1 parent 7b62366 commit e41bfe4

1 file changed

Lines changed: 47 additions & 52 deletions

File tree

‎tutorials/mob-app-mao-erp-app-create/mob-app-mao-erp-app-create.md‎

Lines changed: 47 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ In this mission you will learn how to create and update an SAP Mobile Services a
4646

4747
1. Execute the transaction **`/MERP/CPMS_APPCREATE`** from the SAP GUI, then select your required variant (i.e., `SAP&SAM_<version>`).
4848

49-
2. Fill in the **Admin API**, **SCC Location Id** and **Virtual Host**. Please ensure the **Background Job User** will maintain authorization to run the Usage Metering background job (parameter info below). To use an RFC Destination to create the app instead of the **Admin API** please see Step 4 (optional). The app is created as the Metrics Host by default, to set up the app as the Metrics Sattelite please see Step 7. Then execute the transaction.
49+
2. Fill in the **Admin API**, **SCC Location Id** and **Virtual Host**. Please ensure the **Background Job User** will maintain authorization to run the Usage Metering background job (parameter info below). To use an RFC Destination to create the app instead of the **Admin API** please see Step 4 (optional). The app is created as the Metrics Host by default, to set up the app as the Metrics Satellite please see Step 6. Then execute the transaction.
5050

5151
![SelScreen](selscreen.png)
5252

@@ -67,7 +67,7 @@ In this mission you will learn how to create and update an SAP Mobile Services a
6767
| **Client** | Used to set `sap-client` header for Mobile Services Mobile Destinations. Defaulted to current System Client. |
6868
| **Background Job User** | Used to schedule the Usage Metering background job with a daily frequency. If no user is provided, then the user executing the transaction is used. Please ensure the **Background Job User** will maintain authorization to run the background job. |
6969
| **Client Role** | Used by the Metrics report to determine user counts (i.e., 0 user counts sent for non-productive systems). Defaulted to System Client Role defined in transaction SCC4. Stored in MAIF Product Table. |
70-
| **Satellite System** | See step X to use Satellite Systems. |
70+
| **Satellite System** | See Step 6 to use Satellite Systems. |
7171

7272
>**WARNING:** Any change that may affect the offline configuration (e.g., a new entity type is added to your mobile app configuration, or the **Defer Batch Response** setting is changed for the **OData Service Technical Name** provided when generating the offline configuration) will require you to update the offline configuration in Mobile Services and reset your mobile app. See Step 2.5 to update.
7373
@@ -126,60 +126,59 @@ In this mission you will learn how to create and update an SAP Mobile Services a
126126
| :-----------| :----------- |
127127
| `sap-client` | Your client (i.e., **`800`**) |
128128

129-
5. From your app's **Mobile Connectivity** feature, select the **Service Keys** tab. You should see a Service Key with the properties below. The Key should be automatically maintained as the `X-API-Key` property in the Additional Properties of the Usage Metering Middleware Server which we will review in Step 3.7.
129+
5. From your app's **Mobile Connectivity** feature, select the **Service Keys** tab. You should see a Service Key with the properties below. The Key should be automatically maintained as the `X-API-Key` property in the Additional Properties of the Usage Metering Middleware Server which we will review in Step 3.9.
130130

131-
| Field Name | Value |
132-
| :--------- | :------------------------------------------ |
133-
| Alias | **`<system><client>`** (i.e., **`PRD001`**) |
134-
| Roles | **`sap_application_metering`** |
135-
| Type | **`API Key`** |
131+
| Field Name | Value |
132+
| :--------- | :---- |
133+
| Alias | **`<system><client>`** (i.e., **`PRD001`**) |
134+
| Roles | **`sap_application_metering`** |
135+
| Type | **`API Key`** |
136136

137-
6. From your app's overview screen, if you select the **Offline Access** feature you should be able to display and edit the offline configuration. If the offline configuration is missing, then please see Step 7.
137+
6. From your app's overview screen, if you select the **Offline Access** feature you should be able to display and edit the offline configuration. If the offline configuration is missing, then please see Step 8.
138138

139139
7. From your app's overview screen, select the **APIs** tab to view the onboarding QR code which you can scan from the SAP Service and Asset Manager mobile app.
140140

141141
8. We will now check the Usage Metering Middleware Server. Execute transaction **/SYCLO/ADMIN** from the SAP GUI to open up the MAIF Admin Panel. Navigate to **Administration** > **Server Management**. Select the Middleware Server with the name noted in Step 2.4. If the Usage Metering Middleware Server is missing then please see Step 8.
142142

143143
![MDW](mdw.png)
144144

145-
9. Verify that the Middleware Server has the following **Basic Info** and **Additional Properties**. If the Middleware Server's **Basic Info** or **Additional Properties** are not as expected then please see Step 8.
145+
9. Verify that the Middleware Server has the following **Basic Info** and **Additional Properties**. If the Middleware Server's **Basic Info** or **Additional Properties** are not as expected then please see Step 9.
146146

147147
**Basic Info**
148148

149149
![MDWBasicInfo](mdwbasicinfo.png)
150150

151-
| Field Name | Value |
152-
| :--------------------- | -------------------------------------------------- |
153-
| Mobile Application | **`<mobile_app>`** |
154-
| Server Name | **`<ms_app_id>_MS_UNIFIED_SERVER`** |
155-
| `Middleware Svr SerNo` | **`SCP`** |
156-
| Server GUID | **`<autogenerated_guid>`** |
157-
| Port | **`00443`** |
158-
| UI Host Name | **`https://example.cfapps.sap.hana.ondemand.com`** |
151+
| Field Name | Value |
152+
| :--------- | ----- |
153+
| Mobile Application | **`<mobile_app>`** |
154+
| Server Name | **`<ms_app_id>_MS_UNIFIED_SERVER`** |
155+
| `Middleware Svr SerNo` | **`SCP`** |
156+
| Server GUID | **`<autogenerated_guid>`** |
157+
| Port | **`00443`** |
158+
| UI Host Name | **`https://example.cfapps.sap.hana.ondemand.com`** |
159159

160160
**Additional Properties**
161161

162162
![MDWAdditionalProperties](mdwadditionalproperties.png)
163163

164-
| Property Group | Property Name | Property Value |
165-
| :------------- | :----------------- | :----------------------------------------- |
166-
| **`METERING`** | **`Host`** | **`X`** |
167-
| **`METERING`** | **`X-API-Key`** | **`<autogenerated_key>`** |
164+
| Property Group | Property Name | Property Value |
165+
| :------------- | :------------ | :------------- |
166+
| **`METERING`** | **`Host`** | **`X`** |
167+
| **`METERING`** | **`X-API-Key`** | **`<autogenerated_key>`** |
168168
| **`METERING`** | **`service_path`** | **`/mobileservices/service-key/metering`** |
169169

170-
10. To verify that the Usage Metering Background Job is scheduled, please execute transaction **SM37** from the SAP GUI and search for the job name noted in Step 2.4. If the background job is missing, then please see Step 9.
171-
170+
10. To verify that the Usage Metering Background Job is scheduled, please execute transaction **SM37** from the SAP GUI and search for the job name noted in Step 2.4. If the background job is missing, then please see Step 10.
172171
![SM37](sm37.png)
173172

174173
11. Execute transaction **/SYCLO/CONFIGPANEL** from the SAP GUI to open up the MAIF Configuraiton Panel. Navigate to **Mobile Application Configuration** > **System Components**. You should see a system component with the properties below.
175174

176175
![SystemComponent](syscomp.png)
177176

178-
| Field Name | Value |
179-
| :--------------- | :---------------------- |
177+
| Field Name | Value |
178+
| :--------- | :---- |
180179
| System Component | **`MS_UNIFIED_SERVER`** |
181-
| System Role | **`Host`** |
182-
| Active Flag | Selected |
180+
| System Role | **`Host`** |
181+
| Active Flag | Selected |
183182

184183
12. To ensure the Metrics Requests are sent successfully execute transaction **SE38** and execute program **`/MFND/CORE_CLOUD_METRICS_PROG`**. Provide `SAP_SERVICE_ASSET_MANAGER` in `Product Technical Name` and execute.
185184

@@ -214,11 +213,11 @@ In this mission you will learn how to create and update an SAP Mobile Services a
214213

215214
**Admin API:** `https://mobile-service-cockpit-example.sap.hana.ondemand.com/cockpit/v1/org/ExampleOrg/space/ExampleSpace`
216215

217-
| Field Name | Value |
218-
| :---------------- | :--------------------------------------------------------- |
219-
| Target Host | **`mobile-service-cockpit-example.sap.hana.ondemand.com`** |
220-
| Service No.(Port) | **`443`** |
221-
| Path Prefix | **`/cockpit/v1/org/ExampleOrg/space/ExampleSpace/app`** |
216+
| Field Name | Value |
217+
| :--------- | :---- |
218+
| Target Host | **`mobile-service-cockpit-example.sap.hana.ondemand.com`** |
219+
| Service No.(Port) | **`443`** |
220+
| Path Prefix | **`/cockpit/v1/org/ExampleOrg/space/ExampleSpace/app`** |
222221

223222
>**HTTP Proxy Options** are available in the RFC Destination Technical Settings if required.
224223
@@ -242,14 +241,14 @@ In this mission you will learn how to create and update an SAP Mobile Services a
242241

243242
![MDWCreate](mdwcreate.png)
244243

245-
| Field Name | Value |
246-
| :--------------------- | :------------------------- |
247-
| Mobile Application | **`<mobile_app>`** |
248-
| Server Name | **`Z_MS_ADMIN_API`** |
249-
| Server GUID | **`<autogenerated_guid>`** |
250-
| Port | **`07003`** |
251-
| `Middleware Svr SerNo` | **`SCP`** |
252-
| RFC Destination | **`Z_MS_ADMIN_API`** |
244+
| Field Name | Value |
245+
| :--------- | :---- |
246+
| Mobile Application | **`<mobile_app>`** |
247+
| Server Name | **`Z_MS_ADMIN_API`** |
248+
| Server GUID | **`<autogenerated_guid>`** |
249+
| Port | **`07003`** |
250+
| `Middleware Svr SerNo` | **`SCP`** |
251+
| RFC Destination | **`Z_MS_ADMIN_API`** |
253252

254253
10. You may now use the generated **Server GUID** instead of the **Admin API** in Step 2.2 . You may use F4 Help on the **Admin API or Middleware Server GUID** field of the MS App Create transaction to search for the created Middleware Server.
255254

@@ -285,27 +284,27 @@ In this mission you will learn how to create and update an SAP Mobile Services a
285284

286285
7. Navigate to the **Administration** > **Server Management** section.
287286

288-
8. Select the Middleware Server with the name noted in Step 2.4. If the Usage Metering Middleware Server is missing then please see Step 8.
287+
8. Select the Middleware Server with the name noted in Step 2.4. If the Usage Metering Middleware Server is missing then please see Step 9.
289288

290289
9. Update the **RFC Destination** and click **Save**.
291290

292291
![MDWMetering](mdwmetering.png)
293292

294293
### Optional Feature 3 - Set up Satellite Systems
295294

296-
1. Please ensure app has been created and reviewed (steps 2 and 3) in the host system.
295+
1. Please ensure app has been created and reviewed (Steps 2 and 3) in the Host System.
297296

298-
2. Please follow steps 1 and 2.1 then return to this step. Check `Sattelite System`. The `Host RFC Destination` may be provided to create middleware server in the host system used to get the metrics from the sattelite system. If you do not provide the `Host RFC Destination` please ensure you manually create the middleware server in the host system.
297+
2. Follow Steps 1 and 2 and Check `Satellite System` before executing. The `Host RFC Destination` may be provided to create middleware server in the Host System used to get the metrics from the Satellite System. If you do not provide the `Host RFC Destination` please ensure you manually create the middleware server in the Host System.
299298

300299
![SatelliteSettings](satsettings.png)
301300

302-
3. Please take note of the **Middleware Server** created on the host system with RFC.
301+
3. Please take note of the **Middleware Server** created on the Host System with RFC.
303302

304303
![SatelliteOutput](satoutput.png)
305304

306-
4. Execute transaction **/SYCLO/ADMIN** from the SAP GUI to open up the MAIF Admin Panel. Navigate to the **Administration** > **Server Management** section.
305+
4. In the Host System execute transaction **/SYCLO/ADMIN** from the SAP GUI to open up the MAIF Admin Panel. Navigate to the **Administration** > **Server Management** section.
307306

308-
5. Select Middleware Server noted above. Manually create Satellite Middleware Server if not created automatically via RFC in the previous step. Edit the middleware server and provide an RFC Destination to the Satellite System.
307+
5. Select Middleware Server noted above. Create Satellite Middleware Server if not created automatically via RFC in the previous step. Edit the middleware server and provide an RFC Destination to the Satellite System. Ensure the RFC authentication is automatic.
309308

310309
**Basic Info**
311310

@@ -331,15 +330,11 @@ In this mission you will learn how to create and update an SAP Mobile Services a
331330
| **`METERING`** | **`X-API-Key`** | **`<autogenerated_key>`** |
332331
| **`METERING`** | **`service_path`** | **`/mobileservices/service-key/metering`** |
333332

334-
12. To ensure the Satellite Metrics are gathered successfully execute transaction **SE38** and execute program **`/MFND/CORE_CLOUD_METRICS_PROG`** in the host system. Provide `SAP_SERVICE_ASSET_MANAGER` in `Product Technical Name` and execute.
333+
12. To ensure the Satellite Metrics are gathered successfully execute transaction **SE38** and execute program **`/MFND/CORE_CLOUD_METRICS_PROG`** in the Host System. Provide `SAP_SERVICE_ASSET_MANAGER` in `Product Technical Name` and execute.
335334

336335
**Successful Output**
337336
![SatMetricOutput](satmetricoutput.png)
338337

339-
13. If Satellite RFC Destination authorization is not automatic, please sign into satellite system when prompted.
340-
341-
13. Upon successful execution, we can check the MAIF Product Table in the satellite system. Execute transaction **SE16** and display table `/SMFND/D_SAPPROD`. Check field `HAS_METER_SERV` is set and field `METER_SERV_TS` is updated.
342-
343338
### Optional Feature 3 - Enable Multiple Threads in Offline Configuration
344339

345340
1. Follow Step 2.1 and 2.2 then return to this Step before executing. Then click **Advanced Mode**.

0 commit comments

Comments
 (0)