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 22 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
  • 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 platform. With Content integration, our goal is to get content onto the platform.


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.

β˜‘ 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.

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

After the meeting, 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. JUNO pulls a sample payload and reviews the initial mapping

Initially, the JUNO Integrations team pulls a sample payload to ensure we can access the endpoint.

Then once the Client team delivers the full mapping document, the JUNO integrations team reviews it. If they have any questions about the data, they bring them to the Client team and make revisions.

4. Sign off on the test

The JUNO team checks the attendee count in the sample payload and shares it with the client team. 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.

5. JUNO develops the integration

The JUNO Success Manager adds the Client team’s tags to the platform. The JUNO Integrations team creates an Integration Spec Document that the JUNO Development team uses to build the integration.

6. Review the testing environment (“Dev”)

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.

If needed, the JUNO Development team makes edits.

(tick) You will approve the testing environment.

7. JUNO deploys to the production environment (“Prod”)

The JUNO Development team pushes the build from the test environment (“Dev”) to the live production site (“Prod”).

8. Review the production environment

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

(tick) When you approve the final build, 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 Integration Mapping Document (to review only, not to complete)

Supporting resources:
πŸ–₯ Training video: How to use the Content Integration Mapping Document
πŸ“„ Example of a completed Content Integration Mapping Document check

2. Collecting content meeting

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

β˜‘ Agenda:

3. JUNO pulls a sample payload and reviews the initial mapping

Initially, the JUNO Integrations team pulls a sample payload to ensure we can access the endpoint.

Then once the Client team delivers the full mapping document, the JUNO integrations team reviews it. If they have any questions about the data, they bring them to the Client team and make revisions.

4. JUNO creates test content

The JUNO team uses sample data provided by the Client team to map and import test content.

5. Integrations meeting / Sign off on the test content

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

β˜‘ Agenda:

  • Review each tab of the Content Mapping Document.

  • Address questions from the Integrations Team.

  • Review the test content. The Client team signs off on the test content, if possible.

  • Discuss necessary edits.

  • Discuss a due date for edits and action items.

(tick) You will confirm that the test content was successful.

Your homework, due by the discussed date:
πŸ“„ Make edits to the Content Integration 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.

6. JUNO develops the integration

The JUNO Success Manager adds the Client team’s tags to the platform. The JUNO Integrations team creates an Integration Spec Document that the JUNO Development team uses to build the integration.

7. Review the testing environment (“Dev”)

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

If needed, the JUNO Development team makes edits.

(tick) You will approve the testing environment.

8. JUNO deploys to the production environment (“Prod”)

The JUNO Development team pushes the build from the test environment (“Dev”) to the live production site (“Prod”).

9. Review the production environment

The Client team reviews content on the production site to ensure it is correct.

(tick) When you approve the final build, the integration is complete!

  • No labels