Documentation Center

PublicationOutput 2.5 Containing

This method returns the publication versions in which the specified logical object is used.


Parameters

NameTypeDirectionDescription
psAuthContextStringInOutDeprecated proprietary authentication context only used by .ASMX web services based on internal username/password authentication. Claims based security standards drive all the WCF .SVC web services making this parameter redundant.
psLogicalIdStringInThe logical identifier of the object
psVersionNumberStringInThe version of the object. This version number has to be an exact number.
psXMLRequestedMetaDataStringInRequested Metadata XML structure indicating which metadata has to be retrieved for a given object.
psOutXMLObjListStringOutObjectList XML structure containing the metadata of the objects.

Requirements are:
  • The user must have read access for the folder holding the object.
Note that:
  • All logical identifiers within Content Manager are in uppercase.
  • The Requested Metadata XML can only contain fields of the logical and version level.
  • The order of the returned objects in psOutXMLObjList is random.
When checking if the logical object is used in the publication, the following situations can result in more publications than expected:
  • The method first calculates the baselines in which the logical object is present (see Baseline.Containing). These baselines are used to retrieve the publication versions (see PublicationOutput.UsingBaseline). Consequently, when the baseline is shared between multiple publications, the result can contain publications in which the topic is not used.
  • Selecting a specific version of a map forces version selection for all referenced topics. Changing the version of the map can give less referenced topics, but those topics will still be in the baseline. This can result in publications where the topic is no longer used.
  • If a library contains conrefs with illustrations or links to other topics, all referenced objects will be returned as part of the publication even if they are not used.
  • If a library contains variable definitions with illustrations or links to other topics, all referenced objects will be returned as part of the publication even if they are not used.
  • Conditional filtering is ignored!!!