reference-data
Helps lookup reference data.
API
init
Must be called before using to initialize data for the current context.
Parameters:
- data - the reference data object to use.
-
contextId: {id: string}|{name: string} (optional, defaults to
{ name: "Master" }
) - an identifier specifying the context.
Can throw an error if an invalid contextId
is provided.
initFromFile
Equivalent to init(), only gets the data from a JSON file that is provided by path. Async.
initFromS3
Equivalent to initFromFile(), only gets the JSON file from Amazon S3. Async.
Parameters:
- bucket - the S3 bucket that the file is in.
- key - the key (i.e. file name).
-
contextId: {id: string}|{name: string} (optional, defaults to
{ name: "Master" }
) - an identifier specifying the context.
Can throw an error if an invalid contextId
is provided or if the file does not exist.
isInitialized
Determines whether reference data has been initialized.
lookup
Gets a value.
Parameters:
- domainId: {id: string}|{referenceId: string}|{logicalName: string}|{technicalName: string} - an identifier specifying the domain of the value.
- serviceName - the name of the service.
- valueReferenceId - the reference ID of the value to get.
Can throw an error if no such domain, service or value exists.
reverseLookup
Gets a reference value based on a value from another service.
Parameters:
- domainId: {id: string}|{referenceId: string}|{logicalName: string}|{technicalName: string} - an identifier specifying the domain of the value.
- serviceName - the name of the service.
- value - the value to check.
Can throw an error if no such domain or service exists, if the specified value could not be found, or if there are multiple matches for the value.
reverseValueLookup
Gets a base value based on a value from another service.
Parameters:
- domainId: {id: string}|{referenceId: string}|{logicalName: string}|{technicalName: string} - an identifier specifying the domain of the value.
- serviceName - the name of the service.
- value - the value to check.
Can throw an error if no such domain or service exists, if the specified value could not be found, or if there are multiple matches for the value.
getReferenceIdByValueName
Gets a reference ID based on a value name.
Parameters:
- domainId: {id: string}|{referenceId: string}|{logicalName: string}|{technicalName: string} - an identifier specifying the domain of the value.
- valueName - the name of the value.
Can throw an error if no such domain exists or if the specified value could not be found.
getValueByReferenceId
Gets a base value by reference ID.
Parameters:
- referenceId - the reference ID of the value to get.
Returns undefined if the specified value is not found.
getDomainReferenceIds
Gets all reference IDs for a domain.
Parameters:
- domainId: {id: string}|{referenceId: string}|{logicalName: string}|{technicalName: string} - an identifier specifying the domain.
Can throw an error if no such domain exists.