BIML API Reference
AstPrincipalNode Node Type
AstPrincipalNode defines a security principal that can be used across relational or Analysis Services databases.
Inheritance Hierarchy
- Varigence.Languages.Biml.AstNode
- Varigence.Languages.Biml.AstNamedNode
- Varigence.Languages.Biml.Table.AstPrincipalNode
Namespace:
Varigence.Languages.Biml.Table
Assembly:
Biml (in Biml.dll)
Language Element:
Properties
| Name | Summary | Default | |
|---|---|---|---|
 | Annotations | This is a collection of annotation items that can be used to specify documentation, tags, or other information. Annotations are particularly useful for storing information about nodes that can be used by BimlScript code. (Inherited from AstNode) | |
| BimlFile | This value specifies the BimlFile in which the Biml code that defines AstNode resides. (Inherited from AstNode) | |
 | Connection | This value specifies the name of the connection at which the principal is located. | |
| CustomExtensions | This collection specifies the definition for one or more SSIS package containers that can be used to execute custom actions relevant to the creation of this principal. | |
| ForceDisableIncrementalChangeTracking | This value specifies whether changes to property values of this node should be automatically reflected in the corresponding Biml code. Its primary use is for temporary nodes that will never be persisted into BimlFiles. (Inherited from AstNode) | False |
 | Name | Specifies the name of the object. This name can be used to reference this object from anywhere else in the program. (Inherited from AstNamedNode) | |
| PackageSubpath | This specifies a file path fragment to use for emitting output files for this principal. It is most commonly employed to ensure that the output files for multiple principals will be placed into the same output directory. | |
| ParentItem | This value specifies the parent of the current node. All nodes must have a valid parent in the Biml framework, except for the root node. (Inherited from AstNode) | |
| Permissions | This collection specifies the list of permissions that should be applied for the principal. Permissions are included from across the entire business intelligence solution, such as database and cube permissions. This provides a central location where all permissions for a given principal can be viewed and managed. | |
| PrincipalType | This value specifies the type of the principal selected from the list of principal types recognized by the system. | ApplicationRole |
| ReferenceCount | This value specifies the total number of other node properties that hold a reference to this node. (Inherited from AstNamedNode) | 0 |
| References | This is a collection of FrameworkItemReference objects, which track rich information about the properties that hold references to this node. (Inherited from AstNamedNode) | |
| SsisSafeName | Returns a version of the Name that has been cleaned of invalid characters for SSIS. (Inherited from AstNamedNode) | |
| SsisSafeScopedName | Returns a version of the ScopedName that has been cleaned of invalid characters for SSIS. (Inherited from AstNamedNode) |
Events
| Name | Summary | |
|---|---|---|
 | NameChanged | The NameChanged event occurs when the Name property of the current node has changed to a new value and that value has been committed. (Inherited from AstNamedNode) |
| NameChanging | The NameChanging event occurs when the Name property of the current node is receiving a new value but that value has not yet been committed. (Inherited from AstNamedNode) |
| ScopeBoundaryChanged | The ScopeBoundaryChanged event occurs when any ancestor (as determined by following ParentItem to the AstRootNode) changes in such a way as the ScopeBoundary for this node changes. This will force the ScopedName of this node to change if it is an AstNamedNode. (Inherited from AstNode) |
| ScopedNameChanged | The ScopedNameChanged event occurs when the name of this node or any scope boundary ancestor (as determined by following ParentItem to the AstRootNode) name changes. (Inherited from AstNamedNode) |
Extension Methods
| Name | Summary | |
|---|---|---|
 | GetBiml |
Retrieve the Biml that represents the AstNode
(Inherited from AstNode) [Extension Method: Import namespace Varigence.Hadron.Extensions] |
.NET API Metadata
Code Namespace:
Varigence.Languages.Biml.Table
Assembly:
Biml
Friendly Name:
Principal
Abstract:
False
Referenceable:
True
Root Item:
False
Scope Boundary:
False
Symbol Table Provider:
False
Xml Schema Name:
Varigence.Languages.Biml.Table.AstPrincipalNode
Xsd Namespace:
http://schemas.varigence.com/biml.xsd
Referenceable:
True
Scope Boundary:
False
Properties Referencing This Type
| Referencing Type | Referencing Property | Property Summary | |
|---|---|---|---|
 | AstRootNode | Principals | This is a collection of all principal definitions in the project. |