Academy / Week 2 / SyncApp Support Service / Basics of New Integration Implementation

Basics of New Integration Implementation

Lesson 8.7 ⏱ ~6 min Week 2

💡 Why This Matters

When you're assigned your first new integration ticket, you need to know exactly which files to touch and in what order. This lesson gives you the checklist for adding a new PMS integration to sync-app-support.

🎯 What You'll Learn

  • The provisioner list and how it's populated: the listProviders map and addProvisioner calls
  • register.go: the file where all provisioner registrations live
  • The minimum files to create for a new integration in sync-app-support
  • How to implement each required method on the provisioner interface for a new PMS
  • The integration between sync-app-support and sync-app-authentication for new integrations

Watch Video

Open in Google Drive 💡 Open in Drive for AI-powered transcript search and summaries

📋 Lesson Summary

When implementing a new integration in sync-app-support, start with register.go — add a call to addProvisioner with your new PMS's provisioner instance. Then implement the provisioner interface methods: Name (return the PMS name), Metadata (define required credential fields with types), Steps (document the setup steps), and Provision (implement validate → create data source → add settings → spin up). Look at an existing integration (e.g., DentalEMR) as a reference. All of these are with respect to sync-app-support; the SyncApp data fetching code itself lives in a separate repository.

🏷 Key Concepts

register.goaddProvisioner FunctionlistProviders MapProvisioner Interface MethodsNew Integration ChecklistReference Integration (DentalEMR)sync-app-support vs SyncApp Repo

Key Takeaways

01Start every new integration by adding a call to addProvisioner in register.go
02Use an existing provisioner (DentalEMR or similar) as your template — don't start from scratch
03The provisioner interface has four required methods — implement all of them before testing
04sync-app-support handles provisioning only — the actual data sync code goes in the SyncApp repo
05After implementing, test by going through the WAM 'Create Cloud Sync App' flow end-to-end