Skip to content

Commit ed6f022

Browse files
authored
Merge branch 'sap-tutorials:master' into master
2 parents 6009d54 + e81577b commit ed6f022

File tree

158 files changed

+944
-283
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

158 files changed

+944
-283
lines changed
Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
scikit-learn==0.24.2
2-
joblib==1.0.1
3-
Flask==2.0.1
2+
joblib==1.1.1
3+
Flask==2.3.2
44
gunicorn==20.1.0

tutorials/appgyver-configure-camera/appgyver-configure-camera.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -99,3 +99,6 @@ As an example:
9999

100100
![View results](iphoneapp3.png)
101101

102+
If you can't find a barcode, here's an example:
103+
104+
![Barcode example](barcode.gif)
3.29 KB
Loading

tutorials/appgyver-connect-publicapi/appgyver-connect-publicapi.md

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -47,9 +47,7 @@ Open your draft application in the Composer account.
4747
| **Short description** | Data from Open Food Facts API |
4848
| **Resource URL** | <https://world.openfoodfacts.org/api/v0> |
4949

50-
4. Click **Save**, saving the data resource.
51-
52-
![Enter data resource information](Enter_data_resource.png)
50+
![Enter data resource information](Enter_data_resource.png)
5351

5452

5553
### Configure Get Record data
@@ -62,7 +60,7 @@ You now need to configure which information is taken from the Open Food Facts AP
6260

6361
![Configure relative path field](Configure_path.png)
6462

65-
3. Click the existing **URL placeholder key**, and then configure the following settings:
63+
3. Click the existing **URL placeholder**,(`id`) and then configure the following settings:
6664

6765
| Field | Value |
6866
|-------|-------|
@@ -79,7 +77,7 @@ You now need to configure which information is taken from the Open Food Facts AP
7977

8078
### Test data sources
8179

82-
1. To now test that the HTTPS is configured and able to fetch information, click **Test**.
80+
1. To now test that the data resource is configured properly and able to fetch information, click the **Test** tab.
8381

8482
![Test configuration](test_config.png)
8583

@@ -99,7 +97,7 @@ You now need to configure which information is taken from the Open Food Facts AP
9997

10098
![Click to run test](Run_test.png)
10199

102-
The test now runs, displaying a Test API call response. In this response, you can see information about the confectionary. This includes the product categories, allergen information, and the brand who manufactured the product.
100+
The test now runs, displaying a test API call response. In this response, you can see information about the product. This includes the product categories, allergen information, and the brand who manufactured the product.
103101

104102
![View the results](test_results.png)
105103

@@ -113,7 +111,7 @@ To do this, click **Set Schema from Response**.
113111

114112
![Link text e.g., Destination screen](set_schema.png)
115113

116-
Click **Save**.
114+
Click **Save Data Entity** (bottom right), and then click **Save** (upper right).
117115

118116
![Link text e.g., Destination screen](save_response.png)
119117

tutorials/appgyver-create-application/appgyver-create-application.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ Click the existing **Headline** field and edit the text to read: `Barcode Scann
8484

8585
![Edit UI Headline](EditHeadline.png)
8686

87-
Click the **Paragraph** field and edit the text to read: `Scan a barcode of a food product using your smartphone`
87+
Click the **Paragraph** (Text) field and edit the text to read: `Scan a barcode of a food product using your smartphone`
8888

8989
![Barcode Scanner](BarcodeScanner.png)
9090

@@ -94,7 +94,7 @@ Click the **Paragraph** field and edit the text to read: `Scan a barcode of a fo
9494

9595
Next, you'll need to add a Scan button which, when tapped, will open the camera device on your smartphone.
9696

97-
To do this, locate the **Button** component (found under **Core > Forms**) and drag and drop this underneath the paragraph field.
97+
To do this, locate the **Button** component (found under **Core > Forms**) and drag and drop this underneath the paragraph/text field.
9898

9999
![Adding a button](AddButton.png)
100100

tutorials/cp-aibus-dar-swagger-ior-model/cp-aibus-dar-swagger-ior-model.md

Lines changed: 24 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,11 @@ author_name: Juliana Morais
88
author_profile: https://github.com/Juliana-Morais
99
---
1010

11-
# Use the Invoice Object Recommendation Business Blueprint to Train a Machine Learning Model
12-
<!-- description --> Train a machine learning model for the Data Attribute Recommendation service, using the Invoice Object Recommendation business blueprint.
11+
# Use the Invoice Object Recommendation (IOR) Business Blueprint to Train a Machine Learning Model
12+
<!-- description --> Train a machine learning model for the Data Attribute Recommendation service, using the Invoice Object Recommendation (IOR) business blueprint.
1313

1414
## You will learn
15-
- How to train a machine learning model using the Invoice Object Recommendation business blueprint
15+
- How to train a machine learning model using the Invoice Object Recommendation (IOR) business blueprint
1616
- How to deploy a machine learning model to get financial object predictions
1717

1818
---
@@ -22,15 +22,15 @@ author_profile: https://github.com/Juliana-Morais
2222

