浮动提示

显示TagSet属性

在对象的详细信息中看起来像什么:

https://www.itophub.io/wiki/media?w=400&tok=c35694&media=2_7_0%3Afeature%3Atag-read.png

您不确定标签的确切含义,只需将鼠标移到它上面:

https://www.itophub.io/wiki/media?w=400&tok=fca59f&media=2_7_0%3Afeature%3Atag-readtip.png

如果您单击标签,它将为您提供所有具有此特定标签的常见问题解答。

TagSet属性上的搜索

搜索具有处理人员标签的常见问题解答:

https://www.itophub.io/wiki/media?w=600&tok=38decf&media=2_7_0%3Afeature%3Atag-search-filter-simple.png

搜索具有终端用户或处理人员标签的常见问题解答:

https://www.itophub.io/wiki/media?w=600&tok=fa46c1&media=2_7_0%3Afeature%3Atag-search-filter-or.png

搜索具有终端用户和处理人员标签的常见问题解答:

https://www.itophub.io/wiki/media?w=600&tok=729deb&media=2_7_0%3Afeature%3Atag-search-filter-and.png

OQL语法用于TagSet

假设您有两个域,其代码为处理人员和最终用户,并且带有这些标记的一些常见问题解答:
您可以搜索获得具有这两个标签中的一个或另一个的FAQ:

 SELECT FAQ WHERE domains MATCHES 'agent enduser'

您可以使用搜索获取具有两个标签的常见问题解答:

 SELECT FAQ WHERE domains MATCHES 'agent' AND domains MATCHES 'enduser'

TagSet属性的版本

添加一个标签

如果您的标签数量很少,则它们会在下拉列表中列出

https://www.itophub.io/wiki/media?w=400&tok=be1eba&media=2_7_0%3Afeature%3Atag-edit1.png

如果输入一些文本,则将可选值列表过滤为包含文本的值

https://www.itophub.io/wiki/media?w=400&tok=52e025&media=2_7_0%3Afeature%3Atag-edit3.png

如果您只列出了一个价值,则按Enter键确实会将其添加到标签中

https://www.itophub.io/wiki/media?w=400&tok=eee1a7&media=2_7_0%3Afeature%3Atag-edit4.png

对象上可以设置的标签数量上限。

当达到允许的最大标签数量时,可能值的列表不会显示,因此您无法再添加价值。如果在达到限制后删除标签,则可能的值列表会再次显示。

卸下标签

如果您至少选择了一个标签并将光标放在该字段中:按下键将删除最后一个标签。

如果单击所选标签上的x,它将删除该标签。

https://www.itophub.io/wiki/media?w=400&tok=b700b2&media=2_7_0%3Afeature%3Atag-edit-remove.png

批量版TagSet

如果您具有批量写入权限,则可以大量添加或删除标签。它支持以下用例:

  • 将标签添加到一组对象,并使所有已修改对象上的其他标签保持不变。将标签添加到已经具有的对象无效。
  • 从一组对象中删除标签,并在所有修改后的对象上保留其他标签不变。从不带对象的对象上卸下标签无效。

修改要在其上批量添加或删除标签的对象的列表

https://www.itophub.io/wiki/media?w=600&tok=f4f366&media=2_7_0%3Afeature%3Atagset-bulk-edit.png

标签在批量修改编辑屏幕中的显示方式如下:

  • 所有要修改的对象上存在的标签以白色后台显示
  • 用灰色后台显示存在于要修改的对象上的标签。
    • 如果单击灰色的标签,它将变为白色,并将添加到所有要修改的对象中
    • 如果您保留不变的灰色标签,它将保留在以前拥有它的那些对象上,并且不会添加到其他对象上。
  • 必须在单个对象版本中选择没有要修改的对象上存在但需要添加的标签。
  • 您可以完全按照单个对象版本中的说明卸下标签。

导出导入

当您使用带有TagSet属性的导出对象时,标签将与标签一起输出,并用竖线|分隔。导入数据支持相同的格式。开头和结尾必须有一个管道

  • 您可以使用导出的标签,也可以使用检查标志导出的代码代替Label
  • 您只能使用标签的标签来导入,控制台内的代码尚不支持。

管理标签的允许值

在管理类型时,可以在iTop中管理特定TagSet属性的建议值。请参见“数据管理”下的新菜单:

https://www.itophub.io/wiki/media?w=200&tok=7b74e7&media=2_7_0%3Afeature%3Atagset-configuration.png

变更可以看到此菜单(对于任何菜单)并可以修改这些类,可以通过使用父类TagSeieldData或子类(如果需要)对调整简档(角色)进行精细调整。

搜索并创建新值

  1. 选择要为其管理值的级别和属性
  2. 检查现有值
  3. 创建丢失的

