Knowledge Discovery 26.1
Document Security Administration Guide

# Construct the Text File

This section describes how to construct a text file containing user and group information in a format that can be imported into OmniGroupServer.

The structure of the file should follow these rules:

- Each line that is processed should have the following syntax:

      #<COMMAND> <CSV>

  where,

  `<COMMAND>` is one of the commands listed in Text Commands.

  `<CSV>` is a comma-separated list of users or groups to which the command is applied.

  NOTE: The commands `INITIALIZE`, `NESTEDGROUPS`, and `FINALIZE` do not require the `<CSV>`.

  For example:

      #USER User1,User2,User3

- Any line preceded by two slashes "`//`" is ignored.
- Blank lines are ignored.

- <CSV> entries must be either:

  - enclosed in "double quotes" with all "double quotes" in the string escaped (\)
  - listed without quotation marks, in which case commas must be escaped (\).

  For example:

  <CSV> entry | Specifies the user/group/name
  --- | ---
  `"ABCDE"` | `ABCDE`
  `"AB\"CDE"` | `AB"CDE`
  `"AB,CDE"` | `AB,CDE`
  `\"AB"CDE` | `"AB"CDE`
  `ABC"DE` | `ABC"DE`
  `ABCDE` | `ABCDE`
  `AB\,CDE` | `AB,CDE`
  `AB\CDE` | `AB\CDE`
  `AB\\\,CDE` | `AB\,CDE`
  `AB\\\CDE` | `AB\\CDE`
  `AB\\\\CDE` | `AB\\CDE`

- When you are using the text file with `action=import`, the presence or absence of the INITIALIZE and FINALIZE commands determines whether the group server uses the information to perform an incremental update:

  - to replace all the information in the OmniGroupServer repository with the information in the text file, use the INITIALIZE and FINALIZE commands at the start and end of the text file.
  - to do an incremental update using the information in the text file, do not use the INITIALIZE and FINALIZE commands at the start and end of the text file.

Copyright 2025 Open Text
Version 26.1 | Last updated January 2026

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery 26.1

Topic Title: Construct the Text File