@vendasta/account-group-sdk

Account Group SDK

This provides a typescript implementation of the account group microservice

Requirements

To setup the sdk you will need to:

Install the sdk to your project

npm install @vendasta/account-group-sdk --save

Next, you will need to import and setup your navigation module (generally in app.module.ts)

import { AccountGroupModule } from "@vendasta/account-group-sdk";
…
@NgModule({
  …
  imports: [
    …, AccountGroupModule, …
  ]
})

External Requirements

The Account Group sdk requires the following vendasta packages to be implemented by the project:

• EnvironmentService (https://www.npmjs.com/package/@vendasta/environment-service)
• PartnerService (https://www.npmjs.com/package/@vendasta/partner-service)
• SessionService (https://www.npmjs.com/package/@vendasta/session-service)

Please follow their instructions on how to set those packages up.

Usage

Inject the AccountGroupService into your component and you will be able to start using it!

import {AccountGroupService} from '@vendasta/account-group-sdk';

@Component({
  selector: '…',
  template: '…',
  styles: '…'
})
export class …Component {
  constructor(private accountGroupService: AccountGroupService) {
  }
}

ProjectionFilters

Every call to the account group microservice requires a ProjectionFilter. A projection filter tells the microservice what data to return. By default all fields are false.

interface ProjectionFilterInterface {
  accounts?: boolean;
  listingDistribution?: boolean;
  listingSyncPro?: boolean;
  associations?: boolean;
  accountGroupExternalIdentifiers?: boolean;
  socialUrls?: boolean;
  hoursOfOperation?: boolean;
  contactDetails?: boolean;
  snapshotReports?: boolean;
  legacyProductDetails?: boolean;
  richData?: boolean;
}

During construction, you can pass in all of the properties you want the api call to return:

import {ProjectionFilter} from '@vendasta/account-group-sdk'

let pf = new ProjectionFilter({accounts: true, socialUrls: true, richData: true});

Or you can call enableAll to return all data.

import {ProjectionFilter} from '@vendasta/account-group-sdk'

let pf = new ProjectionFilter().enableAll();

Lookup

lookup(projectionFilter: ProjectionFilter, marketIds: string[] = null, searchTerm: string = null, filters: LookupFilter = null, pageSize: number = 10): Observable<AccountGroup[]>

Lookup returns many account groups matching the criteria specified. To fetch the next set of paged results from a lookup, call loadMore passing in the same criteria that was used in the original lookup.

loadMore(projectionFilter: ProjectionFilter, marketIds: string[], searchTerm: string, filters: LookupFilter, pageSize: number = 10): Observable<AccountGroup[]>

The list of account groups returned by loadMore will include the previous account groups fetched - there is no need to keep track of the list of account groups in your component.

Lookup provides some helper observables you can subscribe to:

get hasMore(): Observable<boolean> Whether or not there are more account groups to fetch

get accountGroups(): Observable<AccountGroup[]> The current list of account groups fetched

get totalResults(): Observable<number> How many results are there total to fetch

get loading(): Observable<boolean> Whether or not the service is currently talking to the microservice

Get

get(accountGroupId: string, projectionFilter: ProjectionFilter): Observable<AccountGroup>

Fetch a single account group by its ID

GetMulti

getMulti(accountGroupIds: string[], projectionFilter: ProjectionFilter): Observable<AccountGroup[]>

Fetch many account groups by their IDs

BulkUpdate

bulkUpdate(accountGroupId: string, updateOperations: UpdateOperations): Observable<Response>

To use the bulkUpdate function you will need to construct an UpdateOperations object and add the update operations you want to do to the account group.

There are 10 operations to choose from:

• NapUpdateOperation
• SnapshotsUpdateOperation
• ListingDistributionDetailsUpdateOperation
• ListingSyncProUpdateOperation
• AccountGroupExternalIdentifiersUpdateOperation
• SocialURLsUpdateOperation
• HoursOfOperationUpdateOperation
• ContactDetailsUpdateOperation
• LegacyProductDetailsUpdateOperation
• RichDataUpdateOperation

import {UpdateOperations} from '@vendasta/account-group-sdk'

let operations: UpdateOperations = new UpdateOperations();

operations.addUpdateOperation(new NapUpdateOperation({key: value...}));
operations.addUpdateOperation(new SnapshotsUpdateOperation({key: value...}));
operations.addUpdateOperation(new ListingDistributionDetailsUpdateOperation({key: value...}));
operations.addUpdateOperation(new ListingSyncProUpdateOperation({key: value...}));
operations.addUpdateOperation(new AccountGroupExternalIdentifiersUpdateOperation({key: value...}));
operations.addUpdateOperation(new SocialURLsUpdateOperation({key: value...}));
operations.addUpdateOperation(new HoursOfOperationUpdateOperation({key: value...}));
operations.addUpdateOperation(new ContactDetailsUpdateOperation({key: value...}));
operations.addUpdateOperation(new LegacyProductDetailsUpdateOperation({key: value...}));
operations.addUpdateOperation(new RichDataUpdateOperation({key: value...}));

Only fields specified will be altered on the account group.