Summary
This block is used to create or update a NavFile with its root Node.
Implementation
- Drag and drop the block from the palette
- Link the "execute" action from the "executed" topic of the previous block
Example
In the example below, we create a new navFile named myNavFile.nav directly in the Files spaces.
The root Node will be called "myNiagaraNetwork", it will target the NiagaraNetwork and it will have the Niagara "deviceNetwork.png" icon
Properties
- Artifacts created by this block
- Added: name of the created node. Useful for following AddNodeToNavFile
- TargetDirectory: The directory in which the NavFile will be created.
- FileName: The name of the NavFile. If the file doesn't exist, it will be created.
- DisplayName: The display name of the root node. Slashes AREN'T allowed inside the displayName.
- TargetOrd: The ord of the component to target
- IconOrd: The ord to the icon of the rootNode
- Policy {AddOnlyIfNotExists, AddAlways, AddOrMerge, AddOrReplace}: Define the behavior of the component to add if it already exists:
- Add only if not exists: nothing will happen if a root already exists with the same name in the file
- Add always: nothing will happen if a root already exists with the same name in the file, it is impossible to have several root in the same file.
- Add or merge: it will merge properties from the value to the existing component.
- Add or replace: the existing component is removed before the new one is added.
Behavior: DO
The NavFile is created
Behavior: UNDO
The NavFile is removed