6. Implement Tenant Settings

This section covers how to implement tenant settings that can be used to configure other tenant settings, pipeline steps and endpoints.

Tip

Install Dynamics CRM Connect, Salesforce Connect or Sitecore Connect for Salesforce Marketing Cloud to view how tenent settings are used in a provider and connector.

Tip

Use a code generator to create structs for template names and IDs, and field names and IDs to use in converters and pipeline steps. When template and field names are changed in Sitecore, the generated values are kept in-sync and compiler errors are generated when values are changed and not updated in converters and pipeline steps.

Steps

• 6.1. Add Tenant Settings Folder
• 6.2. Add Request Header Template
• 6.3. Implement Request Header
• 6.4. Set Request Header Standard Values
• 6.5. Add Request Parameter Template
• 6.6. Implement Request Parameter
• 6.7. Set Request Parameter Standard Values
• 6.8. Add Paging Template
• 6.9. Implement Paging
• 6.10. Set Paging Standard Values
• 6.11. Add Resource Template
• 6.12. Implement Resource
• 6.13. Set Resource Standard Values
• 6.14. Add Application Template
• 6.15. Implement Application
• 6.16. Set Application Standard Values
• 6.17. Add Tenant Settings Folders
• 6.18. Add Tenant Settings Root Branch

Note

Leprechaun is used with the DataExchange.csx script file to create the templates.cs file. The following code block is a sample of the generated code:

namespace DataExchange.Providers.RESTful
{
    using System;

    public partial struct Templates
    {

        /// <summary>
        /// Path: /sitecore/templates/Data Exchange/Providers/RESTful/Tenant Settings/Request Header
        /// </summary>
        public partial struct RequestHeader
        {
            public static readonly Guid TemplateId = Guid.Parse("{EDF0DCDD-E7EC-4B51-86D6-5BC7218ABDEB}");
            public const string TemplateName = "Request Header";

            public partial struct FieldIDs
            {
                public static readonly Guid HeaderName = Guid.Parse("{835BC979-A99D-4DB5-B9CF-3283C604259B}");
                public static readonly Guid HeaderValue = Guid.Parse("{851F32FD-0886-4EB8-A044-D8928C07AA7D}");
            }

            public partial struct FieldNames
            {
                public const string HeaderName = "Header Name";
                public const string HeaderValue = "Header Value";
            }
        }
    }
}