Set up a custom communication type

PDF
Beginner

You can customize communication options in Creatio version 8.0.9 Atlas and later.

In Creatio, you can manage the communication options and addresses of contacts and accounts on their form pages in the Customer 360 app. Manage the communication options in the top left and manage the addresses on the Contact info tab. Learn more: Manage communication options and addresses in Freedom UI.

General procedure to set up a custom communication type:

  1. Create a custom communication type. Read more >>>
  2. Bind the communication option to a communication type. Read more >>>
  3. Add an icon to the custom communication type (optional). Read more >>>

Detailed example: Add a custom communication type.

1. Create a custom communication type 

  1. Open the Lookups section. To do this, click in the top right → System setupLookups.
  2. Create a lookup.

    1. Click New lookup.
    2. Fill out the lookup properties.

      Property
      Property description
      Property value
      Name
      An arbitrary name of a lookup
      Communication types
      Object
      The lookup based on the Type of Communication object includes all communication types from the [Communication] database table.
      Type of Communication
    3. Save the changes.
  3. Open the Communication types lookup.
  4. Click New.
  5. Fill out the properties of the custom communication option.

    Property
    Property description
    Name
    An arbitrary name of a custom communication option
    Code
    An arbitrary code of a custom communication option
  6. Save the changes.
  7. Refresh the page that contains the custom communication type.

As a result, the custom communication type will be created.

2. Bind the communication option to a communication type 

Instructions: Bind the communication option to a communication type.

As a result, the custom communication type will be added to contact and/or account page.The communication option is displayed on a page without bound communication type if the communication type includes only 1 communication option. The communication option is displayed on a page with bound communication type if the communication type includes 2 or more communication options.

3. Add an icon to the custom communication type (optional) 

Instructions: Add an icon.

As a result, Creatio will add the icon to the custom communication type.

Add a custom communication type
Easy

The example is relevant to Creatio version 8.0.9 and later.

To implement the example:

Step 1: Create a custom communication type. Read more >>>

Step 2: Bind the communication option to the communication type. Read more >>>

Step 3: Add an icon to the custom communication type. Read more >>>

Example. Add the Other communication type to contact page. Bind the existing Email, Skype, and Web communication options to the Other communication type. Use the icon for custom communication type.

1. Create a custom communication type 

  1. Open the Lookups section. To do this, click in the top right → System setupLookups.
  2. Create a lookup.

    1. Click New lookup.
    2. Fill out the lookup properties.

      Property
      Property value
      Name
      Communication types
      Object
      Type of Communication
    3. Save the changes.
  3. Open the Communication types lookup.
  4. Click New.
  5. Fill out the properties of the custom communication type.

    Property
    Property value
    Name
    Other
    Code
    Other
  6. Save the changes.
  7. Refresh the page that contains the custom communication type.

As a result, the Other custom communication type will be created.

2. Bind the communication option to the communication type 

  1. Open the Lookups section. To do this, click in the top right → System setupLookups.
  2. Open the Communication option types lookup.
  3. Open the communication option page. To do this, click on the Email communication option.
  4. Unbind the communication option from other communication types to switch the communication option to the Other communication type.

    1. Select all records on the Communication types detail.
    2. Click Delete.
    3. Confirm the deletion.
  5. Clear the Use for accounts checkbox.
  6. Add a communication type for the communication option. To do this, click on the Communication types detail.
  7. Select the Other checkbox.
  8. Save the changes.
  9. Repeat steps 3–8 for the Skype and Web communication options.

As a result, the Other communiсation type will be added to contact page. The Email, Skype, and Web communication options will be switched to the Other communication type.

3. Add an icon to the custom communication type 

  1. Make sure the icon meets the requirements. Instructions: Add an icon (step 1).
  2. Upload an icon to the [SysImage] database table.

    1. Create the Image upload Freedom UI app. Instructions: Create an app.
    2. Open the Image upload form page Freedom UI page.
    3. Add the Image type field to an arbitrary place on the Freedom UI page. Leave default field parameter values.
    4. Save the changes.
    5. Open the Image upload app page and click Run app.
    6. Click New on the toolbar of the Image upload app list page.
    7. Fill out the image properties.

      Property
      Property value
      Name
      Image_1
      Click to upload the icon.
    8. Save the changes.
  3. Find the icon ID.

    1. Open the Lookups section. To do this, click in the top right → System setupLookups.
    2. Create a lookup. To do this, click New lookup on the Lookups section toolbar.
    3. Fill out the lookup properties.

      Property
      Property value
      Name
      Images
      Object
      Image
    4. Save the changes.
    5. Open the Images lookup.
    6. Set up the lookup list. To do this, click ViewSelect fields to display on the lookup toolbar.
    7. Add the column to the lookup list. To do this, click → select the Id column → Select.
    8. Save the changes.
    9. View the icon ID in the Id column.
  4. Bind the icon ID to the communication type.

    1. Open the Configuration section. Instructions: Open the Configuration section.
    2. Select a custom package to add the SQL script.
    3. Add temporary SQL script. To do this, click AddSQL script on the section list toolbar.
    4. Fill out the SQL script properties.

      Property
      Property value
      Code
      UsrAddIconForCommunicationTypeMSSQL
      Installation type
      AfterPackage
      Backward compatible
      Select the checkbox
    5. Add the following SQL script in the Script Designer.

      UsrAddIconForCommunicationTypeMSSQL
      update "Communication"
          set "ImageLinkId" = '1bb30ed3-8a2b-8225-4c13-aad2700af726'
      where "Name" = 'Other'
      

      where:

      [Communication] is the database table that stores communication types.

      1bb30ed3-8a2b-8225-4c13-aad2700af726 is the icon ID from the Images lookup (i. e., icon from the [SysImage] database table).

      Other is the communication type from the Communication types lookup (i. e., communication type from the [Communication] database table) to bind an icon.

    6. Save the changes.
    7. Install the SQL script. To do this, click Install in the section list for the UsrAddIconForCommunicationTypeMSSQL.
    8. Confirm the installation.

As a result, the icon that has the 1bb30ed3-8a2b-8225-4c13-aad2700af726 ID will be added to the Other communication type.

View the result 

  1. Open a contact page. For example, Alexander Wilson.
  2. Click Add communication optionOther.

As a result, Creatio will add the icon to the Other communication type that will be displayed on the contact page. The Other communication type will include the Email, Skype, Web communication options. View result >>>

Source codes 

update "Communication"
    set "ImageLinkId" = '1bb30ed3-8a2b-8225-4c13-aad2700af726'
where "Name" = 'Other'