Using LongReach/Documents (RPG)

[rgjohnson]

I am trying to do some things with the Documents element using LongReach and am having trouble getting the Documents element on the mobile device to work with the LongReach server. The documentation refers to a directive in the client.xml file that does not even exist in mine:

(<rootDirectory>{BASE}</rootDirectory>

I am using the LongReach app from my mobile and can sync up with the server fine so I know the server itself is configured and running correctly. I have not changed any of the settings in the httpd.xml file and am trying to use the standard SHARED and USER paths, but I can't get either to work. No matter what I put in the Folder property, no files are ever displayed and I get an error "Missing path value" if I try to use the "Refresh File List from Server" option in the Document element even though I have provided a path in the Folder property. I have checked authorities for al folders/files involved to make sure my user ID has all access.

Is there some secret to getting this to work? Can I get a copy of what my client.xml file should contain since I don't believe mine has everything in it that should be there?

Thanks.

[Pablo]

You are correct, the shipped client.xml is missing the document library entry.
This is a mistake that will be corrected.

For now, please add it to yours so that it looks something like this:

<config>
<servicesProvider>
<url>http://nnn.nnn.nnn.nnn:pp/service/longreach.jsp</url>
<documentLibrary>
<rootDirectory>{BASE}</rootDirectory>
</documentLibrary>
</servicesProvider>
</config>

[rgjohnson]

Thanks Pablo, that worked perfectly!

[rgjohnson]

I originally had the AllowChanges property set to Yes for my Documents element. When I first display a folder no files are displayed. I have to manually select the "Refresh Files from Server" option at which time all files in my folder are then displayed in the Documents element. The problem I have is that this particular element needs to be "AllowChanges : No" as these files are maintained on the server and cannot be altered by mobile users. When I set the AllowChanges property to No, all options vanish from the bottom of the Documents element including the "Refresh Files from Server" option. Now when a user first displays a particular folder no files are displayed, and there is no option available to the user to refresh the list.

It seems if the AllowChanges property is set to No, displaying the Documents element should automatically refresh the files from the specified folder. Since the user is only allowed to display the existing files and not make changes, I would think the list of files would automatically be refreshed each time the element is displayed, or I could atleast have the ability to programmatically refresh the list from the server when necessary.

How can I currently get the list of files in a folder to display in the Documents element if the AllowChanges property is set to No?

[Pablo]

Using the the shipped example EXAM0029:

AllowChanges : Yes

New, Synchronize and Local are available at the bottom.
Synchronize has 3 options: Refresh file list from server, Make files on this folder available offline and Upload all changes to server.

AllowChanges : No

New is gone and Synchronize and Local are available.
Synchronize has 2 options: Refresh file list from server and Make files on this folder available offline.

In both cases the list of files in the folder is showing - routine SetDOCLIBFolder

Could you try the shipped example and see if you get the same results?

Thanks.
Pablo

[rgjohnson]

Well, I tried EXAM0029 and it worked fine with AllowChanges Yes and No. I recompiled my display file and program and tested it again and now it is working fine. We had tested 2 different iPads earlier and had the same result on both; changing the AllowChanges to No removed all the options from the Document element including the Synchronize and Local. If I can figure out how to make that happen again I wil let you know.

In the mean time, my only knock on how it works is still that the user is required to manually use the Refresh File List From Server option every time the Document element is displayed. Anytime a new product (new folder) is displayed it is always displayed with no files on the list and the user must manually use the Synchronize option to actually see anything. I still think this should happen automatically, or I should atleast be able to force a refresh programmatically.

[rgjohnson]

Pablo, I forgot to also mention that my issue of the Documents element always showing up blank initially and requiring you to manually use the Synchronize option to actually see any files worked the same way in EXAM0029. I thought I would mention that just in case it is supposed to be doing something different.

When I first tested EXAM0029 and went to the Shared box, no files were displayed at all. Using the Refresh File List From Server option then brought up the folders and files in the Shared box.

[Pablo]

OK, I understand, we will look at it.