https://www.itophub.io/wiki/media?w=600&tok=441526&media=2_7_0%3Afeature%3Atagset-allowed-values.png

  • 代码只能使用数字和字母,不能使用其他字符。
  • 标签使用字母顺序[1..9] [A..Z] [a..z]按代码排序。

由于标签的订购基于他们的代码,因此可以更好地对齐代码和标签,以使其对用户而言更加明显

你可以放表情符号 在标签标签中,使用简单的复制粘贴

修改允许的价值

  • 如果没有对象使用该标签价值,则可以对其进行自由修改。
  • 如果至少有一个对象正在使用该标签,则无法更改代码,但可以更改标签和说明。

https://www.itophub.io/wiki/media?w=400&tok=e1f4e8&media=2_7_0%3Afeature%3Atagset-edit-used-value.png

删除允许的价值

  • 如果没有对象使用该标签价值,则可以自由删除它
  • 如果至少有一个对象正在使用该标签,则无法将其删除。

https://www.itophub.io/wiki/media?w=600&tok=fc6572&media=2_7_0%3Afeature%3Atagset-delete-used-value.png

首先从使用该对象的所有对象中删除该标签:

  1. 点击标签
  2. 打开选项卡“标签的用法”
  3. 单击列出的对象上的修改后的功能
  4. 删除批量版本表单中的标签并提交
  5. 现在,您可以删除在面包屑上检索的标签

https://www.itophub.io/wiki/media?w=600&tok=b36a2f&media=2_7_0%3Afeature%3Atagset-tag-usage.png

配置标签集属性

作为标签定义的一部分,您必须定义

  • 给定对象上允许的最大标签数<max_items>。这不限制可用标签的数量,没有限制。
  • 您应该限制性能的标签代码的大小<tag_code_max_len>

请勿在实际数据高于新限制的现有TagSet上减少<max_items>或<tag_code_max_len>,否则可能会丢失数据。

在类FAQ上定义具有id域的属性标记集,自动创建类TagSeieldDataFor_FAQ__domains

Q&A

查询结果是带有含混的的内容,我该怎么办?

尝试通过将优化表申明作为MySQL用户启动,来重建对应的MySQL表全文索引。相应的文件).

局限性

  • “允许的值”不能本地化。
  • 当用户已达到对象上允许的最大标签数时,没有警告,它只是停止提议新值
  • 扩展程序数据本地化器尚未与标记集一起测试FIXME
  • 在实际数据高于新限制的情况下,在现有标记集上减小<max_items>或<tag_code_max_len>的大小,将导致数据库上的依赖产生不可预测的结果。

应将标签属性添加到联系人或Person类,因为它会中断登录名阶段

原贴链接:https://www.itophub.io/wiki/page?id=2_7_0%3Afeature%3Atag


Attribute TagSet

Display of a TagSet attribute

What does it look like within the details of an objet:https://www.itophub.io/wiki/media?w=400&tok=c35694&media=2_7_0%3Afeature%3Atag-read.png

You're not sure about the exact meaning of a tag, just move your mouse over it:https://www.itophub.io/wiki/media?w=400&tok=fca59f&media=2_7_0%3Afeature%3Atag-readtip.png

If you click on the Tag, it will give you all the FAQs that do have this particular tag.

Search on a TagSet attribute

Searching for FAQs having Agent Tag:

https://www.itophub.io/wiki/media?w=600&tok=38decf&media=2_7_0%3Afeature%3Atag-search-filter-simple.png

Searching for FAQs having End-User or Agent Tag:

https://www.itophub.io/wiki/media?w=600&tok=fa46c1&media=2_7_0%3Afeature%3Atag-search-filter-or.png

Searching for FAQs having End-User and Agent Tag:

https://www.itophub.io/wiki/media?w=600&tok=729deb&media=2_7_0%3Afeature%3Atag-search-filter-and.png

OQL syntax for TagSet

Assuming you have 2 domains with code agent and enduser, and some FAQs with those tags:
You can search for FAQs having either one or the other of those 2 tags:

  SELECT FAQ WHERE domains MATCHES 'agent enduser'

You can search for FAQs having both tags:

  SELECT FAQ WHERE domains MATCHES 'agent' AND domains MATCHES 'enduser'

Edition of a TagSet attribute

Add a Tag

If you have a small number of possible tags, they are listed in the drop-downhttps://www.itophub.io/wiki/media?w=400&tok=be1eba&media=2_7_0%3Afeature%3Atag-edit1.png

If you enter some text, the list of selectable values is filtered to those containing your texthttps://www.itophub.io/wiki/media?w=400&tok=52e025&media=2_7_0%3Afeature%3Atag-edit3.png

If you have a single value listed, pressing the key enter does add it to your tagshttps://www.itophub.io/wiki/media?w=400&tok=eee1a7&media=2_7_0%3Afeature%3Atag-edit4.png

There is a maximum number of tags which can be set on an object.

When you reached the maximum number of tags allowed, then the list of possible values is not displayed so you can no more add a value. If after you've reached the limit, you remove a tag, then the list of possible values is displayed again.

