system.groups.loadFromFile

This function is used in Python Scripting.

Description

Loads a transaction group configuration from an xml export, into the specified project (creating the project if necessary). The mode parameter dictates how overwrites occur.

note

This function is scoped for Perspective Sessions, but since all scripts in Perspective run on the Gateway, the file must be located on the Gateway's file system.

Client Permission Restrictions

This scripting function has no Client Permission restrictions.

Syntax

system.groups.loadFromFile(filePath, projectName, mode)

Parameters

Type	Parameter	Description
String	filePath	The path to a valid transaction group xml or csv file.
String	projectName	The name of the project to load into.
int	mode	How duplicates will be handled. 0 = Overwrite, 1 = Ignore, 2 = Replace the existing project with this one.

Returns

Nothing

Scope

Gateway, Perspective Session

Code Examples

Example #1 - Loading a Transaction Group Into a Project

# Note that backslashes are used in Windows filepaths, but are also escaped in Python. Thus, we use the double-backslashes here.
path = "C:\\Users\\user\\Desktop\\group.xml"
 
projName = "MyProject"
 
# Read a Transaction Group from a file and overwrite any preexisting groups that match those in our file.
system.groups.loadFromFile(path, projName, 0)