Troubleshooting "SHFB: Error BE0065: BUILD FAILED: An error occurred while parsing EntityName."

Topics: User Forum
Sep 2, 2010 at 1:52 AM
Edited Sep 2, 2010 at 1:53 AM

After upgrading to I am getting this error:

SHFB: Error BE0065: BUILD FAILED: An error occurred while parsing EntityName. Line 13, position 117.

There isn't much indication of which file it is, here is the end of the log file (it's a bit big to post in its entirety):

  Info: BuildAssembler: Building topic T:Repository.System_RouteRepository
  Info: BuildAssembler: Building topic AllMembers.T:Repository.System_RouteRepository
  Info: ShowMissingComponent: Auto-documenting constructor M:Repository.System_RouteRepository.#ctor
  Info: BuildAssembler: Building topic Methods.T:Repository.System_RouteRepository
  Info: BuildAssembler: Building topic Properties.T:Repository.System_RouteRepository
  Info: BuildAssembler: Building topic M:Repository.System_RouteRepository.#ctor(Bluecap4.Application.Server.Base.State)
  Info: ShowMissingComponent: Auto-documenting constructor M:Repository.System_RouteRepository.#ctor(Bluecap4.Application.Server.Base.State)
  Info: BuildAssembler: Building topic M:Repository.System_RouteRepository.Add(Model.System_Route)
  Info: BuildAssembler: Building topic M:Repository.System_RouteRepository.CreateInstance
  Info: BuildAssembler: Building topic M:Repository.System_RouteRepository.Remove(System.Int32)
  Info: BuildAssembler: Building topic M:Repository.System_RouteRepository.Select(System.Nullable{System.Int32},System.Nullable{System.Int32})
  Info: BuildAssembler: Building topic M:Repository.System_RouteRepository.SelectId(System.Int32)
  Info: BuildAssembler: Building topic M:Repository.System_RouteRepository.Update(Model.System_Route)
  Info: Processed 6649 topics
  Info: CachedCopyFromIndexComponent: Used "reflection" cache entries: 10
  Info: CachedCopyFromIndexComponent: Used "comments" cache entries: 8
    Last step completed in 00:12:40.0827
Combining conceptual and API intermediate TOC files...
    Last step completed in 00:00:00.5540

SHFB: Error BE0065: BUILD FAILED: An error occurred while parsing EntityName. Line 13, position 117.


Sep 2, 2010 at 2:14 AM

I think I found the problem. In my coneptual layout, I have this title:

<Topic id="691b7c69-7398-48df-b449-01c25f3fdfbc" visible="True" noFile="true" title="Methods, Tools &amp; Techniques">

When it gets built, the file <ProjectName>\working\_ConceptualTOC_.xml contains this instead:

<topic id="691b7c69-7398-48df-b449-01c25f3fdfbc" file="691b7c69-7398-48df-b449-01c25f3fdfbc" title="Methods, Tools & Techniques">
Is there something I can do to stop this from happening, or should I just not use ampersands in titles?

Sep 3, 2010 at 2:27 AM

I probably need to encode the title when I create the conceptual TOC XML file.  You may be able to work around it by specifing "&amp;" in the title property since its going through as-is right now.  If not, then you'd have to avoid it for the time being.