SAS Namespace Types

Root

Overview

This is an abstract type that is the supertype for all of the other metadata types.

Security Inheritance and Enforcement Rules

The following is a list of associations which are used to determine if this object should inherit access controls from another object (inheritance) or if the association is allowed for the object (enforcement). For more information about inheritance and enforcement rules, see the SAS Intelligence Platform: Security Administration Guide.

Trees

Attributes

Name	Description	Type	Length
Id	Object's repository id	String	17
Name	A logical identifier for the object. Used for, but not limited to, display.	String	60
Desc	More detailed documentation for this object.	String	200
MetadataCreated	Date and time metadata object was created.	Double
MetadataUpdated	Date and time metadata object was last updated.	Double
ChangeState	This attribute is used by Change management.	String	64
LockedBy	This attribute is used by Change management.	String	32
UsageVersion	Usage version is used by an application to indicate the usage pattern of the logical object.	double

Associations

= indicates the resident side of an association, or where the association is persisted for cross-repository associations. If no resident side is indicated, this association may not cross repository boundaries.

Name	Cardinality	Description	Associated Types
AccessControls Partner: Objects	0 to *	The access controls for this object.	AccessControl AccessControlEntry AccessControlTemplate
Changes Partner: Objects	0 to *	The changes that have been made to this object.	Change
CustomAssociations Partner: OwningObject	0 to *	The custom associations related to this owning object.	CustomAssociation
Documents Partner: Objects	0 to *	The documents that are associated with this object.	Document
Extensions Partner: OwningObject	0 to *	The object the extension is associated with. An extension can be associated with any kind of object.	AbstractExtension Extension NumericExtension
ExternalIdentities Partner: OwningObject	0 to *	The external identities for this object in other contexts.	ExternalIdentity
Groups Partner: Members	0 to *	The groups that have this object as a member.	Group SXLEMap
Implementors Partner: ImplementedObjects	0 to *	The software components that utilize the metadata in this object.	SoftwareComponent ConfiguredComponent DeployedComponent LogicalServer ServerComponent ServerContext ServiceComponent
Keywords Partner: Objects	0 to *	The keywords associated with this object.	Keyword
LocalizedAttributes Partner: AssociatedLocalizedObject	0 to *	The attribute which has localized resources.	Property
Notes Partner: Objects	0 to *	The list of notes associated with the object.	TextStore
PrimaryPropertyGroup Partner: AssociatedObject	0 to 1	The starting place for a hierarchy of property objects, often used to help drive a UI.	PropertyGroup
Prompts Partner: PromptEnabledObject	0 to *	The prompts or prompt group for this object.	AbstractPrompt Prompt PromptGroup
Properties Partner: AssociatedObject	0 to *	The default properties of this object.	Property
PropertySets Partner: OwningObject	0 to *	Complete set of properties used in a particular context.	PropertySet
ReferencedObjects Partner: AssociatedObjects	0 to *	The object(s) which are associated to the owning object using this custom association.	CustomAssociation
ResponsibleParties Partner: Objects	0 to *	The list of responsibilities which have been assigned for this object.	ResponsibleParty
SourceTransformations Partner: TransformationSources	0 to *	The set of transformations that use this input.	AbstractTransformation AbstractJob ClassifierMap FeatureMap JFJob Job Join MiningResult Select SyncStep Transformation TransformationActivity TransformationStep
SpecSourceTransformations Partner: SourceSpecifications	0 to *	The transformation that uses this specification.	AbstractTransformation AbstractJob ClassifierMap FeatureMap JFJob Job Join MiningResult Select SyncStep Transformation TransformationActivity TransformationStep
SpecTargetTransformations Partner: TargetSpecifications	0 to *	The transformation that uses this specification.	AbstractTransformation AbstractJob ClassifierMap FeatureMap JFJob Job Join MiningResult Select SyncStep Transformation TransformationActivity TransformationStep
TargetTransformations Partner: TransformationTargets	0 to *	The set of transformation activities that create this result.	AbstractTransformation AbstractJob ClassifierMap FeatureMap JFJob Job Join MiningResult Select SyncStep Transformation TransformationActivity TransformationStep
Timestamps Partner: Objects	0 to *	The timestamps associated with this object.	Timestamp
Trees Partner: Members	0 to *	The trees that have this object as a member.	Tree
TSObjectNamespace Partner: TSObjects	0 to 1	Table server namespace for this object.	TSNamespace
UsedByPrototypes Partner: UsingPrototype	0 to *	The objects that use this object as a prototype.	ALL TYPES
UsingPrototype Partner: UsedByPrototypes	0 to 1	The prototype for this object. This must be a MetadataPrototype object, or an object of the SAME metadata type as this object.	ALL TYPES
Variables Partner: AssociatedObject	0 to *	The variables associated with this object.	Variable

