Hello,
I was looking at the category documentation for Operating System and noticed that it may be outdated.
This is because:
- the following fields seem to be missing:
assigned_version_for_report
, assigned_databases
, installDate
- every data type in the docs is
int
(except for description
), even though it seems like the API might also accept strings for some of those values, e.g., for assigned_version
.
See here from the administration page:
I noticed this because I wondered why every expected request argument is int
, even though you can insert string values in the web UI, for example in assigned_version
.
This issue probably also applies to other categories too.
Additional question:
My API client uses "cmdb.category_info.read"
to find out the data type that is expected for "cmdb.category.save"
.
In the case of the attribute assigned_version
, we can see (in the response down below) that
response["result"]["assigned_version"]["data"]["type"] = "int"
(and its a "dialog_plus"
).
So it seems like it only accepts int
, but we have seen above in the administration that it should also accept string
. Is it true, that the API also accepts strings? Currently, I have no way to test this out. And how is it possible to know only from API responses, that the data type for assigned_version
and other attributes is int
OR string
?
Running this RPC
{
"jsonrpc": "2.0",
"method": "cmdb.category_info.read",
"params": {
"apikey": "...",
"category": "C__CATG__OPERATING_SYSTEM"
},
"id": 1
}
also returns
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"application": {...},
"application_type": {...},
"application_priority": {...},
"assigned_license": {...},
"assigned_license_key": {...},
"assigned_it_service": {...},
"assigned_variant": {...},
"assigned_version": {
"title": "Version number",
"check": {
"mandatory": null
},
"info": {
"title": "LC__CATG__VERSION_TITLE",
"type": "dialog_plus",
"primaryField": false,
"backwardCompatible": false
},
"data": {
"type": "int",
"field": "isys_catg_application_list__isys_catg_version_list__id",
"sourceTable": "isys_catg_version_list",
"references": [
"isys_catg_version_list",
"isys_catg_version_list__id"
],
"readOnly": false,
"joins": [
{},
{},
{}
],
"index": true,
"select": {}
},
"ui": {
"id": "C__CATG__OPERATING_SYSTEM_VERSION",
"type": "popup",
"default": "-1",
"params": {
"p_strPopupType": "dialog_plus",
"p_strClass": "input-small",
"p_arData": {}
}
},
"format": {
"callback": [
"isys_global_application_export_helper",
"applicationAssignedVersion"
]
}
},
"assigned_version_for_report": {...},
"assigned_databases": {...},
"installDate": {...},
"description": {...}
}
}