7.0.0

The 7.0.0 release updates the version of @angular required to 18 and typescript to 4.5.x.
no new features were added.

What's Changed

• updates the required version of the angular library to version 18.
• updates the typescript dependency to version 5.4.0

Full Changelog: 6.1.0...7.0.0

6.1.0

The majority of the new additions to models and api services only match up to the POC server implementation of the Senzing API Spec and facilitate access to statistics provided through the Data Mart interface(s). As Such these are provided as optional models that are not present in all api products.

Added

• SzCrossSourceSummary model. Describes the cross-source statistics between two data sources.
• SzCrossSourceSummaryResponse model. Extends the BaseResponse to add the fields for statistics representing cross-summary statistics between two specific data sources.
• SzEntity model. Describes an entity that has been synced to the datamart.
• SzLoadedStats model. Encapsulates the statistics pertaining to counts of entities and records both in total and by data source.
• SzLoadedStatsResponse model. Extends the BaseResponse to add the fields for statistics representing counts of entities and records in total and by data source.
• SzMatchCounts model. Describes the entity and record counts for matches between records from the primary data source to at least one record from the "versus" data source.
• SzMatchCountsResponse model. Extends the BaseResponse to add the fields for statistics representing cross-summary statistics on matches between two specific data sources.
• SzMatchCountsResponseData model. Describes the cross-summary statistics for matches between two data sources for each requested match key and principle combination.
• SzPagedRelationsResponse model. Extends the BaseResponse to add the fields describing a list of SzRelation's that is "paged" with a boundary, a page size and a total relations count.
• SzRecord model. Describes a record that has been synced to the datamart.
• SzRelation model. Describes a relationship between two entities.
• SzRelationCounts model. Describes the entity, record and relationship counts for the respective relation type for entities having at least one record from the primary data source to entities having at least one record from the "versus" data source.
• SzRelationCountsResponse model. Extends the BaseResponse to add the fields for statistics representing cross-summary statistics on relationships of a specific type between two specific data sources.
• SzRelationCountsResponseData model. Describes the cross-source statistics between two data sources.
• SzRelationsPage model. Encapsulates a paged list of SzRelation values describing entity relationships pertaining to a specific statistic.
• SzRelationType model. Similar to SzRelationshipType but this enumeration is used with the statistics API provided by the data mart replicator. Possible values are 'AMBIGUOUS_MATCH', 'POSSIBLE_MATCH', 'POSSIBLE_RELATION','DISCLOSED_RELATION'.
• SzSourceLoadedStats model. Encapsulates the statistics pertaining to counts of entities and records for a specific data source.
• SzSourceLoadedStatsResponse model. Extends the BaseResponse to add the fields for statistics representing counts of entities and records for a specific data source.
• SzSourceSummary model. Describes the source summary and all cross-summaries with that data source.
• SzSourceSummaryResponse model. Extends the BaseResponse to add the fields for statistics representing summary statistics for a single data source versus itself and every other data source.
• SzSummaryStats model. Encapsulates the statistics for the source summaries for every data source.
• SzSummaryStatsResponse model. Extends the BaseResponse to add the fields for statistics representing summary statistics for every configured data source.

Modified

• dependency versions updated for security patches

6.0.1

Modified

• angular dependencies updated to 15.2.x
• dependency versions updated for security patches

6.0.0

s of 6.0.0 release this package now requires @angular@~15.0.0 to compile and run. There are no components in this package so technically it would probably be compatible with earlier releases but it is not recommended and would not be officially supported.

Updating to angular 15 resolves major dependency compatibility issues so we can apply the latest security patches to the library.

For information updating your project from a previous angular version to ~15.0.0 see the Angular Update Guide

models updated to senzing-rest-api-spec@3.3.0

• Added methods and models to support "how entity" functionality
• Added enumeration options for detail levels and feature mode to allow for graph optimization.

Added

