Configure Post Connectors for Third-Party Integration

Prerequisites

• An Appspace Account Owner or Publisher that has been assigned a Platform User license.

Create and Configure Beezy Connectors

Follow the instructions below to create and configure connectors.

1. Log in to your Appspace console.
2. Click Integrations from the ☰ Appspace menu, and click Connectors.
3. Click +Create, and select Beezy and click Next.
   
   
   
4. In the Setup Connector section, complete the following:
   • Name – Enter the name of the connector.
   • Passpport* – Select the existing passport or create a new passport. 
   • Entity* –  
   • Beezy Topics or Channels* – Choose your preferred topics or channels. 
   • Permissions – Choose your preferred publisher.
5. Once done, click Next.
6. In the Map Properties section, property mapping in the backend is automated, allowing you to advance in the setup process by either clicking the ‘next’ button or configuring optional settings by toggling them ON or OFF.
7. Once done, click Next.
8. In the Define Output section, complete the following:
   1. • Post Editing Permissions: (New)
        • Allow Editing – This allows editing in Appspace. Once edited, the post will be unsynced from the source connector and will no longer receive updates.
        • Do Not Allow Editing – This will block editing in Appspace, and all updates will come from the source connector.
      • Click Add another and you may do the following:
        • Feed – Select the feed (Topics or Channels) where you want content from your lists will be published.
        • Rules – Create rule for the content that will be posted as followed:
          • Rule – Include or Exclude.
          • Property – Select the property to filter by:
            • • • Title
                • Caption
                • Article
                • Author Email
                • Referral URL
                • Attachment
                • Start Schedule
                • End Schedule
                • Tags
                • Featured
                • Featured Start Date
                • Featured Number of Days
                • Sharepoint List
            • Operator – Choose the desired operator:
              • • • Equals
                  • Not Equals
                  • Contains
                  • Not Contains
                  • Is Empty
                  • Is Not Empty
            • Value– Enter the desired value.
        • Default Author – Search for the desired user.
        • Device App Template – Select the card template the content will be posted in.
9. Once done, click Save.

Create and Configure SharePoint Connectors

Follow the instructions below to create and configure connectors.

1. Log in to your Appspace console.
2. Click Integrations from the ☰ Appspace menu, and click Connectors.
3. Click +Create, and select SharePoint, and click Next.
   
   
4. In the Setup Connector section, complete the following:
   • Name – Enter the name of the SharePoint connector.
   • Passport – Select an existing SharePoint passport or create a new passport.
     Note

     When setting up the SharePoint connector, ensure that you use the “manage site permissions” option, as the SharePoint card’s passport will not be compatible.
   • SharePoint Site Collection – Select the SharePoint site you wish to import the list from.
   • SharePoint Lists – Select one or more lists from the selected site you want to connect to. 
5. Once done, click Next.
6. In the Map Properties section, complete the following:
   • SharePoint Lists tab – Each tab represents a SharePoint list that was selected in the Setup section. Only displayed if multiple lists were selected.
   • Select the post type from the drop-down menu:
     • User Post
     • Event Post
   • Source Filters: The connector pulls all content by default, thus you may want to define the Source Filter to filter any content that you may want or not want imported. Multiple content source filters may be added.
   • Proceed to map the  Source Property (SharePoint lists) with the corresponding Appspace Property (Employee App) from the drop-down menu.
     Note

     The following Appspace properties are required to be mapped:

     • Title
     • Start Date – Event Posts only
     • End Date – Event Posts only

7. Once done, click Next.
8. In the Define Output section, complete the following:
   1. • Post Editing Permissions: (New)
        • Allow Editing – This allows editing in Appspace. Once edited, the post will be unsynced from the source connector and will no longer receive updates.
        • Do Not Allow Editing – This will block editing in Appspace, and all updates will come from the source connector.
      • Click Add another and you may do the following:
        • Feed – Select the feed (playlist channel) you wish content from your SharePoint lists will be published to.
        • Rules – Create rule for the content that will be posted as followed:
          • Rule – Include or Exclude.
          • Property – Select the property to filter by:
            • • • Title
                • Caption
                • Article
                • Author Email
                • Referral URL
                • Attachment
                • Start Schedule
                • End Schedule
                • Tags
                • Featured
                • Featured Start Date
                • Featured Number of Days
                • Sharepoint List
            • Operator – Choose the desired operator:
              • • • Equals
                  • Not Equals
                  • Contains
                  • Not Contains
                  • Is Empty
                  • Is Not Empty
            • Value– Enter the desired value.
        • Default Author – Search for the desired user.
        • Device App Template – Select the card template the content will be posted in.
9. Once done, click Save.

Create and Configure Pull Connectors

Follow the instructions below to create and configure connectors.

