DATAGERRY 官方版 v1.5.0

软件介绍

DATAGERRY是一款资产管理和DB软件，您可以通过这款软件创建资产管理系统，可以在软件管理财务数据，可以在软件管理统计业务，软件可以结合MongoDB数据库使用，在主程序上管理的数据和系统配置的数据都保存在MongoDB中，用户可以自己配置数据库相关的功能，可以添加数据对象，可以编辑数据模型;在DATAGERRY中存储对象，一个对象可以是例如路由器，，位置或合同，并且由多个字段组成，例如，路由器的管理IP，主机名等，每个字段都有特定的数据类型，数据类型可以是文本，复选框，期，下拉列表或更多，您可以随时更改对象类型定义，它完全将数据模型的定义留给用户使用，让用户自己配置数据管理方案!

DATAGERRY主要功能

在简单的Webfntend中定义自己的对象类型(例如，路由器，，位置)

手动添加对象或从CSV，Excel，XML，ON文件导入它们

定义自动导出到外部系统(例如，监视系统，配置管理，备份，票证系统，DNS等)

使用我们的API之一来集成您的系统

...以及路线图上的许多其他功能-我们才刚刚开始

关键事实：

定义自己的数据模型

通过将资产导出到外部系统来自动化您的IT

开源(ALv3)

DATAGERRY软件特色

1、定义自己的数据模型

每个IT环境都有其各自的结构。这就是DATAGERRY没有预定义对象类型(例如路由器，，位置)的原因。使用DATAGERRY，您可以自由地为自己定义数据模型。

2、自动化您的IT

我们不希望您仅将资产存储在DATAGERRY中，而是希望您灵活使用数据。因此，使用我们强大的API之一访问您的数据，或使用外部工具(例如，监视，票务系统，配置管理等)触发事件驱动的同步，将DATAGERRY用作数据库来使您的IT自动化。

3、开源

我们喜欢开源软件。 DATAGERRY是免费的，并根据ALv3获得许可。只需下载，复制，使用或更改它。

DATAGERRY使用说明

什么是DB?

DB是一个数据库，其中包含作IT基结构所需的有关对象(即，路由器，位置，合同)的所有。对象之间的关系也被存储(即，a被放置在位置b上)。可用的解决方案往往带有预定义的对象类型，而这些对象类型通常只能花费很大的精力进行定制。

DATAGERRY是企业级的开源DB，其中对象类型可以由用户完全定义并且可以在运行时进行调整。所存储的数据可以以不同的方式使用，即用于自动导出到外部系统，在数据内进行智能搜索或生成报告。所有功能的实现都考虑到对象类型的通用定义和自定义定义。借助插件系统，DATAGERRY可以轻松地扩展-也可由经验丰富的用户进行扩展。

使用案例

使用DATAGERRY自动化您的IT：

将DATAGERRY用作用于自动化IT环境的数据库。 DATAGERRY可以存储您作所需的所有，并将该推送到外部系统，例如DNS，票证系统，配置管理(例如Ansible)，监视系统等。在DATAGERRY中添加，更新或删除对象时，可以基于事件触发向外部系统的推送。

功能

设计您的对象类型

使用我们直观的GUI设计您的对象类型(例如，路由器，位置，合同)。

对象处理

文件导入导出

导出–基于事件的导出到外部系统

对象处理

对象处理是DATAGERRY的基。开始使用基于Web的向导定义对象类型(例如，路由器等)。对象类型由具有定义数据类型的多个字段组成(例如，文本，期，对另一个对象的引用，复选框，textarea等)。

对象类型可以随时更改。

对于定义的类型，可以添加，更改或删除对象。对象受版本控制，并且每次更改都将使用时间和用户名进行跟踪。快速而强大的搜索将迅速找到合适的对象。

文件导入和导出

添加或导入对象

在Webfntend中创建您的第一个对象。 您也可以从CSV文件导入现有数据。

可以在ON文件中导入和导出对象类型。目前，对于对象的导入和导出，我们支持以下文件格式：

CSV

XLSX

XML格式

ON格式

出口–基于事件的出口到外部系统

