Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 13 Next »

Status

NOT VISIBLE TO PUBLIC JDT-81 - Getting issue details... STATUS

Type

How to / Explanation

Reader

Clients

Reader goal

Understand the integration process so they know what to expect.

Contributors

Amira (info from internal doc)

JUNO version

Reviewers (check the box when you’re done!)

  • Amira
  • Gabe
  • Matt Merrill
  • Travis

Review deadline

Notes for reviewers

Integration is a way to transfer information from your data management system to your JUNO platform. The development of any integration is a team effort between the Client team and JUNO team. This guide outlines that process so that you know what to expect.

When to use integration

Integration is an alternative to importing users, using JUNO’s free registration, and/or importing content. It’s an extra cost that’s agreed upon in the contract process.

With API registration integration and Single Sign On (SSO) integration, our goal is to get users registered on the site. With content integration, our goal is to get content onto the site.


API registration or SSO integration process

The process is the same for both types of integrations.

Flowchart summarizing the 'API registration or SSO Integration Process,' which is fully outlined below the image.

1. Gather information after kickoff

We need to understand your data, data management system, and goals. This helps us get on the same page so that we can smoothly move data from your system into the JUNO system.

After the kickoff meeting, the JUNO Success Manager sends the Client team a Google form and allowlist to complete as homework.

Your homework, due by the Integrations meeting:

📄 API Registration Form or 📄 SSO Form
📋 Allowlist for Integrations

2. Integrations meeting

During the meeting, the JUNO Success Manager, JUNO Integrations Team, and Client team walk through the mapping document and requirements.

(tick) Agenda

  • Walk through the tabs of the mapping document.

  • Go over any specific access codes; Staff, Exhibitor, etc.

  • Discuss any specific dimensions JUNO should be pulling over from registration; City, Country, etc.

  • Discuss any business rules.

  • Discuss attendee communication (see above).

  • If JUNO is sending email/password or magic links, go over email template and if passwords will be randomly generated or universal.

  • The Client team will provide images and copy for the email template.

The JUNO Success Manager sends the Client team the mapping document and training video to complete as homework.

Your homework, due by your third meeting with JUNO:

📄 API/SSO Mapping Document
🖥 Training Video: How to use the API/SSO Mapping Document

3. Test the endpoint

  1. The JUNO team pulls the payload to ensure we can access the endpoint. They’ll check the attendee count, then share it with the Client team.

  2. If the Client team confirms the count is correct, it’s time for JUNO to begin coding.

(tick) You will confirm that this was successful.

4. Coding begins

Then we test the data to make sure everything works and you’re happy with how the integration is set up.

  1. The JUNO Success Manager gives the mapping document to the JUNO Development team. They also add the Client team’s tags to the platform.

  2. As the JUNO Development team codes, they might pass along questions to the Client team, or join a meeting.

5. Review

  1. On a weekly call, the JUNO Success Manager reviews a small sample of each user type with the Client team. Together, they look at the user information in the content management system, on the profile page and profile page editor, and in the directory.

  2. If needed, the JUNO Development team makes edits.

(tick) You will review and approve the mapping.

6. Final build

  1. The JUNO Success Manager makes sure JUNO team members are registered in the Client team’s system.

  2. The JUNO Development team pushes the build from the testing environment (.dev) to the live production site.

  3. The Client team tests users on the production site to ensure the integration is flowing correctly. 

(tick) You will test and approve the final build. Then the integration is complete!


Content integration process

Flowchart summarizing the 'Content Integration Process,' which is fully outlined below the image.

1. Gather information after kickoff

We need to understand your data, data management system, and goals. This helps us get on the same page so that we can smoothly move data from your system into the JUNO system.

After the kickoff meeting, the JUNO Success Manager sends the Client team a Google form and allowlist to complete as homework, along with a mapping document to review.

Your homework, due by the Collecting Content meeting:
📄 Content Integration Form
📋 Allowlist for Integrations
📄 Content Mapping Document (to review only, not to complete)

Supporting resources:
🖥 Training video: How to use the Content Mapping Doc
📄 Example of a completed Content Mapping Doc

2. Collecting content meeting

During the content meeting, the JUNO Success Manager and Client team discuss the mapping document.

(tick) Agenda:

3. Integrations meeting

Using the completed homework documents, the JUNO Integrations team pulls an initial payload of information before the meeting.

Then during the meeting, the JUNO Success Manager, JUNO Integrations Team, and Client team walk through the mapping document and requirements.

(tick) Agenda:

  • Review each tab of the Content Mapping Document.

  • Address questions from the Integrations Team.

  • Discuss necessary edits.

  • Discuss a due date for edits and action items.

Your homework, due by the discussed date:
📄 Make edits to the Content Mapping Document. Make sure to provide at least 1 piece of complete content per content type. Complete means that all fields that should be mapped are filled out with data.

4. Pull a sample payload

We test the data to make sure everything works and you’re happy with how the integration is set up.

  1. The JUNO Success Manager gives the mapping document to the JUNO Development team. They also add the Client team’s tags to the platform.

  2. The JUNO team pulls a sample payload and imports the sample onto the site. There are 2-3 pieces of content per content type.

5. Review sample

On a weekly call, the JUNO Success Manager reviews the content samples with the Client team. They look at the content on the site to make sure it looks correct. They note change requests for the JUNO Integrations team.

(tick) You will review the sample mapping.

6. Pull full payload

The JUNO team pulls the full payload and the JUNO Development team begins coding. If they have questions, they pass them along to the Client team or join a meeting.

7. Review full mapping

  1. On a weekly call, the JUNO Success Manager reviews the content with the Client team. They look at the content on the site to make sure it looks correct.

  2. If needed, the JUNO Development team makes edits.

(tick) You will review and approve the full mapping.

8. Final build

The JUNO Development team pushes the build from the testing environment (.dev) to the live production site. Integration is complete!

  • No labels