• SzFeatureReference model
• SzHowEntityResponse model
• SzHowEntityResult model
• SzHowMatchInfo model
• SzRecordIdentifier model
• SzRecordIdentifiers model
• SzResolutionStep model
• SzVirtualEntity model
• SzVirtualEntityData model
• SzVirtualEntityRecord model
• SzVirtualEntityResponse model
• BAREMINIMAL added to SzDetailLevel to handle just returning the
  entity ID's without record information or relationship match info.
• NETWORKMINIMAL added to SzDetailLevel to behave the same as
  SzDetailLevel.BAREMINIMAL, but with the addition of relationship match info in the case of related entities being included.
• ENTITYNAMEONLY added to SzFeatureMode to handle just retrieving the entity name without actually returning other features.
• ATTRIBUTED value for SzFeatureMode for pulling back feature references at the record level to indicate which records contributed which features.
• featureReferences property to SzEntityRecord
• the following methods added to EntityDataService
  • getVirtualEntityByRecordIds gets a virtual entity by simulating the resolution of the records identified by the specified record ID parameters. This operation simulates the resolution of the one or more specified records into a single entity and returns the simulated "virtual" entity. The subject records are identified by data source code and record ID pairs.
  • howEntityByEntityID gets an analysis of how the entity for the respective entity ID resolved. This operation provides an anlysis of how the records in an entity resolved. The subject entity is identified by the entity ID in the request path.
  • howEntityByRecordID gets an analysis of how the entity for the record with the respective data source code and record ID resolved. This operation provides an anlysis of how the records in an entity resolved. The subject entity is the one containing the record identified by the data source code and record ID in the request path.

Modified

• SzMatchInfo renamed to SzWhyMatchInfo
• Updated GET /entity-paths parameter(s)

5.0.0

A new parameter and enum has been added for finer control over the detail levels of entity response objects.

Added

• SzDetailLevel is a new enum that describes the level of detail desired for entity data when obtained via the various endpoints that return entity data. Details for features of entities as well as the related entities of entities are controlled by other flags. Possible values are:
  • MINIMAL The entities returned will include at most their entity ID's as well as identifiers for their constituent records (i.e.: data source code and record ID for each record). This detail level is optimized for the fastest possible processing time.
  • BRIEF Builds upon MINIMAL to add the entity name and related entity match info when related entity match info when related entities are included. This detail level aims to maintain as much speed as possible while providing names and relationship information for rendering a graph.
  • SUMMARY Identical to BRIEF except that individual record identifier information is excluded, leaving only the record summary (i.e.: a record count by data source code). This reduces the size of the JSON document for large entities with thousands of records. It may take longer to process than BRIEF but less data is returned as well, speeding up network transfer times.
  • VERBOSE Combines BRIEF and SUMMARY and then adds the original JSON data for each record, the record-level matching info, as well as formatted record data. NOTE: the record-level matching info returned via "how" and "why" is often more useful than that embedded in the entity. Further, the formatted record data, while readable, is not formatted according to locale (i.e.: address, name and date formatting may not appear as expected to a user).

Modified

