<div dir="ltr">It's been a big project, but we were successful!<div>Here's the skinny:</div><div>I need to import unstructured FM content into a new SalesForce Knowledge knowledge base. Individual procedures written in FM11 get published out via Mif2Go as Standard HTML (not help), and then imported by SalesForce with the help of a .CSV file. Overall it required about a 30-step procedure to get the content into SF, but now I plan to trim down the process. Then I will write it up and present it at the STC Summit or some other place. </div>
<div>The first question is: Why is this so difficult? I think it's because it is a technically challenging project that demands a lot of up-front work on the FM side, so no knowledgebase provider wants to develop and support it, and Adobe doesn't see the value in it for the neglected FrameMaker product (and market!)</div>
<div><br></div><div>The trick is to produce what SalesForce needs from what FM can give it. SalesForce's importer is pretty primitive and inflexible. AFAIK this is not unusual; last year I tried the same thing with a MindTouch knowledge base and that could import only from a .CHM, and even that was plagued with problems.</div>
<div>SalesForce needs a set of HTML pages saved in a particular nested file structure, accompanied by a .CSV file that provides the title of each article, its address, and some other information. The HTML, folders, and CSV must all be provided in a .ZIP along with a Project file created by the SalesForce admin. </div>
<div><br></div><div>FM's Save as HTML is buggy, barely supported by Adobe, and its HTML is not very clean. I could not generate good individual HTML pages from RoboHelp. Mif2Go offers the flexibility I needed.</div><div>
To develop the CSV was a different adventure. I needed a list of article titles mapped to the HTML file names, which are autogenerated with names like aa100543.htm. I could open each file and copy the title (there is a Mif2Go setting to make the title match the FM Heading 1 or Heading 2), but that would be tedious and error-prone for hundreds of files. </div>
<div><br></div><div>Jeremy had a workaround to get my titles and file names together. After generating the Standard HTML output, I generated OmniHelp output just to get a single .JS page with the list I needed. I deleted all the rest of the output, keeping only that file. </div>
<div>Then I edited the file with several search-and-replaces and saved it as .CSV. </div><div><br></div><div>Then I was able to zip together the HTML and the .CSV and hand it off to the SalesForce Admin, who (after a few false starts) finally reproducibly imported 24 and then 56 files. We have some bugs, but we think we know how to fix them. </div>
<div><br></div><div>Now I have to refine the process, learn how to optimize my FM content, and document it because once the knowledgebase is launched with my existing FM content, I am committed to updating it forever!</div>
<div><br></div><div>Thanks everyone for all your input on this complex project!</div><div>john</div><div> </div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Sun, Aug 4, 2013 at 5:24 PM, John Sgammato <span dir="ltr"><<a href="mailto:john.sgammato@actifio.com" target="_blank">john.sgammato@actifio.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Thank you for all the guidance! I hope to get to it tonight <span></span><br><br>On Sunday, August 4, 2013, Jeremy H. Griffith wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
On Sun, 4 Aug 2013 16:20:31 -0400, John Sgammato <<a>john.sgammato@actifio.com</a>> wrote:<br>
<br>
>I have no [OmniHelpOptions] at all.<br>
>I renamed the HTML version, changing nothing but the name.<br>
>That failed, so I tried editing Config= to point to he OmniHelp file -<br>
>see below.<br>
>I know something's not right, but I don't understand this path well<br>
>enough to figure it out.<br>
<br>
The path looks fine. I gather you aren't using the<br>
Documents template for HTML either? That's OK,<br>
as long as the two projects are the same with that.<br>
The rest of your settings look OK. Oh, add:<br>
<br>
[HelpContentsLevels]<br>
Title=1<br>
Heading1=1<br>
Heading2=1<br>
<br>
If you make them all level 1, your first replace<br>
will always be of "[1,", no wildcard needed.<br>
<br>
See par. 7.4.3, "Including contents entries in<br>
HTML-based Help".<br>
<br>
Perhaps I should have been more explicit about<br>
what to do in the Choose project dialog. Select<br>
the HTML project, but don't push any buttons yet.<br>
<br>
Change the name in the top field, and for the<br>
second field push [...] and choose the new<br>
Omnihelp output directory, Then select Omnihelp<br>
in the last field.<br>
<br>
NOW, press Add, then OK. It should go on to the<br>
Export dialog, just continue as usual.<br>
<br>
-- Jeremy H. Griffith, at Omni Systems Inc.<br>
<<a>jeremy@omsys.com</a>> <a href="http://mif2go.com/" target="_blank">http://mif2go.com/</a><br>
_______________________________________________<br>
<br>
<br>
You are currently subscribed to framers as <a>john.sgammato@actifio.com</a>.<br>
<br>
Send list messages to <a>framers@lists.frameusers.com</a>.<br>
<br>
To unsubscribe send a blank email to<br>
<a>framers-unsubscribe@lists.frameusers.com</a><br>
or visit <a href="http://lists.frameusers.com/mailman/options/framers/john.sgammato%40actifio.com" target="_blank">http://lists.frameusers.com/mailman/options/framers/john.sgammato%40actifio.com</a><br>
<br>
Send administrative questions to <a>listadmin@frameusers.com</a>. Visit<br>
<a href="http://www.frameusers.com/" target="_blank">http://www.frameusers.com/</a> for more resources and info.<br>
</blockquote><br><br>-- <br>
<br><table cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td valign="middle">
<p> </p>
</td>
<td valign="middle">
<p> </p>
</td>
<td valign="middle">
<p> </p>
</td>
<td valign="middle">
<p> </p>
</td>
<td valign="middle">
<p><b>John Sgammato </b></p>
<p>Documentation Architect</p>
<p><span><b>e</b> <a href="mailto:john.sgammato@actifio.com" target="_blank"><span>john.sgammato@actifio.com</span></a> </span></p><p><span><b>w</b> </span><a href="tel:%2B1-%28508%29%20927-2083" value="+15089272083" target="_blank">+1-(508) 927-2083</a><span> </span></p>
</td></tr></tbody></table>
<p> <i>Recover anything instantly for up to 90% less than you're paying now.</i></p><br>
</blockquote></div><br><br clear="all"><div><br></div>-- <br>
<br><table cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td valign="middle">
<p> </p>
</td>
<td valign="middle">
<p> </p>
</td>
<td valign="middle">
<p> </p>
</td>
<td valign="middle">
<p> </p>
</td>
<td valign="middle">
<p><b>John Sgammato </b></p>
<p>Documentation Architect</p>
<p><span><b>e</b> <a href="mailto:john.sgammato@actifio.com" target="_blank"><span>john.sgammato@actifio.com</span></a> </span></p><p><span><b>w</b> </span>+1-(508) 927-2083<span> </span></p></td></tr></tbody></table>
<p> <i>Recover anything instantly for up to 90% less than you're paying now.</i></p>
</div>