Good news - I think I have resolved the issue. Less-good news - the road to success was tortuous and filled with pitfalls, potholes, and blind alleys. My journey is described below:
Let us use the example of the document “five-man-electrical-band--signs” and stick with that until resolved. Once this is resolved, I think I can apply the resolution to at least most of the issues I am encountering.
No matter which Project I am working with, upon any significant action in BH-iPad (i.e. BandHelper on the iPad), among the 41 error messages, I get "The file for the document five-man-electrical-band--signs is missing. (225)”.
In BH-web, I see no corresponding error messages.
In BH-web, I have verified that the document “five-man-electrical-band--signs” is part of the Project “Krell”, and not part of any of the other four Projects yet managed in BandHelper. I can see this both by Repertoire>Documents><<docname>> > Edit>Projects (Krell is the only Project checked), and by navigating to each project from the ‘Your Account’ drop down, and checking the list provided by Repertoire>Songs.
—————
Fail 1:
In BH-web, Repertoire>Songs><<song>> > Edit>Documents - I see two documents listed - “five-man-electrical-band--signs” and “five-man-electrical-band--signs-chords” (yes, I get the error on BH-iPad for the —chords file as well). I click the ‘-‘ for this file and save. I then click the ‘+’ Add documents. I am presented with a list that contains the “five-man-electrical-band--signs” file. I check it, and hit Save on the dialog and [Save] on Song Edit.
In BH-iPad, I click the ‘circled arrows’ sync icon. After sync, I am presented with the same error dialogs, including the one for the relevant file.
———
Fail 2:
I launch BH-iPad. It opens to the Projects menu. I must dismiss a rash of error dialogs before I can do anything - one of them is our “five-man-electrical-band--signs”. I select the ‘Krell’ project - which immediately results in the same dialog storm that must be dismissed one-by-one (including “five-man-electrical-band--signs”). I tap ‘Repertoire (whew! no dialog storm) > Songs (whew!) > ’S’ (whew!), Signs (whew! still no storm). Scrolling down, under Documents is listed both “five-man-electrical-band--signs” and “five-man-electrical-band--signs-chords”. Hmm. I delete them ( ‘-‘ - Remove). Tap ‘Add Documents’, and scroll down to see them in the list. I select them and Save. They are now again displayed in the Documents portion of <<song>> > edit. I hit the sync icon. I get another storm of error dialogs - including “five-man-electrical-band--signs”.
——
Works:
In BH-web, Repertoire>Documents the list contains “five-man-electrical-band--signs” - listed as 0 bytes, nothing listed for ‘Updated’ or ‘File’ columns. Select Edit for that list entry. I the file listed under ‘Name’, allocated to the correct Project, Me as a User, and Active is checked. Looks fine, right? Wait - Orientation is listed as ‘Orientation…’. Hmmm. And what is that ‘No file selected’ next to the [Browse]? Click [Browse], navigate to the file in my computer’s filesystem hierarchy, select it and click [Open]. There is now the filename next to the [Browse] button. Select an orientation, and hit [Save]. When the process finishes, the text next to [Browse] again says ‘No file selected’, though Portrait is listed for Orientation.
Selecting ‘Return to list’, I see the song listed with Updated date & time, and a File icon for this file.
Back on BH-iPad, I hit the sync icon. Another error storm, but this time, there is thankfully one less dialog to be manually dismissed - the one for “five-man-electrical-band--signs”
————
Discussion:
So after that wall of text, I apparently have a means of resolving my issue. Cool.
But I think things could be improved quite a bit.
1) Of the three places I looked to add the documents to the songs, each appearing to have a process to do so, only one works. (Further, it is the last place I looked, but that may be only due to the vagaries of how my individual mind makes associations). I would suggest implementing logic for the other two apparent mechanisms. Lacking that, do something that eliminates the impression that the other two mechanisms would yield the desired result.
1.5) I think I have seen the claim that BH-iPad does everything that SLM did. However, if there is not another way to attach documents to songs in BH-iPad (is there?), this claim would seem to be false. Apologies if such a claim has not been made.
2) BH-iPad seemed to be telling me that the relevant files were attached even though they were not (song>edit>Documents showed them in the list). I maintain that if they are not attached, they should not be shown as being attached.
2.5) Same as 2), but for BH-web>Repertoire>Songs><<song>> : there is a file icon there whether or not a song has been successfully attached. This is misleading.
2.75) Same as 2), but for BH-web>Repertoire>Songs><<song>> > Edit > Documents : the file appears there whether or not successfully attached. This is misleading.
2.875) Same as 2), but for BH-web>Repertoire>Documents><<song>> Edit > Name : the file appears there whether or not successfully attached. This is misleading.
3) This is probably the most important. I think the intent behind BH-iPad is that it is to be used as a tool in live performance. I would suggest that, though error indications are important, modal error dialogs (i.e. ones that must be dismissed manually before any other action can occur) have no place in a tool meant for live use. It takes me about a minute to click through all the missing dialog messages each time the error storm occurred. A minute is an eternity of futzing with borked technology when several hundred sets of eyes and ears are waiting for the downbeat of the next musical opus that will incite them into ecstatic frenzy.
3.5) If an error dialog is to appear anywhere, my preference would be not within BH-iPad, but rather within BH-web - whcih seems after all to be the only place that it can be resolved.
Thanks for listening!