Skip to end of metadata
Go to start of metadata

Introduction

To simulate the use of an S3 storage in your Business Processes, RPA Express offers a local File Storage, which is installed and configured on your machine during RPA Express setup.

There is a pre-configured common bucket called Public, with Read/Write access, so you are able to upload/download files there.

File Storage

In order to create a new bucket or use the existing one to upload files, you should use the local File Storage, which is installed with RPA Express.

  1. Use File Storage from the RPA Express tray menu:




  2. The login page opens in your default browser:

  3. Log in with your credentials.

    Note

    Credentials for the File Storage are defined during installation.

    See RPA Express Installation section for more details.

  4. Upon login you can browse the content of File Storage, create new buckets or upload/delete files:


Attention

The other buckets are for internal purposes of RPA Express.

Do not use, modify or delete them!

Create Bucket

If it is necessary, you can create your own buckets for your Business Processes.

  1. Click the plus button
  2. Select Create bucket
  3. Enter the name for your bucket
  4. Set Bucket Policy (by default a new bucket is created as read-only)
    1. Hover the bucket and click ...
    2. Change the default read-only policy to the type you need for your Business Process


      Add the asterisk (*) symbol to the Prefix field.

    3. Click Add to save your changes and close the window:

Upload Files to Bucket

You can upload files for your Bot Tasks to your bucket. 

  1. Select the bucket to upload a file to. If you need to upload the file to a sub-folder in the bucket, then you should choose the sub-folder before.
  2. Click the plus button
  3. Select Upload files:
  4. Navigate to the file you want to upload to the bucket:


    Note

    You can upload one file at a time!

  5. Now you can see the uploaded file in the bucket:

Delete Files from Bucket

You can delete files from your bucket, if you don't need them anymore. 

  1. Select the bucket to delete a file from. If you need to delete the file from a sub-folder in the bucket, then you should choose the sub-folder.
  2. Select the file you want to delete, and click ... , then click Delete:

  3. Click Delete to confirm deletion, or Cancel to abort the operation

Using File Storage in Recording

For your recordings you can use the Public bucket or create your own bucket as described above. When you create a new bucket do not forget to set the Bucket policy.

How to Create Folders

Folders in a bucket can be created either from the script or using the file system.

Create a Folder in the file system

  1. Open a file manager, for example Windows Explorer.
  2. Go to your RPA Express installation folder (by default C:\RPAExpress\).
  3. Find the data folder there (\RPAExpress\minio\data\).
  4. Find your bucket there (for example "public").
  5. Create a new folder in the bucket.
  6. You can use the folder now to upload your files there. The files can be uploaded as described above or copied over the file system.

How to Upload Files

 The files can be uploaded as described above or copied over the file system.

Copy files over the file system

  1. Open a file manager, for example Windows Explorer.
  2. Go to your RPA Express installation folder (by default C:\RPAExpress\).
  3. Find the date folder there (\RPAExpress\minio\data\).
  4. Go to your folder in the bucket (for example "\public\invoices2process\").
  5. Copy your files to the folder.
  6. Now you can create a list with your files to be used as the Input data for your Business Process.

How to Create Input Data Files

 The files can be uploaded as described above or copied over the file system.

Copy files over the file system

  1. Create a .csv file.
  2. Enter the column name, for example file_link.
  3. Open File Storage from the tray menu.
  4. Go to your folder in the bucket (for example "\public\invoices2process\"), choose a file, click ... and select the Copy link item:
  5. Copy the link to your file:
  6. Paste the link from the Clipboard in the .csv file. The pasted link looks as follows
    localhost:15110/public/invoices2process/invoice1.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=workfusion%2F20170523%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20170523T111642Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=3ef281810c1503606495a1933f8c305af2ba245402c03f0a87376090274fa559
  7. Remove all characters after the question mark, as they are not necessary. So now the link has the following format
    localhost:15110/public/invoices2process/invoice1.png
  8. Repeat the procedure for all files you are going to use as the Input data.
  9. Save and close the file.
  10. Use the file as Input data in your Business Process.

How to open backet to public access

  1. open folder where minio installed (example C:\rpaexpress\minio)
  2. run next command in minio_mc which will add your host as follows 
    minio_mc config host add myminio http://127.0.0.1:15110 %userkey% %passwordkey%
  3. run next command in minio_mc which will apply necessary policy to your backet
     minio_mc policy public myminio/public
  4. now you have open access to the file like this: localhost:15110/public/invoices2process/invoice1.png

Using File Storage in Bot Task

Below you can see an example how to use the Public bucket in the script (Bot Task):

Sample S3 File Storage
<var-def name="s3_link">
	<s3 bucket="public">
		<s3-put-public path='myfiles/tiff/${document_uuid}.tiff' content="${tiff_content}"/>
    </s3>
</var-def>

Code execution results:

  • A sub-folder myfiles/tiff/ is created in the Public bucket.
  • A .tiff file is put there under the name defined in ${document_uuid}.
  • The link to the file is included to the export for the next step.
  • The procedure is repeated for all files from the input data..
  • No labels