如何正确使用inboundReferences(IQL)进行Jira Assets对象搜索？

你的IQL语法错误源于inboundReferences函数的使用不符合规范，该函数用于查找被其他对象引用的目标对象，需要明确指定引用方的对象类型名称、引用属性名称（可选，当类型下存在多个引用属性时必填）以及引用方的过滤条件，且所有字符串参数需用双引号包裹。

正确的IQL写法示例 #

根据你的需求，假设引用键盘的用户对象类型名为User，用户对象中指向键盘的引用属性名为Assigned_Component，正确的IQL语句如下：

Component_Type=KEYBOARD AND Brand=MICROSOFT AND Model="Natural Ergonomic" AND INBOUNDREFERENCES("User", "Assigned_Component", "Usr_Code=40000162")

简化场景（可选） #

如果User类型下只有一个指向键盘的引用属性，可以省略引用属性名称：

Component_Type=KEYBOARD AND Brand=MICROSOFT AND Model="Natural Ergonomic" AND INBOUNDREFERENCES("User", "Usr_Code=40000162")

完整的请求URL（已URL编码） #

将上述IQL编码后，完整的请求地址如下：

http://trtstjirfe1:8080/rest/insight/1.0/iql/objects?includeAttributes=true&iql=Component_Type=KEYBOARD%20AND%20Brand=MICROSOFT%20AND%20Model=%22Natural%20Ergonomic%22%20AND%20INBOUNDREFERENCES(%22User%22,%20%22Assigned_Component%22,%20%22Usr_Code=40000162%22)&includeAttributesDeep=2

关键注意事项 #

• 替换示例中的User和Assigned_Component为你实际的用户对象类型名称、引用属性名称（可在Jira Assets对象类型配置中查看）。
• 所有字符串类型的参数必须用双引号包裹，IQL解析器对格式要求严格。
• 确保API请求的身份凭证拥有足够权限访问Jira Assets数据并执行IQL查询。

内容的提问来源于stack exchange，提问作者Henry marca zeballos