Wiki

Scale Your Enterprise

User Tools

Site Tools


bw:bizweaver_api

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
bw:bizweaver_api [2020/06/04 10:27]
akoehler
bw:bizweaver_api [2020/07/23 11:26] (current)
Line 6: Line 6:
 To initiate another workflow within Bizweaver, use a **//[[bw:web_service_tool|WebService2]]//** step.  The step is configured to use POST (preferred) or GET.  When the second workflow is called, the calling workflow will wait until it receives a response from the called workflow. Once a response is received the calling workflow will continue to its next step. To initiate another workflow within Bizweaver, use a **//[[bw:web_service_tool|WebService2]]//** step.  The step is configured to use POST (preferred) or GET.  When the second workflow is called, the calling workflow will wait until it receives a response from the called workflow. Once a response is received the calling workflow will continue to its next step.
  
-<WRAP center round tip 60%> +<WRAP center round tip 80%> 
-The option to use POST and GET to initiate a Bizweaver workflow is introduced in v2.4. +Processes beginning with v2.4 should always use POST.  Processes from older versions that used GET should be converted to POST as soon as possible.
- +
-Processes beginning with v2.4 should generally use POST.  This provides authentication security that is not available when using GET.  Processes already using GET should be converted to POST as soon as possible.+
 </WRAP> </WRAP>
-<WRAP center round important 60%>+<WRAP center round important 80%>
 A token must be generated in order to use the POST processes described below.  Information on configuring a token is found **//[[bw:bizweaver_general_settings#bizweaver_webservice|here]]//**. A token must be generated in order to use the POST processes described below.  Information on configuring a token is found **//[[bw:bizweaver_general_settings#bizweaver_webservice|here]]//**.
 </WRAP> </WRAP>
-<WRAP center round important 60%>+<WRAP center round important 80%>
 Use caution when connecting multiple workflows in a sequence.  You may need to adjust the timeout value on the earlier steps to be sure the processing doesn't continue before the called step(s) have completed their work. Use caution when connecting multiple workflows in a sequence.  You may need to adjust the timeout value on the earlier steps to be sure the processing doesn't continue before the called step(s) have completed their work.
 </WRAP> </WRAP>
Line 71: Line 69:
   "pArguments":{}   "pArguments":{}
 } }
-</code> 
- 
-=====Call Another Workflow Using GET===== 
-When a Bizweaver workflow is called (initiated) using GET, the configuration of the WebService2 tool involves only the URI section.  An example is shown below. 
- 
- 
-http:%%//%%<color #ed1c24>1</color>:<color #ed1c24>2</color>/BWService/api/workflow/InvokeWorkFlow?pTaskID=<color #ed1c24>3</color>&pStartAfter=0&pArguments={<color #ed1c24>4</color>:'~<color #ed1c24>5</color>~'} 
- 
-The elements in <color #ed1c24>red</color> are specific to your installation. The other items (included variable names used by Bizweaver) are **case sensitive**, so the easiest way to create the Action Target is to copy this string and paste it into Versago, then make the needed changes. You might also update the Bizweaver server information so that you will only need to change a few items. 
- 
-  - The server where Bizweaver is installed 
-  - The port assigned to the Bizweaver web service when the application was installed. 
-  - The Bizweaver workflow ID to be invoked. This can be found in Bizweaver and will always be numeric. 
-  - The name of the variable in Bizweaver that will receive a value from Versago. 
-  - Value(s) to be passed to Bizweaver. 
-    - If value(s) are not being passed to Bizweaver, the space between the curly braces is left blank. 
-    - If the value is a value from the form, use the Column Name from the form enclosed in tilde symbols (~) as shown. 
-    - If the value is static the tildes are not used. 
-    - In both cases the value being passed is enclosed in single quotes. 
-  - If multiple values need to be sent to Bizweaver, separate each pair of values (steps 5 and 6) by a comma. See sample 3 in the next section. 
- 
-===== Bizweaver Action Target String Samples ===== 
- 
-Example using HTTP to port 8082 on server “TWBSTestserver.demo.com”, invoking workflow ID 10, and sending a value from form control name “vgoRecNum” to a Bizweaver variable named “vgoRecNum.” 
-<code html> 
-http://TWBSTestserver.demo.com:8082/BWService/api/workflow/InvokeWorkFlow?pTaskID=10&pStartAfter=0&pArguments={vgoRecNum<:'~5~'} 
-</code> 
- 
-Example using HTTPS to port 443 on server “TWBSTestserver.demo.com”, invoking workflow ID 10, and sending a value from form control name “vgoRecNum” to a Bizweaver variable named “vgoRecNum.” Note that the only difference is the “HTTPS” and port number. 
-<code html> 
-https://TWBSTestserver.demo.com:443/BWService/api/workflow/InvokeWorkFlow?pTaskID=10&pStartAfter=0&pArguments={vgoRecNum<:'~5~'} 
-</code> 
- 
-Example using HTTP to port 8082 on server “TWBSTestserver.demo.com,” invoking workflow ID 10, and sending two values; one from form control name “vgoRecNum” to a Bizweaver variable named “vgoRecNum” and a static value “TextString” to a Bizweaver variable name “vgoText.” 
-<code html> 
-http://TWBSTestserver.demo.com:8082/BWService/api/workflow/InvokeWorkFlow?pTaskID=10&pStartAfter=0&pArguments={vgoRecNum<:'~5~',vgoText: 'TextString'} 
 </code> </code>
  
bw/bizweaver_api.1591280836.txt.gz · Last modified: 2020/06/04 10:27 by akoehler