Downloads: Toolkits
Download the Talis Keystone Developer’s Toolkit
These toolkits are designed to make working with Talis Keystone even simpler, abstracting the Web Services layer and encapsulating the SOAP and REST logic into a simple object library. The toolkits contain all of the binaries, documentation, working code examples and even the source code - licensed under the Open Source GNU General Public Licence. The working code examples have been configured to access the instance of Talis Keystone running in the Talis Keystone sandbox, which is live and accessible on the Internet.
After you download the appropriate toolkit, unzip it and then refer to the “README.txt” to get started.
Java Toolkit
.NET Toolkit
TalisKeystoneDotNETToolkit.zip
JSP Example
This is a simple J2EE web application which displays a borrower summary and single sign-on link in a Java Server Page (JSP) MyLibraryAccountSummary.zip. If you wish to quickly execute this application and
get it running Apache Tomcat for example then this J2EE WAR file has been tested on Java 5.0 and Tomcat 5.5. Drop it into the Tomcat /webapps directory and start the server: it will automatically expand and point to the Talis Keystone sandbox. The following URL's have been tested with it (local machine)
http://localhost:8080/MyLibraryAccountSummary/?studentId=DTBDM3P
http://localhost:8080/MyLibraryAccountSummary/?studentId=GENXW1
http://localhost:8080/MyLibraryAccountSummary/?studentId=LOTGA1CD
If you have a specific requirement or something to share, come and join the discussion in the forum.
TalisKeystoneJavaToolkit.zip
Can't download TalisKeystoneJavaToolkit.zip. Broken link at http://www.talis.com/keystone_toolkit/TalisKeystoneJavaToolkit.zip. Also, were there Java code samples as well as PHP samples here at one time.
Thank you for pointing this out - I will get it resolved
Hi John,
Please accept my apologies for the broken link. I will get this resolved as soon as possible. I will let you know when the toolkits are available again.
Kind regards,
-Andy
Andy Latham
Programme Manager, Talis Keystone
Talis Information Limited
www.talis.com
PHP Code samples are still here
Hi John,
The PHP code samples are still avaliable:
http://www.talis.com/tdn/keystone/phpcode
The Java code examples are part of the Java toolkit download (which I'm on the case to get sorted).
Many thanks,
-Andy
Andy Latham
Programme Manager, Talis Keystone
Talis Information Limited
www.talis.com
Talis Keystone - Toolkits now available
Hi John,
Both of the toolkits are now available.
Please accept my apologies for the inconvenience
Kind regards,
-Andy
Andy Latham
Programme Manager, Talis Keystone
Talis Information Limited
www.talis.com
. Net toolkit
We need to test keystone working with .net. Unfortunately, we get an error when trying to unzip the toolkit.
. Net toolkit
Hi Jane,
I've just tried to unzip the .NET toolkit and it extracts without a problem - Can you try downloading again and unzipping on another machine, if that fails can you post the error that you get?
Richard Francis,
Support, Talis
.NET toolkit
I get an error trying to extract the .NET toolkit. The error is
"The Compressed (zipped) Folder is either invalid or corrupted."
.NET toolkit
Hi - what are you using to unzip the zip file?
Andy Latham
Senior Solutions Consultant
Talis Information Limited
www.talis.com
RE:
I'm using the Windows (zipped) extraction wizard. I think it is the default extraction tool that came with Windows XP.
I've got exactly the same
I've got exactly the same problem, could someone send me the toolkit please?
Thanks, Paul
JSP Toolkit - Integration between Blackboard and Keystone
Hi,
Our uni is in the process of integrating Keystone into our Blackboard system. In case you haven't heard of Blackboard, it is a virtual learning envrionment, that is developed on JAVA platform, and generally sits on a linux box.
So your JSP Toolkit is obviously the best choice. I've downloaded the JSP Toolkit, and tried it on my local Tomcat server. It worked fine. I can connect to your sandbox server. I can connect to our Keystone server without any problem.
The problem happened when I installed the JSP toolkit onto our Blackboard server in the form of a building block. The exception I got is:
-----------------------------------------------------------------------------------
java.security.AccessControlException: access denied (java.net.SocketPermission sandbox.talis.com:80 connect,resolve)
-----------------------------------------------------------------------------------
It seems more like a security policy problem. I just wondered if anyone has heard of this problem before when using the JSP toolkit.
Why the toolkit worked fine on one tomcat server, but not another?
Should I ask our Blackboard server admin to modify the policy file on the Blackboard server?
Thanks in advance.
JSP Toolkit - Integration between Blackboard and Keystone
Hi,
I believe this is a security issue with the Blackboard server, which is preventing outbound connection to the TalisKeystone server. So I would strongly recommend that you speak to your Blackboard server admin and modify the policy file.
My knowledge of Blackboard is limited but I think if you add the following lines in the bb.manifest.xml file , between the opening and closing <permissions> tags, might resolve your problem:
<permission type="socket" name="*" actions="accept,connect"/>
<permission type="java.util.PropertyPermission" name="*" actions="read,write"/>
Hope this helps.
Please let us know how you get on.
Mohammed Hossain
Solutions Consultant
Talis
JSP Toolkit - Integration between Blackboard and Keystone
Hi,
< permission type="socket" name="*" actions="accept,connect"/> solved the problem.
Many thanks,
Su
Blackboard Building Block
Hi - just starting to build a Blackbaord Building Block for us to use here at Brighton. Any chance I could get a copy of yours to save me taking the same learning curve? Much appreciated if poss!
Thanks
Katie
JSP Toolkit - Integration between Blackboard and Keystone (2)
Hi,
I've posted a previous message here regarding some socket permission problem while integrating Blackboard with keystone service. This socket permission problem happened while we were working on our blackboard development server. With your help, the socket permission problem was solved, and we have no problem to integrate our keystone service inside our blackboard development server.
Now we moved onto our blackboard live server, and we encountered a strange problem.
We are able to call the sandbox keystone service (http://sandbox.talis.com/TalisKeystone/ViewMyAccountRESTService) from our live blackboard server without any problem.
But once we changed the ViewMyAccountToolkit.properties file to point to our own keystone service, I got this Unable to invoke REST service due to IOException error. The detailed messages are:
Creating borrowerIdentifier object.
com.talis.integration.services.BorrowerIdentifier [BORROWER ID=9686883] [BORROWER ID TYPE=InstitutionIdNumber]
Creating BorrowerAccount object.
com.talis.integration.services.ClientServiceException: Unable to invoke REST service due to IOException [Ljava.lang.StackTraceElement;@18c24b9
You can see the exception happens when trying to create the BorrowerAccount object. I tried to trace the stack info, but couldn't find any useful info there.
The thing I don't understand is why the live blackboard server is able to invoke the sandbox service without any problem, but got the IOException error when connecting to our own keystone service.
Could the version of Java on the blackboard server be an issue?
What does, "com.talis.integration.services.ClientServiceException: Unable to invoke REST service due to IOException", usually indicate? Is there anyway we can trace more info about this IOException problem?
I'm running out of ideas, please help.
Thanks in advance.
Su
Can I check a few things please
Hi Su,
An IO exception would indicate that a call to the web services has failed somehow. Can I check a few things please:
1) Is your local Talis Keystone service started up OK? Can you See the Talis Keystone service in a web browser for example?
2) Does the borrower you have requested exist in your system? If it doesn't I would have expected the error to be more meaningful than this, but just so i can be sure...
3) Does your live blackboard server have permission to see the port on which Talis Keystone is running? You could check this by logging into your live blackboard box and opening up a telnet session to the Keystone port on the Prism server (default port is 8080 btw) and sending in a HTTP GET request. All of this assumes that keystone has started up on your system, as per question (1)...
4) I don't think the version of Java is an issue here. If you were running the Toolkit with a JVM version which is previous to the one the Toolkit was compiled with I would not expect you to have got this far. You would have seen a major/minor class error in the stack trace.
If you could check your keystone system and validate the borrower in the first instance and let me know then that would be great! If all this is ok we can continue trouble shooting this for you.
Would you like to open up a support call for this?
Many thanks,
-Andy
Andy Latham
Senior Solutions Consultant
Talis Information Ltd
www.talis.com
JSP Toolkit - Integration between Blackboard and Keystone (2)
Hi Andy,
Many thanks for the suggestions. To answer your questions 1 and 2 first, I can confirm that there is no problem with our keystone service or with any of the dummy student IDs we have been using. The fact is the blackboard building block works fine on our development server, and we can see all the dummy students' library account summaries on our blackboard development server.
We're still talking to our network manager to see if there is any problem with our live blackboard server as you've suggested in 3.
So far, we don't see a need for a support call, yet. I'll get back to you when I have more info from our network manager.
Many thanks,
Su
JSP Toolkit - Integration between Blackboard and Keystone (2)
Hi Andy,
We've solved the problem. As you've suggested in (3), we found out that our blackboard server didn't have permission to see our talis server through the firewall. After our network engineer modified the firewall rules, the problem is solved. Now our students can see their library account summary when they use blackboard.
Many thanks,
Su