Skip to content

Commit 218f106

Browse files
committed
changes for travis and readme updates
1 parent 139f250 commit 218f106

File tree

8 files changed

+40
-106
lines changed

8 files changed

+40
-106
lines changed

README.md

Lines changed: 34 additions & 87 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,14 @@
11
V3-JAVA-SDK
22
===========
33

4-
V3-JAVA-SDK
4+
**Help:** [Support](https://developer.intuit.com/help), [Samples](https://developer.intuit.com/docs/0100_quickbooks_online/0400_tools/0005_sdks/0200_java/0004_sample_code_and_sample_apps) <br/>
5+
**Documentation:** [User Guide](https://developer.intuit.com/docs/0100_quickbooks_online/0400_tools/0005_accounting/0200_java/0001_quick_start), [JavaDocs](https://developer-static.intuit.com/SDKDocs/QBV3Doc/ipp-v3-java-devkit-javadoc/index.html)
6+
<br/>
7+
**Continuous Integration:** <br/>
8+
**License:** [![Apache 2](http://img.shields.io/badge/license-Apache%202-brightgreen.svg)](http://www.apache.org/licenses/LICENSE-2.0) <br/>
59

610

11+
## Overview
712
The QuickBooks Online Java SDK provides a set of Java class libraries that make it easier to call QuickBooks Online APIs, and access to QuickBooks Online data. Some of the features included in this SDK are:
813

914
* Ability to perform single and batch processing of CRUD operations on all QuickBooks Online entities.
@@ -19,109 +24,51 @@ The QuickBooks Online Java SDK provides a set of Java class libraries that make
1924
* Sparse Update to update writable properties specified in a request and leave the others unchanged.
2025
* Change data that enables you to retrieve a list of entities modified during specified time points.
2126

22-
## Project Overview
27+
## Project Structure
2328
* ipp-v3-java-data - contains all entities and entity dependencies that are used in data services operations
2429
* ipp-v3-java-devkit - core component, contains rest API support
2530
* ipp-v3-java-devkit-assembly - builds final deployment package (zip) which includes everything
2631
* ipp-v3-java-devkit-shaded-assembly - builds lightweight version (some dependencies excluded)
2732
* ipp-v3-java-devkit-javadoc - contains javadoc for data and devkit classes
2833

29-
## Sample Apps
34+
## System Requirements
35+
The SDK works on JDK 1.6 and above.
3036

31-
* [CRUD Sample](https://github.com/IntuitDeveloper/SampleApp-CRUD-Java)
32-
* [Webhooks Sample](https://github.com/IntuitDeveloper/SampleApp-Webhooks-Java)
33-
* [OAuth Sample](https://github.com/IntuitDeveloper/oauth-java)
34-
* [OpenId-OAuth Sample](https://github.com/IntuitDeveloper/SampleApp-OpenID-Oauth-Java)
37+
## First Use Instructions
38+
1. Clone the GitHub repo to your computer
39+
2. Import it to the IDE of your choice
3540

36-
## Documentation
37-
* [Class Library Reference](https://developer-static.intuit.com/SDKDocs/QBV3Doc/ipp-v3-java-devkit-javadoc/index.html)
38-
* [Installation and SDK user guide](https://developer.intuit.com/docs/0100_quickbooks_online/0400_tools/0005_accounting/0200_java/0001_quick_start)
41+
## Testing the code & building artifacts
42+
To test the code locally, follow the steps below:
43+
1. Update keys and tokens in [ippdevkit.properties](https://github.com/intuit/QuickBooks-V3-Java-SDK/blob/master/ipp-v3-java-devkit/src/test/resources/ippdevkit.properties)
44+
Not sure how to get the tokens? Refer this [blog](https://developer.intuit.com/hub/blog/2016/04/25/quick-start-to-quickbooks-online-rest-api-with-oauth1-0) post to get on boarded with OAuth1 quickly.
45+
2. cd to the project directory
46+
3. Run the command: `mvn install` - this will run the unit test, build the project and generate data & devkit jars
3947

40-
## Building components
41-
To build out individual components such as ipp-v3-java-data.jar or ipp-v3-java-devkit.jar, remove parent dependency from the pom.xml and run maven install.
48+
Note: To build out individual components such as ipp-v3-java-data.jar or ipp-v3-java-devkit.jar, remove parent dependency from the pom.xml of the respective projects and run maven install on the individual project folders.
4249

4350
## Release Notes:
51+
Refer [Java SDK Release Notes](https://developer.intuit.com/docs/0100_quickbooks_online/0400_tools/0005_sdks/0200_java/0080_quickbooks_java_sdk_release_notes)
4452

45-
* V2.8.0 (12/19/2016)
46-
* Removed QBD and IAM Cookie code
47-
* Added support for AuthorizationFault response
48-
* Updated javadoc for findAll method
49-
* Updated httpclient library for platform API (ipp-java-qbapihelper-1.2.2.jar)
50-
* Updated disconnect and reconnect API to return response in platform API (ipp-java-qbapihelper-1.2.2.jar)
51-
52-
* V2.7.1 (11/28/2016)
53-
* Minor version 8 support
54-
* cc/bcc field support for Invoice and Preferences entities
55-
* HttpClient 4.5.2 support
56-
57-
* V2.6.0 (10/14/2016)
58-
* Webhooks support
59-
* Error code 429
60-
61-
* V2.5.0 (05/15/2016)
62-
* Minor version 5 support
63-
* cc/bcc field support for Invoice and Preferences entities
64-
* HttpClient 4.5.2 support
65-
66-
* V2.4.0 (09/28/2015)
67-
* This version includes minor version 3 (default) and 4 support. It also has number of bugfixes.
68-
* Support for voiding transactions, viewing transactions as PDF, and sending transactions as email
69-
70-
* V2.3.2
71-
* Added JSON support for SyncErrorResponse
72-
* Adding data jar packages
73-
74-
* V2.3.1
75-
* Added reports, General Ledger, Vendor Balance Detail, AP Aging Detail.
76-
* Added timeout support for AMEX.
77-
78-
* V2.3.0
79-
* HttpURLConnection
80-
* Tax Agency create
81-
* Tax Code create
82-
83-
* V2.2.1
84-
* v72 Reports
85-
86-
* V2.2.0
87-
* Include param support
88-
89-
* V2.1.2
90-
* Default minor version 1
91-
92-
* V2.1.1
93-
* Modifications for CRT APIs
94-
95-
* V2.1.0
96-
* Regenerated POJOs - v71
97-
* Added minorVersion flag
98-
* Added code to ignore JSON additional fields
99-
100-
* V2.0.4
101-
* Regenerated POJOs - v70
102-
* Added AuthenticationApplicationFailed fault type
103-
104-
* V2.0.3
105-
* Separate jars
106-
* Tested for 8.1 and v69
53+
## Contribute:
54+
We greatly encourage contributions! You can add new features, report and fix existing bugs, write docs and
55+
tutorials, or any of the above. Feel free to open issues and/or send pull requests.
10756

108-
* V2.0.2
109-
* consolidated jar
57+
The `master` branch of this repository contains the latest stable release of Wasabi, while snapshots are published to the `develop` branch. In general, pull requests should be submitted against `develop` by forking this repo into your account, developing and testing your changes, and creating pull requests to request merges. See the [Contributing to a Project](https://guides.github.com/activities/contributing-to-open-source/)
58+
article for more details about how to contribute.
11059

111-
* V2.0.1
112-
* Request Id non static method
113-
* Tracking id implementation
114-
* Platform API deprecation - including qbapihelper jar
60+
Steps to contribute:
11561

116-
* V2.0.0
117-
* Regenerated classes with new XSD (v67 + IDs 8.0)
62+
1. Fork this repository into your account on Github
63+
2. Clone *your forked repository* (not our original one) to your hard drive with `git clone https://github.com/YOURUSERNAME/QuickBooks-V3-Java-SDK.git`
64+
3. Design and develop your changes
65+
4. Add/update unit tests
66+
5. Create a pull request for review to request merge
67+
6. Obtain approval before your changes can be merged
11868

119-
* V1.0.9
120-
* Added support for request id as a param
69+
Note: Before you submit the pull request, make sure to remove the keys and tokens from [ippdevkit.properties](https://github.com/intuit/QuickBooks-V3-Java-SDK/blob/master/ipp-v3-java-devkit/src/test/resources/ippdevkit.properties) that you might have added for testing purpose.
12170

122-
* V1.0.8
123-
* Connection and Socket Timeout support
124-
* Added environment variables (for builds) in devkit project
71+
Thank you for your contribution!
12572

12673

12774

ipp-v3-java-data/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@
7171
<groupId>org.apache.maven.plugins</groupId>
7272
<artifactId>maven-deploy-plugin</artifactId>
7373
<configuration>
74-
<skip>false</skip>
74+
<skip>true</skip>
7575
</configuration>
7676
</plugin>
7777

ipp-v3-java-devkit-assembly/pom.xml

Lines changed: 1 addition & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -34,22 +34,10 @@
3434
<artifactId>ipp-v3-java-data</artifactId>
3535
<version>${release.data.version}</version>
3636
</dependency>
37-
<dependency>
38-
<groupId>com.intuit.code.devkit.v3</groupId>
39-
<artifactId>ipp-v3-java-data</artifactId>
40-
<version>${release.data.version}</version>
41-
<classifier>javadoc</classifier>
42-
</dependency>
43-
<dependency>
44-
<groupId>com.intuit.code.devkit.v3</groupId>
45-
<artifactId>ipp-v3-java-devkit</artifactId>
46-
<version>${release.devkit.version}</version>
47-
</dependency>
4837
<dependency>
4938
<groupId>com.intuit.code.devkit.v3</groupId>
5039
<artifactId>ipp-v3-java-devkit</artifactId>
5140
<version>${release.devkit.version}</version>
52-
<classifier>javadoc</classifier>
5341
</dependency>
5442
<dependency>
5543
<groupId>com.intuit.code.devkit.v3</groupId>
@@ -83,7 +71,7 @@
8371
<groupId>org.apache.maven.plugins</groupId>
8472
<artifactId>maven-deploy-plugin</artifactId>
8573
<configuration>
86-
<skip>false</skip>
74+
<skip>true</skip>
8775
</configuration>
8876
</plugin>
8977
</plugins>

ipp-v3-java-devkit-shaded-assembly/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@
6161
<groupId>org.apache.maven.plugins</groupId>
6262
<artifactId>maven-deploy-plugin</artifactId>
6363
<configuration>
64-
<skip>false</skip>
64+
<skip>true</skip>
6565
</configuration>
6666
</plugin>
6767
</plugins>

ipp-v3-java-devkit/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@
5252
<groupId>org.apache.maven.plugins</groupId>
5353
<artifactId>maven-deploy-plugin</artifactId>
5454
<configuration>
55-
<skip>false</skip>
55+
<skip>true</skip>
5656
</configuration>
5757
</plugin>
5858
<!-- build jar with dependencies -->

ipp-v3-java-devkit/src/test/java/com/intuit/ipp/services/IPPHelper.java

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,6 @@ private static IPPHelper init() {
5656
ippHelper.setQboConsumerSecret(bundle.getString("testsuit.qbo.consumer.secret"));
5757
ippHelper.setQboAccessToken(bundle.getString("testsuit.qbo.access.token"));
5858
ippHelper.setQboAccessTokenSecret(bundle.getString("testsuit.qbo.access.token.secret"));
59-
ippHelper.setQboAppDBId(bundle.getString("testsuit.qbo.app.db.id"));
6059
ippHelper.setQboRealmID(bundle.getString("testsuit.qbo.realm.id"));
6160

6261
Map<String, String> env = System.getenv();

ipp-v3-java-devkit/src/test/resources/ippdevkit.properties

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,6 @@ testsuit.qbo.consumer.key =
2222
testsuit.qbo.consumer.secret =
2323
testsuit.qbo.access.token =
2424
testsuit.qbo.access.token.secret =
25-
testsuit.qbo.app.db.id=
2625
testsuit.qbo.realm.id =
2726

2827

pom.xml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -165,7 +165,7 @@
165165
<groupId>org.apache.maven.plugins</groupId>
166166
<artifactId>maven-deploy-plugin</artifactId>
167167
<configuration>
168-
<skip>false</skip>
168+
<skip>true</skip>
169169
</configuration>
170170
</plugin>
171171

@@ -176,6 +176,7 @@
176176
<version>2.9.1</version>
177177
<configuration>
178178
<excludePackageNames>com.intuit.ipp.internal.*</excludePackageNames>
179+
<skip>true</skip>
179180
</configuration>
180181
<executions>
181182
<execution>

0 commit comments

Comments
 (0)