Skip to content

Commit 74ab0b3

Browse files
committed
Replace username with display name
1 parent 3f2c7cf commit 74ab0b3

File tree

14 files changed

+908
-39
lines changed

14 files changed

+908
-39
lines changed

assets/codejam-exercises.drawio

Lines changed: 7 additions & 7 deletions
Large diffs are not rendered by default.

exercises/05-explore-aem/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ So far, we've learned about events in the SAP ecosystem, CloudEvents and the dif
77
Let's log in to the SAP Integration Suite, advanced event mesh instance that we've made available for the event.
88
> 🔐 Your instructor will provide you with the details to access the SAP Integration Suite, advanced event mesh instance.
99
10-
👉 Navigate to the instance URL provided, e.g. `https://[region].console.pubsub.em.services.cloud.sap/login?tenant-id=[our-tenant-id]`, and enter the user credentials provided to you, e.g. `EDI-[country]-[your-sap-community-username]@sap.com`.
10+
👉 Navigate to the instance URL provided, e.g. `https://[region].console.pubsub.em.services.cloud.sap/login?tenant-id=[our-tenant-id]`, and enter the user credentials provided to you, e.g. `EDI-[country]-[your-sap-community-display-name]@sap.com`.
1111

1212
<p align = "center">
1313
<img alt="AEM start page" src="assets/aem-start-page.png" width="90%"/><br/>