2323
In the service key you created for Data Attribute Recommendation in the previous tutorial: [Use Free Tier to Set Up Account for Data Attribute Recommendation and Get Service Key](cp-aibus-dar-booster-free-key) or [Use Trial to Set Up Account for Data Attribute Recommendation and Get Service Key](cp-aibus-dar-booster-key), you find a section called `swagger` (as highlighted in the image below) with three entries, called `dm` (data manager), `mm` (model manager) and `inference`.
2424

25-
<!-- border -->![Service Key](png-files/service-key-details.png)
25+
<!-- border -->![Service Key](service-key-details.png)
2626

2727
For this tutorial, copy the URL of the Swagger UI for `mm` and open it in a browser tab. The Swagger UI for the model manager allows you to train a machine learning model, to delete it, to deploy the model as well as to `undeploy` the model.
2828

29-
>After finishing this tutorial, keep the Swagger UI for `mm` open to perform the clean up tasks in [Use the Invoice Object Recommendation Business Blueprint to Predict Financial Objects](cp-aibus-dar-swagger-ior-predict).
29+
>After finishing this tutorial, keep the Swagger UI for `mm` open to perform the clean up tasks in [Use the Invoice Object Recommendation (IOR) Business Blueprint to Predict Financial Objects](cp-aibus-dar-swagger-ior-predict).
3030
3131
1. To be able to use the Swagger UI endpoints, you need to authorize yourself. In the top right corner, click **Authorize**.
3232

33-
<!-- border -->![Authorize](png-files/swagger-authorize.png)
33+
<!-- border -->![Authorize](swagger-authorize.png)
3434

3535
2. Get the `access_token` value created in the previous tutorial: [Get OAuth Access Token for Data Attribute Recommendation Using Any Web Browser](cp-aibus-dar-web-oauth-token), then add **Bearer** (with capitalized "B") in front of it, and enter in the **Value** field.
3636

