Wiki
Wiki

Attach files β Pro

β-version! Works in desktop application and web application.

Attach file #

To attach a file to a task, you need to open it for editing. Two methods are available:

  1. Click on the paperclip icon — the standard file selection window of your operating system will open.
  2. Drag-т-drop the file into the task field from the file selection window.

You can attach multiple files at the same time using any of these methods.

If you drag-n-drop a folder with files into the task field, all files in the folder will be attached to the task, subject to limitations.

Settings #

File settings are available in the Files tab β of the application settings.

On the settings tab, you can:

  • See how much space attachments occupy on the server.
  • Free up space on the server by selecting to delete attachments from tasks in the Archive and/or Trash. The files will be removed from the task, the device and the server. The task itself will remain unchanged.
  • Replace the server (requires some technical competence)
  • Set up automatic downloading of files from the server. If the setting is disabled, to download such a file from the server it will be necessary to click on it inside the task. If the setting is enabled, files will be uploaded to the task automatically when the application is loaded). Image files and files less than 1 MB are uploaded automatically regardless of this setting.
  • Select an attachment archiving period for tasks that have not been edited for 1-2-3-6 months or a year. With this setting enabled, files will be deleted from the device but will remain on the server. The list of files will also be available in the task. To re-upload a file, you will need to click on it in the file list. By default, the setting is enabled and 2 months is selected.
  • Delete files from tasks in the Archive and Trash after 1-2-3-6 months or a year.

Important! When the setting is enabled, files are deleted from both the device and the server. By default, the setting is disabled.

Limitations #

  • You can attach a file of any format to a task.
  • A maximum of 20 files can be attached to one task.
  • The size of one file cannot exceed 5 Mb.
  • To attach a file, the task must be open for editing in the task list. You cannot attach a file in the window of quick task creation [this feature is already under development].
  • For recurring tasks: a file can be attached to a recurring task template, but cannot be attached to an instance.

Server connection #

  1. You can connect your s3 server through the settings: Settings → Files → Replace Server → S3.
  2. Next, in the «Connection Parameters» field you should enter a string with the parameters of the server to be connected. The string looks like this: s3://[Key ID]:[Secret key]@[Address]:[Port]/[Container name]?[Additional parameters].

    for example: s3://2e27fa7c72ee11ee:c36ffdff53e-4e03b791-3e3d486a9676@storage.example.com:443/bucket?useSSL=true&pathStyle=true&region=us-east-1

  3. Access Key ID (Access Key ID / user login) and Secret Key (Secret Access Key / password).

    They can be displayed permanently, or they can be displayed only when the user is created by the hoster. In this case it will be necessary to save them in a safe place.

    Address. It is necessary to clarify the hosting provider, or can be found in the documentation provided by them.

    Port. Optional parameter.

    Name of the bucket on the user’s server. The name of the bucket in which the user files will be saved, usually the user sets it himself, in rare cases may be provided by the hosting provider.

    Additional parameters — optional part of the connection string:

    • useSSL: boolean

      true — it is necessary to connect via https, false — via http.

      Default value is true.

    • pathStyle: boolean

      true — whether it is necessary to use path URL style for S3 objects.

      Default value is true.

    • region: string

      region provided by the hosting provider. The default value is us-east-1.

  4. If you get an error when trying to connect your s3 server, try further configuring CORS:

    Create a new rule and set the following parameters:

    • Allowed Origins — *
    • Allowed Methods — HEAD, GET, PUT, POST, DELETE
    • Allowed Headers — *
    • Expose Headers — X-Amz-Content-Sha256, X-Amz-Date, X-Amz-User-Agent
    • MaxAgeSeconds — 3000

If you are unable to connect your S3 server, please contact your provider for more details. SingularityApp technical support does not configure third-party S3 servers or help with connecting them to the app.

If you have connected your S3 server and have questions about other settings for attaching files in Singularity — email us.