• The call signature has been updated for EntityDataService.getEntityByEntityId from entityId: number, featureMode?: SzFeatureMode, withFeatureStats?: boolean, withInternalFeatures?: boolean, forceMinimal?: boolean, withRelated?: SzRelationshipMode, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string} to entityId: number, detailLevel?: SzDetailLevel, featureMode?: SzFeatureMode, withFeatureStats?: boolean, withInternalFeatures?: boolean, forceMinimal?: boolean, withRelated?: SzRelationshipMode, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string}
• The call signature has been updated for EntityDataService.getEntityByRecordId from dataSourceCode: string, recordId: string, featureMode?: SzFeatureMode, withFeatureStats?: boolean, withInternalFeatures?: boolean, forceMinimal?: boolean, withRelated?: SzRelationshipMode, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string} to dataSourceCode: string, recordId: string, detailLevel?: SzDetailLevel, featureMode?: SzFeatureMode, withFeatureStats?: boolean, withInternalFeatures?: boolean, forceMinimal?: boolean, withRelated?: SzRelationshipMode, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string}
• The call signature has been updated for EntityDataService.searchEntitiesByGet from attrs?: string, attr?: Array<string>, includeOnly?: Array<SzAttributeSearchResultType>, featureMode?: SzFeatureMode, withFeatureStats?: boolean, withInternalFeatures?: boolean, forceMinimal?: boolean, withRelationships?: boolean, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string} to attrs?: string, attr?: Array<string>, includeOnly?: Array<SzAttributeSearchResultType>, detailLevel?: SzDetailLevel, featureMode?: SzFeatureMode, withFeatureStats?: boolean, withInternalFeatures?: boolean, forceMinimal?: boolean, withRelationships?: boolean, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string}
• The call signature has been updated for EntityDataService.searchEntitiesByPost from body: { [key: string]: any; }, includeOnly?: Array<SzAttributeSearchResultType>, featureMode?: SzFeatureMode, withFeatureStats?: boolean, withInternalFeatures?: boolean, forceMinimal?: boolean, withRelationships?: boolean, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string} to body: { [key: string]: any; }, includeOnly?: Array<SzAttributeSearchResultType>, detailLevel?: SzDetailLevel, featureMode?: SzFeatureMode, withFeatureStats?: boolean, withInternalFeatures?: boolean, forceMinimal?: boolean, withRelationships?: boolean, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string}
• The call signature has been updated for EntityDataService.whyEntities from entity1: string, entity2: string, withRelationships?: boolean, withFeatureStats?: boolean, withInternalFeatures?: boolean, featureMode?: SzFeatureMode, forceMinimal?: boolean, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string} to entity1: string, entity2: string, withRelationships?: boolean, withFeatureStats?: boolean, withInternalFeatures?: boolean, detailLevel?: SzDetailLevel, featureMode?: SzFeatureMode, forceMinimal?: boolean, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string}
• The call signature has been updated for EntityDataService.whyEntityByEntityID from entityId: number, withRelationships?: boolean, withFeatureStats?: boolean, withInternalFeatures?: boolean, featureMode?: SzFeatureMode, forceMinimal?: boolean, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string} to entityId: number, withRelationships?: boolean, withFeatureStats?: boolean, withInternalFeatures?: boolean, detailLevel?: SzDetailLevel, featureMode?: SzFeatureMode, forceMinimal?: boolean, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string}
• The call signature has been updated for EntityDataService.whyEntityByRecordID from dataSourceCode: string, recordId: string, withRelationships?: boolean, withFeatureStats?: boolean, withInternalFeatures?: boolean, featureMode?: SzFeatureMode, forceMinimal?: boolean, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string} to dataSourceCode: string, recordId: string, withRelationships?: boolean, withFeatureStats?: boolean, withInternalFeatures?: boolean, detailLevel?: SzDetailLevel, featureMode?: SzFeatureMode, forceMinimal?: boolean, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string}
• The call signature has been updated for EntityDataService.whyRecords from dataSource1: string, recordId1: string, dataSource2: string, recordId2: string, withRelationships?: boolean, withFeatureStats?: boolean, withInternalFeatures?: boolean, featureMode?: SzFeatureMode, forceMinimal?: boolean, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string} to dataSource1: string, recordId1: string, dataSource2: string, recordId2: string, withRelationships?: boolean, withFeatureStats?: boolean, withInternalFeatures?: boolean, detailLevel?: SzDetailLevel, featureMode?: SzFeatureMode, forceMinimal?: boolean, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string}
• The call signature has been updated for EntityGraphService.findEntityNetwork from e?: Array<SzEntityIdentifier>, entities?: SzEntityIdentifiers, maxDegrees?: number, buildOut?: number, maxEntities?: number, featureMode?: SzFeatureMode, withFeatureStats?: boolean, withInternalFeatures?: boolean, forceMinimal?: boolean, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string} to e?: Array<SzEntityIdentifier>, entities?: SzEntityIdentifiers, maxDegrees?: number, buildOut?: number, maxEntities?: number, detailLevel?: SzDetailLevel, featureMode?: SzFeatureMode, withFeatureStats?: boolean, withInternalFeatures?: boolean, forceMinimal?: boolean, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string}
• The call signature has been updated for EntityGraphService.findEntityPath from from: SzEntityIdentifier, to: SzEntityIdentifier, maxDegrees?: number, x?: Array<SzEntityIdentifier>, avoidEntities?: SzEntityIdentifiers, forbidAvoided?: boolean, s?: Array<string>, featureMode?: SzFeatureMode, withFeatureStats?: boolean, withInternalFeatures?: boolean, forceMinimal?: boolean, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string} to from: SzEntityIdentifier, to: SzEntityIdentifier, maxDegrees?: number, x?: Array<SzEntityIdentifier>, avoidEntities?: SzEntityIdentifiers, forbidAvoided?: boolean, s?: Array<string>, detailLevel?: SzDetailLevel, featureMode?: SzFeatureMode, withFeatureStats?: boolean, withInternalFeatures?: boolean, forceMinimal?: boolean, withRaw?: boolean, observe?: 'body', reportProgress?: boolean, additionalHeaders?: {[key: string]: string}

