×

扫描二维码登录本站

QQ登录

只需一步，快速开始

标签： 暂无标签
本帖最后由 adminlily 于 2020-12-16 09:58 编辑

为控制台仪表板创建新的仪表盘：iFrame
学习：添加新的仪表盘类型

水平：[ ttps://www.itophub.io/wiki/page?id=level&dataflt%5B0%5D=level_%3DAdvanced]高级[/url]

域：[ ttps://www.itophub.io/wiki/page?id=domains&dataflt%5B0%5D=domains_%3DPHP]PHP[/url],  [ ttps://www.itophub.io/wiki/page?id=domains&dataflt%5B0%5D=domains_%3DPresentation]Presentation[/url]

最低版本：2.1.0

本文档逐步说明了如何创建自己的iTop模块，以便将新的仪表盘添加到控制台仪表板：iFrame。

教程的目标
在本分步教程中，您将学习：

  • 为iTop 2.5创建自己的扩展模块
  • 仪表盘的创建类
  • 在现有仪表板中添加新条目

出于此教程的目的，我们将使用称为IFrameDashlet的仪表盘的创建类，这将非常简单并嵌入外部网页。



您将需要什么
  • 将iTop安装在开发机器上，您可以在其上轻松地访问编辑文件。
  • 一个文本编辑器，能够编辑PHP和XML文件并支持U-8。在Windows上，您可以使用写字板（记事本不喜欢Unix行结尾）或出色的免费开发IDE之一，例如PSPad 要么记事本++.


定制流程
定制流程如下：

  • 安装iTop的开发实例。最好不要在生产中进行试验！
  • [ ttp://119.3.189.35:8082/bin/view/5/5.3/5.3.4/#installing_the_toolkit]安装工具包[/url] 协助您进行定制
  • 使用以下命令创建一个新的（空）模块[ ttp://119.3.189.35:8082/bin/view/5/5.3/5.3.4/#creating_a_module]模块创建向导[/url]
  • 将此新模块复制到iTop上的扩展文件夹，然后再次运行安装程序以安装空模块
  • 修改扩展中的模块并使用工具包检查您的自定义

重复最后一点，直到对自定义满意为止。完成后，就可以部署新模块了。将模块文件夹复制到生产iTop实例的扩展目录中，然后运行安装程序进行安装。

循序渐进教程创建您的自定义模块
使用[ ttp://119.3.189.35:8082/bin/view/5/5.3/5.3.4/#creating_a_module]模块创建向导[/url]。用以下值填充表单：

标签价值备注
模块名称sample-add-dashlet以itop-和combodo-开头的名称保留供Combodo使用。建议不要在模块名称中添加空格或强调字符。具有相同名称的两个模块不能在同一iTop实例中共存。
模块标签Add Dashlet Sample该标签将显示在设置向导中。允许使用本地化的字符和空格
模块版本1.0.0惯例是使用3位数编号方案：X.Y.Z
类别business对数据模型进行修改的模块应位于类别'业务'中

单击生成！将空模块下载为zip文件。

安装空模块
将zip的内容扩展到开发iTop实例的扩展文件夹中。现在，您应该在扩展文件夹中有一个名为sample-add-仪表盘的文件夹。此文件夹包含以下文件：

  • datamodel.sample-add-dashlet.xml
  • module.sample-add-dashlet.php
  • en.dict.sample-add-dashlet.php
  • model.sample-add-dashlet.php

确保Web服务器的文件conf/production/config-itop.php是可写的（在Windows上：右键单击以显示文件属性，并取消选中只读标志；在Linux变更上为文件的权利），然后通过以下方式启动iTop安装：将您的浏览器指向http ::: your_itop/setup/


单击“继续»”开始重新安装。


在单击“下一步»”之前，请确保已选择“更新现有实例”。


继续执行向导的下一步……


您的自定义模块应出现在“扩展”列表中。如果不是这种情况，请检查是否在正确的位置复制了模块文件，并且Web服务器具有足够的权利可以读取它们。

在单击“下一步»”之前，请选择您的自定义模块并完成安装。

添加IFrameDashlet类
使用常用文本编辑器，在扩展文件夹中创建文件iframedashlet.class.inc.php。

添加以下代码：

<?php
class DashletIFrame extends Dashlet
{
        public function __construct($oModelReflection, $sId)
        {
                parent::__construct($oModelReflection, $sId);

        }

        static public function GetInfo()
        {

        }

        public function GetPropertiesFields(DesignerForm $oForm)
        {

        }

        public function Render($oPage, $bEditMode = false, $aExtraParams = ())
        {

        }
}

这是创建仪表盘的基本代码。如您所见，这些方法暂时是空的，我们将必须实现它们，但首先让我们看看它们的用途是什么。

  • “ GetInfo”用于检索仪表盘的基本信息，例如其标签，描述和图标。这主要在仪表板的“可用dashlets”菜单下使用。
  • “ GetPropertiesFields”用于仪表盘的构建，配置表单。在这里，我们必须放置用户将填充的参数以设置仪表盘。
  • “渲染”用于制作仪表盘的HTML渲染，这是大多数逻辑发生的地方。

让我们从GetInfo方法开始。用下面的代码替换空方法：

  • 编辑仪表板时，“ label”将用作仪表盘面板中的工具提示。
  • 仪表盘面板中还将使用“icon”。该路径必须相对于应用根文件夹。
  • “ description”暂时不显示，但应尽快显示。
  
static public function GetInfo()
        {
                return (
                                'label' => Dict::S('UI:DashletIframe:Label'),
                                'icon' => 'env-'.utils::GetCurrentEnvironment

().'/sample-add-dashlet/images/iframe.png',
                                'description' => Dict::S

('UI:DashletIframe:Description'),
                );
        }

然后，将GetPropertiesFields方法替换为以下内容：

    public function GetPropertiesFields(DesignerForm $oForm)
        {
                $oField = new DesignerLongTextField('url', Dict::S

('UI:DashletIframe:Prop-Url'), $this->aProperties['url']);
                $oField->SetMandatory();
                $oForm->AddField($oField);
                $oField = new DesignerIntegerField('width', Dict::S

('UI:DashletIframe:Prop-Width'), $this->aProperties['width']);
                $oField->SetMandatory();
                $oForm->AddField($oField);
                $oField = new DesignerIntegerField('height', Dict::S

('UI:DashletIframe:Prop-Height'), $this->aProperties['height']);
                $oField->SetMandatory();
                $oForm->AddField($oField);


如您所见，我们为每个参数添加一个DesignerXXXField，我们需要用户来填充它。 iTop将处理表单的处理以及与仪表板的交互。
不幸的是，没有可用字段类的文档。要找到可用的内容，请在application/forms.class.inc.php中检查DesignerFormField类及其派生类。

最后，用以下代码替换Render方法：

   public function Render($oPage, $bEditMode = false, $aExtraParams = ())
        {
                $sUrl = $this->aProperties['url'];
                $iWidth = (int) $this->aProperties['width'];
                $iHeight = (int) $this->aProperties['height'];
                $oPage->add('<div class="dashlet-content">');
                $sId = utils::GetSafeId('dashlet_iframe_'.($bEditMode? 'edit_' :

'').$this->sId);
                $oPage->add('<iframe id="'.$sId.'" width="'.$iWidth.'"

height="'.$iHeight.'" frameborder="0" src="'.$sUrl.'"></iframe>');
                if($bEditMode)
        {
            $oPage->add('<div style="width: 100%; height: 100%; position: absolute;

top: 0px; left: 0px; cursor: not-allowed;"></div>');
        }
        $oPage->add('</div>');
        }

在这种情况下，代码非常简单，因为我们只想显示一个指向URL的iframe标签。但这是您应该执行仪表盘的逻辑，通过OQL检索对象，计算内容等的地方。拥有$ oPage元素的访问权限后，您甚至可以携带CSS或JS filessnippets。天空才是极限！

现在，您的文件应如下所示：

<?php
class DashletIFrame extends Dashlet
{
        public function __construct($oModelReflection, $sId)
        {
                parent::__construct($oModelReflection, $sId);
                $this->aProperties['url'] = '';
                $this->aProperties['width'] = 600;
                $this->aProperties['height'] = 650;
                $this->aCSSClasses[] = 'dashlet-inline';
        }
        public function Render($oPage, $bEditMode = false, $aExtraParams = ())
        {
                $sUrl = $this->aProperties['url'];
                $iWidth = (int) $this->aProperties['width'];
                $iHeight = (int) $this->aProperties['height'];
                $oPage->add('<div class="dashlet-content">');
                $sId = utils::GetSafeId('dashlet_iframe_'.($bEditMode? 'edit_' :

'').$this->sId);
                $oPage->add('<iframe id="'.$sId.'" width="'.$iWidth.'"

height="'.$iHeight.'" frameborder="0" src="'.$sUrl.'"></iframe>');
                if($bEditMode)
        {
            $oPage->add('<div style="width: 100%; height: 100%; position: absolute;

top: 0px; left: 0px; cursor: not-allowed;"></div>');
        }
        $oPage->add('</div>');
        }
        public function GetPropertiesFields(DesignerForm $oForm)
        {
                $oField = new DesignerLongTextField('url', Dict::S

('UI:DashletIframe:Prop-Url'), $this->aProperties['url']);
                $oField->SetMandatory();
                $oForm->AddField($oField);
                $oField = new DesignerIntegerField('width', Dict::S

('UI:DashletIframe:Prop-Width'), $this->aProperties['width']);
                $oField->SetMandatory();
                $oForm->AddField($oField);
                $oField = new DesignerIntegerField('height', Dict::S

('UI:DashletIframe:Prop-Height'), $this->aProperties['height']);
                $oField->SetMandatory();
                $oForm->AddField($oField);
        }
        static public function GetInfo()
        {
                return (
                                'label' => Dict::S('UI:DashletIframe:Label'),
                                'icon' => 'env-'.utils::GetCurrentEnvironment

().'/itop-iframe-dashlet/images/iframe.png',
                                'description' => Dict::S

('UI:DashletIframe:Description'),
        
通过运行工具包检查您的修改。将浏览器指向http ::: your_itop/toolkit。


如果在此阶段报告了任何错误，请通过编辑XML文件进行修复，然后单击工具包页面中的“刷新”按钮再次检查您的修改。
解决所有错误后，您可以使用工具包的第二个选项卡将修改应用于iTop。单击按钮更新iTop代码和数据库！至：

  • 将XML数据模型编译为PHP类
  • 更新数据库架构（创建监视器表）。

此时，如果您在iTop中导航并单击“欢迎页面”中的“编辑此页面”，则可以在仪表盘列表中看到“ iFrame”可用：


将仪表盘拖放到仪表板时，将显示以下表单：


填写参数，保存，您将在仪表板中看到仪表盘！



添加元信息
当您要将仪表盘与ITSM Designer一起使用时，元信息将非常有用，因为它们将使它能够用于配置仪表板。

为此，请编辑扩展程序的datamodel.sample-add-dashlet.xml文件，并创建标签itop_design/meta/dashlets/dashlet [@ id =“ IFrameDashlet”]。请注意，仪表盘标签ID必须是仪表盘的类名。您应该具有以下条件：
<?php
class DashletIFrame extends Dashlet
{
        public function __construct($oModelReflection, $sId)
        {
                parent::__construct($oModelReflection, $sId);
                $this->aProperties['url'] = '';
                $this->aProperties['width'] = 600;
                $this->aProperties['height'] = 650;
                $this->aCSSClasses[] = 'dashlet-inline';
        }
        public function Render($oPage, $bEditMode = false, $aExtraParams = ())
        {
                $sUrl = $this->aProperties['url'];
                $iWidth = (int) $this->aProperties['width'];
                $iHeight = (int) $this->aProperties['height'];
                $oPage->add('<div class="dashlet-content">');
                $sId = utils::GetSafeId('dashlet_iframe_'.($bEditMode? 'edit_' :

'').$this->sId);
                $oPage->add('<iframe id="'.$sId.'" width="'.$iWidth.'"

height="'.$iHeight.'" frameborder="0" src="'.$sUrl.'"></iframe>');
                if($bEditMode)
        {
            $oPage->add('<div style="width: 100%; height: 100%; position: absolute;

top: 0px; left: 0px; cursor: not-allowed;"></div>');
        }
        $oPage->add('</div>');
        }
        public function GetPropertiesFields(DesignerForm $oForm)
<?xml version="1.0" encoding="UTF-8"?>
<itop_design xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.0">
  <meta>
        <dashlets>
          <dashlet id="DashletIFrame" _delta="define">
          </dashlet>
        </dashlets>
  </meta>
</itop_design>

现在，将仪表盘元信息放入仪表盘仪表盘中：

  • “label”，您的仪表盘的标签。
  • “icon”，图标出现在“可用的dashlets”菜单中。请注意，该路径相对于扩展文件夹而不是应用程序根目录！
  • “description”，即仪表盘的说明。
  • “configuration”，这是与仪表盘:: GetInfo方法的主要区别。它应该包含配置的XML配置示例，以帮助用户知道要配置什么。这是



必要的，因为由于安全原因，ITSM设计器将无法呈现属性表单。.

您现在应该具有以下内容：
<?xml version="1.0" encoding="UTF-8"?>
<itop_design xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.0">
  <meta>
        <dashlets>
          <dashlet id="DashletIFrame" _delta="define">
                <label>iFrame</label>
                <icon>itop-iframe-dashlet/images/iframe.png</icon>
                <description>Embed external web page as a dashlet.</description>
                <configuration>
                        <url>http://via.placeholder.com/600x300</url>
                        <width>600</width>
                        <height>300</height>
                </configuration>
          </dashlet>
        </dashlets>
  </meta>
</itop_design>



下一步
要将定制部署到另一台iTop服务器，只需将文件夹“ sample-add-dashlet”复制到iTop的扩展文件夹，然后再次运行安装程序。






上一篇：二次开发- 修改界面-字段约束条件
下一篇：二次开发- 修改界面-增加“其他操作”菜单
YYQQ

写了 297 篇文章，拥有财富 1570，被 3 人关注

0
举报 收藏
转播转播 分享分享 分享淘帖 ()()
回复

评论

 使用高级模式，上传图片！
您需要登录后才可以回帖 登录 | 立即注册
B Color Link Quote Code Smilies

成为第一个吐槽的人

手机版|小黑屋|最新100贴|论坛版块|ITIL先锋论坛 |粤ICP备11099876号|网站地图
Powered by Discuz! X3.4 Licensed  © 2001-2017 Comsenz Inc.
返回顶部