... | ... | @@ -4,13 +4,13 @@ The application should be able to open the send message dialogue with already fi |
|
|
|
|
|
## Motivation
|
|
|
|
|
|
Mr. Pavel Krkoška, a SingleCase representative, has contacted us with the the request for the above-mentioned functionality. They want to be able trigger the opening of the send message dialogue from their application to provide more comfort for their users.
|
|
|
Mr. Pavel Krkoška, a SingleCase representative, has contacted us with the the request for the above-mentioned functionality. They want to be able to trigger the opening of the send message dialogue from their application to provide more comfort for their users.
|
|
|
|
|
|
## Brief Description of Function
|
|
|
|
|
|
1. The user of the records management service application selects documents to send them via Datovka. He/she then triggers the operation to send the documents via Datovka.
|
|
|
|
|
|
2. Datovka starts if it has not been already running and displays the send message dialogue. The dialogue must contain all documents which have been specified by the user in the records management service application.
|
|
|
2. Datovka starts (if it has not been already running) and displays the send message dialogue. The dialogue form must contain all documents which have been specified by the user in the records management service application.
|
|
|
|
|
|
3. The user then specifies in the send message dialogue all required missing information such as message annotation, recipient or sender box, etc.
|
|
|
|
... | ... | @@ -22,9 +22,9 @@ Mr. Pavel Krkoška, a SingleCase representative, has contacted us with the the r |
|
|
|
|
|
Nowadays, Datovka does not advertise its presence in any of the supported operating systems.
|
|
|
|
|
|
On UNIX-like systems (excluding macOS) it is commonly installed to the default application path - unless the administrator specifies otherwise. In such case it is the administrator's job to retain all of required the functionality and we are not to be blamed for any error.
|
|
|
On UNIX-like systems (excluding macOS) it is commonly installed into the default application path - unless the administrator specifies otherwise. In such case it is the administrator's job to retain all of the required functionality and we are not to be blamed for any error.
|
|
|
|
|
|
On macOS Datovka package is usually installed to the location `/Applications/datovka.app`. However the application may also reside somewhere in a path specified by the system user. The order of preference could be:
|
|
|
On macOS the Datovka package is usually installed to the location `/Applications/datovka.app`. However the application may also reside somewhere in a path specified by the system user. The order of preference detection could be:
|
|
|
* primarily, launch Datovka from the specified environment PATH
|
|
|
* secondarily, launch Datovka from the default package location
|
|
|
|
... | ... | @@ -37,22 +37,22 @@ The Windows installer could set a registry value (similar to values specified [h |
|
|
Datovka location could also be set in the environment `PATH` variable.
|
|
|
The default installed location of Datovka on 64-bit Windows is `c:\Program Files (x86)\CZ.NIC\Datovka`.
|
|
|
|
|
|
A preferred way of Detecting Datovka on Windows whould presumably be:
|
|
|
A preferred way of Detecting Datovka on Windows would presumably be:
|
|
|
1. Look for a registry value in `HKEY_LOCAL_MACHINE` an then `HKEY_CURRENT_USER`.
|
|
|
2. Try launching Datovka via the specified `PATH`.
|
|
|
2. Try launching Datovka via the `PATH` environment variable.
|
|
|
3. Try launching Datovka from some guessed 'standard' paths.
|
|
|
|
|
|
Of course, the records management service application could ask the user to directly specify Datovka location if it could not be acquired otherwise.
|
|
|
|
|
|
### Passing Required Data
|
|
|
|
|
|
Datovka could provide a `--dlg-send-msg` command-line option which could be similar to the `--send-msg` option of the already [present command-line interface](cli). The checking on the option parameters is not expected to be as strict as it now is for `--send-msg`. The user may supply all of the necessary but missing information later in the actual displayed dialogue window.
|
|
|
Datovka could provide a `--dlg-send-msg` command-line option which could be similar to the `--send-msg` option of the already [present command-line interface](cli). The checking on the option parameters is not expected to be as strict as it is now for `--send-msg`. The user may supply all of the necessary but missing information later in the displayed dialogue window.
|
|
|
|
|
|
Here we would like to know which data are most likely to be passed from the records management service. We now expect only documents to be passed to Datovka.
|
|
|
**Question for Singlecase:** Here we would like to know which data are most likely to be passed from the records management service. We now expect only documents to be passed to Datovka.
|
|
|
|
|
|
#### Passing Documents
|
|
|
|
|
|
The records management service application will create files in a usual temporary files location and pass these files via the proposed command-line option into Datovka. In order to avoid any clashes in file naming, all such files will be located in a **uniquely-named sub-directory** within the normal location for temporary files.
|
|
|
The records management service application will write files in a usual temporary files location and pass these file locations via the proposed command-line option into Datovka. In order to avoid any clashes in file naming, all such files will be located in a **uniquely-named sub-directory** within the normal location for temporary files.
|
|
|
|
|
|
### Handling the Open Dialogue Request in Datovka
|
|
|
|
... | ... | |