This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
versago:configuring_report_links [2020/01/08 10:33] runger [Links Setup] |
versago:configuring_report_links [2020/07/23 11:42] (current) |
||
|---|---|---|---|
| Line 25: | Line 25: | ||
| * The **Link Column** is the column used for the link if the “Existing Column” option is used for //Link From//. Select the desired column from the drop-down list. | * The **Link Column** is the column used for the link if the “Existing Column” option is used for //Link From//. Select the desired column from the drop-down list. | ||
| * **Destination** defines the target of the action. The values in this field will change depending on the link Type. More information on Destinations is found in the discussion of each Type below. | * **Destination** defines the target of the action. The values in this field will change depending on the link Type. More information on Destinations is found in the discussion of each Type below. | ||
| - | | + | |
| - | * **Conditions** can be used to control when an action link is active based on values in other columns. See //**[[#link_conditions|Link Conditions]]**// | + | |
| + | ====Link Conditions==== | ||
| + | * **Conditions** can be used to control when an action link is active based on values in other columns. See // | ||
| * Click the red <color # | * Click the red <color # | ||
| + | |||
| + | ====Link Parameters===== | ||
| * The **Link Parameters** section is used when it is necessary to pass parameters to the target function. There may be some instances where the target function does not require information and this section is not needed. | * The **Link Parameters** section is used when it is necessary to pass parameters to the target function. There may be some instances where the target function does not require information and this section is not needed. | ||
| * Click the red <color # | * Click the red <color # | ||
| Line 34: | Line 38: | ||
| * The **Source Field** provides a parameter value to the target function. If the //Is Static// checkbox is not selected, a drop-down list of columns from the main report is provided. Otherwise the field appears as a text box where a static value can be entered. | * The **Source Field** provides a parameter value to the target function. If the //Is Static// checkbox is not selected, a drop-down list of columns from the main report is provided. Otherwise the field appears as a text box where a static value can be entered. | ||
| - | ===== Report Setup ===== | + | |
| + | =====Configuration of Link Types===== | ||
| + | |||
| + | ====Report Setup==== | ||
| The **Report** link is the execution of a Versago report. The concept is like the Sub-Reports function described earlier, except that the report being opened does not necessarily need to be connected to the main report, as it is in the Sub-Reports. Using a Link rather than a Sub-Report is sometimes helpful if having the child results open in a new browser tab will make the results easier to use. | The **Report** link is the execution of a Versago report. The concept is like the Sub-Reports function described earlier, except that the report being opened does not necessarily need to be connected to the main report, as it is in the Sub-Reports. Using a Link rather than a Sub-Report is sometimes helpful if having the child results open in a new browser tab will make the results easier to use. | ||
| Line 42: | Line 49: | ||
| {{ : | {{ : | ||
| - | ===== Forms Setup ===== | + | ====Forms Setup==== |
| The **Form** action provides a mechanism to open a Versago Form from a Versago Report and either find an existing record for maintenance or start a new record and automatically populate fields on the form. | The **Form** action provides a mechanism to open a Versago Form from a Versago Report and either find an existing record for maintenance or start a new record and automatically populate fields on the form. | ||
| Line 52: | Line 59: | ||
| In this example, the customer code (BP Code) and customer name (BP Name) are being passed into the form. | In this example, the customer code (BP Code) and customer name (BP Name) are being passed into the form. | ||
| - | <WRAP center round help 100%> | + | <WRAP center round help 80%> |
| If the value passed to the form is the primary key (e.g. vgoRecNum or whatever it has been named) the application will automatically execute a lookup for the record of the value passed. If the record is found the remaining fields will be populated. | If the value passed to the form is the primary key (e.g. vgoRecNum or whatever it has been named) the application will automatically execute a lookup for the record of the value passed. If the record is found the remaining fields will be populated. | ||
| </ | </ | ||
| - | ===== Crystal Report Setup ===== | + | ====Crystal Report Setup==== |
| The **Crystal Report** action provides a way to execute a Crystal Report for presentation to the user. An example of how this could be used is where the main report is a list of customer invoices. A Crystal Report action could cause a copy of the invoice document to be generated using Crystal Reports. | The **Crystal Report** action provides a way to execute a Crystal Report for presentation to the user. An example of how this could be used is where the main report is a list of customer invoices. A Crystal Report action could cause a copy of the invoice document to be generated using Crystal Reports. | ||
| + | |||
| + | General information about configuring Crystal Reports for use with Versago and Bizweaver is found **// | ||
| {{ : | {{ : | ||
| Line 65: | Line 74: | ||
| Registration of the Crystal Report is the same as described for Crystal Reports in the // | Registration of the Crystal Report is the same as described for Crystal Reports in the // | ||
| - | <WRAP center round help 100%> | + | <WRAP center round help 80%> |
| Crystal Reports that use a specific value for execution (e.g. an invoice number) must have a parameter in their definition. The Link Parameters will show the parameter(s) as Destination Field(s) that are mapped to a Source Field from the main report. | Crystal Reports that use a specific value for execution (e.g. an invoice number) must have a parameter in their definition. The Link Parameters will show the parameter(s) as Destination Field(s) that are mapped to a Source Field from the main report. | ||
| </ | </ | ||
| - | ===== Bizweaver Webservice Setup ===== | + | |
| + | ====Bizweaver Webservice Setup==== | ||
| A **Bizweaver Webservice** link allows a user to execute a Bizweaver workflow from a report using the Bizweaver API. These workflows can be used for a variety of background processing. | A **Bizweaver Webservice** link allows a user to execute a Bizweaver workflow from a report using the Bizweaver API. These workflows can be used for a variety of background processing. | ||
| - | <WRAP center round tip 100%> | + | <WRAP center round tip 80%> |
| - | Prior to v2.3, calls to the Bizweaver API were only sent using GET. | + | Beginning with v2.3, calls can be made using <color # |
| </ | </ | ||
| - | The “Destination” value is the string that calls the Bizweaver web service and passes any parameters that are needed. When parameters are specified in this string the are automatically set as Destination Fields in the Parameters section. Each parameter then needs to be matched to a Source Field from the report using the drop-down lists. | + | ===Calling Bizweaver Using POST=== |
| - | + | ||
| - | ==== Calling Bizweaver Using GET ==== | + | |
| - | + | ||
| - | {{ : | + | |
| - | + | ||
| - | * **Method** is GET. | + | |
| - | * **Task ID** is not used for GET. | + | |
| - | * **Destination** is the URL needed to contact the Bizweaver web service. | + | |
| - | * All values to be used to execute the Bizweaver workflow are included in the " | + | |
| - | + | ||
| - | <code html> | + | |
| - | https://< | + | |
| - | </ | + | |
| - | + | ||
| - | * **< | + | |
| - | * Use HTTP or HTTPS as needed by your site | + | |
| - | * If Versago uses HTTPS the Bizweaver web service must use HTTPS as well. | + | |
| - | * **Task ID** is the target workflow ID defined in Bizweaver. | + | |
| - | * **Arguments** are any values that need to be passed to the workflow. | + | |
| - | + | ||
| - | ==== Calling Bizweaver Using POST ==== | + | |
| {{: | {{: | ||
| Line 121: | Line 110: | ||
| * Leave these two values blank if no parameters need to be sent to the workflow. | * Leave these two values blank if no parameters need to be sent to the workflow. | ||
| - | ===== URL Setup ===== | + | The “Destination” value is the string that calls the Bizweaver web service and passes any parameters that are needed. When parameters are specified in this string the are automatically set as Destination Fields in the Parameters section. Each parameter then needs to be matched to a Source Field from the report using the drop-down lists. |
| + | |||
| + | ====URL Setup==== | ||
| The **URL** action is used to call a “website” (the URL). The URL is entered in the “Destination” field. The page being called could contain general information. In this case the “Destination” string is whatever you would type into a browser (e.g. __%%www.twbs.com%%__) to open the Third Wave website. | The **URL** action is used to call a “website” (the URL). The URL is entered in the “Destination” field. The page being called could contain general information. In this case the “Destination” string is whatever you would type into a browser (e.g. __%%www.twbs.com%%__) to open the Third Wave website. | ||