https://github.com/tserious/quickfioritimeevents

Taskbar tool to quickly add time events in SAP Fiori.
https://github.com/tserious/quickfioritimeevents

automation beautifulsoup beautifulsoup4 fiori fiori-app selenium

Last synced: about 2 months ago
JSON representation

Taskbar tool to quickly add time events in SAP Fiori.

• Host: GitHub
• URL: https://github.com/tserious/quickfioritimeevents
• Owner: TSerious
• License: mit
• Created: 2023-02-21T06:51:21.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2023-05-05T04:57:54.000Z (about 3 years ago)
• Last Synced: 2025-06-10T03:47:47.322Z (about 1 year ago)
• Topics: automation, beautifulsoup, beautifulsoup4, fiori, fiori-app, selenium
• Language: Python
• Homepage:
• Size: 90.4 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# QuickFioriTimeEvents

Windows-Taskbar tool to quickly add time events in SAP Fiori.

My employer uses a SAP Fiori tool to track our time events (working hours). That means that we have to open the appropiate website and clock in and out. Cause I found this relatively annoying I created this small tool for the (Windows) taskbar with which you can quickly clock in and out.

The tool is shown as a small icon  in the taskbar. A right click opens a menu that let you perform some actions quickly.

## Features

- Arrive (clock in)

- Leave (clock out)

- Leave and shutdown the PC (sleep and hybernate are also possible)

- Start a pause

- Start a pause and shutdown the PC (sleep and hybernate are also possible)

- End a pause

- Show the time you are clocked in and the work time (clock in time minus pause time)

- Log a leave event: The clock out time is only logged and not submitted to SAP Fiori. This is useful, as an offset time can be added to the leave event and events in the future might be blocked.

- Log a leave event and shutdown (sleep and hybernate are also possible)

- Submit logged leave event and arrive afterwards

- Get the current work time from SAP Fiori

## Installation

The tool does not need to be installed just run it.

When run for the first time, you will be asked weather to use Edge or Firefox.

On the first start, you also need to define the url for *Fiori*. Open a browser navigate to your Fiori website and copy the address into the shown window.




### Autostart

In order to start the tool with Windows, it needs to be put into the *Startup* directory. To open the *Startup* directory, hit the keys Win+R, type shell:startup into the opened form (window) and click ok. Afterwards create a shortcut of the *QuickFioriTimeEvents.exe* (right click on the exe and select *Create shortcut*) and copy the just created shortcut to the *Startup* directory. From now on the tool will be started when Windows is started.

## Using the application

You mainly interact with the tool trough the taskbar icon . Right click on it and perform one of the actions.

### Commands

#### Quit

Closes the application.

#### Arrive

Adds an arrive or clock in event to your time events in Fiori. The time in *[ArriveLeave]ArriveOffset* will be added to the current time.

#### Leave

Adds a leave or clock out event to your time events in Fiori. The time in *[ArriveLeave]LeaveOffset* will be added to the current time.

#### Leave and hybernate

