Search

CREATE DATANET_COMMAND_GUIDE

[:: Legends Of The Jedi ::]

Guide to Using Datanet Commands

ABOUT THE GUIDE
This guide is structured as a step-by-step tutorial to help you master the
usage
of Datanet commands. It covers both basic and advanced techniques, providing
detailed explanations for each command and its parameters. The guide includes
specific information on how restrictions work in regards to conditions such as
equals division and greater than or equal to rank.

COMMANDS

Viewing Pages
To view a page in the clan database:
datanet view <path>

Searching
To search for pages within the clan database:
datanet search <keywords>

Editing Pages
To edit an existing page in the clan database:
datanet edit <path>

Creating Pages
To create a new page in the clan database:
datanet edit --title "<title>" <path>

Deleting Pages
To delete a page from the clan database:
datanet delete <path>

Access Restrictions
Restrictions allow you to control access to specific paths within the clan
database. You can customize access based on conditions such as equality,
division, and rank. Here are some examples:

View Restrictions
To restrict view access to a specific path:
datanet --root restrict view add <path> allow <condition>

Edit Restrictions
To restrict edit access to a specific path:
datanet --root restrict edit add <path> allow <condition>

Conditions
name eq <position>: Matches the specific position within the clan (leader,
first, second).
division eq <division number>: Matches a specific division within the clan.
rank <operator> <rank number>: Matches a specific rank within the clan
hierarchy. Operators include eq (equals), gt (greater than), lt (less than),
gte
(greater than or equal to), lte (less than or equal to).

Modifying Default Chain Behavior
By default, chains deny access unless otherwise allowed. You can modify the
default behavior using the default subcommand:
datanet --root restrict <command> default <path> <action>

Viewing Restrictions
To view existing restrictions:
datanet --root restrict <command> view all

Examples

Setup a private space for the clan leaders where other members can't view,
search, or edit:
datanet --root restrict view /private/leadership/ add allow name eq leader
datanet --root restrict view /private/leadership/ add allow name eq first
datanet --root restrict view /private/leadership/ add allow name eq second
datanet --root restrict edit /private/leadership/ add allow name eq leader
datanet --root restrict edit /private/leadership/ add allow name eq first
datanet --root restrict edit /private/leadership/ add allow name eq second

Setup a private space for division 1 to be able to view and edit, where anyone
in that division can view but only those of rank 5 or higher can edit:
datanet --root restrict view /private/security/ add allow division eq 1
datanet --root restrict edit /private/security/ add allow rank gte 5