1. Log in to your Appspace console.
2. Click Integrations from the ☰ Appspace menu, and click Connectors.
3. Click +Create, and select Pull, and click Next.
   
   
   
4. In the Setup Connector section, complete the following:
   • Name – Enter the name of the connector.
   • URL – Enter the URL from where the connector will be pulling content, and click Verify. This should be an XML or JSON format.
   • JSON or XML* – Optionally, you may upload your own schema for the JSON or XML feed format.
   • Pull Every – Determine the pull timer duration for the connector to check for new content.
5. Once done, click Next.
6. In the Map Properties section, complete the following:
   • Pull Lists tab – Each tab represents a list that was selected in the Setup section. Only displayed if multiple lists were selected.
   • Select the post type from the drop-down menu:
     • User Post
     • Event Post
   • Source Filters: The connector pulls all content by default, thus you may want to define the Source Filter to filter any content that you may want or not want imported. Multiple content source filters may be added.
   • Proceed to map the  Source Property (Pull lists) with the corresponding Appspace Property (Employee App) from the drop-down menu.
     Note

     The following Appspace properties are required to be mapped:

     • Title
     • Start Date – Event Posts only
     • End Date – Event Posts only

7. Once done, click Next.
8. In the Define Output section, complete the following:
   • Post Editing Permissions: (New)
     • Allow Editing – This allows editing in Appspace. Once edited, the post will be unsynced from the source connector and will no longer receive updates.
     • Do Not Allow Editing – This will block editing in Appspace, and all updates will come from the source connector.
   • Click Add another and you may do the following:
     • Feed – Select the feed (playlist channel) you wish content from your Pull lists will be published to.
     • Rules – Create rule for the content that will be posted as followed:
       • Rule – Include or Exclude.
       • Property – Select the property to filter by:
         • • • Title
             • Caption
             • Article
             • Author Email
             • Referral URL
             • Attachment
             • Start Schedule
             • End Schedule
             • Tags
             • Featured
             • Featured Start Date
             • Featured Number of Days
             • Sharepoint List
         • Operator – Choose the desired operator:
           • • • Equals
               • Not Equals
               • Contains
               • Not Contains
               • Is Empty
               • Is Not Empty
         • Value– Enter the desired value.
     • Default Author – Search for the desired user.
     • Device App Template – Select the card template the content will be posted in.
9. Once done, click Save.

Create and Configure Push Connectors

Follow the instructions below to create and configure connectors.

1. Log in to your Appspace console.
2. Click Integrations from the ☰ Appspace menu, and click Connectors.
3. Click +Create, and select Push, and click Next.
   
   
   
4. In the Setup Connector section, complete the following:
   • Name – Enter the name of the connector.
   • URL – Enter the URL from where the connector will be pushing content, and click Verify. This should be an XML or JSON format.
   • Push Connector Headers *  – Ensure all Push API requests are authorized.
     • Property Name
     • Key
   • JSON or XML* – Optionally, you may upload your own schema for the JSON or XML feed format.
   • Permissions – To identify all publishers unless specified otherwise. 
5. Once done, click Next.
6. In the Map Properties section, complete the following:
   • Select the post type from the drop-down menu:
     • User Post
     • Event Post
   • Source Filters: The connector push all content by default, thus you may want to define the Source Filter to filter any content that you may want or not want imported. Multiple content source filters may be added.
   • Proceed to map the  Source Property (Push lists) with the corresponding Appspace Property (Employee App) from the drop-down menu.
     Note

     The following Appspace properties are required to be mapped:

     • Title
     • Caption
     • Article
     • Author Email
     • Referral URL
     • Attachment
     • Start Schedule
     • End Schedule
     • Tags
     • Featured
     • ID

7. Once done, click Next.
8. In the Define Output section, complete the following:
   • Post Editing Permissions: (New)
     • Allow Editing – This allows editing in Appspace. Once edited, the post will be unsynced from the source connector and will no longer receive updates.
     • Do Not Allow Editing – This will block editing in Appspace, and all updates will come from the source connector.
   • Click Add another and you may do the following:
     • • Feed – Select the feed (playlist channel) you wish content from your Push lists will be published to.
       • Rules – Create rule for the content that will be posted as followed:
         • Rule – Include or Exclude.
         • Property – Select the property to filter by:
           • • • Title
               • Caption
               • Article
               • Author Email
               • Referral URL
               • Attachment
               • Start Schedule
               • End Schedule
               • Tags
               • Featured
               • Featured Start Date
               • Featured Number of Days
               • Sharepoint List
           • Operator – Choose the desired operator:
             • • • Equals
                 • Not Equals
                 • Contains
                 • Not Contains
                 • Is Empty
                 • Is Not Empty
           • Value– Enter the desired value.
       • Default Author – Search for the desired user.
       • Device App Template – Select the card template the content will be posted in.
9. Once done, click Save.