How to Add a New Flare Community

If this is the first time you are integrating Flare andPulse, add a new Flare community to your project's Flare target. This process automatically creates a new "system" on the Pulse server. In Pulse, a system hosts the following items:

• The activity streams that are used when moderating your topics with the Pulse dashboard
• The embedded discussion forms that registered Pulse users can access in the Flare output

1. In the Analytics tab, locate the Communities list and then click Manage.

2. In the Manage Community dialog, click Add.

3. In the Enter Name dialog, type a name for your community. In this example, we are creating a community to use with a Flare target about Pets. Then click OK.

   

4. In the Manage Communities dialog, the new community appears. Click OK to close the dialog.
5. Click Refresh to update the Current Pulse Configuration info. This provides you with basic information about the community, such as the status of the server, and the total number of users.

After the community is associated with the Flare target, the Remap Topics button becomes available so you can map your community topics to Pulse for the first time.

You also have the ability to select an existing community, delete a community, provide a published URL, and rename a community as follows:

How to Select a Flare Community

If you need to publish any updates for your Flare output and do not wish to create a new community for your documentation release, select the community that you previously created for the target. This gives you the ability to ensure that any new, removed, and updated topics are mapped to the appropriate embedded discussion forms in the Pulse system.

1. In the Analytics tab, locate the Community area.

2. From the Communities list, select an existing community.

   

3. Click Refresh to update the Current Pulse Configuration info. This provides you with basic information about the community, such as the status of the server, and the total number of users.

   Note The Communities list in Flare initially only includes communities that have been added with the Flare user interface. If you create Pulse systems using the Pulse dashboard, those systems will be not be listed as Flare communities until you remap the topics.

   Note You can associate multiple Flare targets with a single community if desired. However, for best results with reporting, we recommend that you create a separate community for each target. This will also simplify any mapping/remapping tasks when you publish updates.

   Note If you want to verify that the Flare community you added is now a system in Pulse, log in to the Pulse dashboard using an account that is a member of the Administrators or Employees group. The select Systems > Find Systems from the menu. The community you created will appear in the list.

   After the community is activated, the Remap Topics button becomes available so you can remap the community topics to Pulse.

How to Delete a Flare Community

If you want to delete a Flare community, use the steps below. This deletes both the Flare community and the Pulse system.

1. In the Analytics tab, locate the Communities list and click the Manage.

2. In the Manage Community dialog, select the community that you want to remove. Then click Delete.
3. When prompted to confirm the delete action, click Yes. This removes your selection from the Communities list.
4. Click OK to close the Manage Communities dialog.
5. Click Remap Topics and confirm the topics to remove.
6. Click to save your work.

How to Provide a Published URL for a Community

You can assign a URL path to your community from your Flare target. This can also be done from the Pulse dashboard (by selecting Administration > Settings and clicking Communities), but using the Flare target is recommended.

1. Under the Analytics area, click the Manage button.
2. In the Manage Communities dialog, highlight the community that you want to edit. Then click Edit

3. In the Edit Community dialog, click in the Enter published url field and enter a path to the main landing page of your Flare output.

   When you enter a published URL path, make sure you include http:// at the beginning of the URL.

   Example You've generated a target called "FlareOutput" and you've uploaded the output so that users access it here: help.mycompany.com/FlareOutput/Default.htm. In that case, enter http://help.mycompany.com/FlareOutput in the Published Url field.

4. Click OK to close the Edit Community dialog. Click OK to close the Edit Community dialog.
5. Click OK to close the Manage Communities dialog.
6. Click to save your work.

Why is it a good idea to assign a URL path to a community? Because it allows topic feeds to open in context.

How to Rename a Flare Community

1. In the Analytics tab, under Current Pulse Configuration, click the Refresh button.
2. Under the Community area, click the Remap Topics button ensure your topics have been mapped
3. Under the Analytics area, click the Manage button.

4. In the Manage Community dialog, highlight the community that you want to rename. Then click Rename.

   In order to add the embedded discussion forms to the Flare output that you will publish, you must map/remap the community topics in Flare for Pulse.

5. In the Enter Name dialog, type a new name for your community. Then click OK.

   This changes the name of the community in Flare, as well as the name of its corresponding Pulse system.

   Note If an error message appears, try clicking the Refresh button and the remapping the topics. This typically resolves any issues.

6. Click OK to close the Manage Communities dialog.
7. Click to save your work.

How to Map a New Flare Community to a Pulse System

If this is the first time you are setting up a Flare community for a target, you will need to map the topics for your community to Pulse.

1. Make the desired changes to your Flare target. Always be sure to update the TOC before remapping the topics.
2. In the Target Editor, select the Analytics tab.
3. From the Communities drop-down list, select the appropriate community.

