日程视图

名称:日程视图

描述:显示每月,每周或每日日历中的元素

版本:2.0.2

发布:2019-07-02

itop-version-min:2.4.0

码:康波多日历视图

州:稳定

下载:https:store.itophub.iooen_USSproductsscombodo日历视图

扩散:iTop集线器

你想要:

日历视图中看到您计划的更改?

速了解下个月结束的合同?

在时间轴视图上可视化到达功效结束的物理设备?

那么此扩展名适合您。

特征

扩展程序带来了一个新的日历仪表盘,可以将其添加到任何仪表板中

从用户的角度来看

对象在日程视图上显示为Google日历中的会议,

对象在字段价值(例如,状况)上可以具有不同的颜色依赖,

用户可以在日,周,月或列表显示模式之间切换,

用户可以导航到下一个或上一个星期几,

用户可以选择隐藏显示的对象中的某些对象组,

修订记录

日期版本描述
2019-07-022.0.2-修复资产保留在缓存中
2019-06-202.0.1-重命名词典文件
-修复显示多个日历时的脚本加载器
-安全硬化
2018-08-132.0.0扩展的新版本通用版本,无需任何代码即可完全自定义。

局限性

在链接的变更的日期上不可能显示FunctionalCI。日期字段必须是显示的对象的属性。

要求

iTop 2.4或更高版本

安装

使用标准安装流程对于此扩展。

配置

一些参数配置可用于此扩展:

参数描述默认
default_scope_count创建新的仪表盘时的默认作用域数3
max_scope_count仪表盘可以具有的最大作用域数。该参数适用于所有日程视图dashlet。10
default_event_duration仅具有开始或结束日期的事件的默认持续时间(以分钟为单位)。30
first_day一周的第一天。无论用户语言如何,此参数都适用于所有日程视图dashlet。价值可以为0(星期日),1(星期一),...1
business_hours短划线中突出显示的一周中的某个时段(可以在此时段之外创建事件)。一个包含days_of_week(与first_day参数相同的模式,默认为array(1,2,3,4,5)),开始时间(默认为09:00),结束时间的PHP数组18:00
'combodo-calendar-view' =>  (
                'default_scope_count' => 4,
                'max_scope_count' => 10,
                'default_event_duration' => 15,
                'first_day' => 1,
                'business_hours' =>  (
                  1 => '08:00, 19:00',
                  2 => '08:00, 19:00',
                  3 => '08:00, 19:00',
                  4 => '08:00, 19:00',
                  5 => '08:00, 19:00',
                ),
        ),

用法

设计日历仪表盘

仪表盘设计人员指定

仪表盘中显示为范围的对象

基于字段的对象子组(例如,每个状况的组)

每组对象使用的颜色,

默认显示模式,…。

日历仪表盘可以显示任何类别的对象,只要它具有至少一个日期或日期时间字段

属性目的
标题标题显示在日历的顶部横幅上,它可以是字典条目,例如。 UI:请求管理菜单概述:标题
默认显示这是默认的显示模式,当显示仪表板时使用,用户仍可以变更的显示模式,但未记录。页面的下一次刷新将复原默认显示
范围计数如果要定义3个以上的对象组以在同一仪表盘中显示,则变更此数字。它将扩展表单的范围。保存空作用域时将被忽略
 范围
名称选择栏中显示的范围标签
合格质量标准OQL查询必须返回单个对象类别才能显示
开始日期以上类的必需日期或日期时间字段,用作在日历中显示对象的开始时间。
结束日期上一类的可选日期或日期时间字段,用作在日历中显示对象的结束时间。
描述将鼠标移到对象上方时,将在工具提示中显示价值的可选字段
通过...分组一个可选字段,用于将范围划分为多个组。
项目颜色固定选择的预定义颜色,以及额外的“彩虹(多色)”
颜色模式纯色(默认),表示每个组将使用相同的颜色,阴影表示每个组将使用不同的颜色阴影

对象的显示,如果date属性(没有时间)是用于开始日期或结束日期

分组依据字段值将显示在范围名称下,默认情况下隐藏。

https://www.itophub.io/wiki/media?w=300&tok=0bddd4&media=extensions%3Acalendar-filter-shades2.png

如果选择“彩虹(多色)”,则每个组将获得不同的纯色,而不是唯一颜色的不同阴影。

https://www.itophub.io/wiki/media?w=300&tok=a708b9&media=extensions%3Acalendar-filter-rainbow2.png

如果未选择``分组依据''字段,则``颜色''模式无效,并且``彩虹(多色)''等效于``橙色''。

