Classic AEM On-Premise Installation Guide

Classic AEM is an Adobe Experience Manager setup in which both front-end and back-end are coupled and hosted in the Adobe environment. A site with React or Angular in the front-end is not classified as Classic AEM.

This guide will teach you how to install the Schema App Connector on your Classic AEM On-Premise system.

Step 1: Select Your Deployment Type in Schema App

Note: A project on Schema App consists of a group of URLs. Every site on AEM should have a configuration that is linked to a project on Schema App (i.e. one configuration for every AEM site).

1. Login to Schema App, select the appropriate project, and click the dropdown to access the settings.
2. Click "Add Website" and enter the base URL / Domain of your AEM website.
3. Under Deployment Settings, select Adobe Experience Manager.
4. In the Deployment Settings dropdown, copy the API Key and Account ID to your clipboard. This information will be required for registration on AEM. 

Step 2: Install Schema App AEM connector

Schema App provides AEM as a maven dependency you can include in your CI/CD process. You can find all versions of the Schema App Connector on Maven. 

To install the Connector, add the following to your pom.xml file.

<dependency>
   <groupId>com.schemaapp</groupId>
   <artifactId>schemaapp.all</artifactId>
   <version>[version_number]</version>
   <type>zip</type>
</dependency>

Step 3: Set up the Schema App Connector Configuration On AEM

1. Log in to Adobe Experience Manager.
2. Click on ‘Tools’ in the right menu bar.
3. Select the 'Cloud Services' and then select the "Schema App Connector" tile.
    
   
   
   
4. Click on the ‘Create’ button on the top right.
    
    
   
   
5. In the dialog box, enter your Account ID, API key and website URL (publisher), and select your deployment method of choice (JavaScript or Crawler). The deployment method you choose here should match your Highlighter deployment in Schema App.
   
   When you're done entering the information, click 'Connect to Schema App' to register the site.
    
6. If you've done everything accordingly, you should see a message indicating that your site has been registered with Schema App. From there, click 'Save' in the top right corner of the page.  
   
    
   
   
7. Your new configuration will now be listed on the left menu bar of the screen.
    
   

Now that you've set up the Schema App configuration on AEM, the next step would be to apply it to the required pages on your AEM site.

Step 4: Apply the Schema App Configuration to your pages

1. Go to your AEM home page.
2. Click on ‘Sites’.
    
3. Select the site that you want the configuration earlier created to apply to.
   
    
4. On the top menu bar, click ‘Properties’.
   
5. Click on the ‘Cloud Services’ tab.
   

    

    
6. Select the appropriate configuration created earlier in the drop-down menu.
   
7. Click Save and Close.
   

Step 5: Check if the metadata is added to the page

 
You can check if a meta data-page-path element is in the header element by following these steps.

1. Open any page of the website.
2. Right-click, then select ‘Inspect’
3. Search with ‘meta data-page' Schema App’, you should see the meta data path and the URL. 

Step 6: Verify if the Connector is working

Once the metadata is present in your header, wait for 5 minutes before verifying whether the Connector is performing as expected. 

Follow these steps to check if the Connector is performing as expected. 

1. Open any page of the website.
2. Right-click, then select ‘Inspect’.
3. Search ‘Schema App’ or 'JSON-LD.' If the integration is successful, you should see the required scripts with your account ID and any Schema Markup that has been authored for the site.
   
   
   

Permissions & Services 

The table below highlights the permissions and services that will be required for the Connector to work efficiently.