All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog (https://keepachangelog.com/en/1.0.0/),
For changes to the BPDM Helm charts please consult the changelog of the charts directly.
- BPDM Pool: Post endpoint to fetch the BPNL/S/A based on the requested identifiers.(#1052)
- BPDM Gate & Orchestrator: Enhance the error handling mechanism for the orchestrator and gate components by extending the list of available error codes.(#1003)
- BPDM System Test: Tester module which performs automated end-to-end tests on an existing golden record process.(#1070)
- BPDM Gate: Fetched and updated legal name of legal entity from pool while performing partner upload process via CSV(#1141)
- BPDM Orchestrator: When trying to resolve tasks for a step that have has been resolved before, the request is ignored. A HTTP OK instead of a BadRequest will be returned (#1092)
- BPDM Pool: Post endpoint to create a site for LegalAndSiteMainAddress addressType.(#739)
- BPDM Orchestrator: Endpoint for checking the result state of given tasks(#1039)
- BPDM Orchestrator: Endpoint for getting event log for finished tasks(#1039)
- BPDM Pool: Enhanced data model for IdentifierTypes by adding three new fields/attributes: abbreviation, transliteratedName, and transliteratedAbbreviation.(#605)
- BPDM Pool: Add CX endpoints for searching and updating the CX membership information of legal entities.(#1069)
- BPDM Gate: Fix possible out of memory exception when handling large golden record process requests(#1034)
- BPDM Pool: Fix not resolving golden record tasks on exceptions(#1033)
- BPDM Gate: Fixed Gate not resending business partner data to the golden record process on error sharing state when member sends the exact same business partner again(#1035)
- BPDM Orchestrator: Search task endpoint now requires the private record ID for each task. This means only the task creator is able to fetch the task state(#1039)
- BPDM Orchestrator: Now aborts tasks that are outdated (that is when a Gate will send newer business partner data for the same record to the golden record process)(#1036)
- BPDM Pool & Gate: Reduce standard batch size for golden record task processing (#1032)
- BPDM Orchestrator: Fix possible out-of-memory exception during the execution of large volumes of tasks (#1029)
- BPDM Cleaning Service Dummy: Add whitespaces between name parts when creating legal name from them (#1041)
- BPDM Cleaning Service Dummy: Improve duplication check to better distinguish between incoming business partners (#1040)
- Apps: Updated double precision data type for Geographic-data(#978)
- BPDM Gate: Improved error response by adding external id details and reduced csv columns by removing support for uncategorized fields in csv file for partner upload process(#700)
- BPDM Cleaning Service Dummy: Added a null check for name parts to ensure proper whitespace handling when constructing the legal name from them. (#1059)
- BPDM Gate: Enabled Tax Jurisdiction code to save it to the Output. (#1058)
- BPDM Cleaning Service Dummy: Removed assignment of uncategorized states while performing cleaning legal entity process. (#1061)
- BPDM Gate: Fixed construction logic for states and identifiers by enabling business partner type (#1067)
- BPDM Gate: Fixed logic for identifiers to retrieve only generic type on output business partner (#1067)
- BPDM Gate: Fixed construction logic for states and identifiers by enabling business partner type (#1067)
- BPDM Pool: When processing golden record tasks the Pool now ignores isCatenaXMemberData field if it is set to null. (#1069)
- BPDM Gate: Fixed gate output logic to provide states based on business partner type. (#1097)
- BPDM Cleaning Service Dummy: Removed assignment of uncategorized identifier while performing cleaning task process. (#1098)
- BPDM Pool: Fix error querying legal forms when non-gleif legacy legal forms are present in the database (#1107)
- BPDM: Fix denial of service attack vulnerability CVE-2024-47535 (#1112)
- BPDM Gate: Fix error on writing golden record task result missing legal name into output stage. Result is now correctly written. (#1115)
- BPDM Gate: Post endpoint to upload business partner input data using csv file.(#700)
- BPDM Gate: GET endpoint to download the csv file template for business partner upload. (#700)
- Apps: Tax Jurisdiction Code to the physical address of a business partner (#955)
- BPDM Orchestrator: Tasks will now be persisted (#722)
- BPDM Orchestrator: Tasks now come with a gate record identifier. This makes it possible for cleaning services to match tasks for the same Gate record (#711)
- BPDM Gate: Fix sending business partner data to the golden record service even when they have no changes (#988)
- BPDM Gate: Fix sharing states sometimes taking the wrong task id from the orchestrator (#989)
- BPDM Gate: Now sends alternative addresses which are NULL correctly to the Orchestrator (#801)
- BPDM Pool: Changed Checksum generation algorithm: Now checksum includes the BPN with prefix (#699)
- BPDM Gate: Remove unused business partner type filter in query parameters from sharing state endpoint (Does not affect behaviour of API)
- Apps: Add no-auth profile to all BPDM applications. This introduced a shortcut to run an application without any authentication configuration for its API and clients
- BPDM Gate: Now correctly sending NULL values for alternative addresses to the golden record process
- BPDM Pool: Name search for business partners now case-insensitive and delivers results on partial matches
- BPDM Pool: Now validate and reject data in golden record tasks only if it is needed for processing (Unchanged business partners are now ignored)
- BPDM Bridge (The Cleaning Dummy Service and Orchestrator are the successor applications to simulate a dummy golden record process)
- BPDM Gate: Removed all Legal Entity, Site and Address endpoints (The generic business partner endpoint is their successor)
- BPDM Gate: Removed legal entity classifications form business partner
- BPDM Gate: Removed business partner type from API models and filters
- BPDM Gate: Removed BPN from the sharing state (BPNs can be viewed in the output data of the business partner)
- APIs: Removed the static prefixes 'api/catena' from all API endpoint paths
- BPDM Pool: Removed the flags for
is legal address
andis site main address
from the logistic address (since it is now expressed by the address type)
- BPDM Gate: Configuration to prevent the uploaded business partner input data to immediately enter the golden record process. In this configuration the business partner data needs to be sent to the golden record process manually over the new state/ready API endpoint. Default configuration remains automatically sharing.
- BPDM Gate: Limited multi-tenancy support. Business partners are now separated by owner-BPNL. The owner is determined from the 'bpn' claim in the token. This means users of a Gate can only see and edit their own business partner data.
- BPDM Pool: New API endpoints to query business partner data which belongs to Catena-X members only
- APIs: Added a major version number to all API endpoint paths indicating the current version of the BPDM APIs. In the future we will use version numbers in the URL to differentiate between all currently supported major versions of the API
- BPDM Gate Client: Now supports the stats endpoints of the BPDM API
- Confidence Criteria: Corrected field name for number of sharing members (formerly number of business partners)
- BPDM Cleaning Service Dummy: Now determines business partner data to be Catena-X member data if it is claimed to be owned
- BPDM Cleaning Service Dummy: Fix ignoring BPNs coming from the sharing member
- BPDM Gate: Fix not correctly updating confidence values it receives from the golden record process
- BPDM Gate: Fix not correctly updating business partner output data from golden record updates in the Pool.
- JAVA version to 21
- BPDM API Permissions: Overhaul of the permissions needed to access the BPDM API endpoints. Permissions are now more fine-granular and differentiate more clearly between read or write. For more details consult the Arc42, API documentation and properties files of the respective applications.
- BPDM App Configuration: Now all applications are secured (authenticated and authorized) by default. You can still deactivate security in the BPDM apps for testing or development purposes though.
- BPDM Pool: Fix Pool trying to update golden records which the golden record process indicated to have no changes
- BPDM Orchestrator: The business partner data for golden record process tasks has been completely overhauled.
Now business partner data is clearly divided into
uncategorized
,legal entity
,site
andadditonal address
data. This model is less verbose and contains less duplicate data. Additionally, both Pool and Gate can write and read from it making it unnecessary for a cleaning service to provide the data in two different models.
- Golden Record Process Use Case: Update sharing member business partner from update in golden record
- BPDM Gate: Stats endpoints
- BPDM Gate: Additional possible roles to business partner
- BPDM Cleaning Service Dummy: Duplicate check based on business partner name
- Confidence criteria for all data models
- Increase Spring Boot version to 3.1.8
- Changed generic business partner model to include LSA typed properties
- Addresses can now be legal and site main addresses at the same time
- BPDM Gate: Refuse request if token is not issued for owner BPNL
- BPDM Pool: Opensearch component
- Golden record sharing process with dummy cleaning (see points below for details)
- BPDM Orchestrator: New BPDM application managing golden record tasks
- BPDM Cleaning Service Dummy: New BPDM application creating dummy cleaning results from golden record tasks
- BPDM Gate: Endpoints for sharing generic business partner input
- BPDM Gate: Endpoints for querying generic business partner output
- BPDM Gate: Service logic for creating golden record tasks from business partner input and writing result in output
- BPDM Pool: Service Logic for creating golden records from tasks
- BPDM Pool: Service logic for assigning BPNs to golden record tasks
- BPDM Pool: Search for name on address and legal entity level
- Swagger: Bearer token authorization flow
- Workflows: latest-alpha tag for Docker images
- Docker: Healthcheck for images
- Apps: Increase Spring Boot version to 3.1.5
- BPDM Gate: New business partner type 'GENERIC' for changelog
- BPDM Gate: New business partner type 'GENERIC' for sharing state
- Workflows: Trivy now targets the latest alpha Docker image instead of the latest release version
- Apps: Increase projectreactor.netty version to fix Trivy vulnerability
- BPDM Pool API: Adjust API text descriptions to BPDM Standard
- BPDM Gate API: Adjust API text descriptions to BPDM Standard
- BPDM Apps: Add legal files to packaged Jar files: LICENSE, NOTICE and DEPENDENCIES
- BPDM Bridge Dummy: Add missing tests for updating business partners
- BPDM Pool: Fix duplicate identifier validation on creating new legal entities
This version introduces breaking changes. Migration files will DELETE existing data in order to perform migration. Please create a back-up of your business partner data before updating.
- BPDM Pool API: Adapt new data model for easier and more intuitive usage, independent of SaaS data model.
- BPDM Gate API: Adapt new data model for easier and more intuitive usage, independent of SaaS data model.
- BPDM: Update dependencies to mitigate vulnerabilities in old versions.
- BPDM bridge dummy: As new application module.
- BPDM: Umbrella Chart with BPDM Bridge Dummy.
- BPDM: Deprecated endpoints for retrieving business partners in legacy format.
- Endpoint for retrieving changelog entries has now improved filtering (breaking API change)
-
Move license "header" of ingress under metadata
-
Increase chart versions and adapt changelogs on each chart folder
-
Increase version release to 3.2.2
- Changed increase to spring boot starter version 3.0.5
- Override spring expression transitive dependency to versiomn to 6.0.8
- Increase version release to 3.2.1
- BPDM Pool API: client library for accessing BPDM Pool API application
- BPDM Gate API: client library for accessing a BPDM Gate API application
- BPDM Gate: internal server error when invoking the POST business-partners/type-match endpoint
- BPDM Gate: output endpoints could miss returning any information for Business Partners in some cases
- BPDM: security issue CVE-2022-1471
- BPDM: applications returning 403 status code on internal errors
- BPDM Gate: Endpoints returning input versions of legal entity, site and address now provide processStartedAt timestamp.
- BPDM Gate: Endpoints for output versions of legal entity, site and address now return error infos and pending entries
- BPDM Gate: For a business partner with a child relation, this relation could be returned as parent relation erroneously.
- BPDM Gate: When a business partner with a child relation was updated, this relation was erroneously deleted, rendering the previous child invalid.
- BPDM Pool: Update dependencies to mitigate vulnerabilities in old versions
- Replaced manual JSON deserializer implementations for various DTOs by generic DataClassUnwrappedJsonDeserializer.
- BPDM Pool: SaaS Sharing Service Importer now also adds missing import entries (SaaS-ID to BPN) when encountering Business Partners that already have BPNs in the SaaS storage (possible due to legacy imports done before)
- BPDM Pool: Business Partner searches have now limited pagination length. Limit is adjustable in configuration.
- BPDM Gate: Now possible to startup without supplying any environment variables or property overwrites
- BPDM Pool: Now possible to deep paginate over business partners (>10000 entries)
- Fixed various vulnerabilities by upgrading affected libraries
- Fixed various vulnerabilities by upgrading affected libraries
- New endpoint to search for addresses in pool
- New endpoint to get valid/mandatory identifiers per country
- Importer in pool now supports Legal Entities, Sites and Addresses
- Update helm charts to align with best practices
- Update logic for fetching data from SaaS provider via gate
- New component "gate" for the integration into the Golden Record process
- Endpoint for creating and retrieving legal entities via gate
- Endpoint for type matching via gate
- Fixed issue in legal entity import for missing "thoroughfare" values
- Fix issue when elliptic curve signing key is configured in keycloak
- Update dependencies with CVEs
- Added the possibility to get BusinessPartner-Legal Entities, BusinessPartner-Sites and BusinessPartner-Addresses as additional information
- Added OpenSearch functionality to search Business Partners by different parameters
- Added reference integration for one SaaS controller
- Helm Charts available via Helm repository
- Swagger UI now integrated with Portal authentication
- BPDM data model
- Endpoints for retrieving business partners in legacy format