Please select one of the links below to view the information related to that topic or question.
Search Tips:
OAIPMH Online Help
- Summary
- Identify
- ListMetadataFormats
- GetRecord
- ListIdentifiers
- ListRecords
- Example Requests
- Testing Resumption Token
Export metadata to JSON Help
FAQs:
- What is a Collection?
- What documents are listed in the "Recent Additions" area of the site?
- Why must I wait to download the articles on the "Coming Soon" page?
- What is a facet?
- How can I suggest another facet to be added to the site?
- What is the small "i" icon located within the site?
- How can I remove a selected facet to broaden my search results?
- After narrowing results with both a Volume and Issue facet, how can I quickly view all of the orginially available Volumes for that Collection?
- Can I sort my Search Results?
- How often is the Home page updated?
![Search Search Image](/congress115th/20190108195848im_/https://stacks.cdc.gov/sites/default/files/images/simpleSearch_helpImage_new.png)
The system performs the query based upon these five fields:
- Title
- Description
- Author Name
- Subject
- The Document itself
However, if you are searching for a phrase containing more than one word, quotation marks play a role. For example, entering "bicycles and pedestrians" (with quotation marks) will return fewer results than entering bicycles and pedestrians (without quotation marks). For more information see item 3 below, regarding what you want to search for.
![Getting Started Search Box](/congress115th/20190108195848im_/https://stacks.cdc.gov/sites/default/files/images/advancedSearch_helpImage_new.png)
The default is to search across all of CDC Stacks ("All Collections").
- To specify a single collection, select an item from the Collections drop-down list.
You can select up to three search categories and corresponding keywords using the fields above or you can select only one field and click the Search button.
- Select where you want to search from the Category drop-down list:
Advanced Search Categories:- Title
- Personal Author
- Corporate Author
- Conference Name
- Description
- Subject
- Genre
- Document Type
- Series
- Publication Date
- PMID
- PMCID
- Language
- Source
- DOI URL
- DOI
- Funding
- Input what you want to search for.
Note: If you enter two words separated by a space, one combined result set is returned. This input acts like first word OR second word.
For example, keying public transit returns a list of documents that contain the word public combined with a list of the documents that contain the word transit.
However, to obtain a more precise match from your search, phrases must be enclosed in quotation marks. Keying"public transit" (with quotation marks) returns the list of documents that contain the entire phrase public transit.
Advanced Search Category: Document TypeYou can now search on documents by the type of works they were published as; a book, journal article, newsletter, poster, report,etc. Select "Document Type" in the category drop-down, pick a specific document type in the drop-down that appears to the right, then click the "Search" button.
Document Type drop-down-options:
Advanced Search Category: Published DateTo search for a document by published date, select "Published Date" from the category drop-down and then enter either a date range in both fields that appear on the right or a single date in the first field. The following formats are accepted: MM/DD/YY, MM/YYYY, or YYYY
You can type the date directly within the fields or you can utilize the date picker by clicking the calendar icon to the right of each field. After entering the published date or date range, click the "Search" button.
Published Date, date picker drop down:
Advanced Search Category: LanguageCDC Stacks has documents in several different languages. To search for documents written in a specific language select "Language" in the category drop-down, pick a specific language in the drop-down that appears to the right, and then click the "Search" button.
Language drop-down options:
- To add additional search criteria, select the appropriate Boolean operator from the drop-down menu.
The following table describes the Boolean operators.AND Narrows your search and retrieve records containing all of the words it separates.
The search retrieves documents that use both search terms you entered.
OR Broadens your search and retrieve records containing any of the words it separates.
This search includes results that contain either of the search terms you entered.
NOT Narrows your search by excluding Articles that do not contain the term following it.
-
When all three drop-downs are used, it is assumed that parentheses go around the first two phrases. Refer to the following example below:
- (A AND/OR/NOT B) AND/OR/NOT C
- The search first gets a result completing (A AND/OR/NOT B).
- Next, it completes AND/OR/NOT C on the returned result.
- Lastly, the search results are displayed.
Note: By clicking on the "x" icon in any Search text box, you can clear that field. Or you can click the "Clear All" link to clear all the text boxes.
OAI-PMH specification is defined as a RESTful service, where each request requires certain attributes. A "verb" is described as to what is being asked. each verb can have different attributes.
A full description of the specifications can be found here.
OAI Verbs: Based on the 2.2 spec, the available verbs are: (the verbs are case sensitive)
- Identify
- ListMetadataFormats
- GetRecord
- ListIdentifiers
- ListRecords
This verb simply presents some metadata about the respository as a whole to the user:
Full URL: http://<host>/fedora/oai?verb=Identify
Extra parameters: none.
Retrieve the metadata formats available from a repository. For Stacks, only oai_dc is currently available.
Full URL: http://<host>/fedora/oai?verb=ListMetadataFormats
Extra Parameters:
- identifier (optional). if retrieving information about a specific format.
GetRecord
Retrieve an individual metadata record from a repository
Full URL: http://<host>/fedora/oai?verb=GetRecord&Identifier=<id>&metadataPrefix=<value>
Extra Parameters:
- identifier (required): the identifier for a given object
- metadataPrefix (required): specifies the metadataPrefix of the format that should be included in the metadata part of the returned record . Stacks supports oai_dc only.
This verb retrieves only headers rather than records. Useful if looking only for the metadata.
Full URL: http://<host>/fedora/oai?erb=ListIdentifiers&metadataPrefix=<value>
Extra Parameters:
- metadataPrefix (required): specifies the metadataPrefix of the format that should be included in the metadata part of the returned records. Stacks supports oai_dc only.
- from (optional): timestap for upperbound value of records to retrieve.
- until (optional): timestamp for lowerbound value of records to retrieve.
- set (optional): filter by set on selective haversting (not supported on stacks)
- resumptionToken: pagination functionality.
ListRecords
Similar to ListIdentifiers, but this method retrieves all records and not only headers.
FullURL: http://<host:<port>/fedora/oai?verb=ListRecords&metadataPrefix=<value>
Extra parameters:
Same as ListIdentifiers. (see above)
Examples:
https://stacks.cdc.gov/fedora/oai?verb=Identify
https://stacks.cdc.gov/fedora/oai?verb=ListMetadataFormats
https://stacks.cdc.gov/fedora/oai?verb=ListSets
https://stacks.cdc.gov/fedora/oai?verb=ListIdentifiers&metadataPrefix=oai_dc
Note: the resumptionToken parameter is mutually exclusive with other parameters. It is used to paginate through results and the token is given by each request under the tag <resumptionToken> at the end of the response.
Ex.: <resumptionToken expirationDate="2012-08-21T09:33:05Z" cursor="100">e80b606013a0a8274d91bb6b95d94bba</resumptionToken>
The first request will pass the appropriate values for other parameters, including metadataPrefix, from and util. subsequent pages have to pass only resumptionToken.
Testing Resumption Token
To test the resumptionToken through the browser, enter this URL:
Then, you will see a value for resumptionToken at the very bottom of the page. Get that value and enter it into the URL like this:
https://stacks.cdc.gov/fedora/oai?verb=ListRecords&resumptionToken ={RESUMPTION_TOKEN_HERE}
example:
https://stacks.cdc.gov/fedora/oai?verb=ListRecords&resumptionToken=002424143c551adba6847564277163c6
- https://<host>/fedora/export/download: Retrieve meta data from the repository as a file to be downloaded. The data will be in the format of JSON.
- https://<host>/fedora/export/download/collection/{pid}: Retrieve meta data of objects in a collection or multiple collections as a json file to be downloaded. For multiple collection, pids will be passed as a single value separated by ",", e.g. /fedora/export/download/collection/pid1,pid2,pid3
- https://<host>/fedora/export/view: Retrieve meta data from the repository to be viewed as a json file
- http://<host>/fedora/export/download/collection/{pid}: View meta data of objects in a collection as json data
- The following meta data will be returned: PID, mods.*, dc.*, keywords, fgs.*, rdf.*
- A data range can be passed as a SOLR date string to the request as parameters:
-
- from: e.g from=2017-01-01T00:00:00Z
- until: e.g until=2017-11-02T00:00:00Z
http://<host>/fedora/export/download/collection/{pid}?from=2017-01-01T00:00:00Z&until=2017-11-02T00:ListMetadataFormats00:00Z
- The number of records returned each time can be specified by the request parameter "rows", e.g rows=200
- The start record can be specified by the request parameter "start", e.g start=150
- If "rows" not specified and it is download, then all applicable data will be retrieved. Therefore, it is strongly recommended that the date range or a collection is passed to the request.
- If "rows" not specified and it is view, then by default only 100 rows of data will be returned each time, to view more, pass to the request the resumptionToken from the result.
A Collection includes documents that address a shared topic.
Searching within a collection allows you to narrow your search results.
The documents that are listed in this area of CDC Stacks site are the twenty documents that were most recently updated or added to the site. These documents are sorted by most recently updated or added to least by default and they may or may not be the most recently published documents.
These journal articles have been placed under a Public Access Embargo. This is the period of a maximum of 12 months in which access to academic journals is not allowed to users who have not paid for access (or have access through their institution).
The CDC Public Access to Publications Policy was developed to ensure that these journal articles may be made freely available to the public within 12 months of publication. Read more about the CDC Public Access to Publications Policy.
![Search Facets](/congress115th/20190108195848im_/https://stacks.cdc.gov/sites/default/files/images/facets_new.png)
A facet allows you to narrow your Search based on pre-defined topic categories.
You can email us at publishinghd@cdc.gov.
The small "i" icon is a tooltip. When you hover your cursor over the icon, additional information is displayed to help explain that section of the site.
![Volume Issue Facet Help](/congress115th/20190108195848im_/https://stacks.cdc.gov/sites/default/files/images/help_volumeissuefacet_new.png)
There are multiple ways to deselect a facet; Click the "x" to the left of the facet in the "Narrowed by" section above your results or deselect it within the "Narrow Results" box to the left of your results.
Simply click the "x" next to the selected Volume and this action will also remove the selected Issue as well.
Search results within a collection can be sorted by Relevance, Last Modified Date, Title, and Published Date.
The content for Recently Added and Popular Articles modules are updated every week. The Featured Article and In the Spotlight are updated every other month. The Featured Collection is updated whenever a new Collection has been added to the CDC Stacks repository.
To view a list of previous Spotlights, click the "Spotlight Archive" link at the bottom of the module.