OpenNTF/SocialSDK

SBTPlayground.nsf contains no documents

jrobichaux opened this issue · 6 comments

The SBTPlayground.nsf database contains no documents (it's supposed to be full of snippets).

It also will not open unless you have also installed the XPages Bazaar update site from https://openntf.org/p/XPages%20Bazaar (there is a dependency on one of those plugins). Perhaps those plugins could be included with the com.ibm.sbt.domino.playground.updatesite, or this dependency could be documented in a README in /sbtsdk/redist/domino or something.

actually it is not suppose to be full of documents, you should be pulling the data from the import.

I apologize for being dense, but what am I supposed to import?

I opened the database in my Notes client, clicked the "Manage" button at the top, and I have an empty view with some possible actions. "Import from a zip file..." looks promising, but I don't know what zip file to import. Is there a README file or a wiki entry I missed?

Thanks.

There is no documentation for the project. You'll have to look at the XSPs in a Web Browser. They are prefixed with Import. You can then import from GitHub.

I guess this issue thread will become the documentation. ;)

I opened the ManageImportJavaSnippets page and created an import source with Source Type of GitHub Repository. Set the location to https://github.com/OpenNTF/SocialSDK , saved, and clicked "Import from source". Got this error:

Error while importing assets from source "GitHub" com.ibm.sbt.services.client.ClientServicesException:

You'll need to include more detail - most likely it's due to your credentials. you can also import from disk, you just need to download the source.

That was the full error message. Both on the web page and on the Domino server console. Nothing in the trace log.

However, I do have the most recent source downloaded, and I seem to have been able to do a successful import from there. Here are the steps I used:

  1. Download the SBT source from https://github.com/OpenNTF/SocialSDK/releases and unzip it to your hard drive.
  2. Open the SBTPlayground.nsf database, either in the Notes client or in a browser. If you are in a browser, make sure you are logged in (the top right of the page should have your user name, not "Anonymous").
  3. Click the "Manage" button/action at the top of the page.
  4. Click the "Customization" item in the sidebar list.
  5. Make sure all of the "snippets" options are set to true, and click "Save".
  6. Now you should have items for all the Snippets in the sidebar, and beneath each snippet there is also an Import item for that snippet.
  7. Click the "Import Java Snippets" item in the sidebar.
  8. Click "New Import Source" and enter the following information in the fields (you can leave User and Password blank):
    • Source Name: Local
    • Source Type: File System
    • Location: C:\Users\julian\Desktop\SocialSDK-1.1.11.20151208-1200\samples\j2ee\snippets\com.ibm.sbt.sample.web\src\main\webapp\samples\java\

Obviously you will want to change the Location path to match the place where you unzipped the SocialSDK source.

After you click the "Save" button, the new Import Source will appear in the Java Import view with a link beneath it that says "Import from source". Click that link and the Java samples will be imported and will now appear in the Java Snippets view.

The other snippets should be the same process, by replacing \java\ in the filepath with \js, \xpages, etc.

What would be really nice is if the samples were either (A) already included in the NSF, or (B) the files to be imported were included with the the release download that includes the NSF so you can import them right away without having to also download the source or figure out how to make the GitHub option work. They are already included in the EAR file and the WAR file in the "samples" folder of the release download, maybe there could be a separate subfolder like samples\domino?