Difference between revisions of "Public Atom Feed Usage"

From FPDS-NG
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
__NOEDITSECCTION__
+
__NOEDITSECTION__
 
==Introduction==
 
==Introduction==
−
FPDS-NG has data reporting web services that provide access in real-time to FPDS-NG’s central data repository. Now FPDS-NG will also provide real time feeds of the same contractual data using Atom feeds.<br><br>
+
FPDS-NG has data reporting web services that provide access in real-time to FPDS-NG’s central data repository. Now FPDS-NG will also provide contractual data using Atom feeds.<br><br>
 
ATOM Feeds can be accessed by the following methods:   
 
ATOM Feeds can be accessed by the following methods:   
 
<ul>
 
<ul>
Line 10: Line 10:
 
</li></ul>
 
</li></ul>
  
−
==Steps to access ATOM feed via portal==
+
==Steps to access the ATOM feed via portal==
  
 
1. Launch the URL https://www.fpds.gov  
 
1. Launch the URL https://www.fpds.gov  
Line 17: Line 17:
  
 
[[Image:Atom_search.jpg|frame|alt=Atom Search|center|thumb|300px300px|]]
 
[[Image:Atom_search.jpg|frame|alt=Atom Search|center|thumb|300px300px|]]
−
 
+
<br>
  
 
3. A new window will be launched with the search results.
 
3. A new window will be launched with the search results.
 
[[Image:search_results.jpg|frame|alt=Atom Results|center|300px300px|]]
 
[[Image:search_results.jpg|frame|alt=Atom Results|center|300px300px|]]
−
 
+
<br>
 
4. Search results can be narrowed by clicking the Advanced Search button.
 
4. Search results can be narrowed by clicking the Advanced Search button.
 
[[Image:Advanced_results.jpg|frame|alt=Advanced Results|center|300px300px|]]
 
[[Image:Advanced_results.jpg|frame|alt=Advanced Results|center|300px300px|]]
−
 
+
<br>
 
5. To automatically get notifed for the changes subcribe to ATOM feeds by clicking [[image:Atom.JPG]]  
 
5. To automatically get notifed for the changes subcribe to ATOM feeds by clicking [[image:Atom.JPG]]  
  
  
−
==Constructing the ATOM feed URL==  
+
==Constructing the ATOM feed URL==
  
 
To construct the Atom Feed URL with required search criteria follow the below methodology
 
To construct the Atom Feed URL with required search criteria follow the below methodology
Line 35: Line 35:
 
</pre>
 
</pre>
 
Repeat the search criteria to add additional search criteria
 
Repeat the search criteria to add additional search criteria
−
 
−
BASE_URL: https://beta.fpdsng.com/dbsight/FEEDS/ATOM?FEEDNAME=PUBLIC&q=
 
  
 
<b>Search Criteria Listing</b>
 
<b>Search Criteria Listing</b>
Line 96: Line 94:
 
</table>
 
</table>
  
−
'''Sorting:'''
+
'''REFRESH PROCESS:'''
−
 
+
<TABLE BORDER=2>
−
The data retrieved can be sorted by appending "sortBy=<dataElement>&desc=Y" to the URL. Where <dataElement> is one of the searchable fields.
+
<tr>
−
 
+
<td>
−
'''Example:'''
+
'''''Atom feeds are refreshed daily and will contain contracts that were reported on or before 9:00 PM Easter time. Contracts reported after 9:00 PM Easter time be available next day.'''''
−
<OL><LI>Search the data based on the Last Modified Date<br><br>
+
</td>
−
<pre>
+
</tr>
−
Atom_URL = https://www.fpds.gov/dbsight/FEEDS/ATOM?FEEDNAME=PUBLIC&q=
+
</TABLE>
−
          + LAST_MOD_DATE:[2006/04/02,2007/04/02]
 
−
</pre>
 
−
<br><br>
 
−
</li><li>Search the data based on:
 
−
* Last Modified Date
 
−
* GSA (Agency code of 3600)
 
−
<pre>
 
−
Atom_URL = https://www.fpds.gov/dbsight/FEEDS/ATOM?FEEDNAME=PUBLIC&q=
 
−
          + LAST_MOD_DATE:[2006/04/02,2007/04/02] + “ “
 
−
          + AGENCY_CODE:”3600”
 
−
</pre><br><br>
 
−
</li><li>Search the data based on the
 
−
* Last Modified Date
 
−
* GSA (Agency code of 3600)
 
−
* Awards only
 
−
<pre>
 
−
Atom_URL = https://www.fpds.gov/dbsight/FEEDS/ATOM?FEEDNAME=PUBLIC&q=
 
−
          + LAST_MOD_DATE:[2006/04/02,2007/04/02] + “ “
 
−
          + AGENCY_CODE:”3600” + “ “
 
−
          + CONTRACT_TYPE:"AWARD"
 
−
</pre>
 
−
</li></ol>
 
−
<br><br>
 
−
<b>Sample Atom URL:</b>
 
−
<pre>
 
−
https://www.fpds.gov/dbsight/FEEDS/ATOM?FEEDNAME=PUBLIC&q=LAST_MOD_DATE:[2006/04/02,2007/04/02] AGENCY_CODE:"3600" CONTRACT_TYPE:"AWARD"
 
−
</pre>
 

Latest revision as of 19:59, 8 August 2014

Introduction

FPDS-NG has data reporting web services that provide access in real-time to FPDS-NG’s central data repository. Now FPDS-NG will also provide contractual data using Atom feeds.