Attribute Details

Name
     Type: String 60
     Required

The name is a logical identifier for the object. Used for, but not limited to, display. Since it is often used for display it is subject to being localized. Even though this is a required attribute, in practice it behaves more like a label than a name. Metadata types which require a name that can be relied on for code in applications will typically have an additional name attribute e.g. PropertyName, TableName, ColumnName.

The following restrictions are currently enforced by InformationService and are proposed as a best practice.

Non-null

60 >= length > 0

May not start or end with a whitespace character

May not contain '/', '\' or control characters

Names may contain any Unicode characters, subject to the restrictions listed above.

Desc
     Type: String 200
     Optional

The desc allows for a brief description of the object. If an object needs more detailed information, refer to Notes or Documents. The desc is subject to localization which should be taken into account when providing a description which you know will be localized. There is an open I18N defect requesting desc be variable in length to prevent translations from being truncated however, current server architecture cannot support a variable length for this attribute. Prior to 9.2, resource templates were translated by the NLS team and all translated values were stored in metadata. In 9.2, a resource key will be stored in metadata, therefore, UIs will not be able to assume the description will be limited to 200.

Id
     Type: String 17

Id is a 17 character string which is guaranteed to be unique for a given object within a metadata server. It takes the form of A0000001.A0000001 where the first 8 characters represent the repository Id and the second 8 characters represent the object Id. If the object is a repository, the first 8 characters represent the repository manager and will always be equal to A0000001, the second eight characters represent the repository Id.

Ids should never be stored outside of the metadata object and it should not be assumed that a given logical entity will retain the same metadata Id during its lifetime. When updating logical entities in the metadata server, applications often delete and recreate objects in the metadata server, the new objects created will have different metadata Ids than the original. Also, metadata definitions may be exported and deployed to a new metadata server, these too will have different metadata ids than the original objects. It is important to note here that the pattern of deleting and recreating objects in the server instead of doing an actual update is discouraged. This pattern creates unnecessary I/O and removes all associations to other objects. The deleting application is often not aware of all associations and will be unable to recreate links which other applications are relying upon.

MetadataCreated
     Type: Double

Date and time metadata object was created. Stored as GMT values in SAS date, time, and datetime encoding. To store the creation date of the entity that the metadata describes use the Timestamps association.

Storage and Formatting of Date, Time, and Datetime Values

Using XMLSelect Syntax to Filter a GetMetadataObjects Request: Attribute Criteria Syntax

MetadataUpdated
     Type: Double

Date and time metadata object was last updated. Stored as GMT values in SAS date, time, and datetime encoding. To store the modified date of the entity that the metadata describes use the Timestamps association.

Storage and Formatting of Date, Time, and Datetime Values

Using XMLSelect Syntax to Filter a GetMetadataObjects Request: Attribute Criteria Syntax

UsageVersion
     Type: Double

All objects that participate in the public object model must implement a standard usage version. The usage version is simply a version number persisted with the object and rules for interpreting those version numbers. The usage version determines level of compatibility between the persisted object and any applications that may access the object. Recommendations for usage versioning may be found here.

ChangeState
     Type: String 64

LockedBy
     Type: String 32

May be used by clients to indicate a source lock on the object.

Association Details

AccessControls
     Cardinality: 0 to *
     Partner: Objects

The access controls for this object.

Associated Types:
AccessControl AccessControlEntry AccessControlTemplate

Changes
     Cardinality: 0 to *
     Partner: Objects

This association is used by the change management facility and represents the changes that have been made to this object.

Associated Types:
Change

CustomAssociations
     Cardinality: 0 to *
     Partner: OwningObject

The custom associations related to this owning object.

Associated Types:
CustomAssociation

Documents
     Cardinality: 0 to *
     Partner: Objects

The documents that are associated with this object.

Associated Types:
Document

Extensions
     Cardinality: 0 to *
     Partner: OwningObject

The object the extension is associated with. An extension can be associated with any kind of object.

Associated Types:
AbstractExtension Extension NumericExtension

ExternalIdentities
     Cardinality: 0 to *
     Partner: OwningObject

The external identities for this object in other contexts.

Associated Types:
ExternalIdentity

Groups
     Cardinality: 0 to *
     Partner: Members

The groups that have this object as a member.

Associated Types:
Group SXLEMap

Implementors
     Cardinality: 0 to *
     Partner: ImplementedObjects

