Gatekeeper Troubleshooting & Common Issues

Edited

Welcome to our guide on troubleshooting common Gatekeeper issues! If you've encountered problems with syncing data between your student information system (SIS) and FinalForms, you're in the right place. This article will help you understand the most common issues and provide simple solutions to get everything back on track.

Understanding Gatekeeper Issues

Most Gatekeeper issues arise from formatting differences, address mismatches, or contact configuration in the SIS. Fortunately, these problems can often be resolved by carefully reviewing the highlighted fields before syncing.

Common Issues and How to Resolve Them

Gatekeeper Icon Stays Yellow After Sync

If the Gatekeeper icon remains yellow after a sync, it typically indicates that one or more fields in the SIS did not update. Here's what you can do:

  1. Open Gatekeeper again.

  2. Review the fields highlighted in yellow.

  3. Correct any formatting or data mismatches.

  4. Sync again.

Address Formatting Differences

Minor differences in address formatting can prevent successful syncing. Common issues include:

  • Capitalization differences

  • Punctuation differences

  • Abbreviations vs. full words

Best practice: Ensure that addresses match exactly in both systems.

Parent Address Same as Student Issues

Some SIS platforms may clear parent addresses when the Same as Student flag changes. To resolve this:

  1. Sync the student again.

  2. Adjust the parent address to match the student exactly.

Extra or Unmatched Contacts

If a contact exists in the SIS but not in FinalForms (or vice versa), it may appear as unmatched. Here are some resolution options:

  • Correct names to match exactly.

  • Remove outdated contacts.

  • Sync again after cleanup.

Paired Contacts

Some SIS platforms support paired contacts (e.g., John & Jane Smith), which can lead to sync issues. Best practice: Use individual contacts whenever possible to avoid complications.

When to Contact Support

If you continue to experience issues, don't hesitate to reach out to FinalForms Support. You should contact us if:

  • You see repeated sync failures.

  • The SIS behavior is inconsistent.

  • You need help configuring converters.

Related Articles

We hope this guide helps you resolve any Gatekeeper issues you may encounter. Happy syncing!