导出是一种将DB对象导出到外部系统的方法。这些系统可以是监视系统，票务系统，DNS等等。外部系统将通过插件系统解决。

导出作业可以手动触发，基于添加/更新/删除对象基于事件或基于cn语法的时间触发

DATAGERRY教程

框架

4.1。管理类别

对象类型按类别组织。类别可以在Framework-> Categoes下进行管理。每种对象类型都分配给一个类别。类别可以分层组织，只需定义父类别即可。类别树及其分配的对象类型显示在DATAGERRY左侧的侧栏上。

4.2。管理对象类型

要管理对象类型，请在菜单栏中选择Framework-> Types：

将显示具有已定义对象类型的列表。

4.2.1。添加/编辑对象类型

在“对象类型”列表中，单击“添加”以添加新类型，或单击“编辑”图标以编辑现有类型。向导将指导您完成整个过程。

首先，将询问有关该类型的一些基本：

选择对象类型的标签和图标，该标签和图标将显示在前端。对象类型的名称将自动创建，并且不能更改，仅供内部使用。每个类型都与一个类别相关联。除名称外，该页面上的每个设置都可以随时更改。

下一步，可以定义对象字段：

字段按“部分”进行组织。要添加新的部分或字段，请从左侧框中选择一个元素，通过拖放将其移动到中心。首先，添加一个部分(您可以在“结构控件”下找到它)，选择一个或多个字段。每个字段或部分都有名称和标签。名称将自动创建，不能手动更改，而标签则可以随时更改。根据字段类型，可以设置几个选项。目前，我们支持以下字段类型：

使用的预览按钮，将显示具有当前配置的对象的示例。

在配置对话框的下一页上，可以设置元：

每个对象都有摘要字段。这些字段汇总了对象，默认情况下显示在对象列表中。在路由器上，这可以是管理IP和主机名。可以在“摘要”下设置摘要字段。此外，可以设置外部链接，这些链接显示在对象页面上，以添加到另一个系统的webUI的快速链接。外部链接具有名称，标签，图标和链接(L)本身。在链接中，使用尖括号访问对象字段的值。

4.2.2。更改现有对象类型

现有对象类型可以随时更改，只需编辑对象类型并添加或删除字段或其他详细即可。对象类型定义将应用于所有现有对象，因此，如果删除字段，该字段将不再显示在DATAGERRY中。被删除的字段仍然存在于数据库中，如果再次添加该字段，则可以访问旧内容。要清理数据库并将对象类型定义与数据库同步，请在对象类型列表中单击“清理”按钮。

4.2.3。导入/导出对象类型

对象类型可以ON格式导出。在“对象类型”列表中，单击的“导出”按钮以ON格式获取文件。默认情况下，将导出所有对象类型。如果只想导出特定类型，请在列表中选择项目，单击“导出”按钮。

还可以从ON文件导入对象类型。在菜单中，选择“类型导入/导出”->“导入类型”，上传带有类型定义的ON文件。在导入期间，您可以选择应从ON文件中导入哪些类型。

4.3。管理对象

您可以通过以下几种方式在DATAGERRY中访问对象：

使用左侧的类别树

使用顶部的搜索栏

使用类别树时，您可以选择一个对象类型(例如路由器)，并获得包含该类型所有对象的列表。默认情况下，表中仅显示对象的摘要字段，使用设置按钮，可以淡入其他字段。

4.3.1。对象的批量修改

批量更改是DATAGERRY中的一项功能，通过它可以基于更改模板一步更改多个对象。进行此更改后，所选对象将采用更改模板的字段值。

开始

只需选择要更改的所有对象，单击按钮即可在列表上方进行质量更改。

模板

根据分配的对象类型生成更改模板。以下更改模板与常规对象的创建相同。以后存储要转移到对象的所有内容，并保存输入。

预览：

在预览中，所有所做的更改都会列出，并且可以根据需要再次进行调整。

结果：

预览后，所选对象将被更改。

4.3.2。有源和非活动对象