The software components that utilize the metadata in this object.

Associated Types:
SoftwareComponent ConfiguredComponent DeployedComponent LogicalServer ServerComponent ServerContext ServiceComponent

Keywords
     Cardinality: 0 to *
     Partner: Objects

The keywords associated with this object.

Associated Types:
Keyword

LocalizedAttributes
     Cardinality: 0 to *
     Partner: AssociatedLocalizedObject

The Role attribute set with the value of "Override" will indicate this Property has associated localized resources. The Name attribute contains the name of the attribute in the AssociatedLocalizedObject that is being localized.

Associated Types:
Property

Notes
     Cardinality: 0 to *
     Partner: Objects

The list of notes associated with the object.

Associated Types:
TextStore

PrimaryPropertyGroup
     Cardinality: 0 to 1
     Partner: AssociatedObject

Any object may have one PrimaryPropertyGroup. PrimaryPropertyGroup is the starting place for a hierarchy of property objects, often used to help drive a UI. The properties contained in this group are not actual values, instead they represent the set of possible values or options for the associated object. For more information see, PropertyGroup.

Associated Types:
PropertyGroup

Prompts
     Cardinality: 0 to *
     Partner: PromptEnabledObject

The prompts or prompt group for this object.

Associated Types:
AbstractPrompt Prompt PromptGroup

Properties
     Cardinality: 0 to *
     Partner: AssociatedObject

The Properties association is available for any object and the objects in this association are considered to be the "default" properties. This association should contain a complete set of properties for "default" usage. If there is no default, then this association should not be used. Properties which are relevant only for a specific context should be grouped using a PropertySet object. For more information see, Property.
The Properties association for a SASLibrary and for PhysicalTable must contain valid libname options.

Associated Types:
Property

PropertySets
     Cardinality: 0 to *
     Partner: OwningObject

Any object may have one or more PropertySet objects. A PropertySet contains a complete group of properties used in a particular context. For more information, see PropertySet.

Associated Types:
PropertySet

ReferencedObjects
     Cardinality: 0 to *
     Partner: AssociatedObjects

The object(s) which are associated to the owning object using this custom association.

Associated Types:
CustomAssociation

ResponsibleParties
     Cardinality: 0 to *
     Partner: Objects

The list of responsibilities which have been assigned for this object. In order to determine the identities who have been assigned to a particular responsibility the application writer would need to traverse the Persons association.

Associated Types:
ResponsibleParty

SourceTransformations
     Cardinality: 0 to *
     Partner: TransformationSources

The set of transformations that use this input.

Associated Types:
AbstractTransformation AbstractJob ClassifierMap FeatureMap JFJob Job Join MiningResult Select SyncStep Transformation TransformationActivity TransformationStep

SpecSourceTransformations
     Cardinality: 0 to *
     Partner: SourceSpecifications

The transformation that uses this specification.

Associated Types:
AbstractTransformation AbstractJob ClassifierMap FeatureMap JFJob Job Join MiningResult Select SyncStep Transformation TransformationActivity TransformationStep

SpecTargetTransformations
     Cardinality: 0 to *
     Partner: TargetSpecifications

The transformation that uses this specification.

Associated Types:
AbstractTransformation AbstractJob ClassifierMap FeatureMap JFJob Job Join MiningResult Select SyncStep Transformation TransformationActivity TransformationStep

TargetTransformations
     Cardinality: 0 to *
     Partner: TransformationTargets

The set of transformation activities that create this result.

Associated Types:
AbstractTransformation AbstractJob ClassifierMap FeatureMap JFJob Job Join MiningResult Select SyncStep Transformation TransformationActivity TransformationStep

Timestamps
     Cardinality: 0 to *
     Partner: Objects

The timestamps associated with this object.

Associated Types:
Timestamp

Trees
     Cardinality: 0 to *
     Partner: Members

The trees that have this object as a member.

Associated Types:
Tree

TSObjectNamespace
     Cardinality: 0 to 1
     Partner: TSObjects

Table server namespace for this object.

Associated Types:
TSNamespace

UsedByPrototypes
     Cardinality: 0 to *
     Partner: UsingPrototype

The objects that use this object as a prototype.

Associated Types:
*ALL TYPES*

UsingPrototype
     Cardinality: 0 to 1
     Partner: UsedByPrototypes

The prototype for this object. This must be a MetadataPrototype object, or an object of the SAME metadata type as this object.

Associated Types:
*ALL TYPES*

Variables
     Cardinality: 0 to *
     Partner: AssociatedObject

The variables associated with this object.

Associated Types:
Variable

Top of Page