-
Notifications
You must be signed in to change notification settings - Fork 9
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #12 from anaplaninc/task/INTEGRA-1996
Task/integra 1996
- Loading branch information
Showing
312 changed files
with
18 additions
and
31,546 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,115 +1,11 @@ | ||
![Anaplan Connect](img/anaplan-connect-logo.png) | ||
# anaplan-java-client | ||
|
||
Anaplan Connect is a command-line client and an SDK that makes it easy to communicate with the Anaplan API to execute Import, Export, Delete, and Process actions. | ||
Please read the [NOTICE.txt](NOTICE.txt) and [LICENSE.txt](LICENSE.txt) files before using Anaplan Connect, particularly if you intend to redistribute it. | ||
## DOCUMENTATION | ||
|
||
The Anaplan Java Client documentation consists of: | ||
|
||
# Documentation | ||
1. "Anaplan API Guide", which shows the workflow of making a series of API calls for import, export, delete, and process. See https://community.anaplan.com/anapedia/integrations/data-integration/anaplan-api-guide | ||
|
||
- The [**Anaplan Connect Guide**](https://community.anaplan.com/anapedia/data-integration/anaplan-connect) provides information on installing and using Anaplan Connect from the command-line on Windows, UNIX, GNU/Linux or MacOS environments. | ||
- The [**Anaplan API Guide**](https://community.anaplan.com/anapedia/integrations/data-integration/anaplan-api-guide) provides information useful to developers who want to access the API directly without using Anaplan Connect. | ||
- The [**Anaplan API Reference**](http://docs.anaplan.apiary.io/) covers all Anaplan APIs. | ||
- The **Javadoc documentation** is useful for Java developers wanting to make use of Anaplan Connect as a library component from their own code. The content is available at ```doc/javadoc```, so open ```doc/javadoc/index.html``` in a browser. | ||
2. For those who already understand the workflow, the API Reference at "Anaplan REST API for Integration" at https://anaplanbulkapi20.docs.apiary.io | ||
|
||
|
||
# Developers | ||
|
||
|
||
## SDK | ||
|
||
The SDK provides the ```Service``` class, representing a connection to the Anaplan Connect server, along with associated classes representing accessible resources on the server. | ||
Software using this library should conform to the following pattern: | ||
|
||
- A new Service object is instantiated for the service endpoint. | ||
- The Service has many necessary properties set. In particular, service credentials need to be provided. | ||
- The Service object can be used to access Workspace objects, from which Model objects can be accessed, and so on. These are all tied to that Service object. | ||
- When all interaction has been completed, the Service.close() method should be called to release any resources. | ||
|
||
The SDK also provides: | ||
|
||
- A mechanism to use custom [Transport-providers](src/main/java/com/anaplan/client/transport/README.md) (default: ApacheHttpProvider) for custom API communication. | ||
- A mechanism to use custom [Serialization handlers](src/main/java/com/anaplan/client/serialization/README.md), to help serialize the data to and from Anaplan. | ||
|
||
|
||
## Build from source | ||
|
||
This is a standard Maven project, so to install, test and package do: | ||
``` | ||
$ mvn clean install | ||
$ mvn clean test | ||
$ mvn clean package | ||
``` | ||
|
||
## Deploy to Maven Repository (check with contributers) | ||
|
||
To deploy to Maven Github repository at anaplaninc.github.io, do: | ||
``` | ||
$ mvn clean deploy | ||
``` | ||
Note: Requires a settings.xml file at location ~/.m2/ with contents as shown below and a Github access token. More info at: (https://github.com/settings/tokens): | ||
``` | ||
<settings> | ||
<servers> | ||
<server> | ||
<id>github</id> | ||
<password><GITHUB PERSONAL ACCESS TOKEN></password> | ||
</server> | ||
</servers> | ||
</settings> | ||
``` | ||
|
||
## Update Javadoc Github-pages | ||
|
||
To update the Github-pages (branch: gh-pages) site for this repository, with the latest Javadoc, do: | ||
``` | ||
$ mvn javadoc:javadoc | ||
$ cp -R target/site/apidocs/* doc/javadoc/. | ||
$ git subtree push --prefix doc origin gh-pages | ||
``` | ||
|
||
|
||
# Releases | ||
|
||
## v1.4.1 | ||
|
||
Features: | ||
|
||
- BugFix to handle NullPointerException when Anaplan returns “Another row has already been processed with this key” | ||
- BugFix - AC did not recognize different column separators | ||
- Allow users to directly use Private key for authentication | ||
- This version will automatically ignore extra text in CA public certificate / Private key. There is extra text appears before the “----BEGIN CERTIFICATE----” part. Users do not need to edit the files to remove these lines. | ||
|
||
## v1.4 | ||
|
||
Features: | ||
|
||
- Use of the new and improved Anaplan v2.0 integration API | ||
- Enabling customers to use certificates, obtained from public Certificate Authorities, for Anaplan authentication | ||
- Enabling users to configure retry timeout and number of retries | ||
- Configurable chunk sizes for imports, ranging from 1 to 50 MB | ||
- Improved screen logging, including timestamp, classpath for debug lines, Linux process ID, and more. | ||
- Better security and ease of querying using JDBCparameters moved to “properties” file. | ||
|
||
## v1.3.6 | ||
|
||
Features: | ||
|
||
- Mavenized the Anaplan-Connect project, previously on Ant. | ||
- Introduced Log4j. | ||
- Removed cs/ C# code-base for Anaplan-Connect. | ||
- doc/ folder cleanup. | ||
- Fixed unit-tests using mocked API responses. | ||
- Built using JDK 1.7.0_79 | ||
- Updated to use Github maven repo at anaplaninc.github.io | ||
|
||
## v1.3.5 | ||
|
||
Bug Fixes as of 19-NOVEMBER-2015 | ||
|
||
- MOD-753: Anaplan Connect retrieves old or incomplete export file if the export fails to complete | ||
- INTEGRA-699: When a value is blank/missing in the file, Anaplan Connect shifts the data to the left one column. | ||
- BGTRK-10844: Anaplan Connect might hang waiting for task cancellation. | ||
- INTEGRA-246: Remove doc and wadl from connect distribution build. | ||
- RB-68: Change base url for UAT to fix naming convention. | ||
|
||
NOTE: Use this for Informatica Connector v1.1.0 | ||
LICENSE See https://github.com/anaplaninc/anaplan-java-client/blob/master/java/LICENSE.txt |
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
Oops, something went wrong.