exercises/06-publish-and-subscribe-events/README.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Example: `sap/S4HANAOD/E4L/ce/sap/s4/beh/businesspartner/v1/BusinessPartner/Crea
2121
- */v1*: Version of the message. If a new version of the message is made available, e.g. adding new fields to the payload, then this will change.
2222

2323
> [!NOTE]
24-
> In our case, we've defined levels on our topic string based on the week, SAP Community username and action, e.g. `codejam/edi/ce/ajmaradiaga/notification`.
24+
> In our case, we've defined levels on our topic string based on the week, SAP Community display name and action, e.g. `codejam/edi/ce/ajmaradiaga/notification`.
2525
2626
Now, by knowing the topic on which a message type will be published, we can create a consumer program/service that subscribes to the topic directly and processes the messages sent to it. Generally, you can subscribe to a topic by specifying the entire topic string when establishing the connection, e.g. *sap/S4HANAOD/E4L/ce/sap/s4/beh/businesspartner/v1/BusinessPartner/Created/v1*. But what if we want to subscribe to all actions (Created, Updated, Deleted) that occur on a BusinessPartner object? Luckily, in the case of SAP Integration Suite, advanced event mesh we can subscribe to the topic by using wildcards (\*). For example, by subscribing to the topic sap/S4HANAOD/E4L/ce/sap/s4/beh/businesspartner/v1/BusinessPartner/*/v1 I will be able to get all messages for different actions (Created, Updated, Deleted) whose version is v1. In AEM, the > character can be used at the last level of a subscription to indicate a "one or more" wildcard match for any topics, e.g. by subscribing to the topic *sap/S4HANAOD/E4L/ce/sap/s4/beh/>* will bring all objects that are published under that prefix, independent of type, action, and version.
2727

@@ -65,8 +65,8 @@ In AEM there is a concept of a Topic Endpoint. A Topic Endpoint is a durable sto
6565
We published a simple event in the previous exercise by using the `Try Me!` page in the `EU-North-Broker` event broker service. Let's now explore another mechanism to exchange messages with our event broker. By the end of this exercise we will achieve a communication scenario like the one below. Enter the `Try Me!`.
6666

6767
<p align = "center">
68-
<img alt="Publish and subscribe to the codejam/edi/ce/[your-sap-community-username]/tickets/Created topic" src="assets/codejam-exercises-Exercise6 - AdvancedTryMe.png" width="70%"/><br/>
69-
<i>Publish/subscribe to the codejam/edi/ce/[your-sap-community-username]/tickets/Created topic</i>
68+
<img alt="Publish and subscribe to the codejam/edi/ce/[your-sap-community-display-name]/tickets/Created topic" src="assets/codejam-exercises-Exercise6 - AdvancedTryMe.png" width="70%"/><br/>
69+
<i>Publish/subscribe to the codejam/edi/ce/[your-sap-community-display-name]/tickets/Created topic</i>
7070
</p>
7171

7272
👉 Navigate to the `EU-North-Broker` event broker service and click the `Open Broker manager` link. On the right-hand side, click the `Try Me!` link. Here you can not just publish and subscribe to topics but we can also interact with queues in the event broker.
@@ -93,7 +93,7 @@ Now, we've got the connection details that we need to configure in the `Try Me!`
9393
<i>Try Me! - Connect</i>
9494
</p>
9595

96-
We have connected the Publisher section to the event broker service. Now, let's publish an event on a topic. We will use the `codejam/edi/ce/[your-sap-community-username]/tickets/Created` topic and the payload below.
96+
We have connected the Publisher section to the event broker service. Now, let's publish an event on a topic. We will use the `codejam/edi/ce/[your-sap-community-display-name]/tickets/Created` topic and the payload below.
9797

9898
```json
9999
{
@@ -124,7 +124,7 @@ We have connected the Publisher section to the event broker service. Now, let's
124124
}
125125
```
126126

127-
👉 Replace the `[your-sap-community-username]` value in the topic example above, with your SAP Community username, and set it as the topic, e.g. `codejam/edi/ce/ajmaradiaga/tickets/Created`. Copy the JSON payload above and publish the message by clicking the `Publish` button.
127+
👉 Replace the `[your-sap-community-display-name]` value in the topic example above, with your SAP Community display name, and set it as the topic, e.g. `codejam/edi/ce/ajmaradiaga/tickets/Created`. Copy the JSON payload above and publish the message by clicking the `Publish` button.
128128

129129
<p align = "center">
130130
<img alt="Try Me! - Publish" src="assets/advanced-try-me-publish.png" width="100%"/><br/>
@@ -137,7 +137,7 @@ Ok, we've published the message but it doesn't seem like much has happened. Apar
137137

138138
We've successfully connected the publisher section to the event broker by providing the ***Solace Web Messaging*** credentials. Let's now connect the subscriber section. In this case, we can reuse the same details used for the publisher.
139139

140-
👉 Click the `Connect` button in the Subscriber section and subscribe to the `codejam/edi/ce/[your-sap-community-username]/tickets/Created` topic. Once subscribed publish the message again.
140+
👉 Click the `Connect` button in the Subscriber section and subscribe to the `codejam/edi/ce/[your-sap-community-display-name]/tickets/Created` topic. Once subscribed publish the message again.
141141

142142
<p align = "center">
143143
<img alt="Try Me! - Subscribe" src="assets/advanced-try-me-subscribe.gif" width="90%"/><br/>
@@ -153,7 +153,7 @@ As explained previously, we can subscribe to a topic directly and so far we've c
153153
> [!IMPORTANT]
154154
> 🚨 Before we create a queue, make sure you open the `Queues` link in a new tab, so that you don't have to re-enter the credentials in the `Try Me!` page and connect again to the event broker.
155155
156-
👉 Select the `Queues` link on the right-hand side to see the queues in the event broker service. Click the `+ Queue` button and enter a name, e.g. `codejam_edi_ce_[your-sap-community-username]_tickets`. Leave the default settings and add as a subscription the following: `codejam/edi/ce/[your-sap-community-username]/tickets/*`.
156+
👉 Select the `Queues` link on the right-hand side to see the queues in the event broker service. Click the `+ Queue` button and enter a name, e.g. `codejam_edi_ce_[your-sap-community-display-name]_tickets`. Leave the default settings and add as a subscription the following: `codejam/edi/ce/[your-sap-community-display-name]/tickets/*`.
157157

158158
> [!NOTE]
159159
> You'll notice that we are "adding levels" in the queue name. This is not really necessary and similar to topic names, it is a string and it can be anything. We are just following a pattern to make it easier to understand what the queue is for.
@@ -167,7 +167,7 @@ As explained previously, we can subscribe to a topic directly and so far we've c
167167

168168
Now that we have created a queue, let's subscribe to it in the `Try Me!` page.
169169

170-
👉 Click the `Connect` button in the Subscriber section. It should grab the ***Solace Web Messaging*** credentials from the publisher section, if not provide them again. Expand the *Bind to an endpoint to receive guaranteed messages* collapsible section, enter the queue name in the text box, e.g. `codejam_edi_ce_[your-sap-community-username]_tickets`, and click the `Start Consume` button.
170+
👉 Click the `Connect` button in the Subscriber section. It should grab the ***Solace Web Messaging*** credentials from the publisher section, if not provide them again. Expand the *Bind to an endpoint to receive guaranteed messages* collapsible section, enter the queue name in the text box, e.g. `codejam_edi_ce_[your-sap-community-display-name]_tickets`, and click the `Start Consume` button.
171171

172172
<p align = "center">
173173
<img alt="Consume Queue" src="assets/consume-queue.gif" width="100%"/><br/>
@@ -196,7 +196,7 @@ In the examples above we've not changed the Delivery Mode. Two delivery modes ar
196196

197197
Before moving to the next exercise, let's clean up the queue we've created in this exercise.
198198

199-
👉 Navigate to the broker manager of the EU-North-Broker event broker service and go to the `Queues` page. Select the queue you've created, e.g. `codejam_edi_ce_[your-sap-community-username]_tickets`, and perform the `Delete` action from the **Action** options.
199+
👉 Navigate to the broker manager of the EU-North-Broker event broker service and go to the `Queues` page. Select the queue you've created, e.g. `codejam_edi_ce_[your-sap-community-display-name]_tickets`, and perform the `Delete` action from the **Action** options.
200200

201201
<p align = "center">
202202
<img alt="Delete queue" src="assets/delete-queue.gif" width="100%"/><br/>
@@ -221,7 +221,7 @@ We've covered a lot in this exercise. We've learned about topics, topic subscrip
221221
If you finish earlier than your fellow participants, you might like to ponder these questions. There isn't always a single correct answer and there are no prizes - they're just to give you something else to think about.
222222

223223
1. What happens if a consumer that's been subscribed to a topic goes down/becomes unavailable and a message is published to a topic that we are interested?
224-
2. Which wildcard will you be able to specify to receive all messages published `codejam/edi/ce/[your-sap-community-username]/tickets/Created`? What if you want to receive all messages, independent of levels for a particular SAP Community username?
224+
2. Which wildcard will you be able to specify to receive all messages published `codejam/edi/ce/[your-sap-community-display-name]/tickets/Created`? What if you want to receive all messages, independent of levels for a particular SAP Community display name?
225225
3. Some queues can be configured to have multiple consumers. Can you think of a scenario where this would be useful?
226226
4. On the Queues page of our event broker service, there were some queues whose names started with a #. What do you think this means?
227227

exercises/07-dynamic-message-routing/README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@
33
In the SAP Integration Suite, advanced event mesh instance that we are using for this event has more than one event broker service but so far we've only published and consumed messages within a single event broker service. In this exercise, we will learn about Dynamic Message Routing and we will see messages being exchanged between brokers. By the end of this exercise, we will achieve a communication scenario like the one below.
44

55
<p align = "center">
6-
<img alt="Publish and subscribe to the codejam/edi/ce/[your-sap-community-username]/dmr topic via DMR" src="assets/codejam-exercises-Exercise7 - DMR.png" width="80%"/><br/>
7-
<i>Publish/subscribe to the codejam/edi/ce/[your-sap-community-username]/dmr topic via DMR</i>
6+
<img alt="Publish and subscribe to the codejam/edi/ce/[your-sap-community-display-name]/dmr topic via DMR" src="assets/codejam-exercises-Exercise7 - DMR.png" width="80%"/><br/>
7+
<i>Publish/subscribe to the codejam/edi/ce/[your-sap-community-display-name]/dmr topic via DMR</i>
88
</p>
99

1010
## Dynamic Message Routing (DMR)
@@ -41,11 +41,11 @@ We've seen how we can exchange messages within a single event broker service. No
4141
<i>Message exchange between event broker services</i>
4242
</p>
4343

44-
👉 Navigate to Mission Control > Cluster Manager and open the broker manager for `APJ-IN-Broker`. Go to the `Try Me!` page and establish a connection in the subscriber section. Subscribe to the `codejam/edi/ce/[your-sap-community-username]/dmr` topic.
44+
👉 Navigate to Mission Control > Cluster Manager and open the broker manager for `APJ-IN-Broker`. Go to the `Try Me!` page and establish a connection in the subscriber section. Subscribe to the `codejam/edi/ce/[your-sap-community-display-name]/dmr` topic.
4545

4646
We've subscribed to the topic in the `APJ-IN-Broker` event broker service. Now, let's publish a message on the same topic but from the `EU-North-Broker` event broker service.
4747

48-
👉 Navigate to Mission Control > Cluster Manager and select the `EU-North-Broker`. Go to the `Try Me!` tab, navigate to the Broker Manager Try Me! page, establish a connection in the Publisher section and publish the message below to the `codejam/edi/ce/[your-sap-community-username]/dmr` topic.
48+
👉 Navigate to Mission Control > Cluster Manager and select the `EU-North-Broker`. Go to the `Try Me!` tab, navigate to the Broker Manager Try Me! page, establish a connection in the Publisher section and publish the message below to the `codejam/edi/ce/[your-sap-community-display-name]/dmr` topic.
4949

5050
```json
5151
{
@@ -78,7 +78,7 @@ There is an optional exercise part of this CodeJam that covers configuring a Mes
7878

7979
If you finish earlier than your fellow participants, you might like to ponder these questions. There isn't always a single correct answer and there are no prizes - they're just to give you something else to think about.
8080

81-
1. What do you think will happen if we have set up two consumers, one in the `APJ-IN-Broker` and another in the `AMER-USEast-Broker` event broker services, both subscribed to the same topic `codejam/edi/ce/[your-sap-community-username]/dmr` and publish a message from `EU-North-Broker`?
81+
1. What do you think will happen if we have set up two consumers, one in the `APJ-IN-Broker` and another in the `AMER-USEast-Broker` event broker services, both subscribed to the same topic `codejam/edi/ce/[your-sap-community-display-name]/dmr` and publish a message from `EU-North-Broker`?
8282
2. Can you think of scenarios when you would use a Message VPN Bridge instead of DMR? What type of message would you rather exchange between event broker services using a Message VPN Bridge?
8383

8484
## Next

exercises/08-cloudevents-sdk/README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,7 @@ In this folder, we have a few files that we need to get familiar with:
9898
👉 Make a copy of the `.env.sample` file and name it `.env`. Place it in the same folder as where the `.env.sample` file resides.
9999

100100
- Replace the placeholder values with the credentials available in the Cluster Manager > `EU-North-Broker` > `Connect` tab > `REST` collapsible section (ensure that you select `Protocol` in the `View by` dropdown).
101-
- Replace the [your-sap-community-username] placeholder with your SAP Community username in the topic.
101+
- Replace the [your-sap-community-display-name] placeholder with your SAP Community display name in the topic.
102102

103103
<p align = "center">
104104
<img alt="EU-North-Broker REST API details" src="assets/broker-details.png" width="90%"/><br/>
@@ -121,7 +121,7 @@ const ticketId = "VPHAH0OC";
121121
const type = "itelo.tms.ticket.v1.Ticket.Purchased.v1";
122122
const source = "https://tms-prod.itelo-entertainment.com/tickets";
123123
const datacontenttype = "application/json";
124-
const sapcommunityid = "[your-sap-community-username]";
124+
const sapcommunityid = "[your-sap-community-display-name]";
125125

126126
var data = {
127127
"ID": ticketId,
@@ -145,7 +145,7 @@ var data = {
145145
};
146146
```
147147

148-
Here we are defining the attributes and data that will be part of the CloudEvent message. We are using the same example as before, the ticket website that generates an event after a customer purchases a ticket. Note: Remember to update the `sapcommunityid` with your SAP Community username.
148+
Here we are defining the attributes and data that will be part of the CloudEvent message. We are using the same example as before, the ticket website that generates an event after a customer purchases a ticket. Note: Remember to update the `sapcommunityid` with your SAP Community display name.
149149

150150
👉 Add the following code in the `Create a CloudEvent` section:
151151

@@ -185,7 +185,7 @@ If everything went well, you should see the CloudEvent message printed in the co
185185
> Note: If you see an error message, make sure that you have set the environment variables correctly in the `.env` file. Also, a solution for this exercise is available in the `.sap/code/08-cloudevents-sdk` folder.
186186
187187
> [!TIP]
188-
> 💡 You can subscribe to the `codejam/edi/ce/[your-sap-community-username]/nodejs` topic, via the `Try Me!` page, to see the CloudEvent message being published.
188+
> 💡 You can subscribe to the `codejam/edi/ce/[your-sap-community-display-name]/nodejs` topic, via the `Try Me!` page, to see the CloudEvent message being published.
189189
190190
## Summary
191191

exercises/08-cloudevents-sdk/code/.env.sample

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,4 @@ SOLACE_REST_HOST="mr-connection-[host-id].messaging.solace.cloud"
33
SOLACE_REST_PORT="9443"
44
SOLACE_REST_USERNAME="solace-cloud-client"
55
SOLACE_REST_PASSWORD="super-secret-password"
6-
TOPIC="codejam/edi/ce/[your-sap-community-username]/nodejs"
6+
TOPIC="codejam/edi/ce/[your-sap-community-display-name]/nodejs"

exercises/09-rest-delivery-points/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@ The newly created REST consumer will be listed in the REST Consumers tab. Now we
9999

100100
## Configure Queue binding
101101

102-
👉 Navigate to the `Queue Bindings` tab and click on the **+ Queue Binding** button. Select the queue previously created, e.g. `S4HC_BP_Created_[your-sap-community-username]`, and click the **Create** button.
102+
👉 Navigate to the `Queue Bindings` tab and click on the **+ Queue Binding** button. Select the queue previously created, e.g. `S4HC_BP_Created_[your-sap-community-display-name]`, and click the **Create** button.
103103

104104
<p align = "center">
105105
<img alt="Queue binding set up" src="assets/queue-binding.gif" width="100%"/><br/>
@@ -133,7 +133,7 @@ First, let's see all the objects that we've configured.
133133

134134
Now we are ready to enable our RDP.
135135

136-
👉 Navigate to the `Summary` tab, click on the name of the REST consumer, e.g. `POST-BPCreated-[your-sap-community-username]`, click the **Edit** button on the top right-hand side and enable the RDP by toggling the Enabled setting. Click the **Apply** button.
136+
👉 Navigate to the `Summary` tab, click on the name of the REST consumer, e.g. `POST-BPCreated-[your-sap-community-display-name]`, click the **Edit** button on the top right-hand side and enable the RDP by toggling the Enabled setting. Click the **Apply** button.
137137

138138
Once we enable the RDP, if we navigate to the `Summary` tab, we should see that all the objects are in an operational state.
139139

0 commit comments

Comments
 (0)