Character Profiler

Use this topic for a simple page, dialog or other UI without any sections or tabs. You must describe every field and option on the page.

To configure this topic so it generates correctly in the help output, perform the following steps:

Configure the Sect1 element:
1. Create the context-sensitive topic as a Sect1.
2. Title the context-sensitive topic to reflect the name of the UI, using a simple noun phrase with headline-style capping. In the page title, include the generic noun. For example, Preferences Page, Preferences Dialog, Editing Window, Resource Catalog. If this is a topic that you are migrating, use the same title as before..
3. Set the HelpTOC attribute to TopicOnly, so this topic does not appear in the TOC.
4. Modify the sample OutputFileName attribute of the element to include the name of your UI and optionally include the product name. For example, if your product is Oracle XYZ Server and the UI is the Preferences Dialog, modify the value of this attribute from cs_pagename1.htm to something like cs_preferences.htm or xyz_cs_preferences.htm.
5. Modify the HelpTopicID attribute to match the topicID for the Help icon, button, or UI.
  
  Use the topicID provided by the engineer as the value for the HelpTopicID attribute for the Sect1 topic. If converting help from another format, use the existing HelpTopicID. Alternatively, you can assign a topicID to the topic and then provide the engineer with the topicID you assigned. The important thing is to make sure the topicID you assign to the topic in FrameMaker matches the topicID assigned to the UI, Help icon or button by development.
Configure the InformalTable element with the following guidelines:
1. Modify the Summary and Title attributes as appropriate for the table.
2. In the Element column, enter all the elements or options in the UI that should be documented, using the HelpPara element. In the Element column, do not bold the UI element.
3. To indent the text in the Element column in order to groups the elements as they display in the UI, edit the Role attribute of the HelpPara element. Select Level1 to indent the text from the left margin. You can indent up to four levels to reflect the organization of options displayed in the UI, if needed, using Level1, Level2, Level3, and Level4.
4. In the Description column, use the Para element, not the HelpPara element. You will not indent text in this column. Describe the option or element in detail. If you reference UI elements other than the one you are describing, use the Bold emphasis. If you provide a code snippet or code reference, apply the Code emphasis.
5. In the Description column, include More inline links to conceptual topics in administrator, developer and user guides in the documentation library; include How? inline links to individual task topics in these books. Do not include inline links for other information. Instead, include those other links under the Related Topics heading, as described below.
6. To insert More and How? link to books, use the Xulink element and for the Attribute value, enter olink:DOCID (for example, olink:ASADM11113). For more detailed information about linking, see the topic Applying TopicID Values and Adding Links to Books in the online help standards.
7. In both the Element and Description columns, add inline graphics where necessary, as described below. Use inline graphics sparingly, only as needed, to provide UI overviews and define unlabeled elements on screen. Icons and buttons are not required in context sensitive online help.
8. Inline graphics are limited to a height of 22 pixels. If you insert an image that exceeds 22 pixels in height, the image will be reduced and distorted in the OHW/OHJ help JAR, so do not insert it. There are no specific restrictions to the pixel width of an image, however images that fill more than half a column would be better inserted as informal figures in the introductory paragraphs.
To insert an inline graphic, follow these guidelines:
1. Select the location where you want to insert the inline graphic.
2. In the Elements window, select InlineGraphic, and click Insert. The Attributes for New Element window appears.
3. Type the AltText value. This is a required attribute and the book will fail if you do not enter some text. Click Insert Element. The Import dialog appears.
4. Select the graphic to be imported from the graphics folder. The Import Graphic Scaling dialog appears.
5. Select 72 dpi. Click Set. The graphic is inserted.
6. Using the spacebar, insert one space before or after the graphic as needed, so there is a single space between the image and text A single space is required between an image and text before or after it (identical to the space between words). No extra space should be added before an image at the beginning of a line.
To include the RelatedTopics element and links, follow these guidelines:
1. The RelatedTopics element is the last element in a Sect1 element and is mandatory. It is included in the template and does not need to be inserted.
2. The only child element available under the RelatedTopics element is the Para element. You can add multiple Para elements under the RelatedTopics element, in addition to those already in the template.
3. Add any topics about technologies mentioned, if they are not covered by inline How? and More links.
4. Add additional cross references to chapters or Sect1s in the documentation library.
5. To insert link to books, use the Xulink element and for the Attribute value, enter olink:DOCID (for example, olink:ASADM11113). For more detailed information about linking, see the topic Applying TopicID Values and Adding Links to Books in the online help standards.

Use the Character Profiler to discover all the distinct characters that exist in a number of text attributes, and how often they occur.

The Character Profiler is particularly useful to find unexpected characters in text attributes that may need to be checked for on an ongoing basis (using Invalid Character Check), removed (using Denoise) or replaced (using Character Replace). Normalizing character discrepancies is also useful before Parsing.The results are created so that they can easily be added to Reference Data for any of the above purposes.Also, where a source of data contains records from a number of different countries, the Character Profiler can help to understand the ranges of characters in the data.

The following table describes the configuration options:

Configuration	Description
Inputs	Specify any String attributes that you want to search for character instances.
Options	None.
Outputs	Describes any data attribute or flag attribute outputs.
Data Attributes	None.
Flags	None.

The following table describes the statistics produced by the profiler:

Statistic	Description
Character	The character found in the data.
Decimal	The decimal Unicode character reference. Note that a hash character is used to prefix the character references, so that the references can be used directly in Reference Data.
Hex	The hexadecimal Unicode character reference. Note that `#x` is used to prefix the character references, so that the references can be used directly in Reference Data.
Total	The total number of occurrences of the character across the selected input attributes.
Record Count	The number of records containing the character in any of the selected input attributes.
[Attribute name] Total	The number of occurrences of the character in the attribute.
[Attribute name] Record Count	The number of records containing the character in the attribute.

Example

For example, the Character Profiler is used to find unusual characters in some multi-language data from a Unicode database. The user chooses to look at the low frequency characters first by sorting the results by the Total column (ascending).

Table 1-120 Character Profiler

Character	Decimal	Hex	Total (asc)
ñ	#241	#0xF1	1
ò	#242	#0xF2	1
ó	#243	#0xF3	1
ô	#244	#0xF4	1
õ	#245	#0xF5	1
ö	#246	#0xF6	1
ø	#248	#0xF8	1