Skip to content

The Protocol System Field

When you ingest an infoton whose subject URL is <protocol>/<path>, the <protocol> value is stored in the protocol system field, while the <path> value is stored in the path system field.

For example, when an infoton whose URL is https://geo/countries is ingested, it will have the following system field values:

protocol="https"
path="/geo/countries"

The ingested infoton can have either http or https as its protocol value. If no protocol value is supplied, a default value of http is assumed.

Note

  • This feature is not related to the protocol used to access CM-Well, which can be either http or https. Regardless of the protocol used to access CM-Well, ingested infotons can have either protocol in their URL.
  • For a triple added to CM-Well, there is only special handling of the protocol in the Subject URL. A URL in an Object is stored as-is, complete with the protocol prefix, if provided.
  • The protocol system field is retrieved when an infoton is read via API, in any format. However, is it not displayed in the CM-Well Web UI.
  • If an infoton was ingested before the protocol system field was introduced, a default value of http will be retrieved when that infoton is read.
  • Two infotons that are identical except for their protocol are still considered identical. For example, if infoton A is written with the http protocol, and then updated with the same path but with the https protocol, then the original instance of A will be updated. However, if during an ingest, nothing is changed but the protocol value, this is not considered a null update - the protocol value will be updated and the lastModified time will be updated.