这是一个示例,其中包含两个合并组。

物理设备使用按“品牌”分组的紫色“阴影”分组

更改使用按“状况”分组的“彩虹”分组

https://www.itophub.io/wiki/media?w=500&tok=e046f5&media=extensions%3Acalendar-configure2.png

使用仪表盘日历

此处显示与以下相同的示例。

变更使用日期时间开始日期和开始日期结束日期,因此显示对象及其持续时间(不显示结束日期的对象将显示在扩展名配置参数default_事态_duration中定义的持续时间),

物理设备使用日期结束功效日期,这意味着对象在每日和每周显示模式下显示为``全天''事件

本示例的默认显示模式是“星期”

https://www.itophub.io/wiki/media?w=600&tok=718b81&media=extensions%3Acalendar-display2.png

用户可以通过打开准则并取消选择某些组来决定隐藏某些组。

https://www.itophub.io/wiki/media?w=800&tok=fc519e&media=extensions%3Acalendar-select-group2.png

用户可以切换到其他显示模式,例如一个月的列表:

https://www.itophub.io/wiki/media?w=600&tok=a3d0b1&media=extensions%3Acalendar-list2.png

或月份显示为表格,每周有一行,每天有一个单元格:

天对象名称后面带有彩色的后台

对象,带有启动时间,名称前带有彩色的项目符号

https://www.itophub.io/wiki/media?w=600&tok=853074&media=extensions%3Acalendar-month2.png

当一个单元格中的对象太多时,会提供许多尚未显示的对象,您可以单击它以显示当天对象的完整列表。

https://www.itophub.io/wiki/media?w=400&tok=2047b4&media=extensions%3Acalendar-month-more2.png

在显示的任何对象上,将鼠标移到它上面会显示一个工具提示,其中包含

  1. 友好名称,
  2. 说明,
  3. 开始日期
  4. 结束日期,
  5. 范围名称和括号中的组价值

https://www.itophub.io/wiki/media?w=600&tok=7cf0f3&media=extensions%3Acalendar-day4.png

原贴链接:https://www.itophub.io/wiki/page?id=extensions%3Acombodo-calendar-view


Calendar view

name:
Calendar view
description:
Displays elements inside a monthly, weekly or daily calendar
version:
2.0.2
release:
2019-07-02
itop-version-min:
2.4.0
code:
combodo-calendar-view
state:
stable
download:
https://store.itophub.io/en_US/products/combodo-calendar-view
diffusion:
iTop Hub

You want to:

  • See your planned Changes on a calendar view?

  • Get a quick overview of contracts ending next month?

  • Visualize Physical Devices reaching End of warranty on a timeline view?

Then this extension is for you.

Features

This extension brings a new Calendar Dashlet which can be added to any Dashboard

From a user perspective

  • Objects are displayed on a calendar view, as meetings in a google calendar,

  • Objects can have a different color depending on a field value (status for eg.),

  • User can switch between Day, Week, Month or List display modes,

  • User can navigate to the next or the previous day/week/month,

  • User can choose to hide some groups of objects, within the displayed ones,

Revision History

DateVersionDescription
2019-07-022.0.2- Fix assets being kept in cache
2019-06-202.0.1- Rename dictionnaries files
- Fix script loader when more than one calendar is displayed
- Security hardening
2018-08-132.0.0New version generic version of the extension, fully customizable without any code.

Limitations

It's not possible to display FunctionalCIs at the date of a Change they are linked to. The date field must be an attribute of the displayed object.

Requirements

  • iTop 2.4 or later

Installation

Use the Standard installation process for this extension.

Configuration

Some configuration parameters are available for this extension:

ParameterDescriptionDefault
default_scope_countDefault number of scopes when creating a new dashlet3
max_scope_countMaximum number of scopes a dashlet can have. This parameter is for all calendar view dashlets.10
default_event_durationDefault duration in minutes for events that have only a start or end date.30
first_dayFirst day of week. This parameter is for all calendar view dashlets, no matter the user language. Value can be 0 (sunday), 1 (monday), …1
business_hoursHighlighted period of the week in dashlets (events can be created outside this period). A PHP array containing the days_of_week (same pattern as the first_day parameter, default is array(1,2,3,4,5)), start hour (default is 09:00), end hour18:00
  'combodo-calendar-view' =>  (
                'default_scope_count' => 4,
                'max_scope_count' => 10,
                'default_event_duration' => 15,
                'first_day' => 1,
                'business_hours' =>  (
                  1 => '08:00, 19:00',
                  2 => '08:00, 19:00',
                  3 => '08:00, 19:00',
                  4 => '08:00, 19:00',
                  5 => '08:00, 19:00',
                ),
        ),

