How Outlook calendar sync works
A calendar sync belongs to one person. Every 30 minutes, Teamhood reads that person’s chosen Outlook calendars with their own Microsoft account and writes one item or one reservation for each event. The sync runs while the person has Teamhood closed, and Teamhood never writes to Outlook.
Which events a sync copies
Section titled “Which events a sync copies”- Teamhood reads from the start of today for the sync’s Days ahead.
- Cancelled events, events shown as free and confidential events are left out.
- An event with no attendee but the organizer is an appointment. Any other timed event is a meeting.
- Meetings you accepted includes meetings you organize. Meetings you have not declined also includes tentative meetings and meetings you have not answered.
- A meeting that is in two of the chosen calendars is copied once.
What an event becomes
Section titled “What an event becomes”- An item gets the event’s title, Start, Finish and Estimate, and its description from the event’s text.
- A reservation is reserved time on your own Schedule lane, labelled with the event’s title. A tentative event makes a tentative reservation.
- With Show as Busy, the title is Busy and the item gets no description. A private event is titled Private and gets no description.
- A timed event’s title starts with its start time.
Your changes and the sync’s
Section titled “Your changes and the sync’s”The sync writes as you, with your permissions. If your role can no longer create items of the sync’s type, or reservations, the sync fails and writes nothing. Its changes show via Outlook in an item’s activity.
The sync changes an item only when its event changes. If you edit an item’s title or dates, your edit stays until someone edits the event in Outlook.
When an event goes away
Section titled “When an event goes away”- When an event is cancelled, declined, deleted or no longer matches the sync, its item moves to the Trash. Its reservation is deleted.
- Past events are not read again, so their items and reservations stay as they are.
- If Teamhood cannot read one of the sync’s calendars, for example because it is no longer shared with you, the sync stops and changes nothing until you edit its calendars.
- If you delete an item or a reservation that a sync made, the sync does not make it again.
- With a done status set, the sync sets an item to it once, after its event ends. If you move the item back, the sync leaves it.
An example
Section titled “An example”Ana syncs her calendar into items of the type Meeting, under the project Launch. On Monday she accepts a review on Thursday morning. Within 30 minutes, a Meeting item for the review appears under Launch, assigned to Ana, with the review’s start time at the front of its title. On Wednesday the organizer cancels the review, and the item moves to the Trash.
Pausing, deleting and disconnecting
Section titled “Pausing, deleting and disconnecting”- A paused sync copies nothing until you resume it.
- Deleting a sync, or disconnecting your Microsoft account, keeps every item and reservation it made.
- When Microsoft ends your sign-in, your syncs show Needs reconnecting until you reconnect.
- If your organization requires two-factor authentication and you have not turned it on, your syncs wait until you do. A sync you set up while signed in through an identity provider, such as Microsoft, keeps running.