discoveredConfigurationItems Mutation
This mutation can be used to push at most 100 discovered configuration items to 4me at once. A more extensive description of this functionality can be found on the Discovery Tools page of the developer documentation.
The query will be executed in the background. Typically the following fields should be queried:
asyncQuery { resultUrl errorCount }
configurationItems { id sourceID }
On initial submission the configurationItems
field will be null
.
The resultUrl
contains an expiring link to the location where the resulting JSON is available
once the query has been executed.
It is possible to poll the link every couple of seconds to check whether the query is completed.
Initially the link will point to an empty JSON document ({}
), once the query is completed it will contain
the JSON result of this mutation.
In the result both the asyncQuery
and configurationItems
fields as requested on submission are present.
The errorCount
can for example be used to see whether processing was successful (then it is 0
).
Input Argument
discoveredConfigurationItems accepts a single input
argument, an input type,
which contains the values it uses.
The fields inside input
are:
[String!]
)
Alternative identifiers for the client application. When a configuration item
or product with the given sourceID
is found linked to one of these
alternative sources it will be identified as the same. For configuration items
the source field in 4me will be updated to the source
value supplied.
String
)
A unique identifier for the client performing the mutation.
[DiscoveredProductCategoryInput!]!
)
Physical assets to be uploaded, grouped by product category and product.
DiscoveredReferenceStrategiesInput
)
How to handle references to records already present in 4me.
String!
)
Identifier for the client application submitting the upload.
String
)
Name of the support team to use as default for new products and configuration items uploaded.
Return Fields
AsyncQuery
)
Metadata about asynchronous query execution. The asyncQuery { resultUrl }
contains an expiring link to the file with the full results.
String
)
A unique identifier for the client performing the mutation.
[ConfigurationItem!]
)
Configuration items will be null
on initial submission. The asyncQuery { resultUrl }
contains an expiring link to the file with the full results.
[ValidationError!]
)
Errors encountered during the mutation.