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:

alternativeSources ([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.

clientMutationId (String)

A unique identifier for the client performing the mutation.

physicalAssets ([DiscoveredProductCategoryInput!]!)

Physical assets to be uploaded, grouped by product category and product.

referenceStrategies (DiscoveredReferenceStrategiesInput)

How to handle references to records already present in 4me.

source (String!)

Identifier for the client application submitting the upload.

supportTeam (String)

Name of the support team to use as default for new products and configuration items uploaded.

Return Fields

asyncQuery (AsyncQuery)

Metadata about asynchronous query execution. The asyncQuery { resultUrl } contains an expiring link to the file with the full results.

clientMutationId (String)

A unique identifier for the client performing the mutation.

configurationItems ([ConfigurationItem!])

Configuration items will be null on initial submission. The asyncQuery { resultUrl } contains an expiring link to the file with the full results.

errors ([ValidationError!])

Errors encountered during the mutation.