4.0.2

dependency and security patches.

What's Changed

• #101 dependency updates by @arawinters in #102
• Add dependabot by @SamMacy in #105
• Bump andymckay/labeler from 1.0.3 to 1.0.4 by @dependabot in #107
• Bump actions/setup-node from 1 to 3 by @dependabot in #108
• Bump actions/checkout from 2 to 3 by @dependabot in #106
• dependency updates by @arawinters in #122
• Bump karma-chrome-launcher from 3.1.0 to 3.1.1 by @dependabot in #113

Full Changelog: 4.0.0...4.0.2

4.0.0

This update brings the models in line with the changes for the 3.0.0 release of the senzing rest api server
and rest api specification.

Modified

• matchScore removed from SzBaseRelatedEntity
• The EntityData.getEntityByEntityId method had the parameter forceMinimal moved from the 3rd position to the 5th position.

Removed

• All models related to Entity Types and Entity Classes removed from the api have been removed from this package(see below)
  • SzEntityClass
  • SzEntityClassDescriptor
  • SzEntityClassResponse
  • SzEntityClassResponseData
  • SzEntityClassesResponse
  • SzEntityClassesResponseData
  • SzEntityType
  • SzEntityTypeBulkLoadResult
  • SzEntityTypeDescriptor
  • SzEntityTypeRecordAnalysis
  • SzEntityTypeResponse
  • SzEntityTypeResponseData
  • SzEntityTypesResponse
  • SzEntityTypesResponseData
• The following methods removed from ConfigService
  • addEntityTypes
  • addEntityTypesForClass
  • getEntityClass
  • getEntityClasses
  • getEntityType
  • getEntityTypeByClass
  • getEntityTypes
  • getEntityTypesByClass
• The following parameters removed from BulkData.analyzeBulkRecordsForm
  • entityType
  • mapEntityTypes
  • mapEntityType
  • maxFailures
• The following parameters removed from BulkData.loadBulkRecordsForm
  • entityType
  • mapEntityTypes
  • mapEntityType

What's Changed

• #91 dependency udpates by @arawinters in #92
• models and methods updated to senzing-rest-api-specification@3.0.0 by @arawinters in #93
• #94 docs updated to rest api spec 3.0.0 by @arawinters in #95

Full Changelog: 3.0.0...4.0.0

3.0.0