4. Click Remap Topics.

   This opens the Remap Community Topics dialog.

5. In the Remap Community Topics dialog, make sure the New Topics tab is selected and review the topics in the list.

   Example A topic count appears in the label of the New Topics tab. The tab lists the topic titles and paths to the topics. These items will be mapped to a corresponding stream in Pulse. In a new community, the counts in the other tabs will typically be zero (0).

   

6. When finished, click OK. The system automatically maps each community to a stream in Pulse. The community updated message appears.
7. Click to save your work.

How to Remap a Flare Community to a Pulse System

As you prepare to publish content updates to a Flare target, you can review the new, removed, and updated topics and then reassign any of the topics to the appropriate stream in the Pulse system. This stream corresponds to the embedded discussion form at the bottom of the Flare topic.

1. Make your content changes in Flare. Be sure to make all of the desired updates in the Flare TOC associated with your target.
2. Open the Flare target.
3. In the Target Editor, select the Analytics tab.
4. From the Communities drop-down list, select the appropriate community.

5. Click Remap Topics. This opens the Remap Community Topics dialog so you can review the updates:

   new topics tab

   The New Topics tab lists Flare updates that have an effect on the Pulse mapping definitions:

   • New Topics New topics that have been added to the Flare TOC associated with the target.
   • Moved Topics Existing topics that have been moved to a different folder or location in the Content Explorer.
   • Renamed Topics (New Name) Existing topics where the actual file name has changed. The new file name appears in this tab.

   

   remove topics tab

   The Remove Topics tab lists Flare updates that have an effect on the Pulse mapping definitions:

   • Deleted Topics Topics that have been removed from the Flare TOC associated with the target.
   • Moved Topics Existing topics that have been moved to a different folder or location in the Content Explorer.
   • Renamed Topics (Former Name) Existing topics where the file name has changed. The former file name appears in this tab.

   

   update topics tab

   The Update Topics tab only lists community topic updates that specifically relate to Pulse mapping definitions. This includes topic updates such as title changes, reassigned links, and so on.

   

   exclude topics tab

   The Exclude Topics tab lists all topic files where Flare changes have no effect on the Pulse mapping definitions.

   

   When finished, click OK. The community updated message appears.

6. Review the topics in each tab and then reassign the links as desired. See below for instructions.
7. When finished, click OK. The community updated message appears.

How to Reassign a Link

When you are preparing to publish content updates for a Flare target, there may occasionally be times when you want to reassign a link that is associated with a community topic. This lets you take the embedded discussion form associated with a topic and associate it with a different topic.

1. Make your content changes in Flare. Be sure to make all of the desired updates in the Flare TOC associated with your target.
2. Open the Flare target.
3. In the Target Editor, select the Analytics tab.
4. Select the appropriate Flare community in the Community drop-down list.  

5. Click Remap Topics. This opens the Remap Community Topics dialog so you can review the updates. In this example, we've renamed a topic file from "Feeding_Cats.htm" to "Feeding_a_Cat.htm."

   

6. In the New Topic tab, right-click the new topic and select Reassign Link from the context menu.

   

   This opens the Reassign Community Link dialog.

7. From the Select Links drop-down list, select the desired topic. This will map the embedded discussion form for the selected link with the topic. In this example, we will select the topic formerly named, "Feeding_Cats.htm."

   

8. When finished, click OK. The community updated message appears.

   When you republish your Flare target, the discussion originally linked to the former file is now linked to the new file.

How to Verify the Community Topics in the Pulse System

To see the community topics that have been created for your Flare output:

1. Log in to the Pulse dashboard with an appropriate user account.

   Note To access systems, you must be a member of the Administrators or Employees group.

2. In the menu bar, select Systems > Find Systems. The Find Systems page appears.

3. Under New Systems, click the Pulse system that corresponds to the appropriate Flare community.

   

4. In the community page, click the Topics link.

   

5. In the list of topics, click a topic. Any community activity for the topic will be reflected in the stream.

   

Style Classes

For HTML5 Side and Top Navigation (and skinless outputs), you can add the following classes of the html style to control the look of these generated pages:

• pulseTopic This style class controls the look of a generated Pulse page (i.e., page opened via the Edit User Profile button).
• searchTopic This style class controls the look of a generated search results page.
• templateTopic This style class controls the look of all generated pages and has precedence over the other the pulseTopic and searchTopic classes.

See Creating Selectors.

Suggested Style Setting

If you include a side menu—via a Menu proxy—that is not context-sensitive, this menu may display on generated pages, not just in regular topics. This is probably something you want to avoid.

Therefore, to prevent this issue, you may want to copy the following to your stylesheet via the Internal Text Editor.

html.templateTopic div.sideContent
{
    display: none;
}

See Editing Styles in the Internal Text Editor and Internal Text Editor.