Time controlled app

<< Click to display Table of Contents >>

Navigation:  Components > Hive Configurator webinterface > Configuration > Create a new app >

Time controlled app

In this chapter you will learn which time settings you can use to make your apps available in the Appsbox only at certain times.

 

hive_config_timeline_example_settings

hive_config_timeline_example_test

 

In this menu you can define the exact start and end time when your app should be available for your users.

With the help of the "Daytime" settings you can also make your app available periodically.

 

You can check your time settings at any time using the test_settings "Test Settings" button to see if your app is available at the desired times.

 

Start

Activate this checkbox if you want your app to be available to your users only from a certain start time.

Also define the desired start date and time.

 

 

An app that is only available at a time in the future is displayed to your users with a note as of when this app is active.

An hourglass icon is also displayed in front of the log, which can be used to filter by in the Appsbox.

 

Example:

 

hive_config_timeline_example_start

 

In this example, the start time was set to 01 June 2023, 09:00.

End

Select this checkbox if you want your app to be available to your users only until a specific end time.

Also define the desired end date and time.

 

 

An app that was available until a point in time in the past will no longer be displayed to your users, it will be hidden.

Utc

Select this check box if you want the defined dates and times to be treated as UTC.

 

 

Above the setting options you will see 3 different dates and times, which will give you an orientation on how to configure your time settings:

 

•Utc: The current time in UTC.

•Hive local time: The current time of the server machine on which the Hive is installed.

•Your local time: The current time on your current machine that you used to open the Hive Configurator application.

Show app before start

Select this checkbox if you want your app, which is only available at a time in the future, to be displayed with the above note.

If you deactivate this checkbox, this app will not be displayed, it will only be shown when the start time is reached.

Reference

Activate this check box if you want to use a specific reference time for checking your desired times.

In addition, define the desired reference date and time.

 

If you deactivate this check box, the current time will be used as the reference time.

 

 

Daytime: Format D=Day, T=Time, N=NOT

 

With the help of this setting you can define your time settings periodically repeating.

The syntax of this functionality is explained in more detail below.

 

You can enter several lines for the "Daytime", all lines will be linked by a logical OR.

 

hmtoggle_arrow1Certain days of the week

 

You have the option to release an app only on certain weekdays.

You only have to enter the character "D" followed by a weekday index as daytime.

 

Index

Weekday

1

Monday

2

Tuesday

3

Wednesday

4

Thursday

5

Friday

6

Saturday

7

Sunday

 

If you want to link several consecutive days of the week, you can also specify a range of weekday indices.

 

 

Examples:

 

hmtoggle_arrow0Your app should only be available on Mondays.

 

 

D1

 

 

 

 

D5

 

 

 

 

D7

 

 

 

 

D1-5

 

 

 

 

D3-7

 

 

 

 

D5-6

 

 

hmtoggle_arrow1Specific time period

 

You have the option to release an app on a certain day only in a certain time period.

To do this, all you have to do as Daytime is enter the character "T" followed by a time in the form "hh" or "hh:mm". (h = hours, m = minutes)

 

 

Make sure that the start time and the end time are included in the time span.

 

Example:

 

You define an end time of 12:00 for example:

 

T0-12

 

This makes this app available to your users until 12:00:59.

If you want to disable your app exactly from 12:00:00, you need to subtract one minute from the end time:

 

T0-11:59

 

 

Examples:

 

 

 

T10

 

 

 

 

T0

 

 

 

 

T22

 

 

 

 

T10-12

 

 

 

 

T10:30-11:45

 

 

 

 

T12-13:10

 

 

hmtoggle_arrow1Specific time period on specific days of the week

 

You can combine the two options above.

To do this, simply write both setting options without separators within one line, starting with the definition of the weekdays.

 

Example:

 

 

 

D1T10

 

 

 

 

D1-3T10-12

 

 

hmtoggle_arrow1Negation of certain days of the week and certain periods of time

 

You can also negate all previous options.

To do this, simply write the character "N" in front of the corresponding weekday or time span definition.

 

 

Examples:

 

 

 

NT10

 

 

 

 

NT10-12

 

 

 

 

ND1

 

 

 

 

ND1-6

 

 

 

 

ND1T10

 

 

 

 

ND1NT10

 

 

 

 

ND6-7NT10-12

 

 

When you are satisfied with your desired time settings, you can return to the app creation using the "Arrow" button and apply them there using the "Save" button.

 

 

Summary example

 

In this summary example, we create a time setting that makes this app available to our users on Mondays through Fridays.

Here, the app is timed from 09:00 to 17:00 on Thursdays and 09:00 to 12:30 on Fridays.

 

The "Daytime" settings look like this:

 

hive_config_timeline_daytime

 

Clicking on the test_settings button results in the following test results:

 

hive_config_timeline_result

 

Here you can see on which days the app is now available. In addition, at the end of the line it is indicated which of the rules defined at the beginning is responsible for the time restriction coming about for this day.

If multiple rules are used to restrict the time settings on one day of the week, they will be listed comma-separated at the end of the line.