SEAL v18.11.01 AdministrationGuide November2018
SEAL v18.11.01 AdministrationGuide November2018
01
Administration Guide
Contents
1 Introduction ....................................................................................................................... 4
2 Describe concepts .............................................................................................................. 5
2.1 Application business flow............................................................................................ 5
2.1.1 Disposal application ............................................................................................. 5
2.1.2 Disposal freeze ..................................................................................................... 6
2.1.3 Expiration review ................................................................................................. 6
2.1.4 Deletion of digital content ................................................................................... 7
2.1.5 Destruction of objects.......................................................................................... 7
2.1.6 Metadata role in disposal process ....................................................................... 7
2.1.7 Disposal audit and reports ................................................................................... 8
2.2 Concepts ...................................................................................................................... 9
2.3 Application components ........................................................................................... 14
2.4 Users and their capabilities ....................................................................................... 16
3 Getting started ................................................................................................................. 18
3.1 Obtain the application............................................................................................... 18
3.2 Access the application ............................................................................................... 18
3.3 Log on to the application .......................................................................................... 18
3.4 User interface ............................................................................................................ 19
3.4.1 GDPR Dashboard ................................................................................................ 24
3.5 User’s settings ........................................................................................................... 27
4 Configure SEAL platform .................................................................................................. 29
4.1 Customers ................................................................................................................. 29
4.2 Digital certificates...................................................................................................... 30
4.3 Electronic archives .................................................................................................... 30
4.4 Archive administrators .............................................................................................. 41
4.4.1 System users ...................................................................................................... 43
4.5 Configure system settings ......................................................................................... 44
4.6 Update storage statistics ........................................................................................... 56
4.7 Compute archive statistics ........................................................................................ 57
Each SEAL document has a complex generic property named “Retention flags”. If a
retention flag is applied to a document, that document cannot be deleted from the
electronic archive even if its storage term has expired. Retention flags can be applied or
removed from a document or a set of documents by running the Legal hold background
process.
SEAL offers a background process – Marked documents for deletion, which is configured
and run by an archive administrator user. The purpose of this process is to generate an
output file containing the list of documents whose storage term has expired, in order to
review them and take the necessary actions, like:
Extend storage term
Launch Delete documents process
In addition to one of the above: Perform offline export or content export, in order
to create a backup copy of the data
After running this process, a generic metadata is modified (Marked for delete), allowing
users and/or archive administrators to search and browse documents ready for disposal
review.
The Marked for delete and/or Storage term metadata can also be used to define security
rules in order to enable only certain organization user groups to perform the review
process.
In addition to this, a special metadata (Approved by CS) will be used if the document file
plan class requires a committee meeting for disposal approval. A distinct job will mark those
documents, making their lifecycle workflow one step longer.
Deletion of digital content is performed in SEAL by the archive administrator through the
Delete documents process, whose purpose is to soft delete the set of documents that have
been marked for deletion. The process will still check the storage term, retention period and
any retention hold existence before performing any deletion.
The Delete documents process will register an audit record for each document deleted and
will also generate a report (CSV) containing all the metadata values for the deleted
documents. This report is saved into the electronic archive repository and archived in the
same conditions as related documents, with permanent retention. For the archive
administrator the process will also produce a list of errors and exceptions, if any appear,
including a line for each document that wasn’t deleted along with a descriptive error
message.
If required, the archive administrator can grant to certain user groups the delete permission
for documents and they will be able to perform individual, ad-hoc delete operations.
The actual digital content will be deleted asynchronously, by a scheduled job named Storage
cleanup. Whenever required, HCP (SEAL underlying storage) shredding function ensures no
trace of a record is recoverable from disk after deletion.
As stated before, the value of the Storage term, is computed by adding the retention period
to a specific DATE metadata value, the reference date, configured for each metadata
schema. Medical records in a repository can have the storage term computed from Last
patient visit, while contracts can have it computed from Contract expiration date.
Each archived document stored in the electronic archiving system has an information sheet
containing the archive date and timestamp, file size, file format, retention policy and
storage term, along with document metadata. This information sheet also contains a
reference that shows the access rights to the document.
The archive administrator must configure access rights to the archive in accordance with the
requirements of the archived content owner. Those requirements are stated in an electronic
document, also stored in the archive, with permanent retention period.
For each electronic repository, SEAL provides a report with all the existent documents from
the current archive, as well as all the documents that were in the archive at a certain time
and were deleted/destroyed. The report includes information about documents stored by
the beneficiary, like:
Document format (mime-type)
Key words required to identify the electronic document (tags)
Document name
Classification level
File plan class
Archive date (date and timestamp)
Document size (in bytes)
Storage term
Removing user
Exit date
For audit trail an audit report is available. The system provides audit operations (for create,
update metadata, delete, download, search and system login). In other words, any event
associated with the information system or with the lifecycle of documents is recorded. Audit
access is available only to administrators. Audit information cannot be altered even by
administrators.
Depending on the selected filters, the report contains the existing objects from the current
archive or from the system, and all the objects that were in the archive or in the system at
certain time and were deleted. The user has the possibility to export the results in a PDF and
the report file can be downloaded later. Each audit report export is saved into the electronic
archive repository and archived in the same conditions as related documents, with
permanent retention.
2.2 Concepts
In this section, we describe the main terms and concepts used in SEAL and in this
administration manual. Please acquaint yourself with them as they will assist you in the
efficient use of the application:
Concept Description
AcroForm AcroForms (also known as Acrobat forms) are forms created in Acrobat;
some PDF readers (including Acrobat Reader) are capable of rendering
these files as interacting PDFs, with features such as fields and radio
buttons, and allows saving of data within the file.
AcroForms support the concept of templates, allowing additional pages
to be added to the PDF form document to support populating the form.
ADFS Active Directory Federation Services, a software component developed
by Microsoft, can run on Windows Server operating systems to allow
sharing of identity information between trusted partners, outside a
company’s network.
ADFS uses all of the identity information stored in AD (users’ accounts
and passwords), and makes it available externally, outside your network.
This information can then be used by other organizations and
applications.
Users that access SealClientWeb application can view documents according to the security
policies established by the archive administrator and the client administrator.
SealClientWeb and SealAdminWeb users have the possibility to easily find the desired
documents using simple or advanced search, or browsing the folder structures associated
with the created perspectives.
Important: SEAL application does not support Internet Explorer versions older than
9.
Note: In case the used space is too small as compared with the free space, then it
will not be displayed in the chart. In such situations, to check the used/free space,
you can either access the option or the option from the bottom of
the chart.
Hereinafter, you can find the description of the main elements of the interface, as
numbered in the following picture:
If the Enable GDPR option has been selected at the creation of the archive, the GDPR
dashboard will also be available to the archive administrator, along with the archive
dashboard. They both can be retrieved in the Dashboard section from the application main
interface.
After the authentication, the archive administrator can view the last accessed dashboard.
Through dedicated GDPR (the new regulation regarding the protection of personal data)
functionalities, SEAL product provides personal data monitoring capabilities, in order to
have a correct image about the data processing purpose, the processing consent and about
a possible processing restriction.
SEAL also provides support for handling the request flows submitted by the data subjects in
compliance with the GDPR regulation for accessing personal data, portability, restriction
requests and more.
To access the GDPR dashboard, click the GDPR Dasboard command from the Dashboard
section.
This functionality is available to the archive administrator only if the Enable GDPR option
has been activated at the creation of the archive.
Hereinafter, you can find the description of the main sections and charts displayed in the
GDPR dashboard, as numbered in the following picture:
1. Marketing consent missing – this section contains the number of smart folders
which fulfill the conditions specified in the query, folders for which the marketing
consent is missing.
To modify the query parameters, click the associated icon. In the Set query
parameters window, you can modify the following parameters:
The smart folder metadata schema for which results are displayed
The metadata of the selected smart folder schema
The value of the selected metadata
By clicking this section, the user will be redirected to the advanced search interface,
having the criteria selected in the Set query parameters window pre-filled. Also, the
search results will be displayed.
2. Expired document retention – this section contains the number of smart folders
which contain documents whose storage term has expired. To modify the query
parameters, click the associated icon. In the Set query parameters window, you
can modify the smart folder metadata schema which is considered in displaying the
number of folders with expired documents.
3. Children data subjects – this section contains the number of smart folder of the
persons under the age of 18 years.
Similarly, the archive administrator users can change their password by clicking the Settings
area from the main interface of the application.
Also, users can set their time zone by selecting the appropriate one from the Time zone list.
Note that places that observe daylight saving time during their respective summer periods
are listed only once, at the offset for their winter (usually known as standard) period.
4.1 Customers
The master administrator can manage the list of customers that purchase the SEAL
electronic archiving service, by clicking the Clients button from the application main
interface.
To add a new client, you must follow the steps:
1. Click one of the two Add buttons in the Client management window.
2. In the Add client window, fill in the information associated with the client (name,
address, CIF, and the maximum number of active users) and the contact person
details (name, phone, and e-mail address).
The Maximum storage size (GB) refers to the maximum storage capacity allocated to
the archives associated with the current customer.
This field is pre-filled with the value set for the Maximum storage size for trial
archive (GB) system setting and can be modified.
Note: Users of the electronic archives need the licence key (which is generated
when adding a client) during the installation process of Star Capture5 Desktop
application. The licence key is sent to a user in the e-mail message for the access
account activation.
An archive is associated with a client when adding the archive in the system. For more
details, see the Electronic archives section.
To view, modify and delete a client, consult the Appendix – General operations.
The deletion operation is available only for clients which are not assigned to an archive.
1. Click one of the two Add buttons in the List digital certificate window.
2. In the Add certificate window, fill in the information associated with the certificate -
name, serial number, issuer, the person for which is issued, and the validity period.
3. Click Save to add the certificate in the system.
To view, modify and delete a digital certificate, consult the Appendix – General operations.
Note: When filling in certain information, the application allows entering a limited
set of special characters.
If the user enters an unsupported character (for example, entering one of the
characters: <>%$*#!?|}{=\), a warning message will be displayed: ”The expression
you entered has an incorrect character.”
1. Click one of the two Add buttons in the Archive management window.
2. In the Details step from the Add archive window, fill in the fields as follows:
Client – select the client associated with the new archive.
Name – enter the archive name.
Description – enter a few details about the new archive.
Access level – select the Public or Classified value from the list. The access
level defines the way in which users can have access to this information.
Therefore, an archive with Public access level can be accessed by Internet,
and for an archive with Classified level, access must not be performed by
Internet. Taking into account that the archiving application itself cannot
detect whether it is accessed by Internet or not, this security restriction will
be applied at the technical level of communication network connectivity.
According mode – you can select one of the following values: Compliance
mode or Business mode. The first option allows the achievement of
documents archiving flow in compliant conditions with The Law of Electronic
Archiving; the second does not require the compliance with archiving law,
thus offering the possibility to edit and delete documents from the archive.
Provision Type – select one of the predefined templates, provided at SEAL
installation. The templates are configured in the system settings section, in
the Archive provision type property.
According to the template selected when creating the archive, certain metadata
schemas will be automatically created.
Style files location – fill in the name of the directory on the server, which
contains the theme for the interface. In case the user does not enter any
value, the theme will be the default one (usually, these themes are located
on the server where the application is installed, \staticcontent\seal\style).
Licence type – select the archive licence type:
Trial – a Trial archive is an archive for which can be defined a limited
number of users. This number is configured in the Settings section, in
the Maximum number of active users for a trial archive field. The
active users which are taken into account for a Trial archive are: client
administrator and client user.
Licenced – when a new user is created on a licenced archive, the
application checks whether the maximum number of active users for
a client is not exceeded. The system counts only the users of
SealClientWeb application (client administrator and client user) which
are associated with the licenced archives, and not the archive
administrator users.
3. Select the digital certificate used to sign documents and click Next to go to the next
step.
4. In the Storage & Index step, fill in the information regarding the storage of the
archive content and the indexing settings. There are four possible values for the
storage type: DISK, Documentum, HCP and Tivoli.
Note: HCP is an independent solution which allows the storage of the archived
documents content. The HCP namespace and tenant for SEAL system must be
created and configured accordingly, before accessing the create archive
functionality.
Documentum is an independent solution which allows the storage of the archived
documents content in a defined docbase. The Docbase for SEAL system must be
created and configured accordingly, before accessing the create archive
functionality.
Tivoli is a data protection platform that enables reliable backups and fast recovery
for virtual, physical and cloud environments of all sizes.
Hereinafter, you can find the description of the fields that must be filled in according to
the selected storage type:
1. DISK:
Archive – select the generated option in case you want the application to
automatically generate the folders structure, where the archive content will
be saved; select the existent option in case the structure already exists.
The following metadata must be filled in only if the existent option was
selected. The folder structure to be created is: storage root→ client folder→
archive folder.
Storage root – fill in the path to the root folder where the archive content
will be stored (for example, e:/seal/storage).
Folder for client – fill in the name of the client folder (for example, SC
ECOCLEAN SRL).
Folder for archive – fill in the name of the archive folder (for example, SC
ECOCLEAN SRL).
If you select the generated option, the application automatically creates a folder
structure of the form: storage rootCIF clientArchive code, where:
2. Documentum:
Docbase – fill in the name of the docbase where the documents content will
be stored.
Administrator – fill in the user name of the docbase administrator.
Password – fill in the password of the docbase administrator.
Folder for backup – fill in the path to the location where the archive backup
copy will be saved (for example, \\<server_name>\sealOfflineExport).
Encrypted content – select the check box associated with this option if you
want the archived PDF documents to have encrypted content. Thus, the
content of the archived documents will be available only from the
application, and not from the location where they are stored.
This storage type does not offer the possibility for the docbase to be automatically
generated by the application.
For the Documentum storage type, the Test button is available, allowing the user to
check Documentum connection. If the Documentum connection information is
incorrect, therefore the warning message will be displayed: Connection failed.
3. HCP:
Archive – select the generated option in case you want the application to
automatically generate the folders structure, where the archive content will
be saved; select the existent option in case the structure already exists.
The following metadata must be filled in only if the existent option was
selected.
HCP address (hostname) – fill in the HCP address (for example, hcp-
dc.star.ro).
HCP basename – for this field, you can enter a string of the form:
HCP_BASENAME = hcp-demo.hcpdomain.com
HCP tenant – fill in the HCP tenant for SEAL.
HCP namespace – fill in the HCP namespace for SEAL.
HCP user – fill in the account user name that can access the HCP namespace.
HCP password – fill in the access account password to HCP namespace.
Use HCP retention – if you select this option, the retention class in HCP is
filled in according to the metadata defined as the reference date for the
document type.
Initial size – fill in the initial size (in GB) of the space assigned to the HCP
tenant and namespace for SEAL.
User Tenant – fill in the name of the user who can access the tenant specified
in the HCP tenant field.
User Tenant Password – fill in the password of the user who can access the
tenant specified in the HCP tenant field.
Folder for backup – fill in the path to the location where the archive backup
copy will be saved (e.g. \\<server_name>\sealOfflineExport). This path is used
by the application when running an Offline export process. For more details,
consult the Offline export section.
Note: If you select the generated option for the Archive field, the application
automatically creates in HCP a tenant called CIF client and a namespace named
Archive code.
If you select the existent option, the Test button appears, allowing the user to
check Documentum connection. If the Documentum connection information is
incorrect, therefore the warning message will be displayed: Connection failed.
4. Tivoli
Archive – select the generated option in case you want the application to
automatically generate the folders structure, where the archive content will
be saved; select the existent option in case the structure already exists. The
following metadata must be filled in only if the existent option was selected.
File space name – fill in the name of the file space in which the archived
documents will be stored.
Folder for backup – fill in the path to the location where the archive backup
copy will be saved (e.g. \\<server_name>\sealOfflineExport). This path is used
by the application when running an Offline export process.
Encrypted content – select the check box associated with this option if you
want the archived PDF documents to have encrypted content. Thus, the
content of the archived documents will be available only from the
application, and not from the location where they are stored.
After filling in the details regarding the archive content storage, the administrator must fill
in the information about the indexing settings:
Number of shards – fill in the number of Shard nodes that will be created on
the archive collection.
Replication factor – fill in the number for the replication factor of a Shard
node.
Maximum number of shards for a node – fill in the maximum number of
shards that can be created on a node, which is associated with a core.
Shard key metadata – fill in the internal name associated with the dispersion
metadata. The value of the dispersion metadata helps to split documents on
all shard nodes, when there is a lot of data on a single shard node.
Full text search – select the check box associated with this option if you want
the user to be able to perform a simple search by entering text sequences
that can be found in the content of the archived documents.
After filling in the details regarding the archive content storage and the indexing settings,
the administrator must click Next to go the following step:
Note: If you select the existent option, the Test button appears, allowing the user
to check the database connection. If the database connection information is
incorrect, therefore the warning message will be displayed: Connection failed.
Important: In case a database already exists (and the existent option was selected),
the master administrator must make sure that the tables’ population script was not
run for the existing database. For all the existing databases, associated with
archives in the application, the tables’ population script was automatically run
when the archives were created. Moreover, the database must be created and
configured accordingly.
The brief steps that must be performed in order to create and configure the database, in
SQL Server, for example, are described in the Appendix – create and configure a SQL Server
database.
After filling in the details regarding the database associated with the archive, click Next to
go to the following step.
6. In the LDAP step, fill in the details regarding the synchronization with a LDAP server,
as follows:
Connection name – the name of the connection to LDAP server.
Server URL – the URL server address. For example: 192.168.101.166.
Port – the network port of LDAP server. The standard port for LDAP is 389.
Username – the name of the user who can authenticate to LDAP server.
Password – the user’s password.
The synchronization allows taking information about the users who have Active
Directory accounts and automatically creates access accounts in SealClientWeb
application.
Note: Users from Active Directory must have their e-mail addresses filled in, for the
synchronization to be performed. Users from Active Directory are imported in SEAL
as client users and they implicitly have the Unclassified (0) authorization level.
7. In the SEAL Physical Records step, fill in the following fields for the integration with
SEAL Physical Records:
SEAL Physical Records server address – fill in the URL address used to
connect to SEAL Physical Records server, more specifically the IIS server
Note: To synchronize the physical containers coming from SEAL Physical Records
application, it is necessary to import the SEAL Physical Records certificate into the
Java keystore used by the application servers where SEAL is installed (JBoss).
Note: When an archive is created in the system, the application sends a notification
e-mail to the master administrator which contains the connection data to the
archive database. In addition, for a HCP storage archive, the e-mail contains the HCP
connection data: namespace and tenant name, namespace and tenant user, the
encrypted passwords of the tenant and namespace users. To decrypt the passwords
from the notification e-mail, the master administrator must use the
encryption/decryption tool, which can be accessed from the Resources section.
For details regarding the archive content, you can only modify the Folder for backup field.
For an archive with HCP storage type, you can only modify the HCP password field, if
necessary.
For an archive with DISK or Documentum storage type, no metadata can be modified.
In the Database step, the information associated with the database cannot be modified.
If the database was automatically generated, the master administrator can access the
details about the database associated with the archive in the server configuration file. The
datasource is automatically generated by SEAL on the applications server where SEAL is
installed.
In the LDAP step, the information about LDAP and LDAP plugin cannot be modified.
To delete an archive, click the Delete button associated with it. In the confirmation
window, the master administrator is informed of the following: the deletion of the archive
results in removing any reference of the archive in SEAL system and no user will be able to
access the archived data. All archive users’ will be disabled, but they will remain in
SEAL_MASTER database and they will be active on the other archives to which they are
associated, if any.
If you also want to remove the archive database, the archive content and the results of all
Offline export processes, select the options corresponding to them.
Note: For the archives whose content is stored in Tivoli or Documentum, the content
of the archive cannot be deleted.
After entering the password of your access account, click the Yes button.
The deletion operation is performed by means of the Delete archive process, which is
automatically created when the master administrator accesses the button that confirms the
deletion of the archive. The process audits the archive deletion and saves all its properties in
the details of the audit event. To view the process details, consult the Processes section.
For more details about associating an archive with a user, see the Users section.
1. Click one of the two Add buttons in the Administrator management window.
2. In the Administrator details step from the Add administrator window, fill in the
fields as follows:
E-mail address – fill in the administrator e-mail address.
Important:
Note that the e-mail address of an archive administrator must be correctly
filled in, considering that, after creating a new user, the system will
automatically send a notification e-mail to the address filled in the E-mail
address field. The notification e-mail contains the user’s password. At a first
login, the newly created administrator will use the username and password
provided in the notification e-mail to authenticate in the application. Then,
the system will ask the administrator to change the password. The e-mail
address must be unique in the application.
If you enter the e-mail address of a user which already exists in the system
(client user or client administrator), the application will display a message
informing the user that it has been found a user with the same e-mail
address. You can save the user with an archive administrator role.
Username – fill in the name that the archive administrator will use to log on
to the application.
First name – fill in the first name of the administrator.
Last name – fill in the name of the administrator.
Description – enter a short description of the archive administrator.
Authorization level – represents the access level to the archived documents
according to the following laws: the access law on classified information and
the law regarding the access to strictly confidential information. The user will
have access to those documents which have the same classification level or
lower level than his authorization level. The values that can be selected from
the list are: Unclassified (0), Protected (1), Confidential (2), Secret (3), Top
secret (4).
Important: It is important to keep in mind that the authorization level is applied only
for client users.
To reactivate an account, the master administrator must click the Enable button from
the Administrator management window. This button appears when you hover the mouse
over the Disable button associated with a user whose account is disabled.
The master administrator can manage the accounts of system users, by clicking the
Integration users tab from the Administrators section.
The system users are:
To view the information of a system user, click the associated View button.
To modify the information of a system user, click the associated Edit button. The
information that can be modified is: the password, the e-mail address, the first name and
the last name of the system user.
There is no possibility to delete or create a system user.
The general settings are divided into sections; by positioning the mouse over the icon
associated with a field, the administrator has the possibility to view information about that
metadata.
The master administrator can modify the system general settings, whose descriptions can
be found in the following table:
System setting Description Example
Time interval before The time interval after which a new 1000
attempting to resubmit retry is started to execute a Solr
a Solr query (ms) query, if the last attempt has failed.
Maximum size of files The maximum size (in MB) of the 9000000
for export content (in files exported after an advanced
MB) search, by running the Export
documents with content process.
Terms and conditions If this option is selected, users must It can be either selected
accept SEAL terms and conditions.
Use token If this option is selected, the user It can be either selected
authentication filter who launches SEALUploader and or not.
StarCapture applications from SEAL
main interface doesn’t need to
enter the connection data for these
applications, as they are
automatically taken from SEAL.
List of video file A list of HTML5 supported video Mp4, m4v, ogv, webm
formats extensions. A video viewer icon will
be displayed if the file extension is
supported and the content of the
file will be opened within a
dedicated viewer. Please check
www.w3.org or
www.w3schools.com for an
updated list.
List of audio file A list of HTML5 supported audio Aac, mp4, m4a, mp1,
formats extensions. An audio viewer icon mp2, mp3, mpg, mpeg,
will be displayed if the file extension oga, ogg, wav, webm
is supported and the content of the
file will be opened within a
dedicated viewer. Please check
www.w3.org or
www.w3schools.com for an
updated list.
CMIS Seal base URL The protocol used to contact SEAL http or https
scheme CMIS server.
If SAP Content Server Library Services is enabled, you must also perform the following
steps:
Unzip the sapjco30P_6-10005326.zip file to a local path on your SEAL server. If SEAL
is installed in cluster architecture, then the steps must be repeated on every server
where the application server is hosting SealAsynchronousApplication.ear. Write
down the path to the unzipped folder.
Create (or edit, if already exists) the system environment variable CLASSPATH
pointing to the SAP JCo jar file. E.g.:
To configure the process, click the corresponding Edit button from the Recurrent
processes tab. In the Edit recurrent process page, you can run the process immediately by
clicking the Run button or schedule the process to run at a certain time with a certain
frequency. For this purpose, enter the date and time for the process next run, as well as the
running frequency and click Save.
The process becomes active (marked with the button). At each execution of the process,
the application creates a background process that can be accessed in the Background
processes page.
To view the history of the process executions, click the Runs history link from the History
column. You will be redirected to the Background processes page.
To view the process details, click the Information button corresponding to the Update
storage information process, located in the Background processes tab.
If a process does not run successfully, its state will be Error and will have an errors.txt file
associated which will contain the encountered errors.
To configure the process, click the corresponding Edit button from the Recurrent
processes tab.
In the Edit recurrent process page, you can immediately run the process corresponding to
an archive by clicking the Run button or schedule the process to run at a certain time
with a certain frequency. For this purpose, enter the date and time for the process next run,
as well as the running frequency and click the associated Save button.
The process becomes active (marked with the button in the Recurrent processes tab).
At each execution of the process, the application creates a background process that can be
accessed in the Background processes page.
To disable the process for all the archives for which it has been configured, click the Disable
button in the Recurrent processes tab. This button appears when you hover the mouse
over the Enable button associated with an active process.
To individually disable a process for an archive, click the Disable button corresponding
to the desired archive from the Edit recurrent process window. The process status for that
archive will be Inactive.
A process which is not active for any archive has the button associated with it in the
Recurrent processes tab.
To view the history of the process executions, click the Runs history link from the History
column. You will be redirected to the Background processes page.
To view the process details, click the Information button corresponding to the
Compute archive statistics process, located in the Background processes tab.
If a process does not run successfully, its state will be Error and will have an errors.txt file
associated which will contain the encountered errors.
5.1.1 Users
The archive administrator has the possibility to manage the list of users for the current
archive, by clicking the Users command from the Security section. Users created by the
archive administrator can access SealClientWeb application.
To add a new user, follow the steps:
1. Click one of the two Add buttons in the User management window.
2. In the User details step from the Add user window, fill in the information associated
with the user (name, first name, e-mail address) and click Next.
3. In the Associated archives for user step, select the archives associated with the user
and his role.
In the Role list, the following values are available:
Client user
Important:
Note that the e-mail address of a user must be correctly filled in, considering
that, after adding a new user, the system will automatically send a
notification e-mail to the address filled in the E-mail address field. The
notification e-mail contains the activation link for the user account. When the
activation link is accessed, the system requires setting a password.
The e-mail address must be unique in the application.
In the Username field, you must fill in the name used to authenticate in the
application.
If you enter the e-mail address of a user which already exists in the system,
the application will display a message informing the user that it has been
found a user with the same e-mail address. You can save the user either with
a client user role, or with a client administrator role.
If you enter the e-mail address of a user which already exists in the current
archive, the application will display a message stating that a user with the
same e-mail already exists in the archive and you will not be allowed to save
it.
Note: When filling in certain information, the application allows entering a limited set
of special characters.
If the user enters an unsupported character (for example, entering one of the
characters: <>%$*#!?|}{=\), a warning message will be displayed: ”The expression
you entered has an incorrect character.”
Important: When you add a new user (Client administrator or Client user), you must
take into account the maximum number of users that was set when adding the client
that has associated the archive on which you want to add the user. If you exceed the
number of admitted users, the application displays a warning message.
To view, modify, and delete a user, consult the Appendix - General operations.
The deletion operation is available only for the users which have not logged on the
SealClientWeb application.
The archive administrator can reset the password of a user, by clicking the Reset password
button from the User management window.
If the archive administrator confirms the password reset operation, the system sends a
notification e-mail to the user. To set the new password, the user must access the link from
the e-mail message. The link is valid for one day and can be used only once. When setting a
new password, several requirements must be fulfilled, requirements which are displayed in
the application login interface.
The archive administrator can disable a user account by clicking the Disable button from
the User management window. This button appears when you hover the mouse over the
Enable button associated with a user whose account is active.
A user with a disabled account cannot access the SealClientWeb application. Also, for a user
with a disabled account, the following operations are not available: edit, delete, or reset
password.
To reactivate an account, the archive administrator must click the Enable button from
the User management window. This button appears when you hover the mouse over the
Disable button associated with a user whose account is disabled.
The archive administrator can add and modify groups of users, in order to define the
security model, for each archive.
To manage user groups, click the User groups command from the Security section.
The archive administrator can add a group of users without a reglementation document, or
he can assign either a new reglementation document to the group or already created
reglementation documents. The reglementation document represents the supporting
document provided when creating or modifying a group of users. These can be found in the
administrative documents area (the Administrative documents section).
1. Click one of the two Add buttons in the Group management window.
2. In the Users group details step from the Add group window, fill in the group name
and select the users that will be part of the group.
3. In the Supporting document list, you can select one of the following options:
a. One of the existing reglementation documents – in order to add a group with
an existing supporting document.
b. The New document value - in order to add a group with a new supporting
document.
c. The No document value – in order to add a group without a supporting
document. This value is available only for Business archives.
4. If you select the 3a. or 3c. option, click Save to add the group in the system.
5. If you select the 3b. option, click Next to go to the following step, that is
Reglementation document.
6. In the Reglementation document step, click Browse to upload the reglementation
document and fill in the associated information.
7. Click Save to add the group of users in the system.
To view, modify, and delete a group of users, consult the Appendix - General operations.
The deletion operation is available only for groups which are not associated with a security
policy. For more detailed information about assigning a group of users to a security policy,
consult the Assign permissions using security policies section.
Automated rules are logical expressions, based on the documents or smart folders
metadata. They are evaluated whenever a new document is uploaded in the electronic
archive or when a smart folder is created, in order of their priorities.
To manage automated rules, the archive administrator must click the SecurityAutomated
rules section from the application main interface.
This section is organized in the following tabs:
Security rules
Retention rules
Workflow rules
Security rules are used when no security policy is explicitly sent from the upload documents
tool.
In this case, when uploading documents in the system, after evaluating a logical expression,
the application decides whether to apply a certain policy, or to evaluate the next security
rule. Evaluation is made by taking into account the priority established for each security
rule, when creating it. If no security rule is applied, the system automatically establishes the
default policy of the archive for the uploaded document.
1. Click one of the two Add buttons from the corresponding tab: Security
rules/Retention rules/Workflow rules.
2. In the Rule details step, fill in the name of the rule in the Rule name field.
3. To compose the rule, use the fields described below:
Logical operator – select the logical operator which connects the conditions
added in the rule’s body: N/A (begin condition), AND, OR. The N/A (begin
condition) value is used only before the first condition which is added to the
rule.
Choose metadata schema – select the document metadata schema or the
smart folder schema for which the rule will be applied and then click the Add
new condition to rule icon to add the condition to the rule.
You can add a condition based exclusively on a metadata schema name or,
after clicking the Add new condition to rule button, you can also add a
condition regarding a metadata.
To consecutively add many conditions to the security rule, repeat the steps
described above and click the Add new condition to rule button.
The created rule is displayed in the Rule field. To delete the conditions added in the
rule’s body, click the Clear rule button.
To manually edit the rule, click the Edit rule (Advanced users only) button.
4. Click Next to go to the second step, where you will establish the following, according
to the automated rule type:
The security policy which will be applied to the documents/smart folders if
the security rule is successfully evaluated.
Select a policy from the Select security policy list or the New policy value.
Expand the file plan tree structure and select the file plan class which will be
applied to the documents which fulfill the criteria of the rule. Only leaf nodes
can be selected. When a file plan class is selected, its details are displayed
next to the file plan structure: name, code, retention period, whether a
selection committee meeting is required or not.
To cancel the selection of a file plan class, click the Deselect button or select
another file plan class.
The workflow to which the documents/smart folders will be sent if the rule
is successfully evaluated.
For this, fill in the following fields:
Default Workflow Name – select the workflow definition to which the
document/smart folder will be automatically sent when it is
uploaded/created in the archive. The list contains only the workflow
definitions, for which has been configured in the BPMN file, the name
of users or groups of users to which each task is assigned.
Default Workflow Message – fill in the message which explains users
what needs to be done to successfully complete the workflow.
Default Workflow Due Time (hours) – fill in the due time (in hours)
for solving the workflow tasks.
Note: When you create a rule which contains a condition based on the Signing status
metadata, the value of the metadata must be specified by the status code from the
database, and not by its name (Signed or Not signed). Thus, the code which
corresponds to the Not signed status is 2, and the code corresponding to the Signed
status is 8.
Note: In order to create composed rules, you must use the parentheses to separate
the conditions in the rule’s body. For this purpose, you must manually edit the rule,
as in the following example:
((MetadataSchema = "Bill of lading" + Issuer ="John Smith"), (MetadataSchema =
"Bill of lading" + Issuer ="Sarah Brown"))
The application automatically associates an integer number, named priority to each rule
which is added in the system. To change the priority of the rules displayed in the grid, use
the Move up and Move down buttons.
Note: 1. When filling in a value for a date type attribute, make sure that the date is
entered in the correct format. For more information, consult the Metadata types
sub-section, in the Metadata schemas section.
2. When filling in certain information, the application allows entering a limited set of
special characters.
If the user enters an unsupported character (for example, one of the characters:
<>%$*#!?|}{=\), a warning message will be displayed: ”The expression you entered
has an incorrect character.”
To view, modify and delete a rule, consult the Appendix - General operations.
Any archived document can be associated with security permissions which determine the
users’ access to that document (see the Security policy metadata associated with each
document). These permissions are specified in the security policy.
To manage security policies, the archive administrator must access the Security button
from the application main interface.
Note: The last two permission levels (Edit and Delete) are available only for Business
archives.
Moreover, for each security policy, the administrator can configure the rights of a document
creator. The creator of a document is the user who uploaded the document in the
electronic archive. The creator can be any of the users defined in SEAL application, except
for the master administrator. The creator’s access to the archived documents is defined
depending on the rights granted to the creator. The creator will always have the right to
view at least the document form.
The creator’s rights are the same with the permission levels of a group of users mentioned
above.
Another permission which defines the right of a client user to a document is the share
permission.
This permission can be assigned to the creator or to the groups of users and is not
cumulative with the other security rights. However, in order to have the share permission,
the creator or the group of users must have at least the view document content permission.
The client users which are part of the group associated with a security policy and have the
share permission can add documents to a collection and can activate it.
Thus, based on the evaluation of the security rules defined in the archive, one or more
policies can be applied to a document. If no security rule is applied, the system
automatically establishes the default policy of the archive for the uploaded document.
If the criteria from several security rules are fulfilled, all policies specified by the rules will be
applied to the document. Therefore, security permissions for a user will cumulate. For
example, if a user has the right to View document content, specified in a policy, and the
right to Delete, specified in another policy associated with the document, the user will have
the right to delete the specific document. Similarly, the security permissions of the creator
are also set.
If it is necessary, the security policies of a document/set of documents can be edited as
follows:
By running a background process by the archive administrator. For more details,
please check the Apply security policy section.
By editing the values of the documents metadata, metadata which are part of the
security rule definition. The security rules are dynamically re-evaluated when the
editing is done, so the policies applied to the document can change.
To manage security policies, click the Security policies command from the submenu
displayed when selecting the Security button from the application main interface.
To add a security policy, you must perform the following steps:
1. Click one of the two Add buttons in the Security policy management window.
2. In the Security policy details step from the Add security policy window, fill in the
policy name and select the security permissions associated with the groups that will
be part of the security policy. Also, select the creator’s rights. Select the check box
associated with the Default policy option if you want the newly created policy to be
the default policy of the current archive.
Note: The deactivation of a default policy on an archive can be done only by selecting
the Default policy option corresponding to another policy. Only a single default
policy can be defined on an archive at a time.
In Business version, a default policy is automatically created when creating an
archive.
3. In the Supporting document list, you can select one of the following options:
a. One of the existing reglementation documents – in order to add a policy with
an existing supporting document.
Note: When filling in certain information, the application allows entering a limited set
of special characters.
If the user enters an unsupported character (for example, entering one of the
characters: <>%$*#!?|}{=\), a warning message will be displayed: ”The expression
you entered has an incorrect character.”
To view, modify, and delete a security policy, consult the Appendix - General operations.
The deletion operation is available only for the policies which haven’t been applied to
documents uploaded in the system or which are not associated with a security rule.
The archive administrator can manage collections of documents, whose purpose is to group
documents in order to share them with a set of users. Users can temporarily or permanently
view documents using the browsing and searching standard functionalities or by accessing
the dedicated section from the application main interface. Also, the documents of a
collection can be shared with other users, from outside SEAL system.
If a client user is associated with a collection of documents, the client user can view the
metadata and the content of the documents in the collection, even if he is not part of a
group which is associated with the security policy that is assigned to those documents.
If the client user already had access to the documents as being part of a group with
permissions assigned to the security policy associated with the documents, then the client
user will have access to the documents according to those permissions.
By means of the interface, the administrator can create a collection, can activate it (provide
access), can revoke it (remove access), and can delete it.
You can add documents to a collection by using one of the following methods:
1. Click one of the two Add buttons in the Collections management window or -
after performing an advanced search - click the Select collection button, select the
[New collection] value, and click Save.
2. In the Collection details step from the Add collection window, fill in the collection
name and select the period of time in which the grant of rights is valid. At the same
time, you can fill in a message that will be transmitted to the users who access the
documents of the collection, after activation.
3. In the Supporting document list, you can select one of the following options:
a. One of the existing reglementation documents – in order to add a collection
with an existing supporting document.
b. The New document value - in order to add a collection with a new supporting
document.
c. The No document value – in order to add a collection without a supporting
document. This value is available only for Business archives.
4. If you select the 3a. or 3c. option, click Next to go to the Users step.
5. If you select the 3b. option, click Next to go to the Reglementation document step.
In this interface, click Browse to upload the reglementation document and fill in the
associated information. Then, click Next to go to the Users step.
By clicking the Activate icon from the Collections management window. This
button appears when you hover the mouse over the Revoke button associated
with an inactive collection.
By clicking the Save and Activate button in the collection editing interface, in the
Documents step.
From a collection adding interface, starting from the simple and advanced search or
from the navigation sections.
When the archive administrator activates a collection, the application sends a notification e-
mail to all client users and external users to which the documents of the collection have
been shared. The notification e-mail contains a link, its accessing directing users to SEAL
application, in My Collections section. In case of SMS code authentication, when an external
user accesses the link from within the notification e-mail, a code will be sent to his phone
number as a text message and the user will be redirected to a dedicated authentication
interface where he will be asked to provide the SMS code in order to authenticate in the
application. The generated code sent via SMS expires after one minute.
To inactivate a collection, the administrator must click the Revoke icon from the
Collections management window. This button appears when you hover the mouse over the
Activate button associated with an active collection. The documents of an inactive
collection cannot be accessed by the users associated with it.
Revoking access only to one or more external or client users can be done from within the
editing interface of a collection, as follows:
By removing the check mark corresponding to the name of the client user.
By deleting the e-mail address corresponding to the external user, when clicking the
associated Delete button.
To view, modify, and delete a collection of documents, consult the Appendix - General
operations. The deletion operation is not available for an activated collection.
At the institution level, the file plan is made according to the Flow chart and the
Organization and Working Rule of the institution who owns the archived documents.
In SEAL, the file plan is presented as a table or as a tree structure, in which are listed, by
compartments, the categories of documents grouped by problems and storage terms.
Grouping documents on the basis of the file plan has a great importance for the regulation
of the retention policies and for the recovery of documents information.
The file plan can be changed only if the flow chart changes or the organizational structure of
the institution changes.
For example, if new directions, services or other compartments and divisions are
introduced, the file plan is updated with the names of the new structures and folders
created by them. If some compartments or their divisions develop their activity and enlarge
their responsibilities, the file plan is completed with the new genres and categories of
documents, as well as with their corresponding storage terms.
The archive administrator has the possibility to manage the versions of the file plan, by
clicking the File plan command from the submenu displayed when selecting the Manage
data model button from the application main interface.
The administrator can consult the list of the existing file plan versions. Versions are defined
in time in such a way that at a particular moment, only one version of the file plan to be in
force; it must not be a moment in time when no version of the file plan to be in force. The
previous versions will continue to be available for adding documents.
Create a new version of the file plan
To create a new file plan version, the administrator can start with a copy of the current file
plan version (if there is one) and edit its structure.
To add a new file plan version, click one of the two Add buttons located in the File plan
management window. A new unpublished version of the file plan will be available, whose
structure will be created.
Note: In Business version, a default file plan version is automatically created when
creating an archive.
Important: When you create the first file plan version, in order to be allowed to
store older documents, the file plan date of entry into force must be earlier than the
current date.
By placing the cursor of the mouse over a compartment or category of documents, you can
access several available operations for the selected compartment or category, as you can
see in the following picture:
Add compartment
To add a new compartment, click one of the or buttons. In the File plan class details,
select the Department value for the Type attribute and fill in the code and name of the
compartment. Then, click Save.
To add a new category of documents, click one of the or buttons. In the File plan
class details, select the Document category value for the Type attribute and fill in
accordingly the rest of the attributes. Then, click Save.
Note: The administrator can select the check box associated with the Selection
committee field in order to be gathered a selection committee for the deletion of a
document using a process of the Delete documents type.
To permanently keep the documents in the archive, the Permanent option must be
selected.
To view the hierarchical structure of the file plan, click the View button associated with
the version. The compartments or categories of documents cannot be modified if the file
To view the file plan structure in a tabular form, click the icon associated with the
version.
The user has the possibility to export the file plan in a PDF file by clicking the Export button.
The file resulted after the export can be downloaded from the background processes area
or from the administrative documents browse area (see the Export file plan and
Administrative documents sections).
The metadata schema represents a list of attributes which describe a document or smart
folder type. In this manual, the metadata schema is also known as document or smart folder
type.
The archive administrator can manage metadata schemas by clicking the Metadata schemas
command from the submenu displayed when selecting the Manage data model button
from the application main interface.
1. Click one of the two Add buttons in the Manage metadata schemas window.
2. In the General information step from the New metadata schema window, fill in the
fields as follows:
Name – fill in the name of the metadata schema.
Description – fill in a few details about the schema.
Metadata schema type – select the schema type: Archived documents or
Smart folders.
Prefix record name – select this option if you want all the documents names
to start with the metadata schema name.
3. Click Next to go to the Metadata step, which is organized in three tabs: Specific
metadata, Generic metadata and All metadata.
4. In this step, you can modify the options of the generic metadata or add specific
metadata. To add a specific metadata, click the New metadata icon from the
Specific metadata tab. For more details, see the Add specific metadata section.
If you modify the position in name for a metadata within a metadata schema, the
modification will be taken into account the next time when documents will be
uploaded in the application. Changes will not be applied to the documents which are
already in the electronic archive.
7. In the Retention tab, from the Retention period start metadata field select a DATE
type metadata as a date from which the storage term will be computed. This
metadata can be a mandatory one or not.
Note that when ingesting a document, if the retention period start metadata points
to a metadata for which no value was given, then the storage term will not be
computed and will appear as Not set. The retention policy will show the predefined
rule (e.g. 20 years from the retirement date). These documents can be deleted only
after setting the metadata at which the retention period starts. Until then, for delete
operations, an error message will be shown (stating that the documents cannot be
deleted because they have no retention period set). Similarly, neither the Mark
documents for deletion job nor the REST services will be able to delete the
documents until the storage term is set.
8. In the Document templates tab, you can decide whether or not the content of the
documents uploaded in the archive on this metadata schema (using the Web Upload
form) to be generated based exclusively on a template. If yes, select the check box
associated with the Generate content based exclusively on template option and
select a template from the list, then click the Add button. Only one template
must be selected.
Otherwise, if you do not wish for the documents content to be generated exclusively
based on a specific template, leave this option unchecked. Optionally, you can
associate one or more templates to the metadata schema by selecting them from
the Choose template list, one by one, and clicking the Add button. Thus, when
uploading a document in the archive, you can also generate its content using one of
the selected templates, besides adding a document from the local disk.
Also, it is necessary to select the Unique key for search option for at least one
metadata.
Thus, each time a document is uploaded in the archive, on a document metadata
schema for which folder distribution mappings have been made, a folder having the
configured folder schema will be searched for, whose values coincide with the values
of the document metadata, for the mapped metadata.
If no such folder exists in the archive, it will be created, its metadata being initialized
with the values of the document metadata, according to the mappings configured in
this section. If a single folder is found, whose unique key value coincides with the
value of the configured document metadata, the document will be uploaded in it;
otherwise, a new folder will be created. If several folders are found, the document
will be added to all of them.
If several unique keys are configured, when a document is uploaded in the archive,
all unique keys must be validated in order to add the document to a folder.
If the Override value option is selected for a metadata, when a document is
uploaded in a smart folder, the value of the folder metadata will be replaced with
the value of the document metadata.
In this interface, you have the possibility to rename the newly created metadata, to select
its type and to select the desired options according to the following explanations:
Edit – select this option if you want the metadata associated with the schema to be
editable in the application interface (see the Edit specific and generic metadata for
an archived document section).
View – select this option if you want the metadata associated with the schema to be
visible in the electronic form of a document or folder. If the Display in entry form
option is also selected, the metadata will also be visible in SEALUploader and
StarCapture5 Desktop interfaces.
Mandatory – select this option if you want the metadata associated with the schema
to be mandatory when uploading a document in the application.
Browse – select this option if you want the metadata associated with the schema to
be visible while browsing the archive, in document grids.
Multivalued – this option can be checked only for the value list type metadata. If
checked, multiple values can be selected for the metadata, from a predefined value
list. For more details on defining value lists, please see the Value lists section.
Display in entry form – select this option if you want the associated metadata to be
displayed when a document is uploaded in the archive, as follows: in the web upload
form and in SEALUploader and StarCapture5 Desktop interfaces. The selection of this
option for a metadata depends on the selection of the View option.
Note: A default value can be set for any visible, specific or generic metadata
which is not a system metadata, except for the issuedDate,
archiveClassificationClass and securityPolicy metadata.
Extractor type
If, for your metadata you configure an Extractor type, then when you upload a
document the value for the metadata will be extracted from the file properties and
automatically set to your metadata. For example, if you upload a file that has your
name in the properties author field, then your name will be automatically set as the
value of the metadata that has the Extractor type set to author.
RegEx for
If you configure RegEx for a metadata, when a document is uploaded in the archive,
the value of the metadata configured for RegEx will be extracted from the document
content and automatically set for your metadata. The uploaded document must be
searchable and the archive must have the Full text search option enabled.
For example, if you set the CNP value for RegEx, the CNP found in the content of the
uploaded document will be automatically set as the value of the metadata that has
the RegEx set to CNP. If several values are found for CNP, these will be separated by
commas.
Note: A metadata cannot have values set for both the Extractor Type and
RegEx at the same time.
Edit
View
Mandatory
Browse
Index – select this option if you want the metadata associated with the schema to
be indexable.
Multivalued
Display in entry form
GDPR
The supported file types from which Solr can extract properties values are the ones
supported by Apache Tika 1.7.
The values that can be extracted from the file properties can be verified in the Solr interface
executing the request handler /update/extract with the Raw query parameters
stream.file=<local_file_path>/<file_name>.<file_extention>
&literal.id=coco&captureAttr=true&capture=true&extractOnly=true
Example:
stream.file=D:/Invoices/NewInvoice.docx&literal.id=coco&captureAttr=true&capture=true&
extractOnly=true
Extract the desired properties form the result of the query.
Modify the properties name – change all the uppercase characters to lowercase and replace
white spaces and punctuation signs with underscore. For example, Message To will become
message_to.
The desired properties must be inserted in the schema.xml file of Solr and in SEAL System
Settings.
For example, the following can be added to the schema.xml:
<!--emails -->
<field name="message_from" type="text_general" indexed="true" stored="true"/>
<field name="message_to" type="text_general" indexed="true" stored="true"/>
<field name="message_cc" type="text_general" indexed="true" stored="true"/>
<field name="message_recipient_address" type="text_general" indexed="true"
stored="true"/>
<!--mp3 -->
<field name="xmpdm_album" type="text_general" indexed="true" stored="true"/>
For the above example, the corresponding values must be added in System Settings:
message_from:STRING,message_to:STRING,message_cc:STRING,message_recipient_address
:STRING,xmpdm_album:STRING,xmpdm_artist:STRING,xmpdm_audiocompressor:STRING
To change the order of the specific and/or generic metadata, use the Move down and
Move up buttons. The order set in this area will be the order in which the metadata will
be displayed in the document form, in the web upload form and in SEALUploader and
StarCapture5 Desktop interfaces.
To modify a specific metadata, click in the field whose value you want to modify or access
the Edit button.
A specific metadata of a metadata schema cannot be deleted under the following
conditions:
If there are documents which have values assigned for this metadata.
If a value is set for the Position in name option associated with the metadata, so
that its value to be part of the documents name which are uploaded on the
metadata schema.
Metadata types
When you choose the metadata type, you must consider the descriptions in the following
table. It is important to choose the right type for the metadata, as the application validates
the fields when you enter the values.
The following image illustrates the case in which the user is not allowed to enter a sequence
of characters for a Date type metadata. The errors resulted are displayed next to the input
fields that caused the problem, by the appearance of a specific message and a red flag.
To successfully update a metadata, you need to correct problems. Follow the indications in
the text attached to the error message in order to make the necessary rectifications.
Note: The merge operation can be performed only for two metadata schemas from
the Archived documents category. Also, if there are metadata that contain the values
from both schemas, the correspondence between them must be mentioned (see the
Add specific metadata section).
1. Select the desired schemas and click Merge in the Manage metadata schemas
window.
2. In the Merge metadata schemas window, select the metadata schema that will
remain after the merge operation as destination and click OK.
3. In the General information step, fill in the fields and click Next to go to the following
step.
4. In the Metadata step, specify what will happen with each of the specific metadata of
the source schema, if they exist:
The metadata of the source schema (if they are not mandatory or
they don’t have values assigned) will be deleted.
or
New metadata will be created in the destination schema, having the
same names as in the source schema.
Figure 5.11 - The correspondence between the metadata of the merged schemas
Figure 5.12 - Fill in values for the mandatory metadata of the destination schema
The Merge metadata background process is created, having the Finished state. If a process
does not run successfully, its associated state will be Partial success. For more information,
see the Merge metadata section.
Note: The merge operation can be performed only for two specific metadata. Also, if
you want to merge two metadata of different types, you must modify the data type
of one of the metadata.
1. Select metadata and click Merge selected from the Edit metadata schema
<schema_name> window.
2. In the Selection window, select the metadata which remains as destination and click
OK.
3. In the Selection window, select the metadata merge type.
4. To continue the merge operation, click Save in the Edit metadata schema
<schema_name> window.
The Merge metadata background process is created, having the Finished state. If a process
does not run successfully, its associated state will be Partial success. For more information,
see the Merge metadata section.
During the merge process, the metadata schema is not available for ingestion operations.
If you modify the type of a specific metadata and save the changes made to the
corresponding metadata schema, the Merge metadata process is automatically created.
To manage value lists, the archive administrator must click the Value Lists command from
the submenu displayed when selecting the Manage data model button from the
application main interface.
To add a new value list, proceed as follows:
1. Click one of the two Add buttons in the Manage value lists window.
To manually add a value to the list, click one of the two New list value
buttons and fill in the (Key, Label) pair.
To add values from a CSV file, click the New list values from CSV file
button and upload the file from the location where it is saved. Then, click
Save. The values contained in the CSV file are imported in the table from the
application interface.
For each metadata schema, the archive administrator can define a metadata schema view
and customize it for each user group.
So, a metadata schema view can be defined starting from an existing metadata schema, by
choosing one or several metadata of the schema and one or more user groups. Within the
metadata schema view, the administrator can customize the order in which the metadata
will be displayed in the document form, in the web upload form and in SEALUploader and
StarCapture5 Desktop interfaces an also the metadata properties (edit, view, browse and
display in entry form).
If a user is not part of a group associated to a metadata schema view, then this user will see
the metadata as they are defined on the metadata schema.
To add a metadata schema view, follow the steps:
1. Click one of the two Add buttons from the Document templates interface.
2. In the General information window, fill in the following fields, as follows:
Name – fill in the name of the metadata schema view.
Description
Metadata schema – select the metadata schema whose metadata
properties and order will be customized as needed.
User group – select the user group from the list and click the Add
button. You can select one or more user groups.
Note: For some metadata, not all properties can be edited. For example: if a
metadata is set as mandatory on the metadata schema and has no default
value, then the Display in entry form property cannot be unchecked.
Implicitly, the View option cannot be unchecked.
5.1.10 Registers
In Business version, the archive administrator can define registers from which unique
registration numbers will be generated and assigned for the documents uploaded in the
1. Click one of the two Add buttons located in the Mailroom window.
2. In the General register data step from the Add new register window, fill in the
following fields:
Register name – the name of the register.
Register type – the register type.
Register year – the register year.
Register start index – fill in a number representing the starting point for
indexing a document.
Metadata schema – select the metadata schema from the list and click the
Add button. Optionally, select the associated Generate registration
number option. You can proceed in a similar way for adding other metadata
schemas to the list. Thus, when uploading documents in the archive on one
of the associated metadata schemas, unique registration numbers are
generated and assigned to the documents from the register.
The application does not allow you to associate a metadata schema to more
than one register.
If the Generate registration number option is selected along with the
metadata schema, unique registration numbers will be generated for the
documents uploaded on the metadata schema, based on the format set in
the next step.
If this option is not selected, the registration number will not be
automatically generated when the the document is uploaded in the archive.
However, users can manually generate the document registration number
based on the format set in the next step, by clicking the Generate Reg.
Number option from the document form.
3. Click Next to go to the following step.
4. In the Registration numbers format step, you can define the registration number
format for each metadata schema selected at step 1.
For this, proceed as follows:
Select the schema from the Metadata schemas field.
Select a value from the Choose field: Metadata, Separator or Constant.
According to the selected value, fill in the next field, as follows:
Proceed in a similar way to set the registration number format for each metadata
schema associated with the register.
5. Click Save to add the register in the system.
To view, edit or delete a register, consult the Appendix - General operations.
To upload a document in the archive, click the Upload document button. This option is
available for the archive administrator only if he has the Registrar role.
The Register new document window is displayed and the user must fill in the document
specific and generic metadata, as in the case of uploading a document using the Web
Upload form. For more information, please consult the Upload documents in the archive
from within SEAL web interface section.
To view the documents registered in a certain period, click the Register report button.
In the displayed window, you can define the following filters:
Period – select the period for which to display the registered documents.
Registration number – fill in the document registration number.
In Business version, the archive administrator can manage the organization chart, by clicking
the Organization Chart command from the submenu displayed when selecting the Manage
data model button from the application main interface.
The Organization Chart section is available only if the Registry module option has been
activated at the creation of the archive.
At the beginning, the hierarchical structure contains only the Company node, and within it,
the archive administrator can add entities, sub-entities, users and entity managers,
according to the company business needs.
Create or modify the structure of the Organization Chart
To create the structure of the organization chart from the beginning, click the Add child
button displayed when placing the cursor of the mouse over the Company node.
In the displayed window, select one of the two values: Entity or User for the Type field.
For the Entity value, the following fields are displayed:
Entity name – fill in the entity name.
Entity type
Entity description
Entity manager – optionally, you can set an entity manager. The list contains all
users of the current archive.
For the User value, the following fields are displayed:
Choose user – select one of the users of the current archive or the New User value.
Entity manager – select this check box if you want to set the user as entity manager.
If you select the New User value, fill in his associated information: e-mail address,
user name, first name, last name, authorization level, select the associated archive
and the desired roles.
Delete - by clicking this option, the archive administrator can delete the selected
entity or sub-entity; the approval for an entity deletion leads to the deletion of sub-
entities and associated users. The administrator can decide whether to delete the
entity along with all its entities or to move them to parent entity.
Add brother - by clicking this option, the archive administrator can add an entity
or a sub-entity or a user on the same level with the selected one.
Add child - by clicking this option, the archive administrator can add a sub-entity
or a user to the selected entity/sub-entity.
Modify - by clicking this option, the archive administrator can edit an entity or a
sub-entity.
Move up - by clicking this option, the archive administrator can move with one
position above the selected sub-entity. This option is not available for an entity
which is directly subordinated to the Company node.
By placing the cursor of the mouse over a user, you can access the following operations:
Delete - by clicking this option, the archive administrator can delete the selected
user.
Add brother - by clicking this option, the archive administrator can add an entity
or a user on the same level.
Modify - by clicking this option, the archive administrator can edit the selected
user.
Move up - by clicking this option, the archive administrator can move with one
position above the selected user. This option is not available for a user which is
directly subordinated to the Company node.
Change entity - by clicking this option, the archive administrator can move the
selected user to other entity or sub-entity in the organization chart.
When the out of office is enabled for a user, a read-only message with this information will
be displayed in the organization chart, on the entity to which the user is assigned. For more
information on how to set up an out of office, please consult the User’s settings section.
Perspectives represent a way to navigate through the archive, where the archived
documents are displayed in a hierarchical structure (after the values of the defined
metadata), through which the administrator can navigate in a similar way to navigating a
hierarchy of files in a file system.
The archive administrator can manage perspectives by clicking the Perspectives command
from the submenu displayed when selecting the Manage data model button from the
application main interface.
To add a new perspective, follow the steps:
1. Click one of the two Add buttons located in the Perspectives management
window.
2. In the Perspective details step from the Add perspective window, enter the
perspective name and select the category of objects: Archived documents or Smart
folders.
Decide whether the perspective will be available or not for WebDAV, by selecting the
Available for WebDAV check box. This option is displayed only for the Archived
documents objects category, if the Activate WebDAV option has been selected at
the creation of the archive.
3. Select the metadata schema. To select more than one schema, press Ctrl and, at the
same time, click all the desired metadata schemas. The list contains the metadata
schemas from the category of objects selected at step 2. Also, if the Available for
WebDAV option has been selected, the list contains only the metadata schemas
which fulfill WebDAV requirements.
4. Click the Next button to continue.
5. In the Perspective level step, select the desired attributes, for each metadata
schema (in case several schemas were selected), for the first hierarchical level (Level
1 is displayed by default). The administrator must click the icon in order to add
the next level, and select the desired attributes for the metadata schemas. To
remove the last added level, click the icon.
For the data type attributes, the user can select the year, the month or the day from
the selected date.
Perspectives created in this section will be used to browse the archive. See the Browse the
documents structure section.
To view, edit or delete a perspective see the Appendix – Gneral operations.
The archive administrator has the possibility to export an archive data model in JSON format
and then import it into another archive.
The archive administrator can export the data model by clicking the Export and Import
command from the submenu displayed when selecting the Manage data model button
from the application main interface.
The data model export is performed using a background process. To view the process
details, please see the Background processes section. The execution of this process
generates a JSON output file that contains the details of the exported entities.
Download this CSV file on the local disk to use it for importing the data model into another
archive.
The archive administrator can import the data model into another archive by clicking the
Export and Import command from the submenu displayed when selecting the Manage data
model button from the application main interface. Click the Browse button and select
the resulting document after running the Export data model process, from the file system.
The name of the file will be displayed in the adjacent box. Click the Import button.
The data model import is performed using a background process. To view the process
details, please see the Background processes section.
Note: In Compliance version, the security rules, security policies and groups will not
be imported.
When you import a data model into an archive, you must consider the following:
The file plan will not be imported, if there are documents already uploaded in the
archive.
The archive administrator can create workflow definitions, necessary for sending a
document or smart folder to a workflow. This functionality is available only if the archive
parameter, Enable BPM features, is selected.
To manage workflow definitions of the current archive, click the Workflow definitions
command, from the sub-menu displayed when selecting the Manage data model button
from the application main interface.
In order to create a workflow definition, follow the steps:
1. Click one of the Add buttons from the Workflow definitions window.
2. Fill in the following fields, in the displayed window:
Select a workflow definition – click the Browse button and upload the
BPMN file, which represents the workflow definition.
Select a workflow image file (.svg) – optionally, by accessing the Browse
button, you can upload a SVG file including the graphical representation of
the workflow tasks.
Allow task owners override – if this option is enabled, the users or groups of
users assigned to the workflow tasks (as configured in the BPMN file) can be
modified when sending a document/smart folder to the workflow.
If users or groups of users are not assigned in the BPMN file for all workflow
tasks, then this option cannot be disabled (the option is automatically
enabled and cannot be disabled).
Metadata schema – select the metadata schema (document schema or
smart folder schema) and click the Add button in order to add it in the
grid. Similarly, you can associate more metadata schemas on a workflow
definition. Therefore, the documents/smart folders uploaded in the archive
on the metadata schemas associated with the workflow definition can be
sent to the specific workflow. If no schema is selected, the workflow
definition can be used to send a document/smart folder from any metadata
schema.
3. Click Save to add the workflow definition in the system.
The BPMN file, which represents the workflow definition, is created with the jBPM designer
and contains, among others, the following configurations: the name of the workflow and
The workflow consists of several steps for approving a contract, at the end of which the final
state of the workflow is decided.
At the end of step 1 (in point 1), the user assigned to the task will decide whether the
contract will go for approval or it is not valid, in which case the flow will end.
In point 2, as it is configured in the BPMN file, the flow will continue with the following
steps:
Legal approval, regardless of the document metadata values.
Director approval or Sub director approval, according to the Value metadata of the
document sent to the workflow, so that: if its value is greater than 1000, the
Director approval step will be automatically available; otherwise, if the Value
metadata of the document sent to the workflow has no value or a value less than or
equal to 1000, the Sub director approval step will be automatically available.
The conditional expressions which must be defined using the jBPM we designer are:
return value != null && value > 1000; – in order to continue the workflow
with the Director approval step
return value == null || (value != null && value <= 1000); – in order to continue
the workflow with the Sub director approval step
Similarly, in point 3, after the completion of both tasks by each assigned users, the final
state of the workflow will be decided, according to the values filled in for the LegalApproval
and ExecutiveApproval metadata of the document sent to the workflow, as follows:
If the value of the LegalApproval and ExecutiveApproval metadata is Yes, the
workflow will be automatically finished with the Contract approved state.
If the value of at least one of the LegalApproval and ExecutiveApproval metadata is
No or null, the workflow will be automatically finished with the Contract rejected
state.
The conditional expressions which must be defined using the jBPM we designer are:
return legalApproval != null && legalApproval == true && executiveApproval!=
null && executiveApproval == true; – in order for the workflow to be finished
with the Contract approved state
return !( legalApproval != null && legalApproval == true &&
executiveApproval != null && executiveApproval == true); – in order for the
workflow to be finished with the Contract rejected state
To edit and delete a workflow definition, consult the Appendix - General operations. The
deletion is available only if there are no workflows started, based on this definition.
To download the BPMN file underlying this workflow definition, access the Download
button.
To view the graphical representation of a workflow tasks, click the View image button.
This button is displayed only if a SVG file was uploaded for the workflow definition.
To cancel all active workflow instances based on a definition, click Cancel all active
workflow instances associated with this definition .
The archive administrator can view and modify the archive parameters configured at the
creation of the electronic archive by the master administrator.
To view the archive parameters, access the Manage data modelArchive parameters
section from the application main interface.
In the displayed interface, perform the necessary changes and click Save.
For more detailed information on the archive parameters, please see the Electronic archives
section, step 8.
You can browse through the structure of the archived documents by using the archive
default structure or the user-defined perspectives.
For example, as you can see in the previous image, when selecting the “16” directory, the
application displays in the Browse section the Personal Loans type of documents issued on
the 16th of August 2018.
The documents displayed in the grid can be added to a new collection or to an existing one
by clicking the Select collection button.
To upload a document in the archive directly from SEAL web interface, click the Upload
document button or simply drag and drop the document from the local disk to the Browse
interface. The Web Upload window is displayed, in which the metadata of the document
must be filled in. For more details, please consult the Upload documents in the archive from
within SEAL web interface section.
Also, you can export the content of the documents displayed in the grid by clicking the
Export content button. When the Export documents with content process finishes its
execution, you will be able to download the content of the exported documents as a .zip file
from within the e-mail notification or from the latest messages area. Apart from the content
of the archived documents, the .zip archive also contains the attachments of the
The administrator can set one or more hierarchical levels when creating a perspective. As
you can see in the following picture, the Bank Product perspective has three levels of
hierarchy:
Level 1 is represented by the Product metadata.
Level 2 is represented by the Borrower’s name metadata.
Level 3 is represented by the Due date/Year metadata.
When the directory of the Due date/Year type is selected, the application displays only the
list of bank products which have the selected borrower’s name and due date.
The documents displayed in the grid can be added to a new collection or to an existing one
by clicking the Select collection button.
To upload a document in the archive directly from SEAL web interface, click the Upload
document button or simply drag and drop the document from the local disk to the Browse
interface. The Web Upload window is displayed in which the metadata of the document
Note: If you have defined a perspective after the File plan class metadata on an
archive, then when browsing the archive using such a perspective, the archived
documents are displayed in a structure whose hierarchical levels are generated for
each level in the file plan tree structure that is currently in force. If there are no
documents uploaded in the archive for a file plan class, that hierarchical level is not
displayed when you browse the archive using the perspective.
For example, for the Documents classified by file plan perspective, defined after the
File plan class metadata, there are generated three hierarchical levels, as you can
see in the following picture.
Figure 5.26 - A perspective defined after the File plan class metadata
For more details about defining hierarchical levels, see the Perspectives section.
You can browse through the archive folder structure by using the default folder structure or
the user-defined folder perspectives.
To browse through the folder structure of your current archive, click the Browse icon
from the application main interface and access the Smart folders tab.
Browse through the default folder structure
In the Smart folders tab, select the Default smart folders navigation value from the list
displayed, in order to browse through the default folder structure of the current archive.
The smart folders are displayed in a hierarchical structure, grouped by the folder type
metadata schema and the folder creation date (year, month, and day). The hierarchical
structure is automatically generated by the system when a new folder is created in the
application.
For example, as you can see in the previous image, when selecting the “7” directory, the
application displays in the Browse section the folders which have been created on the 7th of
June 2018, on the Contracts folder metadata schema.
To create a new folder, follow the steps:
The administrator can set one or more hierarchical levels when creating a perspective. As
you can see in the following picture, the Folders perspective has three levels of hierarchy:
Level 1 is represented by the Folder creation date/Year metadata.
Level 2 is represented by the User name metadata.
Level 3 is represented by the Folder name metadata.
When the user selects a directory of the User name type, the application displays all folders
created by the user with that name, in the selected year.
To create a new folder from within a user-defined perspective, follow the steps:
Simple search
The simple search facility allows the user to enter sequences of characters which will be
searched for in the values of all attributes associated with objects (archived documents,
folders, and physical containers).
The administrator must enter the text in the search box and click the icon.
The list with the search results is displayed. The search will return identic results or that are
likely identical with the search argument. The value entered for an attribute can be
incomplete or partially inaccurate. This type of search (fuzzy) is based on the Damerau-
Levenshtein distance, an algorithm which measures the editing distance (number of
operations in which a sequence of characters changes into another) between two
sequences of characters. Basically, the editing distance between two words represents the
minimum number of operations (consisting of insertions, deletions, substitutions or
transposition of two adjacent characters) required to change one word into the other. For
SEAL searches, Damerau-Levenshtein distance has a maximum value of 2, which means you
can apply no more than 2 editing operations that will be used to discover similar values to
the one you look for. In SEAL, the fuzzy search can also work with sentences, except full-text
search.
For example, for the string entered as shown in the previous figure (act), the search will
return all objects whose attributes contain the values: chat, cat, acts, task, pact and so on.
The list with the search results can be ordered by all columns, except for the Actions
column, by clicking the name of the desired column.
You can perform a simple search by using the following substitution characters:
The advanced search facility allows users to combine complex search criteria using the
metadata associated with objects. You can define criteria based on multiple metadata
schemas linked by the logical OR operator. Also, you can use the logical AND operator and
parentheses to group the search criteria.
If you want to perform a search using more than 2 criteria linked by the AND operator, the
application returns those objects which fulfill all criteria defined.
Two or several search criteria based or not on the same metadata schema and linked by
the logical OR operator will return results only if at least one object in the application fulfills
at least one criterion.
Two search criteria based on different metadata schemas and linked by the logical AND
operator will not return any results.
When defining criteria based on multiple metadata schemas, use the parentheses to
separate and group criteria based on the same metadata schema, as shown in the
following picture:
For example, for the search criteria entered as in the previous image, the advanced
search will return all archived documents whose name is identic or likely identical
with the entered value loan, for example: loans, boat, soap and so on.
If the Full text search option was selected when creating the electronic archive, you
can define a criterion based on the Content metadata and you can perform an
advanced search by entering text sequences that can be found in the content of the
archived documents.
When you define the search criteria, you can use the following substitution characters for
the values of the metadata:
? – this character substitutes a single character. For example, when you run a search
for ca?e, the application will return objects whose attributes have values, such as:
case, care, cape and so on.
3. Select the icon to add a new search criterion. To remove a criterion, select the
corresponding icon. You must add at least a criterion to perform a search.
Link the defined criteria using the logical operators: AND, OR. Also, where necessary,
use the parentheses to group criteria, as explained above.
4. After filling in the search criteria, click the Search button. To reset the criteria
entered, click Reset.
In the page of the results displayed after a simple search, as well as after an advanced
search, the user can view the object form or content. For more details about viewing
objects, please see the following sections.
According to the objects category, the archive administrator can export the search results as
a CSV file (the Export button) or add the resulting objects to the collection (the Add to
collection button). Also, the archive administrator can export the content of the archived
and administrative documents, by clicking the Export content button.
If the results of the advanced search contain documents belonging to a single metadata
schema, a CSV file containing all indexable metadata will be exported. If the results contain
documents belonging to different metadata schemas, the export result will be a .zip archive
containing a CSV file for each metadata schema. Each CSV file contains columns for each
indexable metadata of the schema.
Important: The type of the Document size metadata is numeric. The system saves
the metadata value in bytes, so that the simple search and the advanced search
return results only if the user enters the value in bytes. However, to be displayed in
the interface, this value is converted to larger units of measure (Mb, Kb), in order to
be easily read by the user.
Search templates
To save the advanced search criteria in a template, click the Add button next to the
Search template field.
Fill in the name of the template in the Save search template as field and click Save. The
saved template can be used in subsequent searches, by selecting the template from the
Search template list. The application will automatically upload the search criteria contained
in the template.
Note: The application allows the user to save a template which contains maximum
10 search criteria.
To edit a template, select the template from the list, perform the changes you need on the
search criteria, then click the Actions button and select the Save option. To save the
changes into a new template, click the Save as button.
To delete a search template, select the template, then click the Actions button and
select the Delete option.
In the Search template list, the user has access only to the templates saved by him.
To subscribe to a saved template, select the desired template from the Search template list,
then click the Actions button and select the Subscribe option. This action is shown
when you hover the mouse over the Unsubscribed option. After subscribing to a template,
the associated button will be Subscribed.
The subscription to a template is intended to notify the user when new documents which
fulfill the criteria in the template are added in the electronic archive. The user is notified
both by e-mail, as well as in the Latest messages area from the application main interface.
The notification contains the following information: the name of the template whose
criteria are fulfilled by the document added in the archive, the name of the document and
the user who added it, the date and time when the document was added in the archive and
the link to the document.
The notifications are automatically sent by the application when the archive administrator
launches the Subscriptions delivery process. For more details on how to configure and run
this process, consult the Subscriptions delivery process.
To cancel the subscription to a template, select the desired template from the Search
template list, then click the Actions button and select the Unsubscribe option. This
action is shown when you hover the mouse over the Subscribed option. After cancelling the
subscription to a template, the associated button will be Unsubscribed.
The archive administrator will be notified both by e-mail, as well as in the Latest messages
area from the application main interface, at the first subscription of a user to a template
The administrator can download and view the content and metadata of a document both
from the navigation sections of the application and from the search sections.
To download an archived document, click the Download icon from the Browse window.
The archive administrator can choose from the following options: open the document, save
the document on the local disk or cancel the operation of downloading the content of the
archived document. The user can view the downloaded files by using an appropriate
application which is not part of the archive system (for example, Adobe Reader installed on
the user workstation).
View the form of an archived document
By clicking the Information icon from the Browse window, the Details window is
displayed, that contains the following tabs:
1. In the Content metadata tab, all the metadata of the selected document are
displayed. The metadata displayed in the Specific metadata section are different
according to the type of the selected document.
To view the list of the generic metadata and their descriptions, consult the Appendix
- the generic metadata of an archived document.
By clicking the Content button, the administrator can view or download the content
of the document on the local disk. To view the document content in the application
interface, using the built-in viewer, click the Content preview button placed
vertically on the left side of the document form.
If the document has no content attached, the Add content button is displayed
instead, which allows you to add content to the document.
The E-mail button allows the administrator to send by an e-mail message either the
content of the current document, or both the content and the PDF form containing
the associated metadata.
In the window displayed, fill in the following fields:
From – the e-mail address of the authenticated user is already filled in and
cannot be modified.
For the digitally signed documents, if the original content was in a format, other
than PDF/A, the archived documents resulted after signing will be in PKCS #7
format. For the documents in PKCS #7 format, two other options are available
when clicking the More button:
2. In the Security tab is displayed the information associated with the security policy
applied to the selected document (both the groups of users for the security policy, as
3. In the Content and metadata related history tab, the administrator can view all the
actions performed on the selected document and, also, can download the
supporting document by accessing the link associated with the Reference
administrative document field.
4. The Content details tab will be available only for the archived documents in .zip or
.p7m format, but which were in .zip format initially. In this section, the administrator
can view the content of the .zip archive and download the files contained in the .zip
archive.
5. The Container tab is displayed only for those documents for which, when uploading
them in the archive, the Original id container metadata is filled in with the value that
represents the identifier of a physical container (box or file). This tab consists of the
specific and generic metadata of the physical container whose identifier was filled in
for the Original id container metadata of the archived document.
The Electronically filed documents button redirects you in the Search results
window that contains the electronic documents for which you have filled in the
Original id container metadata with the same identifier of the current physical
element.
6. In the Attachments tab, the administrator can view the attachments of the
document. The attachments are grouped in a tabular form; the user can perform the
following operations on each attachment:
Also, the user can add a new attachment by clicking the Add button and by
selecting the desired document. For more information about adding an attachment
along with the upload of a document from within the application interface, please
consult the Upload documents in the archive from within SEAL web interface
section.
7. In the Workflow related history tab you can trace the document within every
workflow, view the initiator and the state of the workflow. This tab is available only if
the document has been sent to at least one workflow.
By clicking the View icon from the Browse window, the administrator is able to view the
content of an archived document, in SealAdminWeb application.
When the document content viewer is opened, the administrator can perform different
actions on the image: zoom in, zoom out, rotate or view the image on the entire window.
Note: The option of viewing the content of an archived document within the web
application (the button) is available only for the file formats which were
configured in the Settings section.
For files in DICOM format, the option for viewing the content of an archived document is
available only after running the Extract metadata process. The content of a file in DICOM
format is displayed using DICOM Web Viewer.
Edit specific and generic metadata for an archived document
Note: In Business version, given the fact that compliance with archiving law is not
required, users which have access to a document (according to the defined security
policies) will also have the possibility to edit the specific metadata associated with
that document (individual), without further examinations.
To edit a specific metadata associated with an archived document, access the value of the
desired metadata from the Content metadata tab, in the Browse section.
The administrator can edit a metadata only if the metadata is set as editable at the creation
of the metadata schema (see more in the Metadata schemas section).
Note: For a generic metadata of the String type, the application does not allow
entering a value whose length is greater than 4000 characters.
Note: In Business version (where compliance with archiving law is not required),
users which have access to a document (according to the defined security policies)
will also have the possibility to delete the document (individually), without having
to use a supporting document. In this context, however, the deletion operation will
be audited. The storage term will also be taken into account, if the document is
classified according to a file plan.
To start a document on a workflow, click the associated Start workflow button. For
more information, please consult the Use BPM features section later in this document.
The administrator can view folders and their content, both from the simple search section
as well as from the advanced search section. Also, the administrator can view the specific
and generic metadata associated with folders.
By clicking the View icon from the Actions column, the Details window is displayed,
which contains the following tabs:
1. The Smart folders form tab displays all the metadata of the selected folder. The
metadata displayed in the Specific metadata section are different according to the
accessed folder.
By clicking the Content button, the administrator can download the content of the
folder in a .zip archive. To download the .zip archive which contains all the
documents included in the folder, the administrator must navigate to the Latest
messages area, in the application home page.
Once the Content button is accessed, the Export smart folder documents with
content process is automatically created.
The PDF form button allows the user to download the electronic form of the folder.
By clicking the Folder link button, you can view the URL address of the selected
folder and you can send it by an e-mail message.
Click the Start workflow button to send the smart folder to a workflow. When the
workflow starts, all users which have been assigned to the workflow tasks are
notified both by e-mail, as well as in the Latest messages section from the
application main interface.
If a barcode generation rule is configured on the metadata schema on which the
smart folder is uploaded and also, the Generate barcode automatically at smart
folder creation option is enabled, then the View barcode option is available. By
clicking this option, the application displays a window containing the barcode image
and value. Also, the option to print the smart folder barcode is available.
By clicking the View button, the administrator is able to view the content of the
archived document, in SealAdminWeb application.
To remove a document from the current folder, click the Remove button.
By clicking the Document link button, you can view the URL address of the
selected document and you can send by an e-mail message either the content of the
current document, or both the content and the PDF form containing the associated
metadata. Also, the e-mail message contains the link which allows the user to view
the attached document.
Clicking the Start workflow button allows you to send the document to a
workflow. When the workflow starts, all users which have been assigned to the
workflow tasks are notified both by e-mail, as well as in the Latest messages section
from the application main interface.
The administrator can edit a metadata only if the metadata is set as editable at the creation
of the metadata schema.
Clicking the Download icon from the Actions column associated with a folder has the
same result as clicking the Content button from the Smart folders form tab.
Upload document in a folder
To upload a document in a folder, click the Upload document button associated with a
folder and fill in accordingly the information in the Web Upload window. For more details,
consult the Upload documents in the archive from within SEAL web interface section.
Delete a folder
To delete a folder, click the Delete button associated with it. When a folder is deleted,
the documents contained therein are not deleted from the electronic archive.
Start workflow
To start a smart folder on a workflow, click the associated Start workflow button. For
more information, please consult the Use BPM features section later in this document.
The administrator can view the specific and generic metadata associated with physical
containers both from the simple search section and from the advanced search section.
By clicking the View icon from the Search results window, the Details physical element
window is displayed, that contains the following tabs:
1. In the Container form tab, all the metadata of the physical container are displayed.
The metadata displayed in the Specific metadata section are different according to
the physical element selected (box or file).
The PDF form button allows the user to download the form of the physical element
in a PDF file.
The administrative documents can be accessed in the Browse section from the
application main interface. In the Documents tab, select the Default navigation value from
the list displayed. The administrative documents can only be viewed by the archive
administrator and the client administrator.
The administrative documents have been created:
After finishing a process or after the export of a set of documents.
At the creation or modification of a group or security policy.
The types of administrative documents managed in the application are the following:
Metadata update: represents the supporting document provided at the creation of
an Update metadata process.
Apply legal hold: represents the supporting document provided at the creation of a
Legal hold process.
Change retention period: represents the supporting document provided at the
creation of a Change retention period process.
Documents marked for selection committee: represents the document generated
by the application, as a result of the execution of a Mark document for selection
committee recurrent process (the execution result of the Mark document for
selection committee process).
To download and view the content of an administrative document, click the Download
icon associated with the desired document.
When accessing the download file option, you can choose to open the document, save the
document on the local disk or cancel the operation of downloading the administrative
document. The downloaded files can be viewed by using an appropriate application which is
not part of the archive system.
View form and content for an administrative document
To view the details of an administrative document, click the Information icon associated
with the desired document. The Details window is displayed and contains the generic
metadata of the selected document.
Note: The option of viewing the content of an administrative document within the
web application (the icon) is available only for the file formats which were
configured in the Settings section.
If you want to add an attachment to the document which will be uploaded in the
archive, click the Browse button from the Attachments tab and select the
desired document. Then, to add one new attachment, click the button and
proceed in a similar way. To delete a selected attachment, click the button.
3. Click the Save button displayed in any of the 3 tabs to upload the document in the
archive.
Some metadata of the document will be automatically filled in by the application, after
the document is uploaded. For example:
The digital format is automatically taken from the properties of the uploaded
document.
The security policy, if it is not specified by the user, it will be automatically filled
in with the default policy of the archive in which the document is uploaded.
The Issuer metadata, if it is not specified by the user, it will be automatically
filled in with the name of the client on which the archive is associated.
To upload a document in the archive, from within a user-defined perspective, follow the
steps:
1. Click the Upload document button from the Browse window or simply drag and
drop the desired document from the local disk to the Browse interface.
Issued date – this metadata is already filled in with the current date or the
issued date of the document, taken from within the perspective. After
selecting a document which will be uploaded in the archive, the issued date is
Figure 5.38- Automatic filling of metadata using the values from the perspective structure
Some metadata of the document will be automatically filled in by the application, after
uploading the document. For example:
The digital format is automatically taken from the properties of the uploaded
document.
The security policy, if it is not specified by the user, it will be automatically filled
in with the default policy of the archive in which the document is uploaded.
Note: The installation of SEAL Signer application consists in running a .msi file, named
SEALSignerSetup.msi. The installation process is extremely easy and intuitive.
To view the graphical representation of the tasks of a workflow, click the View image
button.
To take a task, click the Start button from the view received tasks interface or from the
task details interface.
To leave a task you previously claimed, click the Release button from the view received
tasks interface or from the task details interface.
To claim a task you have released, click the Claim button from the view received tasks
interface or from the task details interface. After claiming it, you can start the task.
To complete a task, click the Finish button from the view received tasks interface or
from the task details interface.
To view the graphical representation of the tasks of a workflow, click the View image
button.
To view the details of a workflow, click the View button associated to it. In this window,
you can view the following information: the person who initiated the workflow, the
When accessing the Processes Processes section from the main page, the
administrator is directed to the processes page. The processes are divided into three
categories, grouped into three tabs:
Background processes
Recurrent processes
Continuous processes
For most of the background processes, the administrator must perform the following steps
to run a process:
The administrator must check if the changes performed to the exported documents were
performed successfully.
The recurrent processes need to be configured by the archive administrator. The recurrent
processes will be launched automatically according to the configuration. The administrator
can set a process to run immediately after the configuration or at a certain date and hour,
with a configurable frequency. The recurrent processes don’t need a file with the input data
or a supporting document. Some recurrent processes can have an output data file.
Process name – select the process for which you want the errors to be displayed.
Started by – select the user who launched the selected process.
Click the Search button to view the details of the encountered errors, displayed in the
Results interface.
Also, you can reach the errors of a process instance by following the Errors Details link from
the Details column associated with the process.
This type of process allows the export of documents that are the result of an advanced
search and has the following particularities:
The input data file is automatically generated by the application and contains the
search criteria.
There is no supporting document as an input file.
The execution of this process generates a CSV output file that contains the results of
the advanced search.
Download the CSV file that contains the advanced search criteria by clicking the
button corresponding to the Input file attribute.
Download the CSV file that contains the list of documents that were exported along
with the metadata and their values, by clicking the button corresponding to the
Execution result attribute.
This type of process allows the export of archived and administrative documents that are
returned by a simple or advanced search. Also, the process allows the export of the archived
documents from within a perspective or from the default directory structure of the archive.
The process has the following particularities:
The input data file is automatically generated by the application and contains the
search criteria.
There is no supporting document as an input file.
The execution of this process generates a CSV output file that contains the results of
the advanced search.
Also, after running the Export documents with content process, the user can
download the content of the exported documents as a .zip file from the notification
e-mail received or from the latest messages area. In Business version, along with the
content of the archived documents, the .zip archive also contains the attachments of
the archived documents, if they exist. The attachments of each document are
included in separated subdirectories, named as follows:
<archived_document_name_attachments>.
The .zip files resulted after exporting the documents will be deleted after exceeding
the number of days set when creating the electronic archive (as the value of the
Number of days for keeping export content files parameter).
Download the CSV file that contains the advanced search criteria by clicking the
button corresponding to the Input file attribute.
This type of process is created and run automatically when downloading the content of a
folder. For more details, please consult the Operations performed on smart folders section.
The process has the following particularities:
The input data file is automatically generated by the application and contains the
unique identifiers of the downloaded folders.
There is no supporting document as an input file.
Also, after running the Export smart folder documents with content process, the
user can download the content of the exported folders as a .zip file from the
notification e-mail received or from the latest messages area.
The .zip files resulted after exporting the smart folders content are deleted after
exceeding the number of days set when creating the electronic archive (as the value
of the Number of days for keeping export content files parameter).
Click the Information button corresponding to the desired Export smart folder
documents with content process, from the Background processes tab.
The purpose of running this process is to change certain metadata for a precise set of
documents.
To create and run this process you need to perform the following steps:
1. Search the documents for which you wish to modify metadata and export the search
results.
2. In the CSV file obtained after the documents export, modify the desired metadata.
Any modifications to the following attributes issuedDate, archiveDate,
uniqueIdentifier, securityClass, batchCode, documentName, and documentSize will
be ignored when running this process.
3. Click one of the Add buttons located in the Background processes tab.
Note: When filling in certain information, the application allows entering a limited
set of special characters.
If the user enters an unsupported character (for example, entering one of the
characters: <>%$*#!?|}{=\), a warning message will be displayed: ”The expression
you entered has an incorrect character.”
After the process has run it will be automatically added in the process list found in the
Background process tab.
After saving a process, its state is Started. If the process finishes successfully then its state
will be Finished. If a process does not finish successfully, its state will be Partial success and
will have an errors.txt file associated which will contain the encountered errors.
If the process runs successfully, verify if the metadata of the documents was changed
according to the uploaded CSV file.
Download the CSV file that contains the advanced search criteria by clicking the
button corresponding to the Input file attribute.
Download the supporting document used when adding the process, by clicking the
button corresponding to the Supporting document attribute.
The purpose of running this process is to modify the security policy for a precise set of
documents.
Note: The security policy inserted in the CSV file must exist in the application. If it
does not exist in the application, the process will not run.
If the process runs successfully, verify if the security policy of the documents has changed
according to the uploaded CSV file.
To view the process details, follow the indications from the Update metadata section.
The purpose of running this process is to apply or remove a legal hold on a precise set of
documents. Through this process, a retention flag is associated to a set of documents stating
that the documents must not be deleted from the archive.
To create and run this process you need to perform the following steps:
1. Search the documents for which you wish to apply or remove a legal hold and export
the search results.
2. From the CSV file obtained after the documents export, only the uniqueIdentifier
column will be used to identify the documents.
3. Click one of the Add buttons located in the Background processes tab.
4. In the add page select the desired value for the process type (in this case – legal
hold).
5. Upload the input data file – the CSV file with the document metadata that you
processed at a previous step.
6. From the Supporting document list, choose either an existing administrative
document or the new document entry to create a new administrative document. In
Business version, you can also create a process without a supporting document (the
No document value).
7. If you have selected the New document value at step 6, then upload a supporting
document and fill in the metadata corresponding to the document.
8. Select one of the two available options:
Add legal hold – when choosing this option, the desired legal hold identified
through label and description will be applied.
If the process runs successfully, verify if the retention flag has been set or removed for the
documents contained in the uploaded CSV file (in a document details page, check the value
corresponding to the Retention flags metadata).
To view the process details, follow the indications from the Update metadata section.
The purpose of running this process is to modify the retention period for a precise set of
documents.
To create and run this process you need to follow the steps:
1. Search the documents for which you wish to modify the retention period and export
the search results.
2. In the CSV file obtained after the documents export, modify the value of the
storageTerm attribute with the expiration date for the storage term. Only the
storageTerm and uniqueIdentifier columns will be taken into account for this
process.
3. Proceed with the 3-8 steps from the Update metadata section.
Note: For the storageTerm column you must use the existent data format:
dd.mm.yyyy (28.10.2014).
If the process runs successfully, verify if the retention period of the documents has changed
according to the uploaded CSV file.
To view the process details, follow the indications from the Update metadata section.
The purpose of running this process is to automatically create security policies and rules
based on the information provided in a CSV file. This process can only be run by an archive
administrator.
Note: Initially, this process is not available in SEAL application. Contact Star Storage
if you wish to have this functionality.
The purpose of running this process is to merge two similar metadata or two documents
that, from a business point of view, represent the same type of document.
Unlike all the other background processes, this process is created and run automatically
when merging two metadata schemas (more details in the Metadata schemas section) or
when merging two specific metadata (more details in the Add specific metadata section).
This type of process has the following particularities:
The input data file is automatically generated by the application and contains the
search criteria.
There is no supporting document as an input file.
The execution of this process generates a CSV output file.
In the page containing the information of the process you can download the CSV file that
contains the results of the process by clicking the button corresponding to the Execution
result attribute.
The purpose of running this process is to recalculate the Apache SOLR indexes in order to
find the following objects in the application: electronic documents, folders, physical
containers (boxes and files), and administrative documents. The archive administrator
configures this process, and then the process runs automatically, according to the
configuration.
To create and run this process you need to follow the steps:
1. Click one of the Add buttons located in the Background processes tab.
2. In the window that appears, select the desired value for the process type (in this
case – Rebuild SOLR Index).
3. Select the type of rebuild. If you select Choose details, follow the next steps:
Select the time period when the objects have been archived.
Select one of the objects categories: Archived documents, Smart folders,
Physical containers, Administrative documents or All.
Select the metadata schema for which you want rebuild index. If for the
above field you have selected All, then selecting metadata schema is no
longer available.
If you select CSV file with unique identifiers, follow the next steps:
After a process is saved, its state is Started. If the process successfully finishes then its state
will be Finished. If a process does not finish successfully, its state will be Partial success.
Click the Information button corresponding to the desired Rebuild SOLR index
process located in the Background processes tab.
All the documents that have the expiration date in the past and do not have active
retention flags must be gathered in the list of documents to be deleted.
The purpose of running this process is to delete a precise set of documents. Only the
documents that have been marked for deletion and do not have retention flags can be
deleted. The deleted documents will not be visible in the application, but they will still exist
in the location configured for storing the archive content, for example: DISK, HCP, etc. To
delete the documents from the storage location, see the Storage cleanup section.
The archive administrator must download the result file of the recurrent process Mark
documents for deletion (see the Mark documents for deletion section). If you do not want
to delete all the documents contained in the CSV file, then you can process the file and
delete the corresponding lines. Only the uniqueIdentifier column will be taken into account
for this process.
Note: A document is eligible for deletion if it has an overdue retention term and it
has no retention flags or it has a file plan class that does not suppose a selection
committee meeting. For documents that have a file plan class that supposes a
selection committee meeting, you must wait for the committee approval.
To create and run this process you need to perform the following steps:
1. Click one of the Add buttons located in the Background processes tab.
After a process is saved its state is Started. If the process successfully finishes then its state
will be Finished. If a process does not finish successfully, its state will be Partial success.
If the process runs successfully, verify if the documents have been deleted. The process
generates a file that contains a list of all the documents that have been deleted.
The scope of running this process by the archive administrator is to access information
regarding most of the operations performed in the system (the user that performed an
operation, the type of operation performed, the date, etc.) for a certain period of time.
The Audit export background process is run from the Reports Audit report section (see
section Audit report). The administrator fills in the search criteria for the audit entries and
exports the results. This automatically creates the process Audit export in the Background
processes tab from the Processes section.
This type of process has the following particularities:
Click the Information button corresponding to the desired Audit export process
located in the Background processes tab.
Download the CSV file containing the input data for the process by clicking the
button corresponding to the Input file attribute.
Download the PDF file containing the output data for the process by clicking the
button corresponding to the Execution result attribute.
The purpose of running this process is to view the archived documents from the current
archive.
The Export archive ledger background process is run from the Reports Archive ledger
section (see the Archive ledger section). The administrator launches the process by clicking
one of the following buttons: Download PDF or Download CSV from the Archive ledger
page. This automatically creates the process Export archive ledger in the Background
processes tab from the Processes section.
The output file of the process will be in a:
PFD format – if the process was started by clicking the Download PDF button.
CSV format – if the process was started by clicking the Download CSV button.
Click the Information button corresponding to the desired Export archive ledger
process located in the Background processes tab.
Note: If the archive ledger export process is launched after starting the same type of
process, then the resulting document will be available only for the last process.
The purpose of running this process is to view information regarding the document file plan.
The Export file plan background process is run from the Reports File plan section (see the
File plan section). The administrator launches the process by clicking the Export button
from the File plan page. This automatically creates the process Export file plan in the
Background processes tab from the Processes section.
This type of process has the following particularities:
There is no supporting document as an input file.
The execution of this process generates an output PDF file that contains the
document file plan.
Click the Information button corresponding to the desired Export file plan
process located in the Background processes tab.
Download the file containing the input data for the process by clicking the button
corresponding to the Input file attribute.
Download the PDF output data file containing the document file plan by clicking the
button corresponding to the Execution result attribute.
The purpose of running this process is to create a backup copy of the archive (all the
archived and administrative documents are saved). The documents are saved according to
their retention term so that they can be grouped on off-line environments specific to each
expiration date of the documents retention. The archive backup copy will be located on the
server on which the application is installed, in a location similar to the following one:
...\sealOfflineExport\<archive_name>
To create and run this process you need to perform the following steps:
After a process is saved its state is Started. If the process successfully finishes then its state
will be Finished. If a process does not finish successfully, its state will be Partial.
After the process has run, the backup copy of the archive will be created in a predefined
location on the server.
SEAL system marks the documents which are exported when the process is started, so we
recommend that you do not delete the files exported in the directory structure on the disk,
as another copy of the files which have been exported will not be created at a subsequent
run of the Offline export process.
This type of process allows the export of an archive data model and has the following
particularities:
There is no supporting document as an input file.
The execution of this process generates a JSON output file that contains the archive
data model.
The Export data model background process is run from the Manage data model Export
and Import (see the Data model export and import section). The administrator launches
the process by clicking the Export button. This automatically creates the process Export data
model in the Background processes tab from the Processes section.
To view the process details:
Click the Information button corresponding to the desired Export data model
process located in the Background processes tab.
This type of process allows the import of an archive data model and has the following
particularities:
There is no supporting document as an input file.
The execution of this process is automatically generated by the application and
contains the imported archive data model.
The Import data model background process is run from the Manage data model Export
and Import (see the Data model export and import section). The administrator launches
the process by clicking the Import button. This automatically creates the process Import
data model in the Background processes tab from the Processes section.
To view the process details:
Click the Information button corresponding to the desired Import data model
process located in the Background processes tab.
Download the CSV file containing the input data for the process by clicking the
button corresponding to the Execution result attribute.
The scope of running this process by the archive administrator is to have access to the
details of the error codes and messages displayed in the application interface for each user
of the current archive for a specific period of time.
The Export errors background process is launched from the ReportsErrors audit section
(5.7.7 Errors audit section). The administrator defines the search criteria for the audited
error codes and exports the search results. Thus, an Export errors process is automatically
created in the Background processes tab from the Processes section.
The particularities of the process are the following:
There is no supporting document as input file.
The execution of this process generates a CSV output file with the error codes and
messages audited which have been exported.
To view the process details:
Click the Information button corresponding to the desired Export errors process
located in the Background processes tab.
In the page containing the information corresponding to the process, you can:
This process allows the export of the documents metadata registered within a register, in a
certain period and has the following particularities:
The input data file is automatically generated by the application and contains the
search criteria.
There is no supporting document as an input file.
The execution of this process generates a PDF output file that contains the metadata
of the documents registered within the register.
The Register report export process is run from the Manage data model Mailroom section
(see the Registers section). The administrator generates a register report and launches the
process by clicking the Export button. This automatically creates the Register report export
process in the Background processes tab from the Processes section.
To view the process details:
The scope of running this process is to generate an output file containing the list of
documents that can be deleted. The result of the process execution is used by the archive
administrator as an input data file for creating and running the Delete documents
background process.
The archive administrator configures this process and then, the process is launched
automatically according to the set configuration.
The process becomes active (marked with the button). At each execution of the process,
the application creates a background process that can be accessed in the Background
processes page.
To disable a process, click the Disable button in the Recurrent processes tab. This
button appears when you hover the mouse over the Enable button associated with an
active process. A process which is not active has the button associated with it.
The Mark documents for deletion process has some particular characteristics that are
distinct form other background processes, such as:
Note: The documents marked for deletion are documents that have an overdue
retention term and no retention flags or a file plan class that does not suppose a
selection committee meeting. For documents that have a file plan class that
supposes a selection committee meeting, you must wait for the committee approval.
In the page containing the information of the process you can download the CSV file that
contains the list of documents that can be deleted by clicking the button corresponding
to the Execution result attribute.
Note: The Mark documents for selection committee process is available only for
Compliance version.
The scope of running this process is to generate an output file containing a list of documents
that have a file plan class stating that at the end of the retention period a selection
committee will meet to decide if and when the documents will be deleted. This process is
similar to the Mark documents for deletion process.
The process becomes active (marked with the button). At each execution of the process,
the application creates a background process that can be accessed in the Background
processes page.
To disable a process, click the Disable button in the Recurrent processes tab. This
button appears when you hover the mouse over the Enable button associated with an
active process. A process which is not active has the button associated with it.
The Mark documents for selection committee process has some particular characteristics
that are distinct form other background processes, such as:
Note: The documents marked for the selection committee are documents that have
an overdue retention term, no retention flags and a file plan class that requires a
selection committee meeting.
In the page containing the information of the process you can download the CSV file that
contains the list of documents for the selection committee by clicking the button
corresponding to the Execution result attribute.
The scope of running this process is to allow a periodical synchronization with the LDAP
server, according to the information provided when the archive was created.
The synchronization allows taking information about the users who have Active Directory
accounts and automatically creates access accounts in SealClientWeb application.
If a user is disabled or removed from the group of users from Active Directory, when you run
the process which allows the synchronization with the LDAP server, the changes will be
transmitted to SEAL, as follows:
If a user’s account from Active Directory is disabled, the user will also be disabled in
SEAL and will not be able to access SealClientWeb application.
If a user is removed from the Active Directory group of users, then the user will also
be removed from the group of users from SEAL, in which he was imported.
Moreover, the user’s account is disabled in SEAL and the user will not be able to
access SealClientWeb application.
The archive administrator configures this process and then, the process is launched
automatically according to the set configuration.
To configure the process, click the corresponding Edit button from the Recurrent
processes tab. In the Edit recurrent process page, run the process by clicking the Run button
or schedule the process to run at a certain time with a certain frequency and click the Save
button.
The process becomes active (marked with the button). At each execution of the process,
the application creates a background process that can be accessed in the Background
processes page.
To disable a process, click the Disable button in the Recurrent processes tab. This
button appears when you hover the mouse over the Enable button associated with an
active process. A process which is not active has the button associated with it.
Unlike other background processes, this process does not require an input data file or a
supporting document.
To view the process details:
The scope of running this process is to update the statistics from the application.
The archive administrator configures this process and then, the process is launched
automatically according to the set configuration.
The process becomes active (marked with the button). At each execution of the process,
the application creates a background process that can be accessed in the Background
processes page.
To disable a process, click the Disable button in the Recurrent processes tab. This
button appears when you hover the mouse over the Enable button associated with an
active process. A process which is not active has the button associated with it.
Unlike other background processes, this process does not require an input data file or a
supporting document.
To view the process details:
The purpose of running this process is to delete the archived documents from the location
configured for storing the archive content, for example: DISK, HCP, etc., as a result of
deleting them from SEAL using one of the following ways:
By means of the Delete documents process
Directly from SEAL web interface, by clicking the Delete button from the Actions
column.
For the HCP-storage type archives, the archived documents will be deleted from the storage
location only if the Purge after delete system setting is enabled.
When a document is deleted from SEAL, the document name and the path to its storage
location are inserted in a table of the archive database. Thus, when the Storage cleanup
process is launched, it takes from the database table, the information which is needed to
identify the coordinates from the storage location and checks whether the documents exist
in this location. If the documents exist in the storage location, they will be deleted when the
process is running; otherwise, if the documents that must be deleted do not exist in the
location which was set for storing the archive content, then a message will be displayed in
the process error file, and the corresponding records from the database table will be
deleted.
To configure the process, click the corresponding Edit button from the Recurrent
processes tab. In the Edit recurrent process page, run the process by clicking the Run button
or schedule the process to run at a certain time with a certain frequency and click the Save
button.
The process becomes active (marked with the button). At each execution of the process,
the application creates a background process that can be accessed in the Background
processes page.
To disable a process, click the Disable button in the Recurrent processes tab. This
button appears when you hover the mouse over the Enable button associated with an
active process. A process which is not active has the button associated with it.
Unlike other background processes, this process does not require an input data file or a
supporting document.
To view the process details:
The purpose of running this process is to allow a periodical synchronization with the SEAL
Physical Records application, according to the information provided when the archive was
created.
The archive administrator configures this process and then, the process is launched
automatically according to the set configuration.
To configure the process, click the corresponding Edit button from the Recurrent
processes tab. In the Edit recurrent process page, run the process by clicking the Run button
or schedule the process to run at a certain time with a certain frequency and click the Save
button.
The process becomes active (marked with the button). At each execution of the process,
the application creates a background process that can be accessed in the Background
processes page.
Unlike other background processes, this process does not require an input data file or a
supporting document.
To view the process details:
The purpose of running this process is to notify users with relation to the documents that
have been uploaded in the archive, documents which fulfill the criteria in the templates to
which users are subscribed.
Users are notified both by e-mail, as well as in the Latest messages area from the
application main interface. The notification contains the following information: the name of
the template whose criteria are fulfilled by the document added in the archive, the name of
the document and the user who added it, the date and time when the document was added
in the archive and the link to the document.
The archive administrator configures this process and then, the process is launched
automatically according to the set configuration. At each execution, the process identifies
the documents that have been added to the archive from the process last run up to the
present and which comply with the conditions included in the template to which the user is
subscribed.
To configure the process, click the corresponding Edit button from the Recurrent
processes tab. In the Edit recurrent process page, run the process by clicking the Run button
or schedule the process to run at a certain time with a certain frequency and click the Save
button.
The process becomes active (marked with the button). At each execution of the process,
the application creates a background process that can be accessed in the Background
processes page.
To disable a process, click the Disable button in the Recurrent processes tab. This
button appears when you hover the mouse over the Enable button associated with an
active process. A process which is not active has the button associated with it.
To view the process details, click the Information button corresponding to the desired
Subscriptions delivery process from the Background processes tab.
The purpose of running this process is to extract the information from the files in DICOM
format. The extracted information is displayed as the value of the DICOM properties specific
metadata which is added to the metadata schema (after successfully running the Extract
metadata process) on which files in DICOM format have been uploaded.
After the Extract metadata process is completed successfully, it will be available the option
for viewing the content of a document in DICOM format by using a dedicated viewer.
The archive administrator configures this process and then, the process is launched
automatically according to the set configuration. At each execution, the process identifies
the documents that have been added to the archive from the process last run up to the
present and which comply with the defined filters.
To configure the process, click the corresponding Edit button from the Recurrent
processes tab. In the Edit recurrent process page, select the metadata schema for which you
want to run the process or, to run the process for all metadata schemas, select the any
schema value.
Run the process by clicking the Run button or schedule the process to run at a certain time
with a certain frequency and click the Save button.
The process becomes active (marked with the button). At each execution of the process,
the application creates a background process that can be accessed in the Background
processes page.
To disable a process, click the Disable button in the Recurrent processes tab. This
button appears when you hover the mouse over the Enable button associated with an
active process. A process which is not active has the button associated with it.
Unlike other background processes, this process does not require an input data file or a
supporting document.
To view the process details, click the Information button corresponding to the desired
Extract metadata process from the Background processes tab.
The purpose of running this process is to delete the audit information older than a specified
number of days, stored in the archive database, in order to free database server space and
to improve audit search response time.
The archive administrator configures the Purge audit process and then, the process is
launched automatically according to the set configuration.
To configure the process, click the corresponding Edit button from the Recurrent
processes tab. In the Edit recurrent process page, run the process by clicking the Run button
or schedule the process to run at a certain time with a certain frequency. For this, fill in the
date and time of the next run, as well as the process frequency.
Also, configure the following parameters:
Maximum process duration (hours) – fill in the number of hours for which the
process will run.
Number of records in a batch – fill in the number of records that will be deleted in a
single database transaction (the default value is 10000).
Delete entries older than (days) – fill in the number of days after which the audit
records are deleted from the database.
Path to export deleted entries – optionally, you can fill in the path in which the
deleted audit records will be exported. The audit records will be exported in CSV
files, with a maximum size of 200 MB.
To save the configurations made, click Save.
The process becomes active (marked with the button). At each execution of the process,
the application creates a background process that can be accessed in the Background
processes page.
Important: In order not to affect the performance of SEAL application, the process
must be configured to run outside working hours.
To disable a process, click the Disable button in the Recurrent processes tab. This
button appears when you hover the mouse over the Enable button associated with an
active process. A process which is not active has the button associated with it.
Unlike other background processes, this process does not require an input data file or a
supporting document.
To view the process details:
Note: The user who runs the Contentless documents ingestion process must have at
least write permission in the directory which contains the CSV files.
If a process instance does not finish successfully, its state will be Partial success. The Details
column contains a link to the details of the encountered errors. To view the filters that can
be defined in the Process errors audit interface, consult the beginning of section 5.6,
Processes errors audit.
Once started, the Contentless documents ingestion process can be stopped by clicking the
Disable button from the Continuous processes tab. If the process is in the middle of
processing a CSV file, the current file will be finished and then the process will stop.
To view the history of the process executions, click the Runs history link from the History
column. You will be redirected to the Background processes page.
To view the process details, click the Information button corresponding to the
Contentless documents ingestion process, located in the Background processes tab.
The Import files process is a continuous asynchronous process, whose purpose is to import
documents in the electronic archive, documents whose content is stored in a location on the
disk. The process is manually started and stopped by the archive administrator and it is
configured to monitor a directory in which it searches for CSV files in order to process them.
The schema and the metadata of documents will be imported from CSV files. These must
fulfill the following conditions:
The CSV file must contain on the first row the names of the documents metadata
which are to be imported and the metadata values on the following rows.
The CSV file must be built-up so as to use a comma (,) as a delimiter for columns and
the quotation marks (“) as a text delimiter. The (double) quotation marks in a field
must be represented by two (double) quotation marks.
The CSV file must be in UTF-8 format. For example, if you edit the file using
Notepad++, verify whether it is in UTF-8 format after saving the changes you have
made (Encoding->Encode in UTF-8).
The mandatory columns which must exist in the CSV file are:
metadata_schema
filePath – this column must contain the location from which the documents will be
imported. For example: C:\\input_folder\\test.txt
The user who runs the Import files process must have at least read permission in the
locations specified in the filePath column.
Note: The metadata_schema and filePath columns can be renamed in the
filesimportprocess.properties file which is located on the application server where
SEAL is installed.
filename – this column must contain the name of the file to be imported. For
example: test.txt
issueddate
documentType
This column is mandatory if the documentType metadata is mandatory and a default
value has not been set for it.
Also, the mandatory metadata of the SEAL metadata schema on which documents will be
imported must exist in the CSV file on the corresponding columns and must have values
assigned, each metadata on a separate column with the metadata system name.
If you add the documentSize column to the CSV file, the value filled in for it must match the
size of the file which represents the content of the document imported in SEAL, otherwise
the document cannot be properly downloaded from SEAL.
To create and run this process, you must follow the steps:
Note: The user who runs the Import files process must have at least write
permission on the directory which contains the CSV files.
If the process finishes successfully, the .imported extension will be added to the original CSV
file. If at least one error appears, the .processed extension will be added to the original file
and a new file with the .error extension will be created, containing only the lines for which
errors have appeared.
The Details column contains a link to the details of the encountered errors. To view the
filters that can be defined in the Process errors audit interface, consult the beginning of
section 5.6, Processes errors audit.
Once started, the import files process can be stopped by clicking the Disable button
from the Continuous processes tab. If the process is in the middle of processing a CSV file,
the current file will be finished and then the process will stop.
To view the history of the process executions, click the Runs history link from the History
column. You will be redirected to the Background processes page.
# csv props
csv.referintaStorage.column=referintaStorage
The schema and the metadata of documents will be imported from CSV files. These must
fulfill the following conditions:
The CSV file must contain on the first row the names of the documents metadata
which are to be imported and the metadata values on the following rows.
The CSV file must be built-up so as to use a comma (,) as a delimiter for columns and
the quotation marks (“) as a text delimiter. The (double) quotation marks in a field
must be represented by two (double) quotation marks.
The CSV file must be in UTF-8 format. For example, if you edit the file using
Notepad++, verify whether it is in UTF-8 format after saving the changes you have
made (Encoding->Encode in UTF-8).
The mandatory columns which must exist in the CSV input file are:
metadata_schema
referintaStorage – this column uniquely identifies the records in the database table.
Considering the blobingestion.properties file displayed above, this column must be
filled in with values of the id column from the job_data table, and the content of the
imported document will be the content of the data_file column.
filename – this column must contain the name under which you want the file to be
imported in SEAL. For example: test.csv
Note: The user who runs the BLOB documents ingestion process must have
at least write permission on the directory which contains the CSV files.
The Details column contains a link to the details of the encountered errors. To view the
filters that can be defined in the Process errors audit interface, consult the beginning of
section 5.6, Processes errors audit.
Once started, the BLOB documents ingestion process can be stopped by clicking the Disable
button from the Continuous processes tab. If the process is in the middle of processing
a CSV file, the current file will be finished and then the process will stop.
To view the history of the process executions, click the Runs history link from the History
column. You will be redirected to the Background processes page.
To view the process details, click the Information button corresponding to the BLOB
documents ingestion process, located in the Background processes tab.
The Details column contains a link to the details of the encountered errors. To view the
filters that can be defined in the Process errors audit interface, consult the beginning of
section 5.6, Processes errors audit.
Once started, the process can be stopped by clicking the Disable button from the
Continuous processes tab.
To view the history of the process executions, click the Runs history link from the History
column. You will be redirected to the Background processes page.
To view the process details, click the Information button corresponding to the Content
processing process, located in the Background processes tab.
Smart Folder Processing is a continuous asynchronous process, which allows the automatic
creation of smart folders and the upload of the new documents within, as a result of the
mapping rules configured in the Automated actions step Smart folder distribution tab
from the metadata schemas creation wizard.
The process is manually started and stopped by the archive administrator.
To create and run this process, you must follow the steps:
1. Click the Continuous processes tab from the Processes section.
2. Click the Run button associated with the process.
3. In the Edit continuous process window, fill in the following fields:
Core threads – fill in the number of threads that are constantly available to
the continuous process, even if the threads are idle. A value of 0 means an
unlimited number of threads. The value for this setting cannot exceed the
maximum number of threads.
Maximum threads – fill in the maximum number of threads that can be used
by this continuous process.
The Details column contains a link to the details of the encountered errors. To view the
filters that can be defined in the Process errors audit interface, consult the beginning of
section 5.6, Processes errors audit.
Once started, the process can be stopped by clicking the Disable button from the
Continuous processes tab.
To view the history of the process executions, click the Runs history link from the History
column. You will be redirected to the Background processes page.
To view the process details, click the Information button corresponding to the Smart
Folder Processing job, located in the Background processes tab.
5.7 Reports
The archive management application offers the user reports that contain useful information
about the number of archived documents and the space used by them, the operations done
in the system, the time and date of the execution.
To consult the reports, the user must click the Reports button from the main interface
of the application.
The Archive ledger report is available to the archive administrator only if the archive
parameter, Enable archive ledger, is selected.
To access the archive ledger report, click the Archive ledger command from the submenu
displayed when selecting the Reports button from the application main interface. This
report is available only for archive administrator users and client administrator users.
Input data: The records regarding the documents that were uploaded in the archive and
those that were deleted from the archive.
Applied filters: N/A
To access the quantitative report, click the Quantitative report command from the
submenu displayed when selecting the Reports button from the application main interface.
This report is available only for archive administrator users and client administrator users.
The quantitative report displays the maximum volume of information reached in a certain
period.
Input data: Aggregated statistics information about the current archive.
Applied filters: N/A
Results:
The report can be downloaded and viewed in a PDF file by clicking the Download PDF
button.
To access the audit report, click the Audit report command from the submenu displayed
when selecting the Reports button from the application main interface. This report is
available both for the master administrator, as well as for the archive administrator.
Input data:
For the archive administrator, the current archive audit information is considered: records
of the actions (create, edit, delete) performed on objects from the archive and records
about other actions, such as login or download.
For the master administrator, according to the search criteria entered, all the information
from the system (objects, actors, archives) can be considered.
Applied filters:
In the search criteria page, the following fields must be filled in:
To generate the file plan report, click the File plan command from the submenu displayed
when selecting the Reports button from the application main interface. This report is
available only for archive administrator users and client administrator users.
Input data: Only the information from the active file plan of the current archive is
considered.
Applied filters: N/A
Results:
The archive administrator has the possibility to export the file plan in a PDF file by clicking
the Export button. The file can be downloaded from the background processes area or from
the administrative documents area (consult the Export file plan and the Administrative
documents sections).
The PDF report contains the following columns:
Direction
Services
Register Folder Name etc.
Storage Term
SC (Selection committee)
Observations
In addition to this information, the report contains the following: the file plan date of entry
in force, the current selected archive, the date and time when the report was generated.
To access the usage report, click the Usage report command from the submenu displayed
when selecting the Reports button from the application main interface. This report is
available only for archive administrator users and client administrator users.
Input data: Statistics about the number of users and the data volume, regarding the current
archive.
Applied filters: N/A
The information from the current and last month are considered.
The report also contains the following: the name of the current archive and the name of the
associated client, as well as the date and time when the report was generated.
To access the active users report, click the Active users report command from the submenu
displayed when selecting the Reports button. This report is available only for the master
administrator.
Input data: Statistics about the number of allowed, defined, and active users for each client
defined in SEAL system.
Applied filters: N/A
Results:
The report can be downloaded and viewed in a PDF file by clicking the Download PDF
button. It contains the following information, for the system license and for each client
defined in the system:
The maximum number of allowed users
The number of defined users
The total number of active users
The report also contains the date and time when the report was generated.
To access the errors audit report, click the Errors audit command from the menu displayed
when selecting the Reports button from the main application interface. This report is
available to the master administrator user, and also to the archive administrator.
Input data:
SEAL01093: An error The input data file Introduce a new valid value for
occurred when running uploaded when creating the archiveClassificationClass
Update metadata the process contains a attribute (e.g. , I.A.1. General
process. Error when
wrong value for the documents) and then run the
editing metadatas for
lines: [2] Error when archiveClassificationClass process.
editing documents. attribute.
ro.star.seal.business.Bus
inessLogicExceptionWit
hRollback:
ro.star.seal.business.Bus
inessLogicException:
There is no file plan
class
SEAL01097: Security This error appears when For the securityPolicy attribute, fill
policies [Politica test] running an Apply security in the name of a security policy
were not found. policy process. The politica that exists in the system and run
test value corresponding the process.
to the securityPolicy
attribute from the input
data file is missing.
SEAL01020: An error This error appears when When creating a Legal hold
occurred when running running a Legal hold process, with the purpose to
Legal hold process. The process. remove a retention flag from a set
flag 111 is not in the of documents, make sure that you
There is no 111 retention
flag list of document enter the code of a retention flag
flag for the document with
with id that exists on the set of
the specified id.
IRNDLREOOL_900000 documents. Then, run the
process.
SEAL01088: Storage This error appears when When creating a Change retention
“Wrong e-mail The provided e-mail address An e-mail address should look
format.”
For the errors that can appear when uploading documents in the archive using
SealUploader, consult the user guide of this application.
Include the name of the product for which you send the message in the e-mail subject.
By following these instructions you will help us investigate the problem and find a solution.
When you click the button, the Go to page window appears. The user must enter the
number of the desired page and click Go.
To order the elements displayed on the page, click the title of the column you want to sort
by. The symbol means that the records are in ascending order, and the symbol means
that the records are in descending order.
The user has the possibility to filter the list by entering a string in the Filter by name field.
The application displays the specific entities (documents, users, processes, and rules) whose
name contains the entered string.
Hereinafter, we describe the options that can be found in the Actions column. This column
appears within the interfaces that display information in a table format.
By clicking the Download button, users can access documents from the archive
(archived or administrative documents). Users can choose from the following options: open
the document, save the document on the local disk or cancel the operation of downloading
the content of the document.
In the application, you can find other ways to download documents, either explicit links
from the interface, or buttons like or . The downloaded documents can be viewed
with a corresponding application, from the user workstation, that is not part of the archive
system, such as Adobe Reader or MS Excel.
In all sections of the application where documents are listed, click the Information
button to display the document details window.
By clicking the View button ( for documents, for audio files and for video files),
users can view the document content in the browser, without installing other software. This
functionality is available only for the file formats which were configured in the Settings
section. For more details about the file formats supported by the built-in SeeIt viewer,
please consult the Configure system settings section.
When the viewer is open, the first page of the document is displayed, and in the left side are
displayed all the document pages.
To view a certain page, select the page from the left side or enter the page number in the
Go To field and click the button.
To return the page to its original size, after it was zoomed in or out, click the Go home
button.
To zoom in an image, proceed in one of the following ways:
Left click the image region that you want to increase
Click the button from the document view area
Scroll up the mouse wheel
To zoom out an image, proceed in one of the following ways:
- Shift + left click the image region that you want to decrease
- Click the button from the document view area
- Scroll down the mouse wheel
The user has the possibility to rotate the image by clicking the , , or
buttons.
By clicking the button, the image can be viewed in full screen, as in the following
picture:
In this page, a button is displayed which redirects the user to the edit mode (Edit button).
In the interfaces that display entities (such as: users, perspectives, metadata schemas), to
edit the details, click the Edit button associated with the desired entity.
To delete an entity (users, perspectives, metadata schemas), click the Delete button
associated with the desired entity.
This file can be used as an input data file for creating and running most of the processes
from the application.
Also, the content of the objects (archived documents, administrative documents) resulted
from an advanced search can be exported in a .zip archive by clicking the Export content
button.
Note: In the application, the operations and actions which are not available are
disabled and cannot be accessed by the user.
1 Archive archiveDate Date YES The date and time when ”01/23/2
date (including the electronic document 015
time) was uploaded in the 11:22:45
archive. ”
It is automatically filled in
by the system, if content is
uploaded into SEAL
directly.
If content is discovered by
the Contentless
documents ingestion job,
then the value can be
specified in the input CSV
file and can be saved as
provided by 3rd party
system.
2 System documentNa String YES The name of the document ”Invoice
name me as it appears in the list of RD
documents. 283_21.0
9.2010”
It is automatically
composed by the solution
by concatenating the
values of some mandatory,
generic and/or specific
It is automatically filled in
by the system.
1. Access the Microsoft SQL Server Management Studio application and select the new
database options.
2. In the Database name field, enter the database name and click the OK button.
3. Make sure the user roles on the created database are dbo_owner and public
(SecurityLogins< login name > User Mapping). If these roles are not selected for
the created archive, mark these roles and click OK.
Search for Date field (the date must be entered in the following format yyyy-mm-dd)
SELECT * FROM cmis:'Proces Verbal' where ss:Date>=2010-11-28 or
ss:Date=2014-11-06
Once everything is started, you can start playing with the Eclipse and web tooling, as
explained hereinafter.
If you only want to try out the web tooling and do not wish to download and install the
Eclipse tooling, you can use these alternative commands:
ant install.demo.noeclipse
ant start.demo.noeclipse
Note: It may take 1-2 minutes until the application becomes accessible, from the
moment the ant command finishes. If any problems appear, they can be tracked in
the WildFly application server log, which can be found in the unzipped folder.
According to how the already existent bpmn files were generated, it is possible that
they are successfully imported or not.
If you want to check if the current file is valid you can use the Start validating
option from the top menu corresponding to the icon. To display the errors,
access the View all issues option from the same menu.
To add elements, use the expandable menu on the left. Each process must begin
with a start state (Start Events – None) and end with a final state (End Events -
Terminate).
Figure 12.5 - Use start state and final state in creating processes
To use it in the context of SEAL application, currently you can only use the user task
states (Tasks – User), so you must only use this type of node. To add different types
of nodes in the graphical user interface, select the node and use the “drag and drop”
method to put the node in the desired location.
In order to be valid, the nodes must have a name (as the visible one in the figure
above) and a Task Name. In this regard, select the desired node and expand the top-
right menu, which contains the associated properties of the node, where you can
edit Name and Task Name.
If you want to add more branches, they must be connected through gateways (the
Gateways section from the left menu).
Important: Both files, svg and bpmn must be obtained by exporting them from KIE
Workbench, so as to correspond the identifiers inside the files, necessary to build
the image of a workflow instance (by coloring the completed states and the work-in-
progress ones).
The files resulted after the export are used to create the workflow definition in SEAL
application. For more details, consult the Workflow definitions section.
To add custom service tasks, take the following steps:
In KIE Workbench, navigate to Project Authoring. In the upper left section of the
page, select New Item -> Uploaded File; name the file “SealWorkItemDefinitions”
and upload the file named SealWorkItemDefinitions.wid, which can be found by
accessing the _full\seal\workflows path from the SEAL installation kit received. In the
WORK ITEM DEFINITIONS tab (lower left of the page), you should be able to see the
newly created work item definitions set.
Select the SealWorkItemDefinitions from the WORK ITEM DEFINITIONS. The custom
work item definitions will be uploaded in the editor window. Click Validate on the
top right section of the page, to make sure the definitions are valid. If not, contact an
administrator.
After uploading the custom work item definitions, the custom service tasks should
already be available in the Object Library.
On the gateway where manual routing should apply, for each of its outgoing
connections, select the branch and expand the Properties tab on the right. Click
Expression. In the newly opened pop-up, select Process variable as nextState,
Condition as is equal to, and fill in the remaining field with the name of the next
User Task, ServiceTask or End event that follows after the branch.
As part of SEAL integration with JBPM, it should be known that a JBPM workflow refers a
SEAL document and all the tasks of a JBPM workflow are applied over the respective SEAL
document. In order to ease the access to a SEAL document, SEAL provides some JBPM
process variables that may be mapped as workflow definition variables and used further on
Data Outputs, Conditions, and so on.
These process variables provided by SEAL are:
currentArchive – the name of the current SEAL archive;
currentArchiveId – the ID of the current SEAL archive;
currentUser – the name of the current logged user on the current SEAL archive;
documentId – the name of the current document on which the workflow is applied;
workflowStartDate – the date at which workflow started;
To create a workflow definition, you must install the graphical modeling tool, Eclipse BPMN2
Modeler 1.4.2. (in Eclipse, navigate to the HelpEclipse Marketplace menu and install the
necessary tool).
To create a new workflow definition, proceed as follows:
1. Navigate to the FileNewJava Project menu to create a new project. The project
you created is saved and displayed on the left side of the interface, in Package
Explorer. Later, the workflow definitions will be created inside this project.
2. Select the project you created and add a new process definition by selecting the
NewFile option from the contextual menu displayed when you right click the
project.
3. In the displayed window, you have the following options:
You can import the process definition from an already existent bpmn2 file, if
you check the Link to file in the system option and upload the desired file.
You can create a file with the .bpmn2 extension, whose name must be
indicated in the File name field. For example: test.bpmn2. In this file you will
have to draw later the process by using the Eclipse BPMN2 Modeler, taking
into consideration the bpmn standard, so you can have a valid workflow
definition.
Figure 12.15- Use the start and final state in creating the processes
To use it in the context of SEAL application SEAL, currently you can only use the user
task state (Tasks – User), so you must use only this type of node. To add different
nodes in the graphical user interface, select the node and use the “drag and drop”
In order to be valid, the nodes must have a name (as the visible one in the above
figure) and a Task Name. In this regard, double click the desired node and the Edit
User Task window opens, which contains the associated properties of the node,
where you can edit the Name (from the General tab) and the Task Name (from the
User Task tab).
If you want to add more branches, they must be connected through gateways (the
Gateways section from the right menu).
You can add nodes and connections to the created process until this one represents
the business logic you want to specify.
Moving from one step to another inside the workflow can be done automatically,
based on evaluating the conditions that take into consideration the metadata values
of the document.
To add a condition on a “gateway” type element, simply click it. In the lowest part of
the interface, in the PropertiesGateway tab the existent conditions are displayed.
If the Properties tab is not displayed, you can add it this way: right click in the
interface for creating the graphic representation of the process and select the Show
Property View option.
To manage a condition, select the desired condition and access the edit button.
In the displayed interface you can add (Add Condition), edit or delete (Remove
Condition) a condition.
In the previous figure, if the totalScore metadata of the document sent on the
workflow has an associated value and this is greater than 9, the workflow ends with
the Contract approved state. Otherwise, the workflow ends with the Contract
rejected state.
The global variables (the metadata), on which the conditions are based, must exist in
the PropertiesData Items tab.
To add a variable, click the Add button, as you can see in the following figure:
Note: Next, we refer to the ADFS server as IDP (Identity Provider), and to SEAL
application as SP (Service Provider).
Prerequisites
For ease of handling certificates/keys, install KeyStore Explorer, from the location:
http://keystore-explorer.org/downloads.html
SEAL configuration
1. Download the metadata of the ADFS server in a file named FederationMetadata.xml.
You can find it on the machine with ADFS, for example:
https://<machine_ip_adfs>:<machine_port_adfs>/FederationMetadata/2007-
06/FederationMetadata.xml
or
https://localhost/FederationMetadata/2007-06/FederationMetadata.xml, if you are
on the machine where the ADFS server runs.
When saving the FederationMetadata file, verify that it is xml valid (its content has
not been altered).
You must make sure that the address referred in the XML file, downloaded for the
SingleSignOnService node and the Location attribute can be accessed from the SEAL
server machine.
2. Copy the ADFSv2.0-FederationMetadata.xml file obtained at step 1 in SEAL to the
location:
{cale_server_wildfly_seal}\modules\ro\star\main\conf\adfs\. This file represents the
ADFS server description (metadata) used for authentication.
3. This step is required if the certificates are not trusted (for example, they are not
signed by a trusted authority). Download the certificates used by ADFS from the
machine where the ADFS server runs, as follows:
Note: If the seal.adfs key (in the previous figure, referred to as tomcat7) is
expired, it has to be replaced with a valid one.
7. In the SealAdminApplication.ear\SealAdminWeb.war\WEB-INF\spring-config\seal-
security.xml and SealAdminApplication.ear\SealClientWeb.war\WEB-INF\spring-
config\seal-security.xml files, uncomment the lines which refer to ADFS. This change
requires restarting WildFly server application.
8. In the SealAdminApplication.ear\SealAdminWeb.war\WEB-INF\spring-config\seal-
security-adfs.xml and SealAdminApplication.ear\SealClientWeb.war\WEB-INF\spring-
config\seal-security-adfs.xml files, within the metadataGeneratorFilter bean, for the
entityBaseURL entity, set the SEAL URL (Admin and Client by case).
9. AD (ADFS) users must be part of the AD accepted security group (Seal_Authorized
implicitly) – the name of the group is configured in SEAL system settings (System
settingsOther settings ADFS group authorized for SEAL).
The ADFS group authorized for SEAL must be previously defined in the AD used by
the ADFS server.
Useful information
To check the ADFS logs with the purpose to view, for example, the errors appeared in the
requests to ADFS, proceed like this:
Remotely access the machine on which the ADFS server is installed.
In Windows Start, type Event Viewer and press Enter.
In the details section, double click Applications and Services Logs, then click AD FS
Eventing and then click Admin.
On the right side you can view the log – click one of the events to view all the details.
SEAL00215 Document is already related to a workflow! Cannot send document from async {0}
SEAL00216 The operation could not be completed because you don't have the rights to access
the document associated with this task.
SEAL00217 An error occured while completing the task due to one or more metadata values
being empty or invalid. Please check the workflow definition
SEAL00218 Could not complete workflow task {0}
SEAL00219 The storage does not allow document deletion
SEAL00220 An attachment with filename {0} already exists. You cannot attach 2 files with the
same filename for the same document
SEAL00221 There are already started workflows, based on this definition. The workflow
definition cannot be deleted
SEAL00222 Error mapping value on existing ValueList. Input value: {0} for list with name: {1} and
id: {2} does not exist.
SEAL00223 Cannot find selected provision type. Check the sql script in path: {0}
SEAL00224 Cannot initialize archive. Check the sql script in path: {0}
SEAL00225 Could not create new filespace! {0}
SEAL00226 The DataSource could not be installed!
SEAL00227 Document was not saved! {0}