Skip to main content
Legend
July 24, 2013
Question

Unable to get the baggage files in published Webhelp folder

  • July 24, 2013
  • 3 replies
  • 1268 views

I have a tabbed interativity in SWF format. The contents of this interactivity is coming from an XML file. I have to insert this interactivity into my RH project which has a linked FM book. Here is my approach:

Creating a FM-linked RH project:

1. Create a blank project.

2. Right-click HTML Files (Topics) folder and select Link > FrameMaker document.

3. Browse and select the FrameMaker book. The FrameMaker book is imported to RH.

4. Right-click the FM book and click Properties.

5. Create a new associated TOC.

6. Come back to HTML Files folder and update the book.

The project is ready now. The TOC has 2-level hierarchical book/topic structure in line with my FM TOC. My RH project folder has a folder for each FM topic I have imported.

Inserting the interactivity to the RH project:

1. Copy SWF and XML file into my RH project folder.

2. Insert the SWF file using Insert > Multimedia/Demo or Insert > Captivate Demo option in a topic.

3. Add the XML file to the Baggage Files folder.

4. Publish the RH project as a WebHelp output.

Result: The SWF loads, but without any content from the XML file.

When I check the Webhelp folder, I noticed that folder of the FM topic to which I added this SWF did not pick up the XML I attached.

Fine. So, I went back to the Baggage folder in RH, tried to create a folder by the same as the FM topic. RH does not allow me to do so because there is another folder by the same name.

Then, how do I solve this problem? What am I missing?

This topic has been closed for replies.

3 replies

Matt-Tech Comm Tools
Community Expert
Community Expert
August 1, 2013

Hi Sreekanth,

It looks to me like this is independent of your Fm file, and is related to the Rh HTML, and the SWF and the XML.

Can you run a test that doesn't involve an Fm file?

Most baggage file issues are a result of broken path references. You may have to sleuth around to determine the exact path of the baggage file after adding it to the Rh project.

Try the non-Fm test, and pinging the Rh forum to get Peter, Rick and John to help you out.

Once you get that far, then look to how you can implement the Fm files.

-Matt

-Matt Sullivan, FrameMaker Course Creator, Author, Trainer, Consultant
Legend
August 2, 2013

Hi

I tried your suggestions. The outcomes/ results .

Jeff:

I am trying to import a SWF created in Flash.

It works if I manually copy the xml file to the WebHelp folder. However, I don't really want to do this because, my FM-based webhelp folder might have 8-10 sub folders (one for each book) and each folder might have 5-6 such interactivities.

I have tried inserting the SWF in FM and importing FM to RH. However, the XML content is not picked up by the FM (only the skeleton of the interactivity created Flash gets into FM), and hence does not show up in RH output.

Matt:

When I insert this XML-based SWF in a independent RH project and add the XML file to the baggage folder, I get the correct output because the XML file is automatically going to the WebHelp folder.

So, based on these analysis, I think the problem in the FM-linked RH is that RH is unable to pull baggage files into its respective sub-folders in WebHelp output.

Jeff_Coatsworth
Community Expert
Community Expert
August 2, 2013

"When I insert this XML-based SWF in a independent RH project and add the XML file to the baggage folder, I get the correct output because the XML file is automatically going to the WebHelp folder." - is it being put in the root \WebHelp\ folder or in the sub-folder where the swf is located? My understanding of where baggage files get dumped in the help output is that it's in the root folder.

As Matt says, the problem isn't an integration issue, it's the swf/xml relationship - I assumed it was created in Captivate; but as you say, it's a Flash project. Maybe you need to look at publishing it out of Flash in another format or package - having never used it, I can't help you much with that.

Jeff_Coatsworth
Community Expert
Community Expert
August 1, 2013

So I'm guessing that the swf & the xml file have to live in the same folder for it to work, right? So that would rule out just including them in the baggage "folder" (it's not a real one - it's just a RH representation of one).

Does it work if you manually copy in the xml to the \!SSL!\WebHelp\ folder where the swf is located? If so, then the answer is Willam's - copy the missing xml files into the output post-generation.

I'm slightly puzzled by your workflow - usually when you link, all the content is coming from your FM source files (you don't add stuff in RH, because it's going to get overwritten next Update All - unless you mark the topic with a "Don't Update" field tag). Normal Captivate content can just be added to FM and brought over; you don't have to copy the swf into the RH project as the Insert Captivate command does that for you.

Your complication is the extra xml file - maybe another way around it is to publish the Captivate object as something else (not a swf ) that maybe will encapsulate the swf and xml all in some sort of wrapper of html or something.

Willam van Weelden
Inspiring
August 1, 2013

I’m hoping Jeff can jump in with a better answer. But I don’t see an easy way forward. Perhaps a script that automatically runs after generation copying the missing xml files into the toutpu.

Greet,

Willam