ATOM Feeds can be accessed by the following methods:

  • Using Portal
  • By constructing the URL

Steps to access the ATOM feed via portal

1. Launch the URL https://www.fpds.gov

2. Type the search criteria keywords in the ezSearch input text box and hit enter

Atom Search


3. A new window will be launched with the search results.

Atom Results


4. Search results can be narrowed by clicking the Advanced Search button.

Advanced Results


5. To automatically get notifed for the changes subcribe to ATOM feeds by clicking Atom.JPG


Constructing the ATOM feed URL

To construct the Atom Feed URL with required search criteria follow the below methodology 

Atom_URL = BASE_URL + “URL String of the Search Criteria 1” + " " + “URL String of the Search Criteria 2”

Repeat the search criteria to add additional search criteria

Search Criteria Listing

Search CriteriaURL String
Last Modified DateLAST_MOD_DATE:[2006/04/02,2007/04/02]
Agency CodeAGENCY_CODE:”3600”
Agency NameAGENCY_NAME:”General Services Administration”
Contracting AgencyCONTRACTING_AGENCY_ID:"5700"
Award Completion DateAWARD_COMPLETION_DATE:[2006/04/02,2007/04/02]
Award Status (Deleted | Final)AWARD_STATUS:”Final”
Contract Type (IDV | Award)CONTRACT_TYPE:”AWARD”
Contract IDPIID:”ABCD”
Contracting Agency NameCONTRACTING_AGENCY_NAME:”DEPT OF THE AIR FORCE”
Contracting Office ID CONTRACTING_OFFICE_ID:”FA8734”
Contracting Office NameCONTRACTING_OFFICE_NAME:”FA8734 ESC 554 ELSG PNPK”
Created ByCREATED_BY:”ABC”
Created DateCREATED_DATE:[2008/10/14,2008/10/14]
Date SignedSIGNED_DATE:[2006/04/19,2006/04/19]
Department IDDEPARTMENT_ID:”4700”
Department NameDEPARTMENT_NAME:”GENERAL SERVICES ADMINISTRATION”
Description of RequirementDESCRIPTION_OF_REQUIREMENT:"Katrina"
Effective DateEFFECTIVE_DATE:[2006/04/19,2006/04/19]
Estimated Completion dateESTIMATED_COMPLETION_DATE:[2006/04/19,2006/04/19]
Funding Agency IDFUNDING_AGENCY_ID:"4740"
Action Obligation OBLIGATED_AMOUNT:[4142,4150]
Funding Office IDFUNDING_OFFICE_ID:”W91278”
Funding Office NameFUNDING_OFFICE_NAME:”mobile”
Last Modified by LAST_MODIFIED_BY:”ABC”
Legislative MandatesLEGISLATIVE_MANDATES:”walsh”
Local Area Set Aside ( Y | N)LOCAL_AREA_SET_ASIDE:”N”
Modification NumberMODIFICATION_NUMBER:”1”
Multiyear contractMULTIYEAR_CONTRACT:”Y”
NAICS CodePRINCIPAL_NAICS_CODE:”511210”
NAICS DescriptionNAICS_DESCRIPTION:”SOFTWARE PUBLISHERS”
National Interest Action CodeNATIONAL_INTEREST_CODE:”T10S”
National Interest DescriptionNATIONAL_INTEREST_DESCRIPTION:”Samoa”
Product or Service CodePRODUCT_OR_SERVICE_CODE:”J070”
PSC DescriptionPRODUCT_OR_SERVICE_DESCRIPTION:”GUNS”
POP congressional District CodePOP_CONGRESS_DISTRICT_CODE:"04"
POP Country NamePOP_COUNTRY_NAME:”UNITED STATES”
POP State NamePOP_STATE_NAME:”VIRGINIA”
Reason for ModificationREASON_FOR_MODIFICATION:”D”
Reference IDV PIIDREF_IDV_PIID:”ABC”
Reference IDV Agency IDREF_IDV_AGENCY_ID:”4740”
Socio Economic IndicatorsSOCIO_ECONOMIC_INDICATORS:”SMALL BUSINESS”
Type of Contract PricingTYPE_OF_CONTRACT_PRICING:"J"
Ultimate Contract ValueULTIMATE_CONTRACT_VALUE:[13587,13600]
Vendor CityVENDOR_ADDRESS_CITY:”WAKEFIELD”
Vendor congressional District CodeVENDOR_CONGRESS_DISTRICT_CODE:”04”
Vendor Country CodeVENDOR_ADDRESS_COUNTRY_CODE:”USA”
Vendor Country NameVENDOR_ADDRESS_COUNTRY_Name:”UNITED STATES”
Vendor DUNS NumberVENDOR_DUNS_NUMBER:”1207920560000”
Vendor Doing Business As NameVENDOR_DOING_BUSINESS_AS_NAME:”ABC”
Vendor NameVENDOR_NAME:”ABC”
Vendor State CodeVENDOR_ADDRESS_STATE_CODE:"VA"
Vendor State NameVENDOR_ADDRESS_STATE_NAME:"Virginia"
Vendor Address Zip CodeVENDOR_ADDRESS_ZIP_CODE:”20190”

REFRESH PROCESS:

Atom feeds are refreshed daily and will contain contracts that were reported on or before 9:00 PM Easter time. Contracts reported after 9:00 PM Easter time be available next day.

Retrieved from "https://fpds.gov/wiki/index.php?title=Public_Atom_Feed_Usage&oldid=4450"