General settings
The CtrlTMS configuration has one section per concern: how it signs in to Microsoft Graph, the properties shared by teams and channels, one section each for teams, members and channels, the workflow that drives a team’s life cycle, and discovery. Every setting is listed at the foot of this page, and each section has a page of its own with the data type every setting accepts.
Graph configuration
Section titled “Graph configuration”Client ID, Client Secret and Tenant ID come from the Entra ID registration. Leave Authentication URL, API URL and API Version at their defaults, which point at the global Microsoft Graph. See Graph configuration.
Common, team, member and channel
Section titled “Common, team, member and channel”These sections name the vault structure CtrlTMS reads and writes, created in the vault structure step:
- Common Configuration holds the properties teams and channels share: whether one is active, its Graph ID and Graph URL, and the team a channel belongs to. See Common configuration.
- Team Configuration and Channel Configuration name the object type and class for each, and the properties for the display name, description, owners and members. A team also has a groups property, whose people are added to the team as members, and a property saying whether it is private. See Team configuration and Channel configuration.
- Member Configuration names the object type that represents people, such as Employee, and the property holding their email address, which is how CtrlTMS matches them to Microsoft 365 accounts. See Member configuration.
Channel types
Section titled “Channel types”A channel is standard, private or shared, and CtrlTMS records which in a lookup property. Create a value list with one item for each of the three types first. Then, under Channel Types, select that value list and the item standing for each type, and name the lookup in Channel Type Property. See Channel types.
Workflow
Section titled “Workflow”A team’s life cycle is a workflow. Moving a team into Create State starts its creation in Microsoft Teams. CtrlTMS moves it on to Created State and sets its Active Property to Yes when that succeeds, or to Error State with Active Property set to No when it fails. A team that already has a Graph ID, such as a discovered team or one whose creation failed after the team was made in Microsoft Teams, is not created again. It moves on to Created State, with Active Property set to Yes, only if its display name, description, owners, members or groups change in the same save, and otherwise stays in Create State.
Discovery puts the teams it finds in Discovered State and leaves their Active Property empty. CtrlTMS never moves a team into Archived State or Deleted State, and does not read whether Microsoft has archived or deleted one; those states are for a person or a workflow to set. The down-sync leaves out a team in Archived State, and any team whose Active Property is not Yes. See Workflow configuration.
Discovery
Section titled “Discovery”Discovery finds teams and channels that already exist in Microsoft Teams and creates them as objects in the vault. It runs as a background operation on Auto-run schedule, and the three switches decide whether it also brings in private teams, members and owners, and channels. See Discover configuration.
Down-sync interval
Section titled “Down-sync interval”Down-sync interval is how often CtrlTMS asks Microsoft Graph for changes to teams and channels and applies them to the vault.
Settings
Discover Configuration
Configuration for channel and teams discovery.
Down-sync interval
Interval for syncing changes from Microsoft Teams to the vault.
Main configuration settings, generated from CtrlTMS 0.25.6.0.