Application Branding

From AgileApps Support Wiki

Here, you learn how to customize the application banner with your company name and logo, how to Customize Your Email Templates, and how to rename the predefined objects that come with the platform.

Add Your Logo, Company Name, and Custom Feeds

The first step is to make sure your users and visitors see an interface that includes your organization's name and logo.

  1. Open the ServiceDesk application
  2. Go to GearIcon.png > Channels > Service Portal
    (Branding changes made here apply to all applications.)
  3. In the Branding section, specify:
    Header Logo
    Upload your organization's logo image.
    Standard logo size is 98 pixels wide by 24 pixels high
    A realistic maximum size is up to 600 pixels wide by 32 pixels high
    Even at 32 pixels high, only very simple images and stylized text are readable.

    Web Site Url
    Enter the URL the users go to when they click on your logo.
    (Typically, that will be your organization's web site.)

    Upload a small favicon image that displays in the browser's address bar,
    in bookmarks, and in browser tabs.

    Mobile Logo
    Upload an image that will be seen by users who access the portal over a mobile device.

    Announcement Widget
    Specify the title and HTML text for a welcome message or any other announcement
    you would like to make on this page.

    Page Background Color
    Select a background color that matches your organization's theme.
  4. While you're here, note that the Email Templates section contains links to the templates for messages that portal users will see. (You'll do some customizing momentarily. For now, just note where they are.)
  5. Click [Save]
For a complete list of Service Portal configuration options, see the Service Portal Settings.

Customize Your Email Templates

Add Team Information to the Global Template Variables

The first step in customizing your email templates is to make sure that they contain the right name and email addresses. Variables have been defined for just that purpose, so you need to make the changes in only one place. To modify the variables:

  1. Go to GearIcon.png > Customization > Template Variables
  2. Click [Manage Custom Template Variables]
  3. Modify the first three default variables:
    Support Team Name
    Put the name of your support team here, so messages recipients know who the message is coming from.

    Support Team Email Address
    When users reply to a case-related message, their comments are automatically recorded as part of the case. This address lets them send messages to the support group for everything else.

    Support No Reply Email Address
    Some messages are informational, and do not allow replies. Use this value to display something for your users to see. For example:
  4. Add any other variables you need for use in multiple templates.
  5. Click [Save]

Add Your Logo and other Information to the Templates

With the template variables set up, the default email templates are perfectly usable, just as they are. They aren't very stylish, however! To add a logo, additional text, and additional styling, you'll want to modify the templates:

  1. Go to GearIcon.png > Case Management > Email Templates to see a list of all email templates used in the system.
  2. Go to GearIcon.png > Channels > Service Portal to modify the templates that are used by the Service Portal.
  3. Go to GearIcon.png > Customization > Objects > {object} > Email Templates to make changes to email templates defined for other objects


Tip: When you're done making changes to a template, be sure to click [Save] at the bottom of the page.

Change the Name of Predefined Objects

The concept of "Case Management" covers many different areas of activity. While many organizations work with things called "cases", others work with things called "Incidents", or "Investigations"--or they may have some other name entirely for the unit of work that comes in, gets handled, and then goes back out as "completed". They all work in fundamentally the same way--with defined processes, business rules, data forms, email communications stored in a history, and associated documents--but it's helpful for users if the interface gives them names they recognize.

In the AgileApps Cloud platform, the names displayed in the ServiceDesk can be modified to suit your organization. The label used for the Cases object can be changed, along with the labels used for Tasks, Contacts, and other objects.

Change the Object Name

  1. Go to GearIcon.png > Customization > Objects > {object} > Object Properties
  2. You now have two options:
    • You can change the name of the object, if you like. The advantage is that any code you write will use the new object name. The disadvantage is that you will have to modify any and all Email Templates and Document Templates defined on the object, and change the names of the template variables they refer to--since those names all contain the object label (for example: $cases.description).
    • The more common solution is to change the Plural and Singular labels defined for the object. For cases, for example, those labels are "Cases", and "Case", respectively. Those changes affect the UI that users see. Template variables and code, on the other hand, continue to use the object name. As an added plus, code samples you get from others or find on the wiki will work with fewer modifications.

Reviewing the interface, you will see that many of the labels and buttons that the user sees automatically reflect the change. There are some things that don't change, however. The next steps change those.

Change View Names

Looking down the sidebar, you'll see that the predefined views are still using the old object names. For example: "All Active Cases" and "Open Team Tasks". You'll want to change those to match your object name.

If you don't need most of the views, do the following:

  1. Do a "Save As" on the views you wish to keep, and change the name.
  2. Then, for each the original views:
    • Edit the view as the administrator
    • Click [Save]
    • Change visibility to Visible to me only
    • Click [Save] again

If you want to keep most of the default views, use the Translation Workbench:

  1. Go to GearIcon.png > Administration > Account Management > Translation Workbench
  2. Select the language (there may only be one).
  3. Under Elements, choose Views
  4. For Tasks, under View Type, choose Other Views.
  5. For Cases and other objects, choose Object Related Views, and then select the object in question.
  6. Click [Edit]
  7. Specify "translated" labels to use for the predefined views.
  8. Click [Save]

Change Field Labels

Most of the time, the default field names are fine. But there are times when the field name appears in the column heading, when a list of records is displayed. For example, when displaying a view of Case records, one of the column headings is Case Channel (the "channel" by which the case arrived--by email for example, or after it was entered by a case agent).

  1. Go to GearIcon.png > Administration > Account Management > Translation Workbench
  2. Select the language (there may only be one).
  3. Under Elements, choose Fields.
  4. Under Objects:
    • For Cases, choose Case Folder. (The object from which all case types are inherited. The Cases object contains custom fields, only.)
    • For other objects, choose the object name.
  5. Click [Edit]
  6. Specify "translated" labels to use for the predefined fields.
  7. Click [Save]