| Parameter name | From version | Description | Paremeter type | Default value | Field type | Comments and restrictions |
|---|
| Files download source* | 1.0.0 | Specifies the source from which the files to be signed are to be downloaded. There are 3 options: - Process - documents attached to the process are downloaded.
- Archive - documents are downloaded from the archive, from a specified class of documents.
- File identifiers from the archive - specified files by identifier are downloaded from the archive.
| Text | | Uneditable drop-down list | | Displayed value | Passed value |
|---|
| Process | PROCESS | | Archive | ARCHIVE | | File identifiers from the archive | FILEIDS |
If you select "Process" or "Archive", the latest version of the document will be downloaded. |
| Document classes Source document classes [Process]* | 1.0.0 | The names of the classes of documents from which the documents are retrieved. The resulting signed files are saved as new document version in the indicated document classes if the Save as new version parameter is set to Yes. | Text values array | | Uneditable drop-down list | In case of an empty document class names table (parameter not completed), all documents attached to the process will be downloaded. | Document The names of the document classes in the column cannot be duplicated. |
| Destination document classes [Process]* | 1.0.X | Paramater indicates to the files from the specified source document classes attached to the process a place to save their corresponding signed files in the selected destination document classes. | Text values array | | Uneditable drop-down list | The parameter is available when the Save as new version parameter is set to No. |
| Source document class [Archive]* | 1.0.0 | Name The name of the document class from which the documents are retrieved. The resulting signed files are saved as new document version in the indicated document class if the Save as new version parameter is set to Yes. | Text | | Uneditable drop-down list | |
Index name [Readnames [Filtering by indexes - Archive] | 1.0.0 | Optional filtering by indexes of the selected document class. This parameter specifies the name of the index. | Text values array | | Uneditable drop-down list / editable field | List of indexes to choose from after selecting a specific class of documents. If a variable or function is used in the Document Source document class [Archive] parameter, the field of this parameter becomes an editable field. |
| Index value [Readvalues [Filtering by indexes - Archive] | 1.0.0 | Optional filtering by indexes of the selected document class. This parameter specifies the index value. | Text values array | | Editable field | |
| File identifiers* | 1.0.0 | IDs of files to be downloaded from the archive. The resulting signed files are saved as new document version in the indicated identifiers of document from the archive if the Save as new version parameter is set to Yes. | Integer values array | | Editable field | |
| Save as new version* | 1.0.0 | If set to "Yes", the signature file will be saved as a new version of the input document. If set to "No", the signature file will be saved in the specified document class and indices as a new document. | Boolean | Yes | Editable field | |
| Document classes [Index mapping - Process] | 1.0.X | The names of the document classes where the files with the signatures will be saved. | Text values array | | Uneditable drop-down list | Only those document classes that have been previously defined in the Destination document classes [Process] parameter can be used in this parameter. If there is a function or a variable in one of the values of the Destination document classes [Process] parameter, the rule is not applied. |
| Index names [Index mapping - Process] | 1.0.X | The names of the indexes from the selected document classes. | Text values array | | Uneditable drop-down list | |
| Index values [Index mapping - Process] | 1.0.X | The values of the indexes from the selected document classes. It is possible to use the SOURCE_FILE_ID and SOURCE_DOCUMENT_CLASS_NAME keywords as mapping information about the source file identifier and the source document class from which the document passed for signature originates. | Text values array | | Editable field | Keywords are plain, written text - they are not selected from the list of variables as in the case of, for example, context variables. |
| Destination document classes [Archive / File identifiers from the archive]* | 1.0.X | Document class to which already signed files can be saved that belong to the indicated document class from the archive or based on indicated file identifiers. | Text | | Uneditable drop-down list | |
| Index names [Index mapping - Archive / File identifiers from the archive] | 1.0.X | The names of the indexes from the selected document class. | Text values array | | Uneditable drop-down list / Editable field | List of indexes to choose from after selecting a specific class of documents. If a variable or function is used in the Destination document class [Archive / File identifiers from the archive] parameter, the field of this parameter becomes an editable field. |
| Index values [Index mapping - Archive / File identifiers from the archive] | 1.0.X | The values of the indexes from the selected document class. It is possible to use the SOURCE_FILE_ID and SOURCE_DOCUMENT_CLASS_NAME keywords as mapping information about the source file identifier and the source document class from which the document passed for signature originates. | Text values array | | Editable field | Keywords are plain, written text - they are not selected from the list of variables as in the case of, for example, context variables. |
| Add document to process | 1.0.0 | Attaches a signature file to the process. | Boolean | No | Editable field | |
| Execute actions in the document class | 1.0.0 | It calls actions which have the source of action set to "Add new document in archive". | Boolean | No | Editable field | |
| Mode of operation* | 1.0.0 | Defines how the Szafir application works. The "Szafir window" mode enables the creation of a signature using the native graphical user interface. On the other hand, the "Window with PIN code and optional certificate selection" mode performs the signing with the use of a dialog in which the PIN for the cryptographic device and optionally the certificate file are entered. | Text | | Uneditable drop-down list | | Displayed value | Passed value |
|---|
| Szafir window | SZAFIR_WINDOW | | Window with PIN code and optional certificate selection | PIN_AND_CERTIFICATE_WINDOW |
Selecting the "Szafir window" value results in the appearance of the Certificate parameter, and selecting "Window with PIN code and optional certificate selection" - the Certificate parameter and the User selects certificate. |
| Certificate* | 1.0.0 | File name containing the certificate configuration, which comes from the Plugin Configuration Manager (PCM) panel. The parameter presents a list of all created files with the certificate configuration. | Text | | Uneditable drop-down list | |
| User selects certificate | 1.0.0 | Specifies whether the user on the form can select the certificate file from the Plugin Configuration Manager (PCM) panel. The selection is possible from the level of the dialog box that appears while the Szafir application is running and includes the certificates specified in the Available certificates parameter. | Boolean | Nie | Editable field | Setting the parameter to "Yes" causes the appearance of the Available certificates parameter and hides the Certificate parameter, while setting the parameter to "No" leaves the Certificate visible. |
| Available certificates | 1.0.0 | It defines the files with the certificate that can be selected by the user on the form from the level of the dialog box. The parameter presents a list of all created files with the certificate configuration. | Text values array | | Uneditable drop-down list | |
| Signature version* | 1.0.0 | Specifies a signature version. More information... | Text | | Uneditable drop-down list | | Displayed value | Passed value |
|---|
| BES | BES | | T | T | | LTV/A | LTV_A |
|
| Signature format* | 1.0.0 | Specifies the signature format. The parameter presents the list of available formats depending on the selected signature version. More information... | Text | | Uneditable drop-down list | | Displayed value | Passed value |
|---|
| ASIC-S-CAdES-BES | ASIC_S_CADES_BES | | ASIC-S-XAdES-BES | ASIC_S_XADES_BES | | CAdES-BES | CADES_BES | | EPO-XAdES-BES | EPO_XADES_BES | | PAdES-BES | PADES_BES | | PKCS#7 | PKCS7 | | XAdES-BES | XADES_BES |
| Displayed value | Passed value |
|---|
| ASIC-S-CAdES-T | ASIC_S_CADES_T | | ASIC-S-XAdES-T | ASIC_S_XADES_T | | CAdES-T | CADES_T | | EPO-XAdES-T | EPO_XADES_T | | PAdES-T | PADES_T | | PKCS#7 with Time | PKCS7_WITH_TIME | | PKCS#7-T | PKCS7_T | | XAdES-T | XADES_T |
| Displayed value | Passed value |
|---|
| EPO-XAdES-A | EPO_XADES_A | | EPO-XAdES-A-REFRESH | EPO_XADES_A_REFRESH | | PAdES-LTV | PADES_LTV | | PAdES-LTV-REFRESH | PADES_LTV_REFRESH | | XAdES-A | XADES_A | | XAdES-A-REFRESH | XADES_A_REFRESH |
|
| Debug mode | 1.0.0 | Opens the console window of the SzafirHost application while the action is running. | Boolean | No | Editable field | |
| Source file identifiers | 1.0.0 | A parameter where the column is indicated for saving source file identifiers (fileIds) which correspond to documents submitted for signature. The parameter is completed after the signature operation is finished. | Variable | | Editable field | The parameter is one of the five possible parameters to define that make up the table in the Summary information about the results of signed files section. The table is cleared every time the signature insertion mechanism is called, no matter how many columns it has. The table stores information about the last action invocation. |
Source file names | 1.0.2 | A parameter where the column is indicated for saving source file names which correspond to documents submitted for signature. The parameter is completed after the signature operation is finished. | Variable | | Editable field | The parameter is one of the five possible parameters to define that make up the table in the Summary information about the results of signed files section. The table is cleared every time the signature insertion mechanism is called, no matter how many columns it has. The table stores information about the last action invocation. |
| Identifiers of signed files | 1.0.2 | A parameter where the column is indicated for saving identifiers of signed and result files (fileIds). The parameter is completed after the signature operation is finished. | | | | The parameter is one of the five possible parameters to define that make up the table in the Summary information about the results of signed files section. The table is cleared every time the signature insertion mechanism is called, no matter how many columns it has. The table stores information about the last action invocation. When the signature operation fails for a given source file, the cell in the column will be blank. |
| File processing statuses | 1.0.2 | A parameter where the column is indicated for saving statuses of performing operations on file signatures. Two status values are available: OK - in case of a successful signature, ERROR - in case of an error. The parameter is completed after the signature operation is finished. | | | | The parameter is one of the five possible parameters to define that make up the table in the Summary information about the results of signed files section. The table is cleared every time the signature insertion mechanism is called, no matter how many columns it has. The table stores information about the last action invocation. |
| Error descriptions | 1.0.0 | A parameter where the column is indicated for saving error descriptions occurring during file signature attempts for files from Source file identifiers. The parameter value is populated only when the processing status for the given file is ERROR. The parameter is completed after the signature operation is finished. | Variable | | Editable field | The parameter is one of the five possible parameters to define that make up the table in the Summary information about the results of signed files section. The table is cleared every time the signature insertion mechanism is called, no matter how many columns it has. The table stores information about the last action invocation. If the specified source file is successfully signed, the cell in the column will be blank. |
| Save as new version* | 1.0.0 | If set to "Yes", the signature file will be saved as a new version of the input document. If set to "No", the signature file will be saved in the specified document class and indices as a new document. | Boolean | Yes | Editable field | |
| Document class [Save] | 1.0.0 | The name of the document class where the file with the signature will be saved. | Text | | Uneditable drop-down list | |
| Index name [Save] | 1.0.0 | The name of the index from the selected document class. | Text values array | | Uneditable drop-down list / editable field | List of indexes to choose from after selecting a specific class of documents. If a variable or function is used in the Document class [Save] parameter, the field of this parameter becomes an editable field. |
| Index value [Save] | 1.0.0 | Index value from the selected document class. | Text values array | | Editable field | |
| Add document to process | 1.0.0 | Attaches a signature file to the process. | Boolean | No | Editable field | |
| Execute actions in the document class | 1.0.0 | It calls actions which have the source of action set to "Add new document in archive". | Boolean | No | Editable field | |