@@ -40,32 +40,32 @@ For this tutorial, copy the URL of the Swagger UI for `mm` and open it in a brow
4040
4141
3. Click **Authorize** and then click **Close**.
4242
43-
<!-- border -->![Authorize](png-files/swagger-token.png)
43+
<!-- border -->![Authorize](swagger-token.png)
4444
4545
4646
4747
### Create a training job
4848
4949
50-
To train a machine learning model using the data that you uploaded in [Use an Invoice Object Recommendation Dataset Schema to Upload Training Data to Data Attribute Recommendation](cp-aibus-dar-swagger-ior-upload), you create a training job.
50+
To train a machine learning model using the data that you uploaded in [Use an Invoice Object Recommendation (IOR) Dataset Schema to Upload Training Data to Data Attribute Recommendation](cp-aibus-dar-swagger-ior-upload), you create a training job.
5151
52-
With each training job you provide a model template or a business blueprint which combines data processing rules and machine learning model architecture. You can find the list of available model templates [here](https://help.sap.com/docs/Data_Attribute_Recommendation/105bcfd88921418e8c29b24a7a402ec3/1e76e8c636974a06967552c05d40e066.html). The only business blueprint currently available is Invoice Object Recommendation, as you can see [here](https://help.sap.com/docs/Data_Attribute_Recommendation/105bcfd88921418e8c29b24a7a402ec3/091eace025e14793be0e83ef2109b349.html).
52+
With each training job you provide a model template or a business blueprint which combines data processing rules and machine learning model architecture. You can find the list of available model templates [here](https://help.sap.com/docs/Data_Attribute_Recommendation/105bcfd88921418e8c29b24a7a402ec3/1e76e8c636974a06967552c05d40e066.html), and the list of available business blueprints [here](https://help.sap.com/docs/Data_Attribute_Recommendation/105bcfd88921418e8c29b24a7a402ec3/091eace025e14793be0e83ef2109b349.html).
5353
54-
The Invoice Object Recommendation business blueprint that you use in this tutorial is suited to assign G/L (general ledger) accounts and other financial objects to incoming invoices without a purchase order reference.
54+
The Invoice Object Recommendation (IOR) business blueprint that you use in this tutorial is suited to assign G/L (general ledger) accounts and other financial objects to incoming invoices without a purchase order reference.
5555
5656
To create the training job, proceed as follows:
5757
5858
1. Expand the endpoint **POST /jobs** by clicking on it. Then click **Try it out**.
5959
60-
<!-- border -->![Training Job Endpoint](png-files/job-endpoint.png)
60+
<!-- border -->![Training Job Endpoint](job-endpoint.png)
6161
62-
2. In the text area, replace the parameter value for `datasetId` with the `id` of your dataset that you have created in [Use an Invoice Object Recommendation Dataset Schema to Upload Training Data to Data Attribute Recommendation](cp-aibus-dar-swagger-ior-upload). Delete the `modelTemplateId` line from the **Request body**. Replace the parameter value `modelName` with your model name, `ior_tutorial_model`, for example. Make sure the parameter value for `businessBlueprintId` is `4788254b-0bad-4757-a67f-92d5b55f322d`. Click **Execute** to create the training job.
62+
2. In the text area, replace the parameter value for `datasetId` with the `id` of your dataset that you have created in [Use an Invoice Object Recommendation (IOR) Dataset Schema to Upload Training Data to Data Attribute Recommendation](cp-aibus-dar-swagger-ior-upload). Delete the `modelTemplateId` line from the **Request body**. Replace the parameter value `modelName` with your model name, `ior_tutorial_model`, for example. Make sure the parameter value for `businessBlueprintId` is `4788254b-0bad-4757-a67f-92d5b55f322d`. Click **Execute** to create the training job.
6363
64-
<!-- border -->![Training Job Execute](png-files/job-execute.png)
64+
<!-- border -->![Training Job Execute](job-execute.png)
6565
6666
3. In the response of the service, you find the `id` of your training job. Copy the `id` as you'll need it in the next step. Along side the `id`, you find the training job's current status. Initially, the status is `PENDING` which says that the training job is in queue but has not started yet.
6767
68-
<!-- border -->![Training Job Response](png-files/job-response.png)
68+
<!-- border -->![Training Job Response](job-response.png)
6969
7070
You have successfully created a training job.
7171
@@ -78,15 +78,15 @@ To know when your training job has ended, you have to frequently check its statu
7878
7979
1. Expand the endpoint `GET /jobs/{jobId}` by clicking on it. Then click **Try it out**.
8080
81-
<!-- border -->![Training Job Status Endpoint](png-files/job-status-endpoint.png)
81+
<!-- border -->![Training Job Status Endpoint](job-status-endpoint.png)
8282
8383
2. Fill the parameter `jobId` with `id` of your training job that you copied in the previous step. Click **Execute**.
8484
85-
<!-- border -->![Training Job Status Execute](png-files/job-status-execute.png)
85+
<!-- border -->![Training Job Status Execute](job-status-execute.png)
8686
8787
3. In the response, you find again the current status of your training job along with other details. Immediately after creation of the training job, the status is `PENDING`. Shortly after, it changes to `RUNNING` which means that the model is being trained. The training of the sample data usually takes about 5 minutes to complete but may run longer, up to a few hours due to limited availability of resources in the free tier environment. You can check the status every now and then. Once training is finished, the status changes to `SUCCEEDED` which means the service has created a machine learning model and you can proceed.
8888
89-
<!-- border -->![Training Job Status Response](png-files/job-status-response.png)
89+
<!-- border -->![Training Job Status Response](job-status-response.png)
9090
9191
You have successfully trained a machine learning model.
9292
@@ -99,15 +99,15 @@ To use the trained model, you need to deploy it. Once deployed, the model is rea
9999
100100
1. Expand the endpoint `POST /deployments` by clicking on it. Then click **Try it out**.
101101
102-
<!-- border -->![Deployment Endpoint](png-files/deploy-endpoint.png)
102+
<!-- border -->![Deployment Endpoint](deploy-endpoint.png)
103103
104104
2. In the text area, replace the parameter `modelName` with the name of your model (`ior_tutorial_model`). Click **Execute** to deploy the model.
105105
106-
<!-- border -->![Deployment Execute](png-files/deploy-execute.png)
106+
<!-- border -->![Deployment Execute](deploy-execute.png)
107107
108108
3. In the response of the service, you find the `id` of the deployment and its status. Initially, the status is `PENDING`, indicating the deployment is in progress. Make sure to copy the `id` as you need it in the next step.
109109
110-
<!-- border -->![Deployment Response](png-files/deploy-response.png)
110+
<!-- border -->![Deployment Response](deploy-response.png)
111111
112112
113113
@@ -118,16 +118,14 @@ Finally, you have to ensure that your model is deployed successfully in order to
118118
119119
1. Expand the endpoint `GET /deployments/{id}` by clicking on it. Then click **Try it out**.
120120
121-
<!-- border -->![Deployment Status Endpoint](png-files/deploy-status-endpoint.png)
121+
<!-- border -->![Deployment Status Endpoint](deploy-status-endpoint.png)
122122
123123
2. Fill the parameter `deploymentId` with the `id` of your deployment that you copied in the previous step. Click **Execute**.
124124
125-
<!-- border -->![Deployment Status Execute](png-files/deploy-status-execute.png)
125+
<!-- border -->![Deployment Status Execute](deploy-status-execute.png)
126126
127127
3. In the response of the service, you find the current status of the deployment. If the status is `SUCCEEDED`, your deployment is done. If the status is still `PENDING`, check back in a few minutes.
128128
129-
<!-- border -->![Deployment Status Execute](png-files/deploy-status-response.png)
130-
131-
You have successfully trained a machine learning model and deployed it. Next, you'll use your model to make predictions.
132-
129+
<!-- border -->![Deployment Status Execute](deploy-status-response.png)
133130
131+
You have successfully trained a machine learning model and deployed it. Next, you'll use your model to make predictions.

0 commit comments

Comments
 (0)