You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: en/docs/get-started/key-concepts.md
+7
Original file line number
Diff line number
Diff line change
@@ -23,3 +23,10 @@ Types are used to define the structure of data in Ballerina Integrator. They are
23
23
## Configurations
24
24
Configurations are used to define the settings and parameters of the integration. They are used to configure the behavior of the integration and its components.
25
25
Configurations can be used to set up connections, define global variables, and configure other aspects of the integration in different environments.
26
+
27
+
## Source View
28
+
The source view is a text-based representation of the integration that can be used to view and edit the code directly. It provides a way to see the underlying code that is generated by the graphical interface.
29
+
Switching to the source view allows you to view and edit the code directly, providing more control and flexibility over the integration.
30
+
Clicking on the `</>` button in the top right corner of the design view will switch to the source view.
To learn more about profiles, see [Visual Studio Code Profiles](https://code.visualstudio.com/docs/editor/profiles).
19
-
20
-
### Step 3: Install the Ballerina Integrator extension
9
+
### Step 2: Install the WSO2 Ballerina Integrator extension
21
10
1. Go to the Extensions view by clicking on the extension icon on the sidebar or pressing `Ctrl + Shift + X` on Windows and Linux, or `shift + ⌘ + X` on a Mac.
22
11
2. Search for `Ballerina Integrator` in the Extensions view search box.
23
12
3. Click on the **`Install`** button to install the `Ballerina Integrator` extension.
???+ info "Update Ballerina Integrator's Ballerina Distribution"
36
25
The setup wizard will install the Ballerina distribution required for Ballerina Integrator in to `<USER_HOME>/.ballerina/ballerina-home` directory.
37
26
Press `Ctrl + Shift + P` on Windows and Linux, or `shift + ⌘ + P` on a Mac and type `Ballerina: Update Ballerina Integrator` to update the installed Ballerina distribution.
38
27
39
-
### Step 5: Create a new integration project
28
+
### Step 4: Create a new integration project
40
29
1. Click on the Ballerina Integrator icon on the sidebar.
41
30
2. Click on the **`Create Integration`** button.
42
31
3. Enter the Integration Name as `HelloWorld`.
43
32
4. Select Project Directory by clicking on the **`Select Location`** button.
44
33
5. Click on the **`Create Integration`** button to create the integration project.
The integration service can also be generated using the AI-assistant. Click on the **`Generate with AI`** button and enter the following prompt, then press **`Add to Integration`** to generate the integration service.
51
40
52
41
```create a http service that has base path as /hello, and 9090 as the port. Add GET resource on /greeting that invokes https://apis.wso2.com/zvdz/mi-qsg/v1.0 endpoint and forward the response to caller.```
53
42
54
-
1. In the design view, click on the **`Add Construct`** button.
55
-
2. Select **`Service`** from the menu.
56
-
3. Select **`HTTP Service`** from the service type.
57
-
4. Select the **`Create and use the default HTTP listener`** option from the **`Listener`** dropdown.
58
-
5. Select **`Design from Scratch`** option as the **`The contract of the service`**.
59
-
6. Specify the **`Service base path`** as `/hello`.
60
-
7. Click on the **`Create`** button to create the new service with the specified configurations.
43
+
1. In the design view, click on the **`Add Artifact`** button.
44
+
2. Select **`HTTP Service`** under the **`Integration as API`** category.
45
+
3. Select the **`Create and use the default HTTP listener`** option from the **`Listener`** dropdown.
46
+
4. Select **`Design from Scratch`** option as the **`The contract of the service`**.
47
+
5. Specify the **`Service base path`** as `/hello`.
48
+
6. Click on the **`Create`** button to create the new service with the specified configurations.
1. The generated service will have a default resource named `greeting` with the **`GET`** method.
65
53
2. Click on the `greeting` resource to view the resource details. Let's modify the resource to invoke the [`HelloWorld`](https://apis.wso2.com/zvdz/mi-qsg/v1.0) API endpoint.
66
54
3. Hover to the arrow after start and click the ➕ button to add a new action to the resource.
67
55
4. Select **`Add Connection`** from the node panel.
68
-
5. Search for `HTTP` in the search bar and select **`HTTP`** as the connection type.
56
+
5. Search for `HTTP` in the search bar and select **`HTTP Client`** as the connection type.
69
57
6. Change the variable name to `externalEP`.
70
58
7. Add the URL `"https://apis.wso2.com"` to the connection URL field and click **`Save`**.
71
59
<ahref="{{base_path}}/assets/img/get-started/create-connection.gif"><imgsrc="{{base_path}}/assets/img/get-started/create-connection.gif"alt="Create New Connection"width="70%"></a>
@@ -82,11 +70,20 @@ Download and install the [Visual Studio Code](https://code.visualstudio.com/down
10. Click on the ➕ button again and select **`Return`** from the node panel.
86
-
11. Select the `helloWorldResponse` variable as the **`Expression`** from the dropdown and click **`Save`**. This step will return the response from the `HelloWorld` API endpoint.
73
+
10. Click on the **`Return`**node from the design view.
74
+
11. Select the `epResponse` variable as the **`Expression`** from the dropdown and click **`Save`**. This step will return the response from the `HelloWorld` API endpoint.
<li><b>Pre-built connectors:</b> Ballerina Integrator offers connectors for easy integration with various systems and services.</li>
35
35
<li><b>Reuse components:</b> Create and share reusable components across integrations, saving time and effort.</li>
36
36
<li><b>Automate testing:</b> Automated testing helps identify and fix issues early.</li>
37
-
<li><b>AI-assisted development:</b> Ballerina Integrator’s AI provides smart suggestions to boost coding efficiency and accuracy.</li>
37
+
<li><b>Low-code and pro-code support:</b> Ballerina Integrator allows seamless switching between low-code and pro-code, enabling visual design with optional custom coding. </li>
38
38
</ul>
39
39
</div>
40
40
</div>
@@ -57,7 +57,7 @@
57
57
<li><b>Smart refactoring and code restructuring:</b> Ballerina Integrator’s AI suggests refactoring options, enabling a cleaner, more maintainable codebase.</li>
Copy file name to clipboardExpand all lines: en/docs/learn/data-mapping.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -156,7 +156,7 @@ service / on new http:Listener(8290) {
156
156
```
157
157
158
158
### Step 6: Run the integration
159
-
1. Click on the **`Run`**on the run button in the topright corner to run the integration.
159
+
1. Click on the **`Run`** button in the top-right corner to run the integration.
160
160
2. The integration will start and the service will be available at `http://localhost:8290/transform`.
161
161
3. The service can be tested using a tool like [Postman](https://www.postman.com/) or [curl](https://curl.se/) by sending a POST request with a JSON payload to the service endpoint.
0 commit comments