Introduction
...
Getvisibility agent allows to manually tag a document with a set of classification tags. This command will trigger the agent to write a metadata tag to a file, with a standard getvisibility metadata format.
Default Tag Types
Default Tag Types for tagsets is as below:
Classification = categorical
Distribution = categorical
Compliance = binary
When tagType=binary; true/false should be used in command.
Command format
$ GVClient.CLI.Windows.exe"<file name>" --silent --save --tag
<classificationConfigurationId>/Classification/<tag> Optional
--tag <distributionConfigurationId>/Distribution/<tag>
--tag <complianceConfigurationId>/Compliance/<tag>
Sample command
| Code Block |
|---|
GVClient.CLI.Windows.exe "C:\Users\Downloads\CLI Test\CLI-1.pptx" --silent --overwrite --save --tag e16409a7-1700-4153-9090-3955bc2f0ae8/Classification/Confidential --tag f14fc1f1-8950-40d5-8a29-45909da947d6/PCI/true |
Executable parameters:
silent - Optional. Silent executes the command in the background.
save - Optional. A “Save” parameter is required to write changes to the files. W/o “save” the commands are executed in a “dry-run” mode
tag - Optional. Tag parameter specifies what labels to write to a file. For example “--tag e16409a7-1700-4153-9090-3955bc2f0ae8/Classification/Confidential” will write a Confidential tag from the “e16409a7-1700-4153-9090-3955bc2f0ae8” Classification TagSet.
map-external - Optional. Map-external will use the mapping specified in the configuration under the “externalLabelMappings” stanza, as shown in the screenshot below. This parameter checks file’s metadata with the regex specified in the configuration and applies a GV label specified in tagset and tag sections of the externalLabelMapping stanza of the configuration.
overwrite - Optional. Overwrite means to disregard all existing GV tags inside of a file. For example if we want to tag a file, and a file is already tagged by GV, then we won’t overwrite GV tag if the overwrite option is specified.
