POST Deployment v1.9.0

Audience targeting

MANDATORY

For the new version of Audience Targeting to work, it is necessary to update all the addons where you want to use this new functionality.

The necessary steps for each addon are explained below.

Adding columns in the Content Type

The first step is to add the new columns in the content type. To do this we have to download the addon design:

Open the Syntphony Settings
Go to This tenant
Go to Addons
Export the addons in which you want to use the new audience targeting

Once we have the Json downloaded, we will add the new columns in the content type.

Open the Json file and, in the contentType section, add the following columns at the end of the columns section:

{
    "numberOfLines": 10,
    "unlimitedLengthInDocumentLibrary": true,
    "uniqueId": "79e51135-d90e-41a9-8113-de54d45c4492",
    "title": "Audience",
    "name": "TogoAudience",
    "description": "Audience",
    "type": "Note",
    "defaultValue": "",
    "isBase": true,
    "searchProperty": "TogoAudienceOWSMTXT"
},
{
    "uniqueId": "cea45918-e8c9-48db-b377-e8cacc584b7c",
    "title": "Apply Audience",
    "name": "TogoApplyAudience",
    "description": "Apply Audience",
    "type": "Checkbox",
    "defaultValue": "False",
    "isBase": true,
    "searchProperty": "TogoApplyAudienceOWSBOOL"
},
{
    "uniqueId": "67d8a3b7-51b0-4097-bda6-230ea8eaee1e",
    "title": "Audience type",
    "name": "TogoAudienceType",
    "description": "Audience type",
    "type": "Text",
    "defaultValue": "",
    "isBase": true,
    "searchProperty": "TogoAudienceTypeOWSTEXT"
}

Save the file and go back to Syntphony to import the Json, overwriting the previous version:

Access Syntphony Settings
Go to This tenant
Go to Addons
Click on the Import button
Copy the Json or Upload the file
Save the changes by clicking on the Save button

Add new columns in the forms

The next step is to update all the forms to include the new columns and change the audience control.

Creation Form

We update the creation form:

Access the Addon we want to update
Go to Forms
Go to Creation
In the Design tab

Delete the sections named departments and locations
In the same position where the previous sections were, add the following code:

{
    "name": "audience",
    "type": "Audience",
    "locationField": {
        "name": "locations",
        "label": {
            "t": "forms.locations"
        },
        "description": {
            "t": "forms.locationsDescription"
        },
        "termSetNameOrID": "b49f64b3-4722-4336-9a5c-56c326b344d4"
    },
    "departmentField": {
        "name": "departments",
        "label": {
            "t": "forms.departments"
        },
        "description": {
            "t": "forms.departmentsDescription"
        },
        "termSetNameOrID": "8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f"
    }
}

In the Submit tab

Delete the sections departments and locations
Add the following code at the end:

"departments": "{audience.departments}",
"locations": "{audience.locations}",
"togoApplyAudience": "{audience.applyAudienceTargeting}",
"togoAudienceType": "{audience.audienceType}",
"togoAudience": "{audience.selectedAudiences}"

Edition Form

We update the edit form:

Access the Addon we want to update
Enter Forms
Go to Edition
In the Design tab

Delete the sections named departments and locations
In the same position where the previous sections were, add the following code:

{
    "name": "audience",
    "type": "Audience",
    "applyAudienceTargeting": "{fields.togoApplyAudience}",
    "selectedAudiences": "{fields.togoAudience}",
    "audienceType": "{fields.togoAudienceType}",
    "locationField": {
        "label": {
            "t": "forms.locations"
        },
        "description": {
            "t": "forms.locationsDescription"
        },
        "termSetNameOrID": "b49f64b3-4722-4336-9a5c-56c326b344d4",
        "value": "{base.locations}"
    },
    "departmentField": {
        "label": {
            "t": "forms.departments"
        },
        "description": {
            "t": "forms.departmentsDescription"
        },
        "termSetNameOrID": "8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f",
        "value": "{base.departments}"
    }
}

In the Submit tab

Delete the sections departments and locations
Add the following code at the end:

"departments": "{audience.departments}",
"locations": "{audience.locations}",
"togoApplyAudience": "{audience.applyAudienceTargeting}",
"togoAudienceType": "{audience.audienceType}",
"togoAudience": "{audience.selectedAudiences}"

Visualization Form

We update the display form:

Access the Addon we want to update
Enter Forms
Go to Display or Addon information depending on the case
In the Design tab

Delete the sections named departments and locations
In the same position where the previous sections were, add the following code:

{
    "name": "audience",
    "type": "Audience",
    "disabled": true,
    "applyAudienceTargeting": "{fields.togoApplyAudience}",
    "selectedAudiences": "{fields.togoAudience}",
    "audienceType": "{fields.togoAudienceType}",
    "locationField": {
        "label": {
            "t": "forms.locations"
        },
        "description": {
            "t": "forms.locationsDescription"
        },
        "termSetNameOrID": "b49f64b3-4722-4336-9a5c-56c326b344d4",
        "value": "{base.locations}"
    },
    "departmentField": {
        "label": {
            "t": "forms.departments"
        },
        "description": {
            "t": "forms.departmentsDescription"
        },
        "termSetNameOrID": "8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f",
        "value": "{base.departments}"
    }
}

Reprovision all communities

For the changes to take effect, it is necessary to re-provision all communities. For this purpose, a PowerShell script has been provided to help you update the configuration of all communities.

PRE Deployment 1.8.5