This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
bw2:web_service_tool [2022/08/02 16:25] akoehler |
bw2:web_service_tool [2024/01/08 16:02] (current) wgates [Request Settings] |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== Introduction (WebService Tool v2)====== | ====== Introduction (WebService Tool v2)====== | ||
| - | The Web Services tool is used to allow Bizweaver to interact with APIs from other applications. Bizweaver also has its own API in the form of the Bizweaver web service. Unfortunately, | + | The Web Services tool is used to allow Bizweaver to interact with APIs from other applications. Bizweaver also has its own API in the form of the Bizweaver web service. This document describes how the Web Service tool is configured and provides some basic examples of how it is used for some major applications. |
| ====== Related Documents ====== | ====== Related Documents ====== | ||
| Line 25: | Line 25: | ||
| Before you begin to configure a web service tool, you will need information from the provider of your target API to know exactly what type of authorization will be used, what needs to be transmitted, | Before you begin to configure a web service tool, you will need information from the provider of your target API to know exactly what type of authorization will be used, what needs to be transmitted, | ||
| - | - The web service tool currently has two ways to work with known **REST** connections. | + | - The web service tool currently has three ways to work with known **REST** connections. |
| - | - The **Select Service** drop-down currently has two options: Custom | + | - The **Select Service** drop-down currently has three options: Custom, Salesforce.com, and SAP Service Layer. |
| - | - Custom is used for all cases other than Salesforce.com | + | - Custom is used for all cases other than Salesforce.com |
| - The Salesforce.com option provides a predefined tool specifically for working with Salesforce.com. See **// | - The Salesforce.com option provides a predefined tool specifically for working with Salesforce.com. See **// | ||
| + | - SAP Business One Service Layer is a new generation of extension API for consuming SAP Business One data and services. | ||
| - Additional predefined tools may be added in the future. | - Additional predefined tools may be added in the future. | ||
| - When basic or oAuth 2 authentication is used, a REST Global Connection can be defined. This allows the use of the same information to be used for each call to the target system. In these cases, select the **Custom** as the Service, check the “Authentication Required” checkbox, and select the (previously defined) Global Connection from the “Select Service” drop-down. | - When basic or oAuth 2 authentication is used, a REST Global Connection can be defined. This allows the use of the same information to be used for each call to the target system. In these cases, select the **Custom** as the Service, check the “Authentication Required” checkbox, and select the (previously defined) Global Connection from the “Select Service” drop-down. | ||
| Line 51: | Line 52: | ||
| - The basic URI string can also be defined as a variable and then referenced using the <F4> option and adding additional qualifiers as needed. | - The basic URI string can also be defined as a variable and then referenced using the <F4> option and adding additional qualifiers as needed. | ||
| - | As an example, here is the base URI to use the HANA Service Layer web services. | + | As an example, here is the base URI to use the Service Layer web services. |
| https:// | https:// | ||
| Line 99: | Line 100: | ||
| Once the request information has been provided, click the __SEND__ link in the lower right corner of the screen. This will initiate a web service call to the target API based on the information provided. The screen will automatically shift to the Response tab to review the results of the call. | Once the request information has been provided, click the __SEND__ link in the lower right corner of the screen. This will initiate a web service call to the target API based on the information provided. The screen will automatically shift to the Response tab to review the results of the call. | ||
| + | |||
| + | ==== Multipart\Formdata ==== | ||
| + | |||
| + | In version 2.7.8 there was new functionality added to use the content type of multipart\formdata to send files and other key-value pairs through certain APIs that use this functionality. | ||
| + | |||
| + | {{: | ||
| + | |||
| + | - Radio button to select the multipart/ | ||
| + | - Key field to enter the name of the variable you are passing into the API | ||
| + | - The dropdown field that indicates if the value field is Text or a file if the file is selected the value box will have " | ||
| + | - Value field this will allow you to either enter a file path or text | ||
| + | - If the file is selected a " | ||
| + | - If text is selected it will allow multi-line text that will be sent through the API | ||
| + | - Description allows you to enter a description of the field | ||
| + | - " | ||
| + | |||
| + | |||
| ===== Response ===== | ===== Response ===== | ||