HowTo: Working With Documents

Official Content
This documentation is valid for:

To work with documents in GXflow, that is, in order to associate process instances with attachments of formats such as doc, xls, pdf, etc. you have to do the following:

Definition at the global level in the Knowledge Base

First, they should be defined at the global level from the GeneXus IDE using the Preferences /Workflow/ Documents option as shown in the image below:

docs_1_v18_jpg

Association of Documents with Processes

Once the documents have been defined at the global level, they have to be associated with the processes in which they are going to be used. This is done from the process properties dialog as shown in the figures below.

docs_2_v18_jpg

Note: If the documents are not associated with the process, it will be automatically done upon associating the documents with the task.

Association of Documents with Tasks

Once the documents have been defined at the global level, they can be associated with a task. If the previous step was skipped and they weren't defined at the process level, it will be automatically done.

Before associating the documents with the task, you will have to enable it to manage them as shown below.

docs_3_v18_jpg

Next, you will have to associate the document definitions with the task, which implies that later on you will be able to instance documents of that type. When you do this, it is also possible to indicate which actions are available to the user and which are required, by checking the enabled and required columns respectively.

docsOptions_png
Once the documents' logic has been defined, you have to perform the following steps in the Workflow client before executing a flow with documents.

Configuration of preferences

In the GXflow Client, in the Advanced/Document Management group of preferences, the Enabled preference must be set to Yes. Also, in the Upload Path you have to specify the absolute path to the directory in the server that will be used to temporarily save the uploaded documents (before they are entered into the system database, the documents must be temporarily saved in the server disk).

Note: the Upload Path must be an absolute path and the web server user must have write rights over that folder.

See more in this article Configuration of preferences.

i4_2022104115921_1_png

Work with Documents

After configuring all the necessary settings, execute the task whith associated documents.

If the task doesn't have an associated application, such as a Transaction, the dialog to work with documents is displayed when executing the task. Otherwise, you have to select the instance and press the Documents button as shown in the image below:

i5_2022104115952_1_png

Then, in both cases, a dialog similar to the one below will be displayed:

Actdoc_png

The possible actions that you can execute on the documents are the following:

  • Read documents

By accessing the button "Read" you can visualize the content of the last document version. If the document format has an associated application in the client PC, the document will be opened with this application. Otherwise, a document copy will be saved on the disk.

  • Check out documents

By accessing the button "Check out" you can modify documents content. This action amounts to executing a document “check out”. That is to say, the user obtains a soft copy of the document to make the modifications. Once the modifications have been made, the user will be able to execute the corresponding document “check in”; that is to say, uploading the document to the server as a new version (See “Uploading documents” section). It is to be pointed out that, once a user has executed a document “check out”, this document will remain locked and other users will not be able to modify it until the corresponding “check in” is executed.

  • Check in documents

By accessing the button "Check In" you can upload a new version of the document to the server (execute a “check in”). In the dialog displayed, you must specify the path of the document that you want to upload:

updoc_png

This option will only be available if the user has executed the corresponding “check out” of the document (mentioned in the previous section), once the check in is done, the document will be unlocked.

  • Remove documents

By accessing the button "Remove" you can delete a document and all its versions.

  • Versions

By accessing the button "Versiones" you can see all the versions that have been uploaded of a document.

  • New documents

Among the actions that you can execute with documents there is also the creation of a new document. For this, you must access the button "New" and entering the document and the document type in the dialog shown.

newdoc_png

The available types are defined in GeneXus for the corresponding task (see Workflow Preferences).

The actions that can be executed on documents associated to a task are those specified in the diagram. E.g.: it is possible that, given a document, you can only visualize its content, but you cannot modify it. Another possibility is not to allow the creation of new documents from a specific type.

It is also possible that a task has a group of actions whose execution is required on specific document types. E.g.: it can be determined that the creation of a “Doc1” type document is required. In this way, if the user does not create this document and attempts to finish the task, the following error message will be displayed:

PendingDocActions_wkf

Document Manager

In this application you can globally manage all the documents existing in the workflow application regardless of the process or task to which they belong. This application can be accessed from the Navigator as shown in the figure below:

docs_7_v18_jpg

GXflow offers the possibility of searching for words within the documents. To do this, you must set the Full Text Search Document Property to yes in the IDE and in the Document Management section, after that you need to select an Index Directory, which should be different than the Upload Path. Once you have configured it correctly, if you search by word in the Document Manager, all the documents that contain that word in the grid will appear. Only documents uploaded after the Full Text Search Document setting will appear.

NOTE: The size of the uploaded files is limited by the property maxRequestLength in the web.config file under <system.web>.

There is a way of determining the maximum value of upload file size and its changing its value

              <httpRuntime  maxRequestLength="<size>"/>

Where <size> is the number of kilobytes; e.g.: 2048. (see http://msdn.microsoft.com/es-es/library/e1f13641(v=vs.80).aspx )

In java its for timeout and we have to configure it in the web server.