Utility provides the capability to import/export OpCon Vision workspaces (cards definition) between OpCon environments.
No Support and No Warranty are provided by SMA Technologies for this project and related material. The use of this project's files is on your own risk.
SMA Technologies assumes no liability for damage caused by the usage of any of the files offered here via this Github repository.
- Uses the opCon API to perform the functions, so an opCon-API license is required
- Requires Java version 11.
- embedded OpenJDK included in installation zip file.
Vision ImpEx provides the mechanism to move Vision Definitions between OpCon Systems.
- It uses the OpCon-API to perform these functions.
It consists of a single program VisionImpex.exe
Is used to export and import Vision definitions from an OpCon System.
The export capability extracts information at the top Group Tag level and all tags associated with the group and writes this to a Json file.
The import capability is used to insert Vision definitions from a definitions file into OpCon System. The import program merges the information contained in the definitions file with the data already defined on the OpCon System. It should be understood that when the program starts, a copy of the existing Vision definitions are extracted from the OpCon System and the this is merged with the definitions in the definitions file. Once completed the definitions are written into the OpCon system.
It supports the following arguments.
- -url : The url of the OpCon System (https://: or http://:).
- -t : The task to execute (values cexport or cimport).
- -u : The name of an OpCon user that has the appropriate OpCon-API privileges (best to use a user which is a member of the Ocadm group).
- -p : The password of the OpCon user (best to execute program from within OpCon and use encrypted property for password protection).
- -odir : (cexport option) The name of the directory where the exported file information will be saved. The program creates a single file containing the action, frequency and card definitions. A file name consisting of VISION_EXTRACT_ and a timestamp (format yyyyMMdd_HHmmss) is created in the output directory (example VISION_EXTRACT_20200317_081140.json).
- -gn : (cexport option) Optional argument defining the name(s) Groups to extract at the top Group Tag level (multiple names should be comma seperated - default is all).
- -idir : (cimport option) The name of the directory that contains the file information to import.
- -f : (cimport option) The name of the file containing the definitions to import (example VISION_EXTRACT_20200317_081140.json).
- -debug : Set program into debug mode.
Example :
<install_dir>\VisionImpex.exe -t cexport -url "https://bvhtest02:9010" -u "ocadm" -p "[[password]]" -odir "<install_dir>\data" -gn "LzLabs Demo,Critical" -debug
<install_dir>\VisionImpex.exe -t cimport -url "https://bvhtest02:9010" -u "ocadm" -p "[[password]]" -idir "<install_dir>\data" -f "VISION_EXTRACT_20200317_081140.json" -debug
Download vision_deploy.zip file from the desired release by selecting and saving the file. After download create a installation root folder and then extract the information from the downloaded file into the created installation directory.
Copyright 2019 SMA Technologies
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
We love contributions, please read our Contribution Guide to get started!
