Creating and Maintaining Vocabularies
Note
This information is intended for the one or more business administrators, who are responsible for creating and maintaining the Pulse and Restricted Vocabularies.
These topics describe the Pulse and Restricted Vocabularies:
•
Understanding the Importance of the Vocabularies
•
Understanding the Vocabulary Used in Various Communication Tools
•
Guidelines for Creating the Pulse Vocabulary
•
Methods for Updating the Pulse Vocabulary
•
Guidelines for Creating the Restricted Vocabulary
•
Methods for Updating the Restricted Vocabulary
•
Summary of Rules for the Pulse and Restricted Vocabularies
•
Working with the Vocabularies
Understanding the Importance of the Vocabularies
Cisco Pulse supports two types of vocabularies: the Pulse Vocabulary and the Restricted Vocabulary. These topics describe the two vocabularies:
•
Pulse Vocabulary
•
Restricted Vocabulary
•
How Cisco Pulse Uses the Vocabularies
•
Structure and Format of the Vocabularies
Pulse Vocabulary
The Pulse Vocabulary contains terms that are integral to the organization in which Cisco Pulse is used. This vocabulary serves these important functions:
•
It is the means through which business administrators, who create and manage the vocabularies, can establish terms on which users can search and find expertise providers and related information, which includes documents and videos.
•
It is the means through which Cisco Pulse can initially attach users to a term, and for each Pulse Locator search on the term, locate expertise providers with the most recent activity with the term.
•
It is the means through which Cisco Pulse can initially attach documents and videos to a term, and for each Pulse Locator search on the term, locate documents and videos with the most recent and highest frequency of the term.
The Pulse Vocabulary forms the basis of Cisco Pulse, and as such, it is critical that it contains terms that are representative of the products, services, and values of the organization.
The business administrators must create the initial Pulse Vocabulary and upload the vocabulary to the system before Cisco Pulse is deployed. Guidelines for creating this vocabulary and an explanation of the structure and format in which a business administrator must upload the vocabulary to the system are provided.
The Pulse Vocabulary is a dynamic entity, and there are several ways in which terms are added, modified, and deleted:
•
Users can suggest new terms for inclusion in the Pulse Vocabulary. The business administrators must approve these suggestions.
•
Users can suggest synonyms for an existing term. The business administrators must approve these suggestions.
•
The business administrators can view, add, modify, and delete terms in the Pulse Vocabulary using the Vocabulary Settings task pane. Or, if there are a large number of updates, be aware that uploading a comma separated values (CSV) file containing the updates only overwrites the existing Pulse Vocabulary. Therefore, we recommend that a business administrator downloads the vocabulary in CSV format, makes the updates to the vocabulary using the Microsoft Excel application, and uploads to file back to the system.
Note
If using the Microsoft Excel application to modify Pulse or Restricted Vocabularies, be aware that the application might treat an alphanumeric entry such as "MAR 20" as a date and convert the entry to a format such as "20-Mar." To work around this issue, format that particular cell as text.
If a business administrator wants to add a new term to the Pulse Vocabulary, the term must adhere to rules described in "Summary of Rules for the Pulse and Restricted Vocabularies" section.
This topic provides more detailed information on the Pulse Vocabulary:
•
Understanding Term Groupings and Normalization
Related Topics
•
Restricted Vocabulary
•
How Cisco Pulse Uses the Vocabularies
•
Structure and Format of the Vocabularies
Understanding Term Groupings and Normalization
A term can be expressed in multiple ways, which includes but is not limited to these variations:
•
In lower-case letters, upper-case letters, or a mixture of the two.
•
Spelled out or as an acronym.
•
In singular or plural forms.
•
For multiple-word terms, with or without hyphens and character spaces between words.
The ability to define synonyms along with a term allows the Pulse Vocabulary to include term variations.
A term grouping is a root term in the Pulse Vocabulary and its associated synonyms. This is a sample term grouping:
•
Root term: Cisco Unified Communications Manager
•
Synonyms: Unified CM, UCM
Cisco Pulse normalizes, or reduces, each term grouping to one term that represents the others in the term grouping. Cisco Pulse uses the root term, or the term that is defined in the Term column of the Pulse Vocabulary, as the normalized term. For example, Cisco Pulse would use Cisco Unified Communications Manager as the normalized term for the sample term grouping.
The normalization of terms in a term grouping has these important impacts:
•
The Pulse tags stored in the Pulse Index are normalized terms.
•
My Top Tags and All Top Tags in the Tag Navigator gadget in the Home page display normalized terms.
Note
Given these impacts, it is imperative for business administrators to put thought and effort into effectively assembling terms and synonyms in each term grouping.
Cisco Pulse does not normalize terms that users enter in an Pulse Locator search.
Restricted Vocabulary
The Restricted Vocabulary contains sensitive terms or terms that are not eligible for analysis because of privacy or confidentiality concerns. If Cisco Pulse finds a Restricted Vocabulary term in content shared across the network, it immediately discards the content.
While having a Pulse Vocabulary uploaded to the system upon deployment of Cisco Pulse is mandatory, the creation of a Restricted Vocabulary and the timing of its deployment are up to the discretion of the organization.
The business administrators can create the initial Restricted Vocabulary. Guidelines on creating this vocabulary and an explanation of the structure and format in which a business administrator must upload the vocabulary to the system are provided.
All terms in the vocabulary must adhere to rules described in "Summary of Rules for the Pulse and Restricted Vocabularies" section.
The business administrators can view, add, modify, and delete terms in the Restricted Vocabulary using the Vocabulary Settings task pane. Or if there are a large number of updates, be aware that uploading a CSV file containing the updates only overwrites the existing Restricted Vocabulary. Therefore, we recommend that a business administrator downloads the Restricted Vocabulary in CSV format, makes updates using the Microsoft Excel application, and uploads to file back to the system.
Note
If using the Microsoft Excel application to modify Pulse or Restricted Vocabularies, be aware that the application might treat an alphanumeric entry such as "MAR 20" as a date and convert the entry to a format such as "20-Mar." To work around this issue, format that particular cell as text.
Related Topics
•
Pulse Vocabulary
•
How Cisco Pulse Uses the Vocabularies
•
Structure and Format of the Vocabularies
How Cisco Pulse Uses the Vocabularies
To understand the importance of the vocabularies, particularly, the Pulse Vocabulary, business administrators must understand the roles they play in Cisco Pulse.
Cisco Pulse analyzes the content shared across the network for terms and their associated synonyms in the Pulse and Restricted Vocabularies. At a high-level, the content shared by Jane Doe across the network undergoes this process:
1.
If Cisco Pulse discovers a term or associated synonyms in the Restricted Vocabulary, it immediately discards the content.
2.
If Cisco Pulse does not discover any Restricted Vocabulary terms or associated synonyms, it continues to analyze the content for terms or associated synonyms in the Pulse Vocabulary.
3.
If Cisco Pulse discovers a match, it retains the term, for example, "collaboration," and associated metadata for people, documents, and videos, and stores this information in the Pulse Index.
4.
Cisco Pulse discards all remaining unmatched content.
After Cisco Pulse discovers the term "collaboration" in content Jane shared across the network, it presents a "network collaboration" tag to her by way of the Tags Navigator gadget in the Home page. Jane can add this tag to her public profile.
As time passes, Cisco Pulse retains the term "collaboration," and the associated people, documents, and videos metadata in the Pulse Index. If a user performs a search on the term "collaboration," Jane might appear as an expertise provider in the people search results depending on her recent activity with the term and if she added the term to her public profile. Also, the documents and videos with the most recent and highest frequency of the term "collaboration" appear in the related information search results.
Note
After initial deployment of Cisco Pulse, the Pulse Index might include sparse information for a term and the attached users, which might result in an inflated NetPulse for users. If this situation arises, Cisco Pulse issues a caveat along with the Pulse Locator search results including these users.
Related Topics
•
Pulse Vocabulary
•
Restricted Vocabulary
•
Structure and Format of the Vocabularies
Structure and Format of the Vocabularies
Cisco Pulse stores the Pulse and Restricted Vocabularies in a 13-column structure and in CSV format. Table 7-1 describes each column in the structure, with column 1 as the leftmost column and column 13 as the rightmost column.
Table 7-1 Pulse and Restricted Vocabulary Structure
|
|
|
1 |
term |
The term. |
2 |
cat |
Cisco Pulse does not currently use this column. |
3 |
grp |
Cisco Pulse does not currently use this column. |
4, 5, 6, 7, 8 |
syn1 syn2 syn3 syn4 syn5 |
Up to five synonyms for the term. |
9 |
nrw |
Cisco Pulse does not currently use this column. |
10 |
brd |
Cisco Pulse does not currently use this column. |
11 |
description |
Cisco Pulse does not currently use this column. |
12 |
created_by |
The username of the person who added the term to the vocabulary. |
13 |
updated_by |
The username of the person who last edited the term. |
This excerpt from a sample Pulse Vocabulary shows five terms in the 13-column structure and CSV format as viewed in an ASCII text file:
term,cat,grp,syn1,syn2,syn3,syn4,syn5,nrw,brd,description,created_by,updated_by
access list,,,access lists,,,,,,,,ncpadmin,ncpadmin
access map,,,access maps,,,,,,,,ncpadmin,ncpadmin
access method,,,access methods,,,,,,,,ncpadmin,ncpadmin
access point,,,access points,,,,,,,,ncpadmin,ncpadmin
access server,,,access servers,,,,,,,,ncpadmin,ncpadmin
Figure 7-1 shows the same excerpt as viewed from the Microsoft Excel application.
Figure 7-1 Sample Pulse and Restricted Vocabulary Structure
A business administrator must create the Pulse and Restricted Vocabularies in an application such as the Microsoft Excel application, use the described structure and format, and upload the files into the system. When uploading the files, Cisco Pulse accepts only the .csv or .txt file extensions and the CSV format.
All terms and synonyms in the Pulse and Restricted Vocabularies must adhere to rules described in "Summary of Rules for the Pulse and Restricted Vocabularies" section.
Note
The Cisco Pulse graphical user interface (GUI) presents the vocabulary structure differently than the 13-column structure described in Table 7-1. The GUI does not display the cat, grp, nrw, brd, and description columns. For more information, see the "Vocabulary Elements" section.
Later, a business administrator can download the Pulse or Restricted Vocabularies, which are both presented in the 13-column structure, then open and edit the vocabularies using the Microsoft Excel application.
Note
If using the Microsoft Excel application to create or modify Pulse or Restricted Vocabularies, be aware that the application might treat an alphanumeric entry such as "MAR 20" as a date and convert the entry to a format such as "20-Mar." To work around this issue, format that particular cell as text.
Related Topics
•
Pulse Vocabulary
•
Restricted Vocabulary
•
How Cisco Pulse Uses the Vocabularies
Understanding the Vocabulary Used in Various Communication Tools
When creating the Pulse and Restricted Vocabularies, the business administrators must understand the organization that will use Cisco Pulse and the terms that are important to it.
The business administrators must also understand the vocabulary used in communication tools that are available in the organization, and analyzed by Cisco Pulse, can vary widely:
•
Email—The vocabulary in email tends to be informal, less carefully crafted, and may use unofficial abbreviations, acronyms, and synonyms. The vocabulary used in email is close to speech level.
•
Documents—The vocabulary in documents posted on internal and external websites tends to be more formal and use standardized or official terminology.
•
Web pages—The vocabulary in web pages can be a mixture of that used in email and documents. Some blogs and newsletters use vocabulary that is less formal than that used in email, while Wiki pages might use more formal vocabulary.
With this understanding of vocabulary variations, we recommend using these guidelines:
•
When adding a term to the Pulse or Restricted Vocabularies, use a formal term.
•
Accommodate for informal variations of the term by defining up to five synonyms or alternate expressions. For example, if a term is composed of the words "word1 word2," if appropriate, the business administrator can define synonyms for a hyphenated version of the term "word1-word2," and a combined version of the term "word1word2."
•
Accommodate for acronym usage if appropriate by defining an acronym. In the Pulse and Restricted Vocabularies, a term itself, as well as one of its associated synonyms, can be an acronym. For example, you can specify "MPLS" as a term and "mpls" as a synonym to "MPLS." For more information, see the "Summary of Rules for the Pulse and Restricted Vocabularies" section.
Guidelines for Creating the Pulse Vocabulary
At deployment of Cisco Pulse, the business administrators must have an initial Pulse Vocabulary uploaded to the system. Creating this vocabulary is a task that requires planning, extracting potential terms from data sources, analyzing the extracted terms, deciding what terms should go into the vocabulary, and finally, assembling the vocabulary in the required structure and format.
These topics describe the steps for creating a Pulse Vocabulary:
•
Identifying and Classifying the Data Sources
•
Processing Unstructured Data Sources
•
Processing Structured Data Sources
•
Assembling the Pulse Vocabulary
Identifying and Classifying the Data Sources
To create an effective Pulse Vocabulary, the business administrators must leverage existing information from within their organization. To that end, they must identify data sources that contain relevant content, which will be carried by the various communication tools that Cisco Pulse monitors.
Two types of data sources exist:
•
Unstructured—This type of data source includes unstructured content, which is often contained in email, web pages, documents, and slide presentations.
•
Structured—This type of data source includes dictionary-like content, which is often contained in spreadsheets, tables, databases, and other similar formats.
Table 7-2 provides examples of both unstructured and structured data sources that might exist within an organization. It also displays the usual vocabulary style, informal or formal, inherent to each data source.
Note
The examples of each data source type are not meant to be all-inclusive. An organization might include other sources not included in this table.
Table 7-2 Data Source Examples
|
|
Unstructured |
Email. |
Informal |
Newsgroups. |
Informal or formal |
Blogs. |
Informal |
Wiki pages. |
Informal or formal |
Marketing materials, which include collateral, white papers, product description documents or web pages, product data sheets or flyers, slide presentations. |
Formal |
Relevant portions of the internal website of a company. |
Formal |
External website of a company. |
Formal |
Instant messages. |
Informal |
Training or informational videos for customers. |
Formal |
Videos of informal meetings, demonstrations, and so on. |
Informal |
Knowledge management systems, which can include shared spaces, such as Microsoft Sharepoint. |
Informal |
Structured |
Product catalogs, which can include company and competitor product and price lists. |
Formal |
Manual/folksonomy tag repositories, which can include the internal topical information of a company in an encyclopedic format or flat list. |
Formal |
Taxonomy terms and metadata repositories. Taxonomies can be formatted in either a flat or hierarchical list. No standard format exists. |
Formal |
Make sure that the data sources selected includes both informal and formal content.
Related Topics
•
Processing Unstructured Data Sources
•
Processing Structured Data Sources
•
Assembling the Pulse Vocabulary
Processing Unstructured Data Sources
We recommend using these high-level steps to manually process unstructured data sources:
1.
Extract text from original documents, and remove any formatting.
2.
Aggregate all text.
3.
Identify and remove these unwanted elements:
a.
Potential Pulse Vocabulary terms containing full or partial names.
b.
Potential Pulse Vocabulary terms containing email-specific functional elements, such as greetings and dates.
c.
Potential Pulse Vocabulary terms containing stopwords at the end or the beginning of their expressions.
4.
Analyze all expressions, and extract those that are meaningful to your organization.
5.
Evaluate the popularity of these expressions using statistical analysis.
Related Topics
•
Identifying and Classifying the Data Sources
•
Processing Structured Data Sources
•
Assembling the Pulse Vocabulary
Processing Structured Data Sources
Structured data sources can provide rich content for creating the Pulse Vocabulary. However, the business administrators must process these data sources manually as there is no standard format for organizing this type of data.
We recommend using these high-level steps to process structured data sources:
1.
Understand the structure and format of the data sources. For example, an acronym database might consist of one column (Acronym), two columns (Acronym, Definition), or three columns (Acronym, Definition, Description). The file might be in comma delimiter, tab delimiter, or other formats.
2.
Understand the conversion process from the existing format to the format of the Pulse Vocabulary (13-column structure, CSV format). Determine if a script to extract relevant terms from the data sources can be used instead of performing this task manually.
3.
Either use a script or manually extract relevant terms from the data sources.
4.
Aggregate all terms.
5.
Identify and remove unwanted elements.
6.
Determine and rank terms according to popularity.
Related Topics
•
Identifying and Classifying the Data Sources
•
Processing Unstructured Data Sources
•
Assembling the Pulse Vocabulary
Assembling the Pulse Vocabulary
After the business administrators have extracted terms from the unstructured and structured data sources, they must perform these high-level steps:
1.
Review the flat lists.
2.
Decide what terms to include in the Pulse Vocabulary.
For rules to which you must adhere when specifying terms, see the "Summary of Rules for the Pulse and Restricted Vocabularies" section.
3.
Add the terms to a Microsoft Excel spreadsheet in the 13-column structure described in the "Summary of Rules for the Pulse and Restricted Vocabularies" section.
Note
If using the Microsoft Excel application to create the Pulse Vocabulary, be aware that the application might treat an alphanumeric entry such as "MAR 20" as a date and convert the entry to a format such as "20-Mar." To work around this issue, format that particular cell as text.
4.
For each term, enter the associated synonyms.
For rules to which you must adhere when specifying synonyms, see the "Summary of Rules for the Pulse and Restricted Vocabularies" section.
5.
Save the file, then upload the file to the system as described in the "Uploading a Vocabulary" section.
Related Topics
•
Identifying and Classifying the Data Sources
•
Processing Unstructured Data Sources
•
Processing Structured Data Sources
Methods for Updating the Pulse Vocabulary
The Pulse Vocabulary is a dynamic entity that must evolve with an organization. New products and concepts might emerge that need to be added, gaps in term coverage might be identified and need to be filled, and so on.
Cisco Pulse provides several methods in which the Pulse Vocabulary is updated:
•
Users suggest new terms for inclusion in the vocabulary
•
Users suggest synonyms for existing terms
•
The business administrators add, modify, or delete terms
Note
The business administrators must approve all suggested terms and synonyms before they are added to the Pulse Vocabulary.
These topics describe the methods in which the Pulse Vocabulary can be updated:
•
User-Suggested Tags
•
Guidelines for Approving User-Suggested Tags
•
Business Administrator Updates
•
Vocabulary Notification Emails
User-Suggested Tags
A user can suggest a new term, along with synonyms, and synonyms for an existing term to be added to the Pulse Vocabulary using these areas:
•
Add a Pulse Tag to My Profile content area of the Profile gadget in the Home page.
•
Pulse Locator search results.
These suggestions are known as user-suggested tags. The term and synonyms that a user specifies can be comprised of these elements:
•
A maximum of 8 words, with character spaces between each word.
•
A maximum of 64 upper- or lower-case alphanumeric and these special characters: ampersand (&), hyphen (-), plus sign (+), pound sign (#), forward slash (/), asterisk (*), period (.), at sign (@).
•
A term itself, as well as one of its associated synonyms, can be an acronym. For example, you can specify "MPLS" as a term and "mpls" as a synonym to "MPLS." Given this entry in the Pulse Vocabulary, Cisco Pulse will tag "MPLS," "mpls," and even "Mpls" or any other mixed-case variation, discovered in content shared across the network.
However, if an acronym, for example, "MPLS," is specified as a term and there are no synonyms specified, Cisco Pulse will tag "MPLS" only. It will not tag "mpls," "Mpls," or any other mixed-case variations.
The business administrator can approve or reject these tags using the Accept Suggested Tags page. For more information, see the "Accepting User-Suggested Tags" section.
Related Topics
•
Guidelines for Approving User-Suggested Tags
•
Business Administrator Updates
•
Vocabulary Notification Emails
Guidelines for Approving User-Suggested Tags
All user-suggested tags are subject to the approval of a business administrator. A timely response to suggested tags is important; otherwise, Cisco Pulse cannot tag users with these terms, and expertise seekers cannot perform a Pulse Locator search on the terms.
Ideally, the organization establishes the frequency at which a business administrator accepts or rejects suggested tags, and make the Cisco Pulse users aware of this schedule so that they know approximately when there will be an influx of new terms upon which to search.
We recommend that a business administrator approves or rejects suggested tags two to three times per week.
Related Topics
•
User-Suggested Tags
•
Business Administrator Updates
•
Vocabulary Notification Emails
Business Administrator Updates
The business administrators can add, modify, or delete terms from the Pulse Vocabulary. When adding a term to the Pulse Vocabulary, the term must adhere to rules described in the "Summary of Rules for the Pulse and Restricted Vocabularies" section.
There are two methods in which business administrators can update the Pulse Vocabulary:
•
If there are a small to moderate number of updates, a business administrator can use the View and Edit Pulse Vocabulary page to make the updates.
•
If there are a large number of updates, be aware that uploading a CSV file containing the updates only overwrites the existing Pulse Vocabulary. Therefore, we recommend that a business administrator downloads a CSV file containing the vocabulary to their hard disk, makes the updates to the CSV file using the Microsoft Excel application, then uploads the file back to the system. The business administrator can download and upload the CSV file using the Vocabulary Settings task pane.
Note
If using the Microsoft Excel application to modify a Pulse or Restricted Vocabulary, be aware that the application might treat an alphanumeric entry such as "MAR 20" as a date and convert the entry to a format such as "20-Mar." To work around this issue, format that particular cell as text.
Related Topics
•
User-Suggested Tags
•
Guidelines for Approving User-Suggested Tags
•
Vocabulary Notification Emails
Vocabulary Notification Emails
Note
We recommend that the business administrators work with the system administrator to determine how the vocabulary notification process should be implemented and communicated to users.
The system administrator can configure Cisco Pulse to send a notification email to users in a mailing list at 11 pm if additions, changes, or deletions are made to the Pulse and Restricted Vocabularies earlier that day.
If desired, users can choose not to receive these emails by removing themselves from the mailing list, which is set up by the system administrator.
Related Topics
•
User-Suggested Tags
•
Guidelines for Approving User-Suggested Tags
•
Business Administrator Updates
Guidelines for Creating the Restricted Vocabulary
If an organization decides to implement a Restricted Vocabulary, the business administrators must create the vocabulary.
To create the Restricted Vocabulary, perform these high-level steps:
1.
From the groups in an organization that are knowledgeable of privacy and liability issues, for example, Human Resources and Legal Services, gather the Restricted Vocabulary terms.
2.
Learn about the vocabulary variations used in the communication tools analyzed by Cisco Pulse by reading the "Understanding the Vocabulary Used in Various Communication Tools" section.
3.
Add the terms and synonyms to a Microsoft Excel spreadsheet in the 13-column structure.
For information on the 13-column structure and the rules for terms and synonyms that you specify, see the "Summary of Rules for the Pulse and Restricted Vocabularies" section
Note
If using the Microsoft Excel application to create Pulse or Restricted Vocabularies, be aware that the application might treat an alphanumeric entry such as "MAR 20" as a date and convert the entry to a format such as "20-Mar." To work around this issue, format that particular cell as text.
4.
Save the file, and upload the file to the system as described in the "Uploading a Vocabulary" section.
Methods for Updating the Restricted Vocabulary
The business administrators can add, modify, or delete terms from the Restricted Vocabulary. There are two methods in which they can update this vocabulary:
•
If there are a small to moderate number of updates, a business administrator can use the View and Edit Restricted Vocabulary page to make the updates.
•
If there are a large number of updates, be aware that uploading a CSV file containing the updates only overwrites the existing Restricted Vocabulary. Therefore, we recommend that a business administrator downloads a CSV file containing the Restricted Vocabulary to their hard disk, makes the updates to CSV file using the Microsoft Excel application, then uploads the file back to the system. The business administrator can download and upload the CSV file using the Vocabulary Settings task pane.
Note
If using the Microsoft Excel application to modify Pulse or Restricted Vocabularies, be aware that the application might treat an alphanumeric entry such as "MAR 20" as a date and convert the entry to a format such as "20-Mar." To work around this issue, format that particular cell as text.
If a business administrator wants to add a new term to the Restricted Vocabulary, the term must adhere to rules described in "Summary of Rules for the Pulse and Restricted Vocabularies" section.
Summary of Rules for the Pulse and Restricted Vocabularies
This topic describes these rules for creating and adding terms and synonyms to the Pulse and Restricted Vocabularies:
•
Rules for Creating a 13-Column Structure
•
Rules for Specifying Terms and Synonyms
Rules for Creating a 13-Column Structure
When uploading a Pulse or Restricted Vocabulary to the system, the file must contain a 13-column structure in CSV format and have a .csv or .txt file extension. You can create or edit this file with an application such as Microsoft Excel.
Note
If using the Microsoft Excel application to create the Pulse or Restricted Vocabulary, be aware that the application might treat an alphanumeric entry such as "MAR 20" as a date and convert the entry to a format such as "20-Mar." To work around this issue, format that particular cell as text.
With column 1 as the leftmost column and column 13 as the rightmost column, Table 7-3 provides the relative position of each column in the structure; the name of the column; and a description of what you need to specify for each row in the column.
Table 7-3 Pulse and Restricted Vocabulary Structure
|
|
|
1 |
term |
The term. For information on specifying a term in this column, see the "Rules for Specifying Terms and Synonyms" section in Chapter 7, "Creating and Maintaining Vocabularies" in the Cisco Pulse Administrator Guide, Release 1.0. |
2 |
cat |
Cisco Pulse does not currently use this column. You can leave this column blank. |
3 |
grp |
Cisco Pulse does not currently use this column. You can leave this column blank. |
4, 5, 6, 7, 8 |
syn1 syn2 syn3 syn4 syn5 |
Up to five synonyms for the term. For information on specifying a synonym in columns 4 through 8, see the "Rules for Specifying Terms and Synonyms" section in Chapter 7, "Creating and Maintaining Vocabularies" in the Cisco Pulse Administrator Guide, Release 1.0. |
9 |
nrw |
Cisco Pulse does not currently use this column. You can leave this column blank. |
10 |
brd |
Cisco Pulse does not currently use this column. You can leave this column blank. |
11 |
description |
Cisco Pulse does not currently use this column. You can leave this column blank. |
12 |
created_by |
You have these options: • Leave this column empty, and the system inserts the username of the business administrator who uploads the initial version of the Pulse or Restricted Vocabulary to the system. • Manually insert a username in each row in the column. Note If you insert the username of a non-existent user, the system replaces it with the username of the business administrator who uploads the initial version of the Pulse or Restricted Vocabulary to the system. |
13 |
updated_by |
You have these options: • Leave this column empty, and the system inserts the username of the business administrator who uploads a subsequent version of a Pulse or Restricted Vocabulary to the system. • Manually insert a username in each row in the column. Note If you manually insert the username of a non-existent user, the system replaces it with the username of the business administrator who uploads a subsequent version of a Pulse or Restricted Vocabulary to the system. |
The 13-column structure must include the column names outlined in Table 7-3, for example, "term" or "cat" at the head of each column. Figure 7-2 shows an excerpt of a sample Pulse Vocabulary as viewed in the Microsoft Excel application.
Figure 7-2 Sample Pulse and Restricted Vocabulary Structure
This excerpt shows the corresponding information as viewed in an ASCII text file:
term,cat,grp,syn1,syn2,syn3,syn4,syn5,nrw,brd,description,created_by,updated_by
access list,,,access lists,,,,,,,,ncpadmin,ncpadmin
access map,,,access maps,,,,,,,,ncpadmin,ncpadmin
access method,,,access methods,,,,,,,,ncpadmin,ncpadmin
access point,,,access points,,,,,,,,ncpadmin,ncpadmin
access server,,,access servers,,,,,,,,ncpadmin,ncpadmin
In the ASCII text excerpt, a comma (,) denotes boundaries for each of the 13 columns in each row.
Note
If the upload of a Pulse or Restricted Vocabulary fails and you are not certain why, we suggest opening the CSV file in a text editor and examining the rows to determine if each row includes the required 12 commas. If you find rows that have fewer than 12 commas, we suggest adding an entry in the updated_by column (the right-most column). This entry can be your username or even a character space. Save the file, then upload the file again to the system.
Related Topics
•
Rules for Specifying Terms and Synonyms
Rules for Specifying Terms and Synonyms
When specifying terms and synonyms for the Pulse or Restricted Vocabularies in the 13-column structure or in the View and Edit Pulse or Restricted Vocabulary page, a sample of which is shown in Figure 7-15, you must adhere to these rules:
•
The term and synonyms must be unique to the vocabulary in which you specify it. There is only one exception to this rule:
–
You can duplicate the same term in the Term and Synonym/Related Terms columns of a row as long as one of the entries is in uppercase, for example, "MPLS." This exception allows you to specify an acronym.
For example, you can specify "MPLS" as a term and "mpls" as a synonym to "MPLS." Given this entry in the Pulse Vocabulary, Cisco Pulse will tag "MPLS," "mpls," and even "Mpls" or any other mixed-case variation, discovered in content shared across the network.
However, if an acronym, for example, "MPLS," is specified as a term and there are no synonyms specified, Cisco Pulse will tag "MPLS" only. It will not tag "mpls," "Mpls," or any other mixed-case variations.
Note
When using the duplication exception to create an acronym, it is important to consider what you specify in the Term column. Cisco Pulse normalizes, or reduces, all entries in a row to one entry that represents all others. Cisco Pulse uses the term specified in the Term column as the normalized term in the Pulse Index, and My Top Tags and All Top Tags in the Tag Navigator gadget.
•
You must not duplicate a term or a synonym that is in the Pulse Vocabulary in the Restricted Vocabulary and vice versa.
•
Each term or synonym that you specify can be comprised of these elements:
–
A maximum of 8 words, with character spaces between each word.
–
A maximum of 64 upper- or lower-case alphanumeric and these special characters: ampersand (&), hyphen (-), plus sign (+), pound sign (#), forward slash (/), asterisk (*), period (.), at sign (@).
Related Topics
•
Rules for Creating a 13-Column Structure
Working with the Vocabularies
Cisco Pulse enables a business administrator to perform necessary tasks for the Pulse and Restricted Vocabularies. These topics describe the Cisco Pulse vocabulary pages and the tasks a business administrator can perform using them:
•
Pulse Vocabulary Active and Pending Tables
•
Vocabulary Page Elements
•
Uploading a Vocabulary
•
Viewing and Updating a Vocabulary
•
Accepting User-Suggested Tags
•
Downloading a Vocabulary
Pulse Vocabulary Active and Pending Tables
Cisco Pulse displays the Pulse Vocabulary in an active table and a pending table.
The active table includes Pulse Vocabulary terms that Cisco Pulse is actively discovering and tagging in content shared across the network. These terms are also known as active terms.
The pending table reflects terms that fall into these categories:
•
Active Pulse Vocabulary terms.
•
Terms that are added, modified, and deleted since the last configuration update (immediate or regularly scheduled). These terms, which are also known as pending terms, can come from these sources:
–
User-suggested terms approved by a business administrator.
–
Terms added, modified, and deleted manually by a business administrator.
–
An updated Pulse Vocabulary included in a CSV file and uploaded by a business administrator. The updated Pulse Vocabulary can include new and modified terms, and no longer include previously existing terms.
As the name implies, the pending table is a temporary entity that includes active Pulse Vocabulary terms, plus pending additions and modifications, and minus pending deletions. The pending additions, modifications, and deletions do not take effect until an immediate or regularly scheduled configuration update occurs. This table allows business administrators a more comprehensive and up-to-date view of Pulse Vocabulary terms in their various states before a configuration update.
These topics provide more information on the active and pending tables:
•
Active and Pending Table Functionality
•
Active and Pending Table Workflow
Related Topics
•
Vocabulary Page Elements
•
Uploading a Vocabulary
•
Viewing and Updating a Vocabulary
•
Accepting User-Suggested Tags
•
Downloading a Vocabulary
Active and Pending Table Functionality
The pending table functions as the focal point of the Pulse Vocabulary. As such, the pending table appears in the View and Edit Pulse Vocabulary page as shown in Figure 7-3.
Figure 7-3 Sample View and Edit Pulse Vocabulary Page
The pending table and its functionality is available to Cisco Pulse users with the "system administrator" and "business administrator" privilege levels only. Users with the "user" privilege level can view and have limited functionality with the active table only. Table 7-4 outlines the functionality available for pending and active tables and each type of user.
Table 7-4 Pending and Active Table Functionality for Cisco Pulse Users
|
Functionality for Business Administrators
|
|
Pending |
• View terms • Add, modify, and delete terms • Download terms to hard disk • Upload terms from hard disk to pending table |
- |
Active |
• Download terms to hard disk |
• View terms • Download terms to hard disk |
Related Topics
•
Active and Pending Table Workflow
Active and Pending Table Workflow
After a configuration update occurs, the contents of the pending table are copied to the active table. The pending additions and modifications are now active terms, and Cisco Pulse begins to discover and tag them. The deleted terms no longer exist in the active table, and Cisco Pulse no longer analyzes content shared across the network for them. Figure 7-4 graphically depicts this process.
Note
Cisco Pulse cannot properly handle pending additions, modifications, and deletions until a configuration update is performed. Given this condition, we recommend performing an immediate configuration update after adding, modifying, or deleting terms from the Pulse Vocabulary.
Figure 7-4 New Pulse Vocabulary Functionality
The contents of both pending and active tables are the same until additions, modifications, or deletions are made to the Pulse Vocabulary. Then, the pending table again includes the active Pulse Vocabulary terms, plus any pending additions and modifications, and minus any deletions until an immediate or regularly scheduled configuration update occurs.
Figure 7-5 shows a sample pending table, while Figure 7-6 shows a sample active table. The columns in both pending and active tables are the same. However, in the sample pending table, the business administrator has manually added three new terms (benchmark results, benchmark definitions, and brand positioning tools) as shown in Figure 7-5. Immediately after these terms were added, a user logged in and viewed the active table, where the terms do not yet appear as shown in Figure 7-6.
Figure 7-5 Sample Pending Table
Figure 7-6 Sample Active Table
Related Topics
•
Active and Pending Table Functionality
Vocabulary Page Elements
To access the Vocabulary page, click the Vocabulary tab. The Vocabulary page appears as shown in Figure 7-7.
Figure 7-7 Sample Vocabulary Page
The Vocabulary page is composed of the Vocabulary Settings task pane, which enables the business administrators to perform various tasks with the Pulse and Restricted Vocabularies. Table 7-5 describes the elements of the task pane.
Table 7-5 Vocabulary Settings Task Pane Elements
|
|
Pulse Vocabulary area |
View Edit link |
Click the View Edit link to access the View and Edit Pulse Vocabulary page, where a business administrator can view the pending table. In this table, the business administrator can add, modify, or delete a term from the Pulse Vocabulary, and the update is reflected in the table until a configuration update is performed. |
Download Active Terms link |
To download the Pulse Vocabulary terms that Cisco Pulse is actively discovering and tagging in content shared across the network, click the Download Active Terms link. The terms are downloaded in a 13-column structure and CSV format to a hard disk. |
Download Pending Terms link |
To download the Pulse Vocabulary terms that Cisco Pulse is actively discovering and tagging, plus any pending additions and modifications, and minus any deletions, click the Download Pending Terms link. The terms are downloaded in a 13-column structure and CSV format to a hard disk. |
Overwrite link |
To upload a Pulse Vocabulary in a 13-column structure and CSV format from a hard disk to the pending table, click the Overwrite link.
Caution
After the Pulse Vocabulary is initially uploaded into the system, any subsequent uploads overwrite the existing vocabulary. For information on preventing this situation, see the
"Uploading a Vocabulary" section.
|
Accept Suggested Tags link |
To access the Accept Suggested Tag page where a business administrator can accept or reject suggested terms from users for inclusion in the Pulse Vocabulary, click the Accept Suggested Tags link. |
number terms Pulse Vocabulary |
Displays the number of terms currently in the pending table. |
Last Updated date |
Displays the date on which the pending table was last updated by the business administrator. If no date appears, the vocabulary has not been created or updated. |
Restricted Vocabulary area |
View Edit link |
To access the View and Edit Restricted Vocabulary page, where a business administrator can view the Restricted Vocabulary, and add, modify, or delete a term, click the View Edit link. |
Download link |
To download the Restricted Vocabulary in a 13-column structure and CSV format to a hard disk, click the Download link. |
Overwrite link |
To upload a Restricted Vocabulary in a 13-column structure and CSV format from a hard disk, click the Overwrite link.
Caution
After the Restricted Vocabulary is initially uploaded into the system, any subsequent uploads overwrite the existing vocabulary. For information on preventing this situation, see the
"Uploading a Vocabulary" section.
|
number terms Restricted Vocabulary |
Displays the number of terms currently in the Restricted Vocabulary. |
Last Updated date |
Displays the date on which the Restricted Vocabulary was last updated by the business administrator. If no date appears, the vocabulary has not been created or updated. |
Note
Even though the Pulse and Restricted Vocabularies have distinct purposes, the user interface elements for both vocabularies are similar. Where similarities exist, the documentation presents one set of instructions for performing tasks for both vocabularies. Any differences in performing a task for a particular vocabulary are explicitly called out.
Related Topics
•
Pulse Vocabulary Active and Pending Tables
•
Uploading a Vocabulary
•
Viewing and Updating a Vocabulary
•
Accepting User-Suggested Tags
•
Downloading a Vocabulary
Uploading a Vocabulary
The Vocabulary Settings task pane provides an upload functionality that enables a business administrator to upload the Pulse and Restricted Vocabularies in their entirety into the system.
Caution
After the Pulse and Restricted Vocabularies are initially uploaded into the system, any subsequent uploads of a CSV file overwrite the existing vocabularies. Therefore, if there are a small to moderate number of updates that need to be made to a vocabulary, a business administrator can make these updates using the View and Edit Pulse or Restricted Vocabulary pages. If there are a large number of updates, we recommend downloading a CSV file containing the vocabulary to a hard disk, making the updates to the CSV file using the Microsoft Excel application, then uploading the file back to the system. For more information, see the
"Downloading a Vocabulary" section and the
"Uploading a Vocabulary" section.
Before You Begin
You must be aware of these guidelines:
•
The vocabulary must be in the 13-column structure described in the "Structure and Format of the Vocabularies" section.
•
When uploading the files, Cisco Pulse accepts only the .csv or .txt file extensions and the CSV format.
Procedure
To upload a Pulse or Restricted Vocabulary from a hard disk:
Step 1
In the Vocabulary Settings task pane, click the Overwrite link in the Pulse Vocabulary or Restricted Vocabulary areas.
Figure 7-8 shows how to click the Overwrite link in the Pulse Vocabulary area.
Figure 7-8 Sample Vocabulary Settings Task Pane—Overwrite Link
The Vocabulary Settings task pane updates with an empty field and associated Browse and Submit buttons as shown in Figure 7-9.
Figure 7-9 Sample Vocabulary Settings Task Pane—Uploading a Pulse or Restricted Vocabulary
Step 2
Click Browse.
The File Upload dialog box appears as shown in Figure 7-10.
Figure 7-10 Sample Vocabulary Settings Task Pane—Navigating to a CSV File
Step 3
Navigate to the location of the file, highlight the file, and click Open.
Step 4
Back in the Vocabulary Settings task pane, click Submit to upload the file to the system.
Related Topics
•
Pulse Vocabulary Active and Pending Tables
•
Vocabulary Page Elements
•
Viewing and Updating a Vocabulary
•
Accepting User-Suggested Tags
•
Downloading a Vocabulary
Viewing and Updating a Vocabulary
These topics describe the elements of and the actions a business administrator can take with the Pulse and Restricted Vocabularies:
•
Vocabulary Elements
•
Viewing a Vocabulary
•
Adding New Terms
•
Modifying Terms
•
Deleting Terms
Related Topics
•
Pulse Vocabulary Active and Pending Tables
•
Vocabulary Page Elements
•
Uploading a Vocabulary
•
Accepting User-Suggested Tags
•
Downloading a Vocabulary
Vocabulary Elements
To view and maintain a vocabulary, a business administrator must access the View and Edit Pulse Vocabulary page or the View and Edit Restricted Vocabulary page. In the Vocabulary Settings task pane, click the View Edit link in either the Pulse Vocabulary or Restricted Vocabulary areas. Figure 7-11 shows how to click the View Edit link in the Pulse Vocabulary area.
Figure 7-11 Sample Vocabulary Settings Task Pane—Clicking the View Edit Link
The View and Edit Pulse and Restricted Vocabulary pages have the same elements. Figure 7-12 displays the View and Edit Pulse Vocabulary page.
Figure 7-12 Sample View and Edit Pulse Vocabulary Page
Table 7-6 describes all elements of the View and Edit Pulse and Restricted Vocabulary pages except those elements that enable business administrators to control what they are viewing. For information on these control elements, see the "Viewing a Vocabulary" section.
Table 7-6 Vocabulary Elements
|
|
Vocabulary Settings link |
To return to the Vocabulary Settings task pane, click the Vocabulary Settings link. |
Row count |
Displays the row numbers currently shown and the total number of rows for the table. |
Add buttons |
To add a new term to the Pulse or Restricted Vocabulary, click Add at the top or bottom left of the page. |
Delete All |
To delete all terms displayed in the current page, click Delete All in the left-most column header. When prompted to verify the deletion, click OK. |
|
To delete a term, click the delete icon next to the term. When prompted to verify the deletion, click OK. |
Term column |
Displays each term in the Pulse or Restricted Vocabulary. Click a term to modify it. For more information on performing this task, see the "Modifying Terms" section. |
Synonym/Related Terms column |
Displays up to five synonyms, separated by commas, for each term. Click the synonyms to modify them. For more information on performing this task, see the "Modifying Terms" section. |
Created By column |
Displays the username of the person who added the term to the Pulse or Restricted Vocabulary. You cannot modify the username. |
Updated By column |
Displays the username of the person who last edited the term. This person could be a business administrator or a user. You cannot modify the username. |
Page count |
Displays the current page number and the total number of pages for the table. |
Resizable columns |
To change the width of a column, place your cursor over a column border. After your cursor changes to a bidirectional arrow, left-click on the border, then drag it to increase or decrease the width of the column. Note The system retains any column changes during your present session only. If you end your session by going to another page then returning to this page, the columns in the vocabulary table return to their default state. |
Related Topics
•
Viewing a Vocabulary
•
Adding New Terms
•
Modifying Terms
•
Deleting Terms
Viewing a Vocabulary
The Pulse and Restricted Vocabularies can include many terms, which encompass several View and Edit Pulse or Restricted Vocabulary pages. This topic describes some helpful control tools that allow you to navigate these pages.
Procedure
To view the contents of the Pulse or Restricted Vocabulary:
Step 1
In the Vocabulary Settings task pane, click the View Edit link in either the Pulse Vocabulary or Restricted Vocabulary areas.
The View and Edit Pulse or Restricted Vocabulary page displays. Figure 7-13 displays the View and Edit Pulse Vocabulary page with callouts to helpful control tools, which are described in this procedure.
Figure 7-13 Sample View and Edit Pulse Vocabulary Page—Helpful Control Tools
Step 2
To change the number of rows displayed in the page, use the drop-down arrow in the upper right corner of the page as shown in Figure 7-13, then click Go.
Step 3
To move through the pages, click the first and last page buttons or the previous or next page buttons in the bottom right corner of the page as shown in Figure 7-13.
Step 4
To narrow the Pulse or Restricted Vocabulary down to one term or all terms that contain a particular word or phrase, enter the desired word or phrase in the Filter field in the upper right corner of the page as shown in Figure 7-13, then click the magnifying glass icon.
Step 5
To return to the Pulse or Restricted Vocabulary in its entirety, remove any verbiage in the Filter field, then click the magnifying glass icon.
Related Topics
•
Vocabulary Elements
•
Adding New Terms
•
Modifying Terms
•
Deleting Terms
Adding New Terms
A business administrator can add new terms to the Pulse and Restricted Vocabularies.
Note
To add a small to moderate number of terms, a business administrator can use the method described in this topic. If there are a large number of additions, be aware that uploading a CSV file containing only the additional terms overwrites the existing Pulse or Restricted Vocabulary. Therefore, we recommend downloading a CSV file containing the Pulse or Restricted Vocabulary to a hard disk, making the additions to the CSV file using the Microsoft Excel application, then uploading the file back to the system. For more information, see the "Downloading a Vocabulary" section and the "Uploading a Vocabulary" section.
Note
If using the Microsoft Excel application to modify the Pulse or Restricted Vocabulary, be aware that the application might treat an alphanumeric entry such as "MAR 20" as a date and convert the entry to a format such as "20-Mar." To work around this issue, format that particular cell as text.
Before You Begin
The View and Edit Pulse and Restricted Vocabulary pages accept a new term, along with up to five synonyms. The term and its synonyms must adhere to rules described in the "Rules for Specifying Terms and Synonyms" section.
Procedure
To add new terms to the Pulse or Restricted Vocabulary:
Step 1
In the Vocabulary Settings task pane, click the View Edit link in either the Pulse Vocabulary or Restricted Vocabulary areas.
The View and Edit Pulse or Restricted Vocabulary page displays. Figure 7-14 displays the View and Edit Pulse Vocabulary page.
Figure 7-14 Sample View and Edit Pulse Vocabulary Page
Step 2
To add a new term, click Add in the top or bottom left of the page.
The first row updates with an editable field in the Term column as shown in Figure 7-15.
Figure 7-15 Sample View and Edit Pulse Vocabulary Page—Adding a New Term
Step 3
Enter the new term in the Term column.
Step 4
To save the term, take one of these actions:
•
Click in the Synonym/Related Term column to the right of your new term.
•
Click the Tab button on your keyboard.
Cisco Pulse displays a message at the bottom of the page indicating whether or not the term was successfully added. If the term is successfully added, the Synonym/Related Term column to the right of the new term becomes an editable field.
Step 5
Optionally, enter up to five synonyms for the term.
You must separate each synonym with a comma (,).
Step 6
To save the synonyms, take one of these actions:
•
Click in another column.
•
Click the Tab button on your keyboard.
Cisco Pulse displays a message at the bottom of the page indicating whether or not the synonyms were successfully added.
The Created By and Updated By columns automatically populate with the username with which you are logged in.
Step 7
Repeat Step 2 through Step 6 for each additional term that needs to be added.
Note
New terms added to the Pulse Vocabulary since the last configuration update appear in the pending table in the View and Edit Pulse Vocabulary page. These terms are not discovered and tagged by Cisco Pulse until a configuration update is performed. Given this condition, we recommend performing an immediate configuration update after adding new terms to the Pulse Vocabulary. For more information, see the "Performing an Immediate Configuration Update" section on page 6-73.
Related Topics
•
Vocabulary Elements
•
Viewing a Vocabulary
•
Modifying Terms
•
Deleting Terms
Modifying Terms
A business administrator can modify terms and synonyms in the Pulse and Restricted Vocabularies.
Note
To modify a small to moderate number of terms and synonyms, a business administrator can use the method described in this topic. If there are a large number of modifications, be aware that uploading a CSV file containing only the modified terms overwrites the existing Pulse or Restricted Vocabulary. Therefore, we recommend downloading a CSV file containing the Pulse or Restricted Vocabulary to a hard disk, making the modifications to the CSV file using the Microsoft Excel application, then uploading the file back to the system. For more information, see the "Downloading a Vocabulary" section and the "Uploading a Vocabulary" section.
Note
If using the Microsoft Excel application to modify the Pulse or Restricted Vocabulary, be aware that the application might treat an alphanumeric entry such as "MAR 20" as a date and convert the entry to a format such as "20-Mar." To work around this issue, format that particular cell as text.
Before You Begin
When modifying terms and associated synonyms, a business administrator must adhere to rules described in the "Rules for Specifying Terms and Synonyms" section.
Procedure
To modify terms and associated synonyms in the Pulse or Restricted Vocabulary:
Step 1
In the Vocabulary Settings task pane, click the View Edit link in either the Pulse Vocabulary or Restricted Vocabulary areas.
The View and Edit Pulse or Restricted Vocabulary page displays. Figure 7-16 displays the View and Edit Pulse Vocabulary page.
Figure 7-16 Sample View and Edit Pulse Vocabulary Page—Locating a Term
Step 2
To locate a term in the Pulse or Restricted Vocabulary, enter the term in the Filter field, then click the magnifying glass icon as shown in Figure 7-16.
Cisco Pulse narrows the vocabulary to one or more terms that contain the word or phrase entered in the Filter field.
Step 3
After Cisco Pulse locates the desired term, click in the term column.
The Term field becomes editable as shown in Figure 7-17.
Figure 7-17 Sample View and Edit Pulse Vocabulary Page—Modifying a Term
Step 4
Modify the term as desired.
Step 5
To save the modification, take one of these actions:
•
Click in the Synonym/Related Term column to the right of the term.
•
Click the Tab button on your keyboard.
Cisco Pulse displays a message at the bottom of the page indicating whether or not the term was successfully modified. If the term is successfully modified, the Synonym/Related Term column to the right of the new term becomes an editable field.
Step 6
Optionally, modify the synonyms and related terms.
Step 7
To save the modifications, click the Tab button on your keyboard.
Cisco Pulse displays a message at the bottom of the page indicating whether or not the synonyms were successfully modified.
The system automatically populates the usernames in the Created By and Updated By columns, and these usernames cannot be modified.
Step 8
Repeat Step 2 through Step 7 for each additional term that needs to be modified.
Note
Pulse Vocabulary terms that are modified since the last configuration update appear in the pending table in the View and Edit Pulse Vocabulary page. Cisco Pulse continues to discover and tag the unmodified version of the term until a configuration update is performed. After the configuration update, the modified term becomes active, and Cisco Pulse begins to discover and tag it. Given this condition, we recommend performing an immediate configuration update after modifying terms in the Pulse Vocabulary. For more information, see the "Performing an Immediate Configuration Update" section on page 6-73.
Related Topics
•
Vocabulary Elements
•
Viewing a Vocabulary
•
Adding New Terms
•
Deleting Terms
Deleting Terms
A business administrator can delete terms from the Pulse and Restricted Vocabularies.
Note
If there are a small to moderate number of terms to delete, a business administrator can use the method described in this topic. If there are a large number of deletions, we recommend downloading a CSV file containing the Pulse or Restricted Vocabulary to a hard disk, deleting the unneeded terms in the CSV file using the Microsoft Excel application, then uploading the file back to the system. For more information, see the "Downloading a Vocabulary" section and the "Uploading a Vocabulary" section.
Note
If using the Microsoft Excel application to modify the Pulse or Restricted Vocabulary, be aware that the application might treat an alphanumeric entry such as "MAR 20" as a date and convert the entry to a format such as "20-Mar." To work around this issue, format that particular cell as text.
Procedure
To delete terms from the Pulse or Restricted Vocabulary:
Step 1
In the Vocabulary Settings task pane, click the View Edit link in either the Pulse Vocabulary or Restricted Vocabulary areas.
The View and Edit Pulse or Restricted Vocabulary page displays. Figure 7-18 displays the View and Edit Pulse Vocabulary page.
Figure 7-18 Sample View and Edit Pulse Vocabulary Page—Locating a Term
Step 2
To locate a term in the Pulse or Restricted Vocabulary, enter the term in the Filter field, then click the magnifying glass icon as shown in Figure 7-18.
Cisco Pulse narrows the vocabulary to one or more terms that contain the word or phrase entered in the Filter field. After Cisco Pulse locates the desired term(s), delete them by taking the action described in Step 3 or Step 4.
Step 3
To delete one or more terms on a page, perform these substeps:
a.
Click the delete icon to the left of the term as shown in Figure 7-19.
Figure 7-19 Sample View and Edit Pulse Vocabulary Page—Clicking Delete Icon
b.
When prompted to verify the deletion, click OK.
The task bar at the bottom of the page provides an update about the status of the deletion.
c.
Repeat Substeps a and b for each additional term that needs to be deleted.
Step 4
To delete all terms on a page, perform these steps:
a.
Click Delete All in the left-most column header as shown in Figure 7-20.
Figure 7-20 Sample View and Edit Pulse Vocabulary Page—Clicking Delete All
b.
When prompted to verify the deletions, click OK.
The task bar at the bottom of the page provides an update about the status of the deletion.
Note
Terms that are deleted from the Pulse Vocabulary since the last configuration update are removed from the pending table in the View and Edit Pulse Vocabulary page. Cisco Pulse continues to discover and tag these terms until a configuration update is performed. After the configuration update, the deleted terms no longer exist in the active table, and Cisco Pulse no longer analyzes content shared across the network for them. Given this condition, we recommend performing an immediate configuration update after deleting terms from the Pulse Vocabulary. For more information, see the "Performing an Immediate Configuration Update" section on page 6-73.
Related Topics
•
Vocabulary Elements
•
Viewing a Vocabulary
•
Adding New Terms
•
Modifying Terms
Accepting User-Suggested Tags
Note
This topic applies to the Pulse Vocabulary only.
Users can suggest new terms, along with associated synonyms or related terms for inclusion in the Pulse Vocabulary, which are known as user-suggested tags. All of these suggestions are subject to the approval of the business administrator.
We recommend that the business administrator visits the Accept Suggested Tags page and approves or rejects suggested terms and synonyms two to three times per week.
These topics provide additional information on user-suggested tags:
•
Accept Suggested Tags Page Elements
•
Accepting and Rejecting Suggested Tags
Related Topics
•
Pulse Vocabulary Active and Pending Tables
•
Vocabulary Page Elements
•
Uploading a Vocabulary
•
Viewing and Updating a Vocabulary
•
Downloading a Vocabulary
Accept Suggested Tags Page Elements
From the Accept Suggested Tags page, which is shown in Figure 7-21, a business administrator can accept or reject new terms, which are also known as tags, and related synonyms suggested by users.
Figure 7-21 Accept Suggested Tags Page
Table 7-7 describes the elements of the Accept Suggested Tags page.
Table 7-7 Accept Suggested Tags Page Elements
|
|
Vocabulary Settings link |
To return to the Vocabulary Settings task pane, click the Vocabulary Settings link. |
Row count |
Displays the row numbers currently shown and the total number of rows for the table. |
Number of rows per page |
To change the number of rows displayed on a page, use the drop-down arrow to select a number, then click Go. |
Search field |
To narrow the suggested tags to those that contain a particular word or phrase only, enter the word or phrase in the search field and click the magnifying glass icon. To return to the entire list of suggested tags, remove any words or phrases from the search field, then click the magnifying glass icon. |
Approve column |
To approve a suggested term, along with its synonyms, for inclusion in the Pulse Vocabulary, click the associated Approve radio button. To approve all suggested terms, along with their synonyms, in a page, click the Approve radio button in the Approve column header. |
Reject column |
To reject a suggested term, along with its synonyms, for inclusion in the Pulse Vocabulary, click the associated Reject radio button. To reject all suggested terms, along with their synonyms, in a page, click the Reject radio button in the Reject column header. |
Term column |
Displays the terms suggested by users. To modify a term, click on the display field, which converts to an editable field and modify the term. |
Synonym/Related Terms column |
Displays one or more synonyms if users suggested them. To add or modify a suggested synonym, click on the display field, which converts to an editable field, and add or modify the synonym if desired. |
Requested By column |
If a term is suggested by a user, displays their username. |
Save button |
To save approvals, rejections, and edits, click Save. |
Reset button |
To reset all radio buttons and edits to their previous state, click Reset. This action applies to changes made since you last clicked Save. |
Page count |
Displays the current page and the total number of pages for the table. |
Paging buttons |
To move through the pages, click the first and last page buttons or the previous or next page buttons as desired. |
Related Topics
•
Accepting and Rejecting Suggested Tags
Accepting and Rejecting Suggested Tags
The business administrator should be aware of these implications for accepting and rejecting suggested terms, which are also known as tags:
•
If the business administrator accepts a user-suggested tag, Cisco Pulse adds the term to the Pulse Vocabulary.
•
Cisco Pulse does not discover and tag approved terms until a configuration update is performed. Given this condition, we recommend performing an immediate configuration update after approving terms. For more information, see the "Performing an Immediate Configuration Update" section on page 6-73.
•
If the business administrator rejects a user-suggested tag, the same or a different user can re-suggest the same tag later.
Procedure
To accept or reject a user-suggested tag:
Step 1
In the Vocabulary Settings task pane, click Accept Suggested Tags in the Pulse Vocabulary area as shown in Figure 7-22.
Figure 7-22 Sample Vocabulary Settings Task Pane—Click Accept Suggested Tags
The Accept Suggested Tags page appears as shown in Figure 7-23.
Figure 7-23 Sample Accept Suggested Tags Page
Step 2
If the list of suggested tags is lengthy, encompassing several pages, use these features to find a particular tag, if needed:
a.
To change the number of rows displayed on the page, use the drop-down arrow in the upper right corner of the page as shown in Figure 7-23, then click Go.
b.
To move through the pages, click the first and last page buttons or the previous or next page buttons in the bottom right corner of the page as shown in Figure 7-23.
c.
To narrow the suggested tags down to one tag, or all tags that contain a particular word or phrase, enter a word or phrase in the search field in the upper right corner of the page as shown in Figure 7-23, then click the magnifying glass icon.
To return to the complete list of suggested tags, remove any words or phrases from the search field, then click the magnifying glass icon.
Step 3
To accept or reject a term, click the associated radio button for that term.
Step 4
Optionally, edit the term and its associated synonyms by clicking the desired field.
The display field converts to an editable field, where a business administrator can correct a typo, add a synonym, remove a synonym, and so on.
Step 5
To save your work, click Save.
If needed, you can also click Reset, which resets all radio buttons and edits to their previous state. This action applies to changes made since you last clicked Save.
Related Topics
•
Accept Suggested Tags Page Elements
Downloading a Vocabulary
Cisco Pulse provides this download functionality for the Pulse and Restricted Vocabularies:
•
Downloading Active and Pending Pulse Vocabulary Terms
•
Downloading Restricted Vocabulary Terms
Related Topics
•
Pulse Vocabulary Active and Pending Tables
•
Vocabulary Page Elements
•
Uploading a Vocabulary
•
Viewing and Updating a Vocabulary
•
Accepting User-Suggested Tags
Downloading Active and Pending Pulse Vocabulary Terms
A business administrator can download the contents of the active and pending Pulse Vocabulary tables. The active table includes the Pulse Vocabulary terms that Cisco Pulse is actively discovering and tagging in content shared across the network. The pending table includes the same terms as the active table, plus any pending additions and modifications, and minus any deletions since the last configuration update.
The system downloads the contents of each table as a CSV file to the desktop of a system. Open the file using an application such as the Microsoft Excel application.
Note
If using the Microsoft Excel application to modify the Pulse Vocabulary, be aware that the application might treat an alphanumeric entry such as "MAR 20" as a date and convert the entry to a format such as "20-Mar." To work around this issue, format that particular cell as text.
Procedure
To download the contents of the active or pending tables:
Step 1
In the Vocabulary Settings task pane, click Download Active Terms or Download Pending Terms as appropriate in the Pulse Vocabulary area.
Figure 7-24 shows how to click Download Active Terms in the Pulse Vocabulary area.
Figure 7-24 Sample Vocabulary Settings Task Pane—Click Download Active Terms Link
The Opening dialog box appears as shown in Figure 7-25.
Figure 7-25 Sample Opening Dialog Box
Step 2
To open the file with the Microsoft Excel application, make sure the Open with radio button is clicked, then click OK.
After the file opens in the Microsoft Excel application, save it to the desired location of the hard disk.
Step 3
Either view the contents, or update the contents then upload the CSV file back to the system.
For information on uploading a CSV file back to the system, see the "Uploading a Vocabulary" section.
Related Topics
•
Downloading Restricted Vocabulary Terms
Downloading Restricted Vocabulary Terms
A business administrator can download the Restricted Vocabulary to a hard disk. The system downloads the vocabulary as a CSV file to the desktop of the system. The business administrator can then open the file using an application such as the Microsoft Excel application.
Note
If using the Microsoft Excel application to modify the Pulse or Restricted Vocabularies, be aware that the application might treat an alphanumeric entry such as "MAR 20" as a date and convert the entry to a format such as "20-Mar." To work around this issue, format that particular cell as text.
Procedure
To download the Restricted Vocabulary:
Step 1
In the Vocabulary Settings task pane, click Download in the Restricted Vocabulary area.
Figure 7-26 shows how to click Download in the Restricted Vocabulary area.
Figure 7-26 Sample Vocabulary Settings Task Pane—Click Download Link
The Opening dialog box appears as shown in Figure 7-27.
Figure 7-27 Sample Opening Dialog Box
Step 2
To open the vocabulary with the Microsoft Excel application, make sure the Open with radio button is clicked, then click OK.
After the vocabulary opens in the Microsoft Excel application, save it to the desired location of the hard disk.
Step 3
Either view the vocabulary, or update its contents then upload the CSV file back to the system.
For information on uploading a CSV file, which contains the Restricted Vocabulary, back to the system, see the "Uploading a Vocabulary" section.
Related Topics
•
Downloading Active and Pending Pulse Vocabulary Terms