Search

How to narrow down your search results using the facets:
  • Articles about using, installing, and administering Jama will be in the Knowledge Base community.
  • Content about releases, webinars or product news will be in the Release Notes and Announcements community.
  • User questions about using Jama or bug reports will be in the Support community.
The search engine uses common functionality.
  • Boolean operators: AND in between terms will return results containing both terms; OR will return results containing either term.
  • Stemming: if you search for "review" it will return results for reviewing and reviewed.
1 to 12 of 12
Sort by

Blog Entry
Throttle Jama REST/SOAP API Requests - 8.0 and above

Overview Jama provides an option to help system admins protect their Jama servers. The system can stop aggressive integrations from overwhelming the CPU and degrading overall system performance by throttling the threads available and queuing API requests. This option is configurable to fit the CPU cores available and requires a restart to enable. The setting for threads will not reserve...

Steve's profile image

Blog Entry
How to retrieve items from a certain location in the document tree via Jama's SOAP or REST API

To retrieve items from a certain location in the document tree: Using SOAP: Use getItemsFromTextSearch to search for items with the target location's API ID as the parent. For example, to find items directly under the folder or set with the API ID of 5: // service is an initialized ContourSoapService object (created by // importing the WSDL descriptor file) // token is a WsAuth...

Jason's profile image

Blog Entry
"The SOAP API is not licensed" error message when making a SOAP API call

Problem: When making a SOAP API call, Jama responds with the error message "The SOAP API is not licensed." This most commonly occurs when using a client like SoapUI . Example Request: <soapenv:Envelope xmlns:soapenv=" http://schemas.xmlsoap.org/soap/envelope/"> ; xmlns:v3= " http://v3.ws.contour.jamasoftware.com/">; <soapenv:Header/> <soapenv:Body...

Jason's profile image

Blog Entry
Getting more insight into logging (specifically for API Calls)

There are three main locations where you can find logs pertaining to​ the API and SOAP calls in Jama: contour-api.log contour-access.log contour.log All these are located in the [tomcat home]/logs/contour folder in versions 2015.5 and prior. For versions 8.0+, you can find the logs in Support > container > jamacore > files > var > log> tomcat >....

Carmen's profile image

Blog Entry
SOAP API Workaround to address that batch update details are not stored in the event entry

First of all, be aware that the GetActivities() function won't get you any changes made by a batch update as these are not stored in the EventEntry table. This article will cover a workaround to get an item even if it was updated through a batch update. We propose using a filter to check the modifiedDate of an item and comparing it to your last sample. Please check this example of how you...


Blog Entry
How to create a relationship with the SOAP API

An item in Jama can have an upstream or downstream relationship with another item to indicate dependancies between items. To create a relationship via the SOAP API, use the createRelationships method. You will need the API ID of both items in the relationship. For example: <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v3="http:/&...

Jason's profile image

Blog Entry
Jamacloud (hosted) SOAP Throttling - Enabled July 11th

At Jama Software our goal is to provide customers with not only the features they need to build great products, but with a responsive application that won’t slow them down. Beginning July 11th, Jama’s SaaS environment "jamacloud" will be throttling SOAP requests. The application servers will have a maximum number of threads available for responding to SOAP requests to prevent...

Steve's profile image

Blog Entry
What ID needs to be used with the SOAP API?

Some SOAP API calls require the ID of the object they should return. The calls getItem and getProject are examples. These calls use the API ID of the object. The API ID is always an integer (number). Note that this is different than the Document Key ("CP-FEAT-6") and Global ID ("GID-6"). The API ID of the item can be found by setting the API ID as a visible column in a list view. Select ...

Jason's profile image

Blog Entry
How can I move Items using SOAP API?

There are use cases where you need to re-order items in a folder using Jama's SOAP API. Currently there is no direct call in the SOAP API to re-order items. However, you still can do that using the moveDocument call as explained here. Note: The WsItem has setters for Sequence and SortOrder. However, these two can not be set by users as Jama handles these two parameters internally. ...


Blog Entry
SOAP Throttling

SOAP Throttler Overview (2015.x releases only) *Configuration of in app throttling has changed for 8.x releases* The 2015.1 release of Jama introduces a new option to help system admins protect their Jama servers. The system can now stop aggressive SOAP integrations from overwhelming the CPU and degrading overall system performance by throttling the threads available and queuing SOAP...

Steve's profile image

Blog Entry
Using Jama SOAP API for test automation

We highly recommend to use our REST API for test automation as we are not expanding our SOAP API anymore. Our hosted customers have access to our REST API and as of Jama 8.0.2 , our on-premises can also enable REST. Please refer to this link for a comprehensive guideline on how to implement test automation using REST. The current SOAP API in Jama includes several useful calls that can...


Blog Entry
Using getItemsFromTextSearch() instead of getItemsFromFilter()

Regarding getItemsFromFilter(), this service call was originally intended for the 2.x version of Contour, not the latest version which instead uses smart filters. Currently no service calls exist to use smart filters or to assemble them. Objects and service calls do still exist to use the deprecated filters from 2.x, but there is really no advantage to using these. From this point...

Jama's profile image