Configuration

The Settings menu provides access to application-wide configuration options. Changes take effect immediately and are persisted across sessions.

Accessing Settings

Click Settings in the top menu bar of the application. The following options are available:

JSON Data Folder

By default, all data files are stored in the same folder as the application script. You can move them to any location — for example, a shared network drive so that team members share the same profiles and templates.

Changing the Data Folder

1. Click Settings > JSON data folder.
2. A folder browser dialog opens.
3. Select the desired folder and click OK.

The application immediately reads and writes all data files from the new location. Existing files in the old location are not moved automatically — copy them manually if you want to preserve your profiles and templates.

Files Stored in the Data Folder

⚠️ Note: If multiple team members point the application at the same shared network folder, they will share the same profiles and templates. Simultaneous writes from multiple instances can cause file conflicts — use this pattern only if members are unlikely to save profiles at the same time.

Language

The application supports multiple UI languages. All labels, button text, messages, and column headers switch when you change the language.

Switching Language

1. Click Settings > Language.
2. Select a language from the list.
3. The UI updates immediately — no restart is required.

Supported Languages

Adding a New Language

SharePoint ToolBox uses a JSON-based translation system. Each language is a separate JSON file in the lang sub-folder of the application directory.

File Structure

Translation File Format

{
  "Connect": "Verbinden",
  "Disconnect": "Trennen",
  "SaveProfile": "Profil speichern",
  "DeleteProfile": "Profil löschen",
  "GenerateReport": "Bericht erstellen",
  "Settings": "Einstellungen",
  "lang": "Sprache"
}

Steps to Add a Language

1. Copy en.json from the lang folder.
2. Rename the copy to the BCP-47 language tag (e.g., de.json).
3. Translate all values in the JSON file. Do not change the keys.
4. Save the file.
5. Restart the application (or toggle the language once to refresh the list).
6. The new language now appears in Settings > Language.

⚠️ Note: All keys present in en.json must also be present in the new translation file. Missing keys will fall back to the English string at runtime.

Templates and Profiles Folder (CLI Override)

You can specify the data folder at launch time using a command-line parameter, overriding the value stored in the configuration:

.\SharepointToolBox.ps1 -dataFolder "D:\SharedTeamData\SharepointToolBox"

Configuration Storage

The application's own settings (data folder path, selected language) are stored in:

{
  "dataFolder": "C:\\Shared\\SharePointToolBox",
  "lang": "fr"
}