{"id":21702825,"url":"https://github.com/openpj/fluent-aps","last_synced_at":"2025-08-25T22:09:10.420Z","repository":{"id":152888145,"uuid":"554326743","full_name":"OpenPj/fluent-aps","owner":"OpenPj","description":"Fluent API for Alfresco Process Services platform available as a JAR library and Maven project. Interact, write tests and migrate your Activiti projects using a Fluent API ","archived":false,"fork":false,"pushed_at":"2023-01-17T17:18:38.000Z","size":34,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-11T11:24:20.439Z","etag":null,"topics":["alfresco","alfresco-activiti-enterprise","alfresco-process-services","api","bpm","fluent","fluent-api","integration-testing","java","maven","ziaconsulting"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OpenPj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-19T16:16:06.000Z","updated_at":"2024-04-12T19:56:14.000Z","dependencies_parsed_at":"2023-07-20T22:32:47.535Z","dependency_job_id":null,"html_url":"https://github.com/OpenPj/fluent-aps","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/OpenPj/fluent-aps","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenPj%2Ffluent-aps","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenPj%2Ffluent-aps/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenPj%2Ffluent-aps/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenPj%2Ffluent-aps/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OpenPj","download_url":"https://codeload.github.com/OpenPj/fluent-aps/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenPj%2Ffluent-aps/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272139148,"owners_count":24880252,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-25T02:00:12.092Z","response_time":1107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alfresco","alfresco-activiti-enterprise","alfresco-process-services","api","bpm","fluent","fluent-api","integration-testing","java","maven","ziaconsulting"],"created_at":"2024-11-25T21:20:14.050Z","updated_at":"2025-08-25T22:09:10.396Z","avatar_url":"https://github.com/OpenPj.png","language":"Java","readme":"[![](https://jitpack.io/v/OpenPj/fluent-aps.svg)](https://jitpack.io/#OpenPj/fluent-aps)\n\n# Fluent APS 0.0.1-SNAPSHOT\n\nFluent APS is a Fluent API for Alfresco Process Services.\nThis project consists of the following Maven modules:\n\n * APS Fluent API JAR (`api`): this is the client API implementation based on the [`aps-2x-client`](https://github.com/OpenPj/aps-2x-client)\n * Docker Runner (`docker`): this starts your APS platform container with Postgres database and ElasticSearch server\n * Integration Tests (`integration-tests`): this is the integration tests module\n\n## Capabilities\n\nThis API allows you to interact and write your tests using a Fluent API against your APS instance.\nThe main goal is to have a strong way to demonstrate or improve the overall project quality using this API for implementing tests.\nYou can implement tests for your workflows following the `integration-tests` module, below the example taken from the test class `FourEyesAppAPSTesterIT.java`:\n\n```java\npublic class FourEyesAppAPSTesterIT {\n\t\n\tprotected FluentAps fluentAps;\n\n\t@BeforeEach\n\tpublic void initApiClient() {\n\t\tfluentAps = new FluentApsBuilder(\"admin@app.activiti.com\", \"admin\").build();\n\t}\n\n\t@Test\n\t@Order(1)\n\tpublic void testFourEyesApp() {\n\t\tSystem.out.println(\"--- /Start - Four Eyes App - Integration Test ---\");\n\n\t\t// Importing the Four Eyes App in APS\n\t\t// NOTE: test flows, but that methods available in each instance\n\t\t// make sense\n\t\tfluentAps\n\t\t\t.afterLoadingAppArchive(\"../target/apps/Four-Eyes-App.zip\")\n\t\t\t.startProcessForApp(\"4 Eyes Principle\")\n\t\t\t.withFormValue(\"reviewtitle\", \"Review from APS SDK\")\n\t\t\t.withFormValue(\"description\", \"Description from APS SDK\")\n\t\t\t.thenSubmitTask(\"First approval\", \"submit\")\n\t\t\t.withFormValue(\"reviewtitle\", \"Review from APS SDK\")\n\t\t\t.withFormValue(\"description\", \"Description from APS SDK\")\n\t\t\t.thenSubmitTask(\"Second approval\", \"submit\")\n\t\t\t.withFormValue(\"reviewtitle\", \"Review from APS SDK\")\n\t\t\t.withFormValue(\"description\", \"Description from APS SDK\")\n\t\t\t.thenCheckThatTheProcessIsFinished();\n\n\t\tSystem.out.println(\"--- /End - Four Eyes App - Integration Test ---\");\n\n\t}\n}\n```\n\n## Quickstart for using APS Fluent API in your Maven project\nTo use it in any Maven project add the following snippet in your `pom.xml`:\n\n```xml\n\u003crepositories\u003e\n\t\u003crepository\u003e\n\t\u003cid\u003ejitpack.io\u003c/id\u003e\n\t\u003curl\u003ehttps://jitpack.io\u003c/url\u003e\n\t\u003c/repository\u003e\n\u003c/repositories\u003e\n```\n\nThen add the following dependency:\n\n```xml\n\u003cdependency\u003e\n\t\u003cgroupId\u003ecom.github.OpenPj.fluent-aps\u003c/groupId\u003e\n\t\u003cartifactId\u003eaps-fluent-api\u003c/artifactId\u003e\n\t\u003cversion\u003e0.0.1-SNAPSHOT\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nA full example is provided in the `integration-tests` module of this project.\n\n## Quickstart for using this Maven project\n\n### Prerequisites\n * OpenJDK 11\n * Apache Maven 3.8.6\n * Docker\n * Put valid  _activiti.lic_  and  _transform.lic_  (or  _Aspose.Total.Java.lic_  )  in the `/license` folder for running unit / integration tests \n * Set the `docker.aps.image` property in order to run the project on your own APS Docker image built with [APS SDK 2.x](https://github.com/OpenPj/alfresco-process-services-project-sdk/tree/2.x)\nFull Maven lifecycle command:\n\n * `mvn clean install docker:build docker:start`\n \nStop all the Docker containers with:\n \n * `mvn docker:stop`\n\n# Enterprise support\nOfficial maintenance and support of this project is delivered by Zia Consulting\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenpj%2Ffluent-aps","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenpj%2Ffluent-aps","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenpj%2Ffluent-aps/lists"}