Does the same as [Leave](#leave) and executes the *[General]ShutdownCommand* afterwards.

#### Start Pause

Adds a pause start event to your time events in Fiori. The time in *[ArriveLeave]StartPauseOffset* will be added to the current time.

#### Start Pause and hybernate

Does the same as [Start Pause](#start-pause) and executes the *[General]PauseStartCommand* afterwards.

#### End Pause

Adds a pause end event to your time events in Fiori. The time in *[ArriveLeave]EndPauseOffset* will be added to the current time.

#### Arriv (submit Leave)

Before doing the same as [Arrive](#arrive), the currently logged leave (or clock out) time is added to time events in Fiori. The added leave time is the logged leave time plus *[ArriveLeave]LeaveLogOffset*.

#### Log Leave

Log the current time as the leave (clock out) time but do not submit this to Fiori.

#### Log Leave and hybernate

Does the same as [Log Leave](#log-leave) and executes the *[General]ShutdownCommand* afterwards.

#### Update state

Gets the current state (if you are logged in and the pause time) from Fiori.

#### Reset icon

Resets the icon to the default one.

#### Open config file

Open the *config.ini* file.

#### Open documentation

Opens the pdf version of this documentation. (You are probably reading it)

#### Show work time

Shows the time (hours:minutes:seconds) since you clocked in. It also shows the *time since clock in* minus the *pause time*. This is the time you have worked.

By default this can be executed with a left click on the icon, if *[General]ShowWorkTimeOnLeftClick* is "True".

### Icon state

The current state is indicated by the taskbar icon. It can be in the following states:



    


         Default icon.

    

    


         You are clocked in and working.

    

    


         You are clocked out.

    

    


         A leave or clock out event has ben logged (but not submitted).

    

    


         You are clocked in but currently in a pause (and not working).

    

    


         An error has occured.

    



## Configuring the application

You can customize what is shown in the right click menu ([see here](#menu-elements)) and other stuff.

Right now the application can only be configured via the config.ini file. The file is seperated into different sections. In order to change the settings of the application you have to edit the config.ini file. The settings of each section are described in the tables below.

### ArriveLeave

    

        

            Setting

            Default value

            Desciption

        

        

            [ArriveLeave]Approve

            True

            A value indicating whether the event shall be approved. Only approved events are stored in fiori. Set to False to approve manually.

        

        

            [ArriveLeave]ArriveOffset

            -5

            Minutes that will be added to the arrive time. Negative values are possible.

        

        

            [ArriveLeave]LeaveOffset

            0

            Minutes that will be added to the leave time. Negative values are possible.

        

        

            [ArriveLeave]LeaveLogOffset

            5

            Minutes that will be added to the leave time. Negative values are possible.

        

        

            [ArriveLeave]StartPauseOffset

            0

            Minutes that will be added to the pause start time. Negative values are possible.

        

        

            [ArriveLeave]EndPauseOffset

            0

            Minutes that will be added to the pause end time. Negative values are possible.

        

    

### General

    

        

            Setting

            Default value

            Desciption

        

        

            [General]MinLogLevel

            

            The minimum level of log entries.
CRITICAL = 50, ERROR = 40, WARNING = 30,
INFO = 20, DEBUG = 10, NOTSET = 0

        

        

            [General]ClearLog

            True

            A value indicating whether the log shall be deleted,
each time the software starts.

        

        

            [General]WaitTimeAfterPageLoad

            10

            The time in seconds to wait after the initial page
is loaded in the browser instance.

        

        

            [General]Url

            

            The (base) url of Fiori.

        

        

            [General]UrlHome

            #Shell-home

            The path to the 'Home' page.

        

        

            [General]UrlTime

            ?appState=lean#TimeEntry-change

            The path to the 'Time' page.

        

        

            [General]Driver

            

            The browser (or driver) that is used to interact with SAP Fiori.
Currently Edge or Firefox are supported.

        

        

            [General]ProfilePath

            

            The path where the profile of the used browser (driver) is stored.

        

        

            [General]BinaryPath

            

            The path where the executable of the used browser (driver) us located.

        

        

            [General]CheckProfilePath

            True

            A value whether to check if [General]ProfilePath is set.

        

        

            [General]ArriveEvent

            P10

            The arrive event indentifier.

        

        

            [General]LeaveEvent

            P20

            The leave event indentifier.

        

        

            [General]PauseStartEvent

            P15

            The pause start event indentifier.

        

        

            [General]PauseEndEvent

            P25

            The pause end event indentifier.

        

        

            [General]PauseStartCommand

            shutdown.exe /h

            The shutdown command. '/h' means hybernate
instead of normal shutdown.

        

        

            [General]ShutdownCommand

            shutdown.exe /h

            The shutdown command. '/h' means hybernate
instead of normal shutdown.

        

        

            [General]CloseInstance

            True

            A value indicating whether the browser instance should be quit
after the event has been created.

        

        

            [General]ShowWorkTimeOnLeftClick

            True

            A value indicating whether a left click on the icon
shows the current work time.

        

        

            [General]Order

            

                


                Quit|---|Arrive|Leave|LeaveAndShutdown|---|StartPause|StartPauseAndShutdown|EndPause|---|LeaveLoggedAndArrive|LogLeave|LogLeaveAndShutdown|---|GetCurrentState|SetDefaultIcon|OpenConfig|OpenReadme|---|ShowWorkTime

                

            

            

                


                The order of the elemnts in the right click menu of the icon.

                Each element is seperated with '|'.


                Possible elements are listed in Menu Elements.

                

            

        

    


#### Menu Elements

The following elements can be added to *[General]Order* to customize the right click menu.





--- A seperator line



Quit Quit





Arrive Arrive





Leave Leave





StartPause StartPause





StartPauseAndShutdown StartPauseAndShutdown





EndPause EndPause





ShowWorkTime ShowWorkTime





LeaveLoggedAndArrive LeaveLoggedAndArrive





LeaveAndShutdown LeaveAndShutdown





LogLeave Log Leave





LogLeaveAndShutdown LogLeaveAndShutdown





GetCurrentState GetCurrentState





SetDefaultIcon SetDefaultIcon





OpenConfig OpenConfig





OpenReadme OpenReadme





### State

These settings doesn't need to be edited as they are only used to save the state of the application. So they will change on each run.

    

        

            Setting

            Default value

            Desciption

        

        

            [State]LastArriveDateTime

            

            The date and time the arrive event was set the last time

        

        

            [State]LastPing

            

            The date and time of the last interaction with the software.

        

        

            [State]IsPause

            False

            A value indicating whether you are currently in a pause.

        

        

            [State]LastPauseDateTime

            

            The date and time of the last pause start event.

        

        

            [State]AccumulatedPauseTime

            0

            The time in seconds the user has been in a pause.

        

        

            [State]LoggedLeaveDateTime

            

            The date and time of the leave event that will be created when using LeaveAndArrive.