User Manual

GETTING STARTED


OTHER EDITIONS


LAUNCHERS


MODULES


PLATFORM


APPENDIX


TUTORIALS & HELPFUL TRICKS


STRATEGIC PARTNER LINKS

Sepasoft - MES Modules
Cirrus Link - MQTT Modules

RESOURCES

Inductive University
Ignition Demo Project
Knowledge Base Articles
Forum
IA Support

ALL USER MANUAL VERSIONS

Ignition 8.1. Offline Version (04/2021)
Ignition 8 Online Version
Ignition 7.9 Online Version
Ignition 7.8 Online Version

Deprecated Pages

SDK Documentation

Employees

Sign In

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Scripting_function


Panel
titleDescription

Exports Tags to a file on a local file system.

The term "local file system" refers to the scope in which the script was running; for example, running this script in a Gateway Timer script will export the file to the Gateway file system.

Client permissions restrictions


Panel
titleSyntax
Note_friendly

This function accepts keyword arguments.

system.tag. exportTags([filePath], tagPaths, [recursive], [exportType] )

  • Parameters

String  or Nothing filePath  - The file path that the Tags will be exported to. If the file does not already exist, this function will attempt to create it.

Changed_in
FunctionMargintrue
Version8.1.8

Previously, this the filePath parameter was required. If omitted, causes the function to return the tag export as a string. 


List
 tagPaths - A List of Tag paths to export. All Tag paths in the list must be from the same parent folder.

Boolean recursive - Set to true to export all Tags under each Tag path, including Tags in child folders. Defaults to true. [optional]

String exportType - The type of file that will be exported. Set to "json" or "xml". Defaults to "json".     

  • Returns

Nothing

  • Scope

Gateway, Vision Client, Perspective Session

Panel
titleCode Examples
Code Block
languagepy
titleCode Snippet
# This example attempts to export the entire Tag Provider, including UDT definitions. 

# The filepath is Operating System dependent, so the path notation below may differ based on where the function is called from.
filePath = 'C:\\Users\\myUser\\Desktop\\myTags'			
tagPaths = ["[default]"]
recursive = True

system.tag.exportTags(filePath, tagPaths, recursive)
Code Block
# Exports the entire tag provider named "default" as a string, and 
# returns the string to a "tags" variable. 
tags = system.tag.exportTags(tagPaths = ["[default]"])
Panel
titleKeywords

system tag exportTags, tag.exportTags