Frontend

The frontend can be found by going to https://www.sandiego.edu/its/services/

Searching, Filters, and Sorting Entries

The frontend enables users to locate services by searching for or filtering the list of services. For instance, if someone is unaware that “Cascade” is the name of our internet content management system (“CMS”), searching for “web” will still list “Cascade Server” as an option.

Selecting the “options” dropdown under the search field allows for searching all content within a service entry as well as searching for exact text.

Additionally, a user can use the Category/Department, Keywords, or Audience options to filter the list of services.

The “View By” option allows users to display services in large tiles (the four boxes icon) or in a list (the two rectangles on top of each other).

The “Sort By” option allows users to order the list of services in alphabetical (A to Z) or reverse alphabetical (Z to A) order.

Clicking on the tile or list for a specific service will take the user to that service’s “Detail Page.” The Detail Page lists all of the relevant information about that service.

Open

Backend

The new Service Catalog’s UI is powered by Camino, while the data itself is part of the Service Catalog API.

To make edits to any of the services, including adding or removing a service, use the Service Catalog Manager (“SCM”) which you can access by going to https://www.sandiego.edu/manage20/service-catalog/ and using your USDOne login name and password to enter.

If you do not have access to the SCM, you can request access by going to sandiego.edu/web-requests and creating a ticket.

Adding a New Entry

If you need to add a new entry, click the “Add New” option at the top. This will open a blank Entry Editor. Fill in the necessary fields as needed for your entry and click the “Submit” button when your changes are complete to publish them on the live server.

In the Entry Editor, you will see the same 8 sections for every entry. They are:

Title: Name of the service.
Overview: Short description of the service which displays along with the title on the listing page.
Detail: The long description of the service which contains all additional necessary information.
Audience: The checkboxes for the service’s intended audience.
Category/Department: The category or department which the service falls under.
Keywords: Simple words or phrases you suspect a user might use to search for a service. For instance, a user might use the word wifi instead of Eduroam to find the “Wireless” service. The keywords field doesn’t appear until the Category/Department field has been set since the options presented in the keywords field are dependent on which category/department you selected.

Synonyms: Add comma-separated words to this text field to make it easier for user’s to find with their searches.
Type: Type can have one to all three options selected for a service. They are:
     Featured: Normally, the list of services is alphabetized, but this option displays a service at the top of the services list.
     Service Catalog: This option comprises all of the entries in the service catalog.
Status: The status can be set to “Active” to “Public” or to both. Marking an entry as “Active” will allow for the service to be displayed to anyone with a USDOne login. Adding it to “Public” will allow the service to display to anyone using the USD website.

To add content to either the Overview or Detail sections, click the Add content button. This will open the Component Selector.

Component Selector

For Overview, the only available component to select is the Text Component. But the Detail section allows you to select any of the following components:

Text
Accordion
Tabs
Media
Instructions
Notifications
Billboard

Selecting a component will display the Component Editor.

Each component has both some form of “lead” field (e.g. a Heading or Title field), at the top followed by either a Content or Description field below. You can add links or images to the Content/Description field.

The final option is generally the ability to add some kind of additional content field, like the Add Accordion items button for an Accordion Component (which will add another entry to the accordion), or an Add Tabs items button for the Tabs Component (which will add another tab). However, the Text, Notifications, and Billboard Components have Add Call to Action buttons instead that allow you to add a button to that section. You can specify the button text and the URL for the button.

Media Component

The Media Component does have several additional options when clicking its Add Media button.

Title: Allows you to include a short caption for your media, like another title.
Description: Allows for a short description of the media and allows for including links or images.
+Add Media: Don’t forget to be accessible! This is where you manually type in a description of the image or video you are linking to for people with vision impairments. For instance, “USD campus during summer.”
     Image or Video: Normally, the list of services is alphabetized, but this option displays a service at the top of the services list.
     Src: Short for “source,” this is where you copy and paste the URL for the media you want to use.
     Alt Text: Don’t forget to be accessible! This is where you manually type in a description of the image or video you are linking to for people with vision impairments. For instance, “USD campus during summer.”
     Caption: Allows for a small amount of text to be added beneath the media image or video.
     Heading: Allows you to include a short caption for your media, like another title.
     Description: Allows for a short description of the media and allows for including links or images.
+ Plus Icon: Allows for the addition of another instance of the same component. This is how you add multiple accordion entries to an accordion or multiple media to the same media component.
Trash Can Icon: This is how you remove a specific entry from a component. Once used, all the data within that entry is deleted. Not the entire component, just the specific entry.
Save: When all of your changes to the component are complete, click the Save text link at the bottom of the Component Editor.

Saving a New Entry

When all of your changes to the component are complete, click the Save text link at the bottom of the Component Editor.

After selecting a component for a specific section of your entry, you can add more components to the same section by clicking the plus icon next to the previous component. To remove a component, click the minus icon.

When all of your changes are made to a service entry, click the Submit button on the bottom to publish your entry.

Editing an Entry

Find the entry to edit.

Navigating the SCM is exactly like navigating the frontend. Searching, filtering, and sorting all use the exact same UI elements and function the same way as outlined in the Frontend section above for Searching, Filters, and Sorting Entries.

Once you have found the entry you need to edit, click that entry’s “Edit” link to enter the Entry Editor.

Editing an entry now works identically to the Add a New Entry section above.