Add Component Tool

Add Component Tool programmatically adds components to an existing HMI project without having to use FactoryTalk View Studio.
For FactoryTalk View ME version 15.0 or later, use the tool located in C:\Program Files (x86)\Rockwell Software\RSView Enterprise\SEAddComponent.exe.
The tool has the following command line usage:
SEAddComponent applicationName applicationType areaName componentListFile [/U username] [/P password] [overwrite]
User authentication
Add
/U
 and
/P
 parameters to a specific user for user authentication. The user must have the application level Read, List Children, Create Children, Write, and Delete security permissions to run the command and add components successfully. Azure AD or OpenID Connect user accounts are not supported.
/U username
This parameter is an optional parameter that specifies the user name to sign in.
/P password
Parameters are case-insensitive. If a specified value includes a space, enclose the value in quotation marks.
TIP: If
/U
 and
/P
 are omitted and only single sign-on is enabled, it can do the user authentication. First, it uses the current user who signed in to FactoryTalk Directory to do the authentication. If no user is signed in, it will use the current Windows system signed-in user to sign in FactoryTalk Directory and do the authentication with that user. When single sign-on is disabled, use
/U
 and
/P
 to specify a valid user to run the command.
Command parameters
  • applicationName
     is the name of the
    FactoryTalk View ME
     application that contains the HMI project where components will be added. Quotations will be needed if the name contains any spaces.
  • applicationType
     is
    ME
    .
  • areaName
     is the name of area where the HMI project is located. For ME, set the area name to /.
  • componentListFile
     is the full path to an XML file containing a list of components to add. Quotations will be needed if the path contains any spaces.
  • overwrite
     is an optional parameter that, if present, will allow existing component files to be overwritten. If this parameter is not present, the existing component files will not be overwritten.
Example
SEAddComponent MyApplication ME / "C:\MEFiles\Files.xml" overwrite
Remarks
  • The component file must not have the
    Hidden
     file attribute set.
  • The component file name must not contain any of the following characters:
    % . " : ? * < > # { } - [ ] ’ \ / ; = & +
  • A log file is generated describing the results of the tool execution. This log file is saved in the same folder as the component list file and it is named
    $AddComponent.txt
    .
  • When importing a tag CSV file, a log file is saved in the same folder as the component list file. The log file is named
    HMIProject
    .log
     where
    HMIProject
     is the HMI project name. For example, for the HMI project TagImportServer, the corresponding log file is TagImportServer.log.
  • When the tool has completed execution, it returns one of the following codes:
    • 0 = successful completion
    • 1 = any error occurred during execution
  • When adding a language file, the HMI server must be loaded and in the
    Active
     state.
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.
Normal