Use Case
Opening of an estimate in one's computer from a remote folder or a web repository, even if it is only readable or hidden, or from a Sharepoint site. The opening may be followed by the parameterization of user variables, the computation of the selling prices and the saving of the estimate.
Principle
Enter a command line in a web browser, or create a html page with hyperlinks (<a>) and click the link.
Code
The unique argument is the complete estimate path to open.
Either the estimate is opened as usual or the code copies/pastes it to the temporary working folder %APPDATA%\Local\QDV\WorkingTemp\
In the latter case, Hidden and Read-only attributes are automatically removed on the copy in the temporary folder.
To save such estimate to the initial location, you can attach a macro to the On_After_Save_Estimate event (refer to Events Management) and read the Es.methodOriginalPathFromQdv7Protocol property in the API to know where the estimate is opened from.
Alternatively, you can benefit from a Sharepoint site.
Examples of hyperlinks:
QDV7 Action |
href="qdv7:// |
|
Just invoking QDV7 |
" |
|
Opening an estimate as usual |
?open=C:\temp\Sample Estimate.qdv" |
|VARIABLES{GLV_VAR1;abc}{GLV_VAR2;def}{GLV_VAR3;ghi}{ComputeSellingPrices;yes}{SaveEstimate;yes}" |
Opening in the temporary folder an estimate |
?opentotemp=C:\temp\Sample_Estimate.qdv |
|
Opening a file by reference to SharePoint |
?open=[SHAREPOINT]https://myserver.com/my folder/my file.qdv" |
You can create/value to the estimate user's variables (R/W) of string type (whether they already exist or not): for this purpose, tag the file path with the third column content (this example features 3 variables and 2 verbs: ComputeSellingPrices et SaveEstimate).
The actions elicited by the verbs are carried out after the opening in the order they appear in the URL. In the example, the selling prices are computed before the estimate is saved.
NOTE Unlike variables, verbs and values are not case sensitive.