DATAGERRY(资产管理工具)

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

主要功能

　　在简单的Webfrontend中定义自己的对象类型（例如，路由器，服务器，位置）

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

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

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

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

　　关键事实：

　　定义自己的数据模型

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

　　开源（AGPLv3）

软件特色

　　1、定义自己的数据模型

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

　　2、自动化您的IT

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

　　3、开源

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

使用说明

　　什么是CMDB？

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

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

　　使用案例

　　使用DATAGERRY自动化您的IT：

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

　　功能性

　　设计您的对象类型

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

　　对象处理

　　文件导入导出

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

　　对象处理

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

　　对象类型可以随时更改。

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

　　文件导入和导出

　　添加或导入对象

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

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

　　CSV

　　XLSX

　　XML格式

　　JSON格式

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

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

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

　　官方教程

　　框架

　　4.1。管理类别

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

　　4.2。管理对象类型

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

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

　　4.2.1。添加/编辑对象类型

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

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

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

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

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

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

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

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

　　4.2.2。更改现有对象类型

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

　　4.2.3。导入/导出对象类型

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

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

　　4.3。管理对象

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

　　使用左侧的类别树

　　使用顶部的搜索栏

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

　　4.3.1。对象的批量修改

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

　　开始

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

　　模板

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

　　预览：

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

　　结果：

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

　　4.3.2。有源和非活动对象

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

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

　　4.3.3。导出对象

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

　　CSV

　　Microsoft Excel（xlsx）

　　JSON格式

　　XML格式

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

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

　　4.3.4。导入对象

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

　　CSV

　　JSON格式

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

　　4.3.4.1。CSV导入

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

　　4.3.4.2。JSON

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

　　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设置仍保留在对象级别，但是以后将不再应用它们。