Entity Read Guidelines and Limitations

Guidelines and limitations when configuring an Entity Read operation.

  • You receive a warning if you define an Entity Read operation, but there is no Create or Update operation at the root of the composite graph using the "Apply output of ENTITY READ operation" cache policy option.
  • You must fill all arguments of the Entity Read operation with a default value, personalization key or Fill-from-Attribute. Any unmapped arguments use the default value.
  • You must map the entire MBO primary key into the input arguments for the Entity Read operation, except primary-key attributes propagated from load arguments. Unwired WorkSpace displays a warning if all MBOs do not have a primary key.
  • All MBOs in the composite graph must have all attributes mapped to results from the Entity Read operation, except attributes propagated from load arguments.
  • For all EIS types, a composite graph can use only one data source.
  • For all object-oriented EIS types (SAP, Web Service, REST) capable of shared read, a composite graph should use only one load group.
  • An MBO can have only one Entity Read operation.
  • For all EIS types, an Entity Read operation can only be defined for the root of a composite graph – an MBO graph can have more than one root (two nodes can have relationships with the same “child” MBO), but only one of the relationships can be a composite. Entity Read operations can only be defined on the root node of a composite object graph – since the Entity Read operation executes when the root operation executes, the results of subsequent child MBO operations are not incorporated into the cache through the Entity Read operation.
  • An error is generated if any operation in a composite graph uses the “Apply output of ENTITY READ operation” cache policy, without an Entity Read operation defined.
  • Entity Read operations are not available to MBOs that belong to an Online cache group. If an MBO has an Entity Read operation and the MBO is moved to an Online cache group, the Entity Read operation is removed.
  • A child node in a composite graph cannot use the “Apply output of ENTITY READ operation”option.