DATAGERRY中的对象可以是活动的或不活动的。非活动对象隐藏在WebUI中，并且未通过“导出”导出到外部系统。默认情况下，DATAGERRY中所有新创建的对象均处于活动状态。您可以通过单击“对象”视图页面上的小开关将“对象”设置为非活动状态。

如果要在WebUI中看到不活动的对象，请单击导航栏下的开关。

4.3.3。导出对象

可以以多种格式导出对象。目前，我们支持：

CSV

Micsoft Excel(xlsx)

ON格式

XML格式

要导出对象，请在“对象”列表中单击“导出”按钮，选择导出格式。只能导出单一类型的对象(因此在包含多种类型的对象的列表中找不到导出按钮)。

也可以在菜单中进行导出，选择“对象导入/导出”->“导出对象”。

4.3.4。导入对象

要导入对象，请从菜单中选择“对象导入/导出”->“导入对象”。当前，我们支持以下文件格式的导入：

CSV

ON格式

要开始导入，请上传文件并选择文件格式。根据格式，您必须进行一些设置才能开始导入。

4.3.4.1。CSV导入

从CSV文件导入期间，必须使用拖放辅助定义行到对象字段的映。如果CSV文件包含与对象字段名称匹配的标题，则映将在WebUI中预定义。对象引用也可以通过“外键”解析。例如，应导入具有“位置”字段的路由器对象。DATAGERRY中有位置对象，其字段为“名称”，其中包含位置的唯一名称(例如FRA1)。带有路由器对象的CSV文件包含唯一的位置名称。如果在映向导中选择“外键：location：name”，则在导入过程中将设置对正确的Location对象的引用。

4.3.4.2。ON

DATAGERRY可以从ON文件导入对象。ON格式与导出对象时创建的格式相对应。

4.4。访问控制

Datagerry使用多个访问控制来限制对数据和功能的访问。除了访问权限。在用户管理级别默认实现，还有访问控制列表的概念。这些目前仅在对象级别实现，但将扩展到核心框架的各个部分。他们应该为已经授权的级别/功能内的访问提供更精确的设置选项。

4.4.1。访问控制列表

ACL的概念基本上非常简单。顾名思义，它们是具有特定权限的组引用的列表。在我们的情况下，用户组存储在此处。因此，如果用户希望通过ACL获得访问权限，则只有在ACL中列出了完整的用户组时才有可能。权限定义将哪些作授予ACL中的组。这样可以更精确地定义不同的作。

4.4.1.1。权限

默认情况下，可能有四个权限：

创建资源

阅读资源

更新资源

删除资源

基于持久存储的四个基本功能。理论上可以添加更多权限，但是目前尚无计划。

4.4.1.2。ACL与系统权利

系统权限和ACL之间的区别在于，ACL仅会提高系统权限并使访问更加详细。它们不是权利的替代，它们只是扩展了限制。没有特定作权限的组(例如，查看对象)不能执行此作，即使其组已在相应的ACL中明确列出。

4.4.2。对象

对象的ACL保护它们免受未经授权的访问。它们用于使某些用户组可以访问或隐藏对象。这不仅影响对象本身的视图，还影响对对象的CRUD访问的任何方面，包括搜索，导出等。

原则上，对对象有五种不同的访问情况。

为什么要附加保护对象?

可以将Datagerry实例定义为大型且复杂的。在许多公司中，存在不同的层次结构和对不同区域的访问限制。到目前为止，DATAGERRY仅提供了向组授予对象的一般读取/查看权限的可能，而没有使单个对象组仅对某些用户组可见。这里的ACL帮助根据配置限制或允许某些用户组的对象可见。

4.4.2.1。配置对象

通过类型构建器在相应的类型定义中定义对象ACL。这些可以根据类型在ACL步骤下定义。默认情况下，它们被禁用，并且菜单被排除。

激活后，将启用菜单，并且可以将组添加到具有相应权限的ACL中。

添加组后，它们将显示在下面的列表中，并且可以进一步编辑其权限。但是一个组只能在ACL中出现一次。无法在同一列表中列出具有不同权限的同一组。

即使禁用了ACL，ACL设置仍保留在对象级别，但是以后将不再应用它们。