• .gitignore file is just the default one coming with sema4.ai create task package. This can be left out, but conda.yaml file will recognize it missing and warn about it.

output/
venv/
temp/
.rpa/
.idea/
.ipynb_checkpoints/
*/.ipynb_checkpoints/*
.virtual_documents/
*/.virtual_documents/*
.vscode
.DS_Store
*.pyc
*.zip
*/work-items-out/*
testrun/*
.~lock*
*.pkl

• conda.yaml Here the package is installed in editable mode.

# For more details on the format and content:
# https://github.com/robocorp/rcc/blob/master/docs/recipes.md#what-is-in-condayaml
# Tip: Adding a link to the release notes of the packages helps maintenance and security.

channels:
  - conda-forge

dependencies:
  - python=3.10.12                # https://pyreadiness.org/3.10
  - pip=23.2.1                    # https://pip.pypa.io/en/stable/news
  - robocorp-truststore=0.8.0     # https://pypi.org/project/robocorp-truststore/
  - pip:
    - robocorp==2.1.0             # https://pypi.org/project/robocorp
    - robocorp-windows==1.0.4     # https://pypi.org/project/robocorp-browser
    - pydantic==2.9.2             # https://pypi.org/project/pydantic
    - email-validator==2.2.0      # https://pypi.org/project/email-validator/
    - pyautogui==0.9.54           # https://pypi.org/project/PyAutoGUI
    - pandas==2.2.3               # https://pandas.pydata.org

rccPostInstall:
  - pip install -e "..\\..\\riverit-vesikanta-manager"

• This is the layout of correct configuration in json format. Values must be changed accordingly

{
    "vesikanta_path": "path_to_the_application_exe",
    "vesikanta_creds": "vesikanta_secrets_within_cloud",
    "reading_report_files_path": "robot_working_folder_for_reading_files",
    "reading_report_files_archive_path": "robot_archive_folder_for_reading_files",
    "tracking_report_files_path": "robot_working_folder_for_tracking_files",
    "tracking_report_files_archive_path": "robot_archive_folder_for_tracking_files",
    "ufile_path": "robot_working_folder",
    "customer_group_start": "group_number",
    "customer_group_end": "group_number",
    "email_creds": "email_secrets_within_cloud",
    "email_sender": "sender@mail.com",
    "email_recipients": ["reciever@mail.com"],
    "email_subject": "subject_of_email",
    "email_body": "body_of_email",
    "date_format": "%Y%m%d_%H%M",
    "signature": "name_for_signature",
    "column_p_regex_list": ["item1","item2"]
}

• Used to differentiate between development and production environments and load corresponding json configuration

import json
import os

from pydantic import ValidationError
from robocorp import log, storage

from riverit_vesikanta_manager import Config


def read_config(config_name: str) -> Config:
    """
    Reads the configuration based on the runtime environment.
    Automatically determines if it should read from a local (development) config or asset (production) config.

    Args:
        `config_name` (str): The name of the configuration file to read from robocorp cloud.

    Returns:
        `config` (Config): The configuration data.

    Raises:
        `Exception`: If there is an error while reading the configuration.
    """
    # Check for an environment variable to determine the runtime environment
    dev_env = os.getenv("RUNTIME_ENV") == "dev"
    config = None

    if dev_env:
        try:
            with open("config.json", "r", encoding="utf-8") as file:
                config_data = json.load(file)
                log.info("Read local config.")
        except Exception as e:
            raise Exception(f"Failed to read local config: {e}")
    else:
        try:
            config_data = storage.get_json(config_name)
            log.info("Read asset config.")
        except Exception as e:
            raise Exception(f"Failed to read asset config: {e}")

    try:
        config = Config(**config_data)
    except ValidationError as e:
        raise Exception(f"Failed to validate config: {e}")

    return config

• Default file coming when creating task package

# For more details on the format and content:
# https://github.com/robocorp/rcc/blob/master/docs/recipes.md#what-is-in-robotyaml

tasks:
  Run Task:
    shell: python -m robocorp.tasks run tasks.py

environmentConfigs:
  - environment_windows_amd64_freeze.yaml
  - environment_linux_amd64_freeze.yaml
  - environment_darwin_amd64_freeze.yaml
  - conda.yaml

artifactsDir: output

PATH:
  - .
PYTHONPATH:
  - .
ignoreFiles:
  - .gitignore

• Minimal task to test the package with. This should log in Vesikanta and close the application immediately afterwards.

from config import read_config
from robocorp.tasks import task

from riverit_vesikanta_manager import VesikantaManager

config = read_config("cloud_config_name")

vk = VesikantaManager(config)


@task
def minimal_task():
    with vk:
        print("onnistui")