As of 3.0.0 release this package now requires @angular@~13.0.0 to compile and run. There are no components in this package so technically it would probably be compatible with earlier releases but it is not recommended and would not be officially supported.

Updating to angular 13 resolves major dependency compatibility issues so we can apply the latest security patches to the library.

For information updating your project from a previous angular version to ~13.0.0 see the Angular Update Guide

2.3.0

Models and API Services updated to compliance with senzing-api-rest-spec@2.7.0 and poc-api-server extended spec for streaming.

There are some potentially breaking changes if an application is referencing models in the package that no longer exist. The vast majority of API service calls and signatures remain unchanged with the notable exception of analyzeBulkRecords and loadBulkRecords having two new additional arguments that change the order of the method parameters. The changes also include some expanded functionality around WHY services and Stream loading(*poc server only).

see changelog for senzing-api-server@2.7.0 here

• https://github.com/Senzing/senzing-rest-api-specification/releases/tag/2.7.0
• https://github.com/Senzing/senzing-api-server/releases/tag/2.7.0
• https://github.com/Senzing/poc-api-server

related #69 #70

• deleted:

  • szBaseResponseLinks.ts
  • szBaseResponseMeta.ts
  • (DEPRECATED) szBulkDataLoadResponse.ts
  • body.ts
  • body1.ts
  • body2.ts
  • body3.ts
  • body4.ts
  • body5.ts

• added:

  • bulkdataAnalyzeBody.ts
  • bulkdataLoadBody.ts
  • bulkdataRecordsBody.ts
  • datasourcesBody.ts
  • datasourcesBody1.ts
  • entitytypesBody.ts
  • entitytypesBody1.ts
  • szDeleteRecordResponseData.ts
  • szDisclosedRelation.ts
  • szLinks.ts (replaces szBaseResponseLinks)
  • szMeta.ts (replaces szBaseResponseMeta)
  • szOpenApiSpecResponse.ts
  • szOpenApiSpecResponseOrRawJson.ts
  • szQueueInfo.ts
  • szQueueInfoResponse.ts
  • szRelatedFeatures.ts
  • szRelationDirection.ts
  • szWhyEntitiesResponse.ts
  • szWhyEntitiesResponseData.ts
  • szWhyEntitiesResult.ts

• SenzingBaseResponse:

  • meta changed from type SzBaseResponseMeta to SzMeta
  • links changed from type SzBaseResponseLinks to SzLinks

• SzEntityRecord:

  • added lastSeenTimestamp as Date
  • added originalSourceData as { [key: string]: any; }

• SzMatchInfo

  • added disclosedRelations as Array

• SzResolvedEntity

  • added lastSeenTimestamp as Date

• SzServerInfo

  • added webSocketsMessageMaxSize as number
  • added infoQueueConfigured as boolean
  • added loadQueueConfigured as boolean

• SzVersionInfo

  • added nativeApiBuildVersion as string
  • added pocServerVersion as string
  • added pocApiVersion as string

• AdminService

  • added openApiSpecification method
  • added root method
  • added getLoadQueueInfo method for querying POC Server Queue

• BulkDataService

  • parameters maxFailures, and eofSendTimeout added to method analyzeBulkRecords
  • parameters maxFailures, and eofSendTimeout added to method loadBulkRecords
  • added analyzeBulkRecordsForm method
  • added loadBulkRecordsForm method

• EntityDataService

  • added searchEntitiesByGet method. existing behavior or passing search parameters in the url of api requests.
  • added searchEntitiesByPost method to allow not passing search parameters through url requests.
  • searchByAttributes refactored as alias of searchEntitiesByGet to prevent breaking change.

2.2.2

• Dependency security updates and bugfixes. #67
• Added new additionalHeaders parameter to ALL service methods. see issue #63
• New methods and property added to Cofiguration class :
  • additionalHeaders
  • addAdditionalRequestHeader
  • removeAdditionalRequestHeader