Usage

Designing a Calendar Dashlet

The Dashlet designer specifies

  • the objects displayed in the Dashlet as scopes

  • sub-groups of object based on a field (groups per status for example)

  • the colors to use per group of object,

  • the default display mode,….

Calendar Dashlet can display objects from any class as long as it has at least one date or date-time field

PropertyPurpose
TitleTitle is displayed on the top banner of the calendar, it can be a dictionary entry eg. UI:RequestMgmtMenuOverview:Title
Default displayThis is the default display mode, which is used when the dashboard is displayed, the user can still change the display mode, but it is not recorded. Next refresh of the page will restore the default display
Scope countChange this number if you want to define more than 3 groups of objects to display in the same dashlet. It will expend the form with more scopes. When saving empty scopes are ignored
 scopes #
NameLabel of the scopes as displayed in the selection bar
OQLAn OQL query which must return a single class of objects to display
Start dateA mandatory date or date-time field of the above class, which is used as the start time for displaying the object in the calendar.
End dateAn optional date or date-time field of the above class, which is used as the end time for displaying the object in the calendar.
DescriptionAn optional field which value will be displayed in a tooltip while moving your mouse above an object
Group byAn optional field to divide your scopes in groups.
Items colorA fixed selection of predefined colors, plus an extra “Rainbow (multicolors)”
Colors modePlain which is the default, means every groups will use the same colors, Shades means a different shade of the color will be used for each group
  • If date attribute (without time) is used either the Start date or the End date, the objects are displayed as full-day event in Daily and Weekly display mode.

  • Group by field values will displayed under the scope name, hidden by default.

https://www.itophub.io/wiki/media?w=300&tok=0bddd4&media=extensions%3Acalendar-filter-shades2.png

  • If “Rainbow (multicolors)” is selected then each group will get a different plain color, instead of a different shade of a unique color.

https://www.itophub.io/wiki/media?w=300&tok=a708b9&media=extensions%3Acalendar-filter-rainbow2.png

  • If no Group by field is selected, then Colors mode is useless and “Rainbow (multicolors)” is equivalent to “Orange”.

Example

Here is an example with 2 scopes, both with groups.

  • Physical Devices uses a purple “shades” grouping by “brand”

  • Changes uses a “Rainbow” grouping by “status”

https://www.itophub.io/wiki/media?w=500&tok=e046f5&media=extensions%3Acalendar-configure2.png

Using a Dashlet Calendar

Here the display of the same example as below.

  • Change uses a date-time Start date and Start date End date, so object are displayed with their duration (Object with no End date will be displayed with a duration defined in the Extension configuration parameter default_event_duration),

  • Physical Device uses a date End warranty date, which means object are displayed as “all day” events in Daily and Weekly display modes

The default display mode of our example is a Week

https://www.itophub.io/wiki/media?w=600&tok=718b81&media=extensions%3Acalendar-display2.png

User can decide to hide some of the groups by opening the criteria and un-selecting some groups

https://www.itophub.io/wiki/media?w=800&tok=fc519e&media=extensions%3Acalendar-select-group2.png

User can switch to a different display mode, such as List for a month:

https://www.itophub.io/wiki/media?w=600&tok=a3d0b1&media=extensions%3Acalendar-list2.png

or Month displayed as a table with one row per week and one cell per day:

  • Full day object have a colored background behind their name

  • Object with a starting hour, have a colored bullet in front of its name

https://www.itophub.io/wiki/media?w=600&tok=853074&media=extensions%3Acalendar-month2.png

When there are too many objects in a cell, a number of not-yet-displayed objects is provided and you can click on it to display the complete list of objects for that day.

https://www.itophub.io/wiki/media?w=400&tok=2047b4&media=extensions%3Acalendar-month-more2.png

On any object displayed, moving the mouse over it display a tooltip with

  1. the friendlyname,

  2. the description,

  3. the Start date,

  4. End date,

  5. The scope name and the group value in parentheses

https://www.itophub.io/wiki/media?w=600&tok=7cf0f3&media=extensions%3Acalendar-day4.png

标签:
由 superadmin 在 2020/08/25, 16:42 创建
    

需要帮助?

如果您需要有关XWiki的帮助,可以联系:

深圳市艾拓先锋企业管理咨询有限公司