Remove a Tag

If you have at least one selected tag and put the cursor in that field: pressing the key back will remove the last tag.

If you click on the x on a selected tag, it will remove that tag.https://www.itophub.io/wiki/media?w=400&tok=b700b2&media=2_7_0%3Afeature%3Atag-edit-remove.png

Bulk edition of TagSet

If you have bulk write right then you can add or remove Tags massively. It supports those use cases:

  • Add a Tag to a set of objects and leave the other tags unchanged on all modified objects. Adding a tag to an object which has it already, has no effect.

  • Remove a Tag from a set of objects and leave the other tags unchanged on all modified objects. Removing a tag from an object which doesn't have it, has no effect.

Modify a list of objects on which you want to bulk add or remove tagshttps://www.itophub.io/wiki/media?w=600&tok=f4f366&media=2_7_0%3Afeature%3Atagset-bulk-edit.pngThis is how the tags are displayed in the bulk modify edit screen:

  • The tags which are present on all objects-to-modify are displayed with a white background

  • The tags which are present on at leat one objects-to-modify are displayed with a grey background

    •  

    If you click on a grey tag it becomes white and will be added to all objects-to-modify

    •  

    If you leave unchanged a grey tag, it will remain on those objects who had it before and won't be added on others.

  • Tags present on none of the objects-to-modify but needing to be added, must be selected as in single object edition.

  • You can remove a tag exactly as described in the single object edition.

Export / Import

When you export objects with a TagSet attribute, the tags are exported with their label, separated by a pipe |. The same format is supported for importing data. There must be a pipe at the beginning and at the end

  • You can export the labels, or the codes checking the flag Export Code instead of Label

  • You can only import using labels of the Tags, the codes within the console are not yet supported.

Manage allowed values for a Tag

Managing the proposed values for a particular TagSet attribute, is done in iTop as you managed a Typology. See the new menu under “Data administration”:https://www.itophub.io/wiki/media?w=200&tok=7b74e7&media=2_7_0%3Afeature%3Atagset-configuration.png

It's possible to change who can see this menu (as for any menu) and who can modify those classes, by fine-tuning the profiles using the parent class TagSetFieldData or the children classes if we want.

Search and create new values

  1. Select the Class/Attribute for which you want to manage the values

  2. Check existing values

  3. Create missing ones

https://www.itophub.io/wiki/media?w=600&tok=441526&media=2_7_0%3Afeature%3Atagset-allowed-values.png

  • code can only use numbers and letters, no other character.

  • Tags are ordered by code using alphabetic order [1..9][A..Z][a..z].

As Tag ordering is based on their code, better align code and label to make it more obvious for users

You can put emoji within a tag label, using a simple copy-paste

Modify an allowed value

  • If no object is using that tag value, then it can be freely modified.

  • If at least one object is using that tag, then the code cannot be changed, but label and description can.

https://www.itophub.io/wiki/media?w=400&tok=e1f4e8&media=2_7_0%3Afeature%3Atagset-edit-used-value.png

Delete an allowed value

  • If no object is using that tag value, then it can freely be deleted

  • If at least one object is using that tag, then it cannot be deleted.

https://www.itophub.io/wiki/media?w=600&tok=fc6572&media=2_7_0%3Afeature%3Atagset-delete-used-value.pngRemove first that tag from all objects using it:

  1. Click on the Tag

  2. Open the tab “Tag usage”

  3. Click on the modifiy action on the listed object

  4. Remove the Tag in the bulk edition form and submit

  5. Now you can delete the Tag, retrieved on the breadcrum

https://www.itophub.io/wiki/media?w=600&tok=b36a2f&media=2_7_0%3Afeature%3Atagset-tag-usage.png

Configure a TagSet Attribute

As part of the definition of a tag, you must define

  • The maximum number of tags <max_items> allowed on a given object. This does not limit the number of available tags, which has no limit.

  • You should limit the size of a tag code for performance <tag_code_max_len>

Do not reduce <max_items> or <tag_code_max_len> on an existing TagSet with real data being above the new limits or you may lose data.

Defining an AttributeTagSet with id domains on class FAQ, create automatically a class TagSetFieldDataFor_FAQ__domains

Q&A

Query results are incoherent with the content, what can I do ?

Try to rebuild the corresponding MySQL table full text index by launching as a MySQL user the optimize table statement (see corresponding documentation).

Limitations

  • “Allowed values” cannot be localized.

  • There is no warning when a user has reached the maximum numbers of Tags allowed on an object, it just stops proposing new values

  • Extension Data Localizer was not yet tested with TagSet FIXME

  • Reducing the size of <max_items> or <tag_code_max_len> on an existing TagSet with real data being above the new limits, will lead to unpredictable results depending on your database.

No Tag attribute should be added to Contact or Person class, as it breaks the login phase

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

需要帮助?

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

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