Izara Wiki - User contributions [en]

Service - Organization

2026-08-18T03:45:58Z

Mint: /* organization */

= Overview =

A user can have many organizations, each organization has it's independent accounting.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== organization ==

<syntaxhighlight lang="JavaScript">
{
objectType: "organization",
canDelete: false,
generatedBy: "userGenerated",
addOnDataStructure: [
{
type:"rbac"
},
{
type: "propertyValue"
},
{
type: "versionedData",
versionedDataLabel: "Detail",
storageResourceTag : "myGraph",
fieldNames: {
"organizationName":{
type: "string",
requiredOnCreate: true,
canUpdate: true,
userCanUpdate: true,
},
"dailyRateCurrencyTableId":{
type: "string",
requiredOnCreate: true,
canUpdate: true,
userCanUpdate: true,
},
}
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
fieldNames: {
organizationId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph']
},
functionalCurrency: {
type: "currency",
requiredOnCreate: true,
canUpdate: false,
userCanUpdate: false,
storageResourceTags: ['myGraph']
},

precision: {
type: "integer",
randomOnCreate: false,
optionalOnCreate: true,
requiredOnCreate: false,
validation: {
pattern: pattern
},
storageResourceTags: ['graph'],
}
},
identifiers: [
{
type: "identifier",
fieldName: "organizationId"
}
]
}
</syntaxhighlight>

== Relationships ==

=== hasOrganization ===

<syntaxhighlight lang="JavaScript">
{
hasOrganization: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
canChangeToRelTypes: [
{
serviceTag: "Organization",
relationshipTag: "removedOrganization"
},
],
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "User",
objectType: "user"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "Organization",
objectType: "organization"
},
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

=== removedOrganization ===

<syntaxhighlight lang="JavaScript">
{
removedOrganization: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
canChangeToRelTypes: [
{
serviceTag: "Organization",
relationshipTag: "hasOrganization"
},
],
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "User",
objectType: "user"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "Organization",
objectType: "organization"
},
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

* links a user to the organization they manage
* does not convey ownership, each organization is a standalone organization that has it's own RBAC
* this allows for simple transfer of ownership of data

= Addresses =

* use same structure as users in Izara Market

= Working documents =

[[:Category:Working_documents - Organization| Organization]]

[[Category:Backend services| Organization]]

2025-11-20 IntegrationTest

2026-08-17T03:25:49Z

Mint: /* dynamoDBSeedDataTags */

Reference:

*[[2020-10-01 - Integration Test Config - Functions|IntegrationtestConfig]]
*[[2020-10-01 - Integration Testing - Lambda Functions|Integrationtesting]]
*[[2025-02-20 - Integration Test examples|Example]]

= File extension =

uploadS3: ".json"
integrationtestConfig: ".js"

=TestRecord=

<syntaxhighlight lang="JSON">
[
{
integrationTestTag: "Integrationtest_xx",
testStartedTimestamp: 111111111, // start time
bucketName: "integrationtest-config-us-east-2",
lastUpdateUniqueRequestId: "sssss", //_izContext.uniqueRequestId protacts race coditionn dynamodb
testStatus: "passed",//failed,processing,passed
testCompleteTimestamp: 1111113, // all test finish
stages: [
{
stageConfig: {
//straight copy of this stage from integration test config
inputEventTag: "xx",
inputEventConfig: {//event input
},
outputEventTag: "output_xx",
outputEventConfig: {//event out put
},
resourceName: "ComplexfilterTestProcessComplexfilter",// function name
resourceType: "Lambda", // function name
serviceTag: "Complexfilter",// (initeate sqs)
snsServiceName: "Complexfilter",// (initeate sqs)
snsTopic: "PorcessComplexfilter_In"// (initeate sqs)

},
stageStatus: "waiting", //waiting|passed|failed,
stageFinishedTimestamp: 111111111,// time that all tests finished and testRecord.stages.{stageKey}.stageStatus updated
stageResults: {
//results at the point of entering the resource (eg a Lambda function is invoked)
inputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of returning from the resource (eg a Lambda function returns)
outputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of invoking an external resource (eg the tested Lambda function is invoking another Lambda function)
invokes: {
"serviceName_resourceType_resourceName_inputEventTag ": {
invokeTimestamp: 111111111,//{ time result saved },
resultTimestamp: 111111112,//{ time result saved },
resultStatus: "passed",//passed | failed,
invokeParams: {},//{event invoke input config }
requestParams: {}// event invoke input request
},
},
dynamodbResults: [
{
indexOfDynamodbOutput: 0,
requestParams,
resultStatus: "passed",//
resultTimestamp: 22222
}]

},
stageErrors: [
//misc errors encountered
]
}]

}
]
</syntaxhighlight>

=Seed Data=
integrationtest manager seed date 2 process

=== Main Seed Data===
:Save file in s3 (in '''buckname''' :integrationtest-config-us-east-2, '''folder''':seedData_integrationTest).For other dev use service,If a developer wants to add more for other important testing purposes.

'''How to use:'''
#Add it from the s3 bucket at this point
#Run batch refreshSeedData [[Developer guide for making Integration Tests#Bash script|batch RefreshSeedData]]
'''Logic''':Process by storage resouse (graph or dynamodb)
:To clean up the seed data in the table after it creates seed data form service deploy and pulls seed data from s3.

=== Refresh Seed Data ===
:ProcessRefreshSeedData use seedDataTag for create data environment of '''test''' and can be refresh seeddata re-test agian.
:'''canbe share''' seed data for other test by seed data tag.
'''How to use:'''
:Save file in s3 (for other dav keep in floder dev name) or testConfig/seedData_config(for admin)

'''Folder'''
*dynamoDBSeedDataTags.json
*graphSeedDataTags.json

'''Example'''
==== dynamoDBSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource dynammodb.
Example
<syntaxhighlight lang="JavaScript">
{
"seedDynamodb_abc_ver2": [ // seedDataTag
{
"tableName": "DelivMethodSTDTestLogicalResultsData", // servcieTag+stage+tablename
"partitionKey": "logicalResultId",
"sortKey": "identifiersId",
"datas": [
{
logicalResultId: {
value: "eeeeeeeeee4"
},
identifiersId: {
value: "lllll123456"
},
processLogicalResultExpiryTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustmentInSeconds: 300 // Seconds eg 5 minite = 5*60 = 300 Seconds. or 2 day = 2*(24*60*60) = 172800
}
},
{
logicalResultId: {
value: "eeeeeeeeee4"
},
"identifiersId": {
value: "lllll777777"
},
processLogicalResultExpiryTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "add", // add|subtract
adjustmentInSeconds: 172800 // Seconds eg 5 minite = 5*60 = 300 Seconds. or 2 day = 2*(24*60*60) = 172800
}
}
],
},
{
"tableName": "MLocationsTestFloatingRelationships",// servcieTag+stage+tablename
"partitionKey": "importBatchId",
"sortKey": "identifierRelationshipsId",
"datas": [
{
"importBatchId":{value: "2-uuuuuuuuuuuuuu"},
"identifierRelationshipsId": {value:"lllll123456"}
},
{
"importBatchId": {value:"2-uuuuuuuuuuuuuu"},
"identifierRelationshipsId": {value:"lllll777777"}
},
{
"importBatchId": {value:"2-uuuuuuuuuuuuuu"},
"identifierRelationshipsId": {value:"lllll99999999"}
}
]
},
{
"tableName": "MLocationsTestFindDataMain",
"partitionKey": "findDataId",
"datas": [
{
"findDataId":{value: "111111"}
},
{
"findDataId": {value:"22222"}
},
{
"findDataId": {value:"333333"}
}
]
}
]
}
</syntaxhighlight>

==== graphSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource graphHanler.
Example
<syntaxhighlight lang="JavaScript">
{
"seedData_testTag_GG": [ // seedDataTag
{
"nodes": [
{
"nodeLabels": [
"SellOfferPlan_sellOfferPlanDeliveryMethodLink"
],
"objectDetail": {
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": {
"value": "minttestrefreshSeedData_01",
},
},
"fields": {
"productId": {
"value": "ddddd",
},
"price": {
"value": 9999
},
exampleTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustmentInSeconds: 300 // Seconds eg 5 minite = 5*60 = 300 Seconds. or 2 day = 2*(24*60*60) = 172800
}
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMall"
],
"objectDetail": {
"identifiers": {
"shoppingMallId": {"value":"minttestrefreshSeedData_shoppingMallId"}
},
"fields": {
"name": {"value":"hotpot-man"},
"totalPrice": {"value":500}
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMallCalculateSetting"
],
"objectDetail": {
"identifiers": {
"versionedDataId": {"value":"minttestrefreshSeedData_versionedDataId"}
},
"fields": {
"addToCalculatedValuePerOrder": {"value":10},
"addToRateTableValuePerOrder": {"value":77}
}
}
}
],
"relationships": [
{
"fromObject": {
"nodeLabel": "SellOfferPlan_sellOfferPlanDeliveryMethodLink",
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": {"value":"minttestrefreshSeedData_01"}
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": {"value":"minttestrefreshSeedData_shoppingMallId"}
}
},
"relationships": [
{
"relTypeConcat": "SellOfferPlan_hasCCCCCCC",
"relId": "uuid-4s56df74s9df79w-w6de4f5w689ef"
}
]
},
{
"fromObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": {"value":"minttestrefreshSeedData_shoppingMallId"}
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMallCalculateSetting",
"identifiers": {
"versionedDataId": {"value":"minttestrefreshSeedData_versionedDataId"}
}
},
"relationships": [
{
"relTypeConcat": "servcieMintTest_shoppingMall_currentShoppingMallCalculateSetting",
"relId": "uuid-s122df5-s21df",
"relationshipProperty": {
"timeStamp":{"value": 1234567879},
"statusName": {"value":true}
}
},
{
"relTypeConcat": "servcieMintTest_shoppingMall_hasShoppingMallCalculateSetting",
"relId": "uuid-77777-99999",
"relationshipProperties": {
"statusName": {
"value": true
},
exampleTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustmentInSeconds: 300 // Seconds eg 5 minite = 5*60 = 300 Seconds. or 2 day = 2*(24*60*60) = 172800
}
}
]
}
]
}
],

"seedData_testTag_LL": []
}
</syntaxhighlight>

=== Cleaning Seed Data ===
:Delete seed data for set environment of '''test'''.
*cleaningeDynamoOneRecordsTags.json
*cleaningeDynamoManyRecordsTags.json

====cleaningeDynamoOneRecordsTags====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_TestFindData_and_Education_case_invalid01": [
{
"tableName": "MLocationsTestFindDataMain",
"primaryKeys": [
{
"findDataId": "cleaning-1"
},
{
"findDataId": "cleaning-2"
}
]
},
{
"tableName": "MLocationsTestEducation",
"primaryKeys": [
{
"studentId": "cleaning-AA"
},
{
"studentId": "cleaning-BB"
},
{
"studentId": "cleaning-CC"
}
]
}
],
"cleaningSeed_TestMemberPersonnel_case_invalid01": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "namtan",
"passwordId": "qqqww"
},
{
"userId": "jack",
"passwordId": "q1"
},
{
"userId": "Momay",
"passwordId": "ttr"
}
]
}
]
}
</syntaxhighlight>

==== cleaningeDynamoManyRecordsTags ====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_manyData_partitionKey_only_miss_sort": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "many-data"
}
]
}
]
}
</syntaxhighlight>

*logic query table MLocationsTestMemberPersonnel use primary Keys "userId" and then delete all data from primary Keys.

=resources=
syntax is object
<syntaxhighlight lang="JavaScript">
{
"Lambda":{
"{FunctionNameHdrSqs}":{ // FunctionNameHdrSqs is match resourceName in file tests
"localLacation":"/src/FunctionNameHdrSqs.js",
"localHandler":"main",
"functionName":"FunctionNameHdrSqs" // FunctionName is function name match key of function.yml of servcie.
},
"ProcessComplexFilterHdrSqs":{
"localLacation":"/src/ProcessComplexFilterHdrSqs.js",
"localHandler":"main",
"functionName":"ProcessComplexFilterHdrSqs"
},
...
},
"Dynamodb": {
"filterMain":{ // match resourceName in file tests(dynamodbOutputEventIdentifiers)
"tableName":"filterMain"
},
"tableNameBB":{
"tableName":"tableNameBB"
},
...
}
}
</syntaxhighlight>

=events=
Syntax is object
==Syntax Name==
===FileName===
::Event_{inputEventTag}

===eventTag===
#inputEventTag
#outputEventTag
#dynamodbTag

*file events.js is have eventTag (inputEventTag,outputEventTag,dynamodbTag)
**How to create name eventTag
***Example case : "test in service complexFilter functionname ProcessComplexFilter case element type is logical basic".
::*'''inputEventTag'''
::::{serviceName}_{functionName}_{caseTest}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''outputEventTag'''
::::output_{inputEventTag}
''output_Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''dynamodbTag'''
::::{inputEventTag}__Dynamodb__{'''action*'''}_{tableName}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic___Dynamodb__putItem_filterMain''
: '''{action}''' is only ''put'' or ''update'', and in case of ''update'' must only test the last step of update 

=== Syntax event===
====initiate by handlerServcie====
=====Sqs=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Sns
{
"LambdaFunctionHdrSqs_input__pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
},
"propertyB":{
"properties":{
"propertyB1":{
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"value":"msgTag"
},
"propertyD":{
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
<syntaxhighlight lang="JavaScript" linein>
"snsSqsTrigger":true
</syntaxhighlight>

=====Dsq=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Direct Sqs
{
"LambdaFunctionHdrDsq_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"DirectSqs":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrDsq_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
* DirectSqs = true
:: for initialStage of Dsq
* messageAttributes is optional

=====Inv=====
<syntaxhighlight lang="JavaScript">
{
"LambdaFunctionHdrInv_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
}
}
},
{
"output_LambdaFunctionHdrInv_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>

=====Api=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of API
{
"LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"forstageMatvhing": true,
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1",
},
"propertyB": {
"properties": {
"propertyB1": {
"value": "valuePropertyB1",
}
}
},
"propertyC": {
"eventValue": [
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3",
]
},
...
}
}
}
},
"Output_LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1"
},
...
}
}
}
}
}
</syntaxhighlight>

=====S3=====

====dynamodb====
<syntaxhighlight lang="JavaScript">
// An example event of Dynamodb //optional
{
{inputEventTag}__dynamodb_{action}_{tablename}: { // eg. "Complexfilter_ProcessComplexfilter_logical_basic__dynamodb_update_FilterMain"
"forStageMatching": true,
"properties": {
"filterMainUniqueRequestId": {
"testValueMatches": fase,
"value": "bbc4f4a9-2032-4dec-9129-8c7d169fecc5"
},
"filterObject": {
"forStageMatching": true,
"properties": {
"logicalType": {
"value": "partitionKey"
},
"comparison": {
"value": "equals"
},
"type": {
"value": "logical"
},
"partitionKey": {
"forStageMatching": true,
"value": "mockIntegratioTestCPF"
}
}
},
"filterMainExpiryTime": {
"testValueMatches": fase,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": fase,
"value": 1731894402678
},
"objType": {
"forStageMatching": true,
"properties": {
"serviceTag": {
"forStageMatching": true,
"value": "IntTesting"
},
"objectType": {
"forStageMatching": true,
"value": "TestRecord"
}
}
}
},
"keyValues": {
"filterMainId": "4865d2451a621cb7f71225cfabf2df4f98e20801",
"objTypeId": "cdb170690571df7522b3850920fce02507c077ee"
}
}
}
</syntaxhighlight>

* partition key: filterMainId
* sort key: objTypeId

[[2021-01-15 - Integration Testing - Adding DynamoDB result tests]]

===Type paramiter===
use for evnet and dyanmodb event
====Normal====
<syntaxhighlight lang="JavaScript">

object: {
forStageMatching: true,
properties: {
name:{
forStageMatching: true,
value:"Tom"
}
}
},
array: {
forStageMatching: true,
useIsEqual: true,
eventValue: [
{
"relTypeAndDirection": {
"relType": {
"serviceTag": "maxxCart2",
"relationshipTag": "hasCartOrder"
},
"relationshipDirection": "from"
},
"targetObjects": [
{
"objType": {
"serviceTag": "maxxCart2",
"objectType": "cartOrder"
}
}
]
}
]
},
number: {
forStageMatching: true,
value: 1111
},
string: {
forStageMatching: true,
value: "hi"
},
boolean: {
forStageMatching: true,
value: true
}
</syntaxhighlight>

<syntaxhighlight lang="JavaScript">
forStageMatching: true
</syntaxhighlight>
::set true for check match value,It is not necessary to set every value
:::use in test importent paramiter

<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
::setting paramiter require on create but can not test random value eg: identifier or timeStamp or uuid

====Empty====
<syntaxhighlight lang="JavaScript">
EmptyString:{
forStageMatching: true,
value:""
},
EmptyArray:{
forStageMatching: true,
useIsEqual: true,
eventValue: []
},
EmptyObject:{
forStageMatching: true,
value:{}
}
</syntaxhighlight>

====Error====
can test noRetryError
<syntaxhighlight lang="JavaScript">
"errorMessage": {
forStageMatching: true,
"value": "Not found schema of {serviceTag:TestGraphHandler, objectType:notFoundObjType}"
}
</syntaxhighlight>

====Paramiter random====
Can not test case random numbber or uuid.
But requriOnCreate mush be set
<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
or set
<syntaxhighlight lang="JavaScript">
forStageMatching:false
</syntaxhighlight>

=tests=
Syntax is array of object
==Syntax name==
===Testtag name ===
*{integrationTestTag}
#Test Own servcie or not a lot stage
<syntaxhighlight lang="JavaScript">
Test_{inputEventTag}
</syntaxhighlight>
#Mix multiple servcie and multiple stage
<syntaxhighlight lang="JavaScript">
IntegrationTest_{inputEventTag}
</syntaxhighlight>

===File name ===
<syntaxhighlight lang="JavaScript">
{integrationTestTag}.json
</syntaxhighlight>

==Setting of test==
[[Service - Integration Test Config#tests.js Syntax|syntax test]]

<syntaxhighlight lang="JavaScript">
{
integrationTestTag: {integrationTestTag},
productionSafe: true|false, //default false
noInitialStage: true, // default false, if set to true, no error when no foundInitialStages found
errorIfStageUndefined: true|false, //default false
errorIfInvokeUndefined: true|false, //default false,
dynamoDBSeedDataTags:["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
graphSeedDataTags:["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
cleaningeDynamoOneRecordsTags: ["cleaningSeed_partitionKey_sortKey_normol"], //optional
cleaningeDynamoManyRecordsTags: [], // optional
stages:[
...
]
}
</syntaxhighlight>
*[[2025-11-20 IntegrationTest#dynamoDBSeedDataTags|dynamoDBSeedDataTags]]
*[[2025-11-20 IntegrationTest#graphSeedDataTags|graphSeedDataTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoOneRecordsTags|cleaningeDynamoOneRecordsTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoManyRecordsTags|cleaningeDynamoManyRecordsTags]]

==Stages==
====Initiate stage====
:'''"initialStage":true'''
[[Service_-_Integration_Test_Config#tests.js Syntax|detail property of test]]
=====HandlerService=====
======Sqs======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"Locations_ProcessLocationNodeSomting_casenotHaveData",
"serviceName":"Locations",
"resourceType":"Lambda",
"resourceName":"ProcessLocationNodeSomtingHdrDsq",
"outputEventTag":"Output_Locations_ProcessLocationNodeSomting_casenotHaveData"
}
]
</syntaxhighlight>
======Dsq======
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'LambdaFunctionHdrDsq_input_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'LambdaFunctionHdrDsq_output__returnvalue_pass',
// **** not set snsServiceName and snsTopic
// can be test dynamodbOutput
}
]
</syntaxhighlight>

======Api======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrApi_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrApi",
"outputEventTag":"LambdaFunctionHdrApi_output__pass"
}
]
</syntaxhighlight>

======Inv======
*'''single stage'''
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": ["cleaningSeed_partitionKey_sortKey_normol"], //optional
"cleaningeDynamoManyRecordsTags": []
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass"
}
]
}]
</syntaxhighlight>
*'''invoke multiple stage'''
:*Each stage test can invoke multiple lambda by use "eventStage Tag" point to stage for test integration test.
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv_invokes__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": [], //optional
"cleaningeDynamoManyRecordsTags": [], // optional
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass",
"invokes":[
{
"eventStageTag":"service_invokesB__pass"
},
{
"eventStageTag":"service_invokesD__pass"
}
]
},
{
"eventStageTag":"service_invokesB__pass",
"inputEventTag":"input_service_invokes__pass",
"serviceName":"ServiceTemplate_B",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_B_HdrInv",
"outputEventTag":"output_service_invokes__pass"
},
{
"eventStageTag":"service_invokesD__pass",
"inputEventTag":"input_service_invokesD__pass",
"serviceName":"ServiceTemplate_D",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_D_HdrInv",
"outputEventTag":"output_service_invokesD__pass"
}
]
}]
</syntaxhighlight>

======S3======
======Batch======

====GeneratedSeedData====
*Integrationtest must be delete identifier every time before test.
*Set 'generatedSeedData' in file tests.json case by case of stage eg: stages[0] create identifier is randomOnCreate will set 'generatedSeedData' and stages[1] create relationship is randomOnCreate(It is usually random, except in the case of relationship version) set generatedSeedData this stages[1].
*How to delete case identifier rendomOnCreate?: set in stage use setting generateSeedData "randomOnCreateIdentifier"
#randomOnCreateIdentifier
#notRandomOnIdentifier
#relationships
=====randomOnCreateIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"randomOnCreateIdentifier": [
{
"objType": {
"serviceTag": "MLocations",
"objectType": "Member"
},
"identifierValue": "Jaya-member-001"
}
]
}
}
]
</syntaxhighlight>
=====notRandomOnIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"notRandomOnIdentifier": [
{
"objType": {
"serviceTag": "gggg",
"objectType": "ssssss"
},
"identifiers": {
"topId": "123456"
}
}
]
}
}
]
</syntaxhighlight>
=====relationships=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"relationships": [
{
"relType": {
"serviceTag": "PaymentMethodGeneric",
"relationshipTag": "disabledPaymentMethodGenericPropertyValue"
},
"relId": "f4f73de7-647c-4b3b-8043-87cc002f361a"
}
]
}
}
]

</syntaxhighlight>

==Dynamodb==
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'output_Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
dynamodbOutputEventIdentifiers: [
{
serviceName: {tableName}, //service that deployed the DynamoDB table, so can build table's full resource name
resourceName: {resourceName}, //DynamoDB resourceName
eventTag: {eventTagDynamoDB}
}
],
}
]
</syntaxhighlight>

= Result of integrationtest =
Data have 2 table "TestRecord" and "TestUnit".
:- TestRecord is table all unti of stage inside eg input output invokes and dynamodb
:- TestUnit is store status each unit
each unit save in table TestUnit
testRecordId is name of test concat with testTime.
testUnitId is point to position of unti instage.
resultStatus is status of unit.
<syntaxhighlight lang="JavaScript">
eg:
input_0 = stages index 0 result '''input'''
output_1 = stages index 1 result '''output'''
invokeInput_0_1 = stages index 0 result '''invokes''' index 1 position input
invokeOutput_0_1 = stages index 0 result '''invokes''' index 1 position output
dynamodb_0_1 = stages index 0 result '''dynamodb''' index 1.
</syntaxhighlight>

after all TestUnit finish (check by awaitingMultiplestep penditnStep is integrationtestTag awaitingStepId is each TestUnit )
check all awaitingStep finish send message to ultimateIntegrationtest for sumla all test is status

== Summary of test status ==
:1.testStatus is "passed" all unit passed.
:2.testStatus is "failed" have some is failed.
:3.testStatus is "processing" have some is have status processing after check all awaiting step is finish.
:4.testStatus is "failed" have record "errorsTest" in case "not match stage invoke", 'found multiple matchingInvokes

*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

=How to test integrationtest s3=
[[Developer guide for making Integration Tests]]

[[Category:Working documents| 2025-11-20]]
[[Category:Working documents - Integration Testing| 2025-11-20]]

2025-11-20 IntegrationTest

2026-08-17T03:24:43Z

Mint: /* graphSeedDataTags */

Reference:

*[[2020-10-01 - Integration Test Config - Functions|IntegrationtestConfig]]
*[[2020-10-01 - Integration Testing - Lambda Functions|Integrationtesting]]
*[[2025-02-20 - Integration Test examples|Example]]

= File extension =

uploadS3: ".json"
integrationtestConfig: ".js"

=TestRecord=

<syntaxhighlight lang="JSON">
[
{
integrationTestTag: "Integrationtest_xx",
testStartedTimestamp: 111111111, // start time
bucketName: "integrationtest-config-us-east-2",
lastUpdateUniqueRequestId: "sssss", //_izContext.uniqueRequestId protacts race coditionn dynamodb
testStatus: "passed",//failed,processing,passed
testCompleteTimestamp: 1111113, // all test finish
stages: [
{
stageConfig: {
//straight copy of this stage from integration test config
inputEventTag: "xx",
inputEventConfig: {//event input
},
outputEventTag: "output_xx",
outputEventConfig: {//event out put
},
resourceName: "ComplexfilterTestProcessComplexfilter",// function name
resourceType: "Lambda", // function name
serviceTag: "Complexfilter",// (initeate sqs)
snsServiceName: "Complexfilter",// (initeate sqs)
snsTopic: "PorcessComplexfilter_In"// (initeate sqs)

},
stageStatus: "waiting", //waiting|passed|failed,
stageFinishedTimestamp: 111111111,// time that all tests finished and testRecord.stages.{stageKey}.stageStatus updated
stageResults: {
//results at the point of entering the resource (eg a Lambda function is invoked)
inputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of returning from the resource (eg a Lambda function returns)
outputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of invoking an external resource (eg the tested Lambda function is invoking another Lambda function)
invokes: {
"serviceName_resourceType_resourceName_inputEventTag ": {
invokeTimestamp: 111111111,//{ time result saved },
resultTimestamp: 111111112,//{ time result saved },
resultStatus: "passed",//passed | failed,
invokeParams: {},//{event invoke input config }
requestParams: {}// event invoke input request
},
},
dynamodbResults: [
{
indexOfDynamodbOutput: 0,
requestParams,
resultStatus: "passed",//
resultTimestamp: 22222
}]

},
stageErrors: [
//misc errors encountered
]
}]

}
]
</syntaxhighlight>

=Seed Data=
integrationtest manager seed date 2 process

=== Main Seed Data===
:Save file in s3 (in '''buckname''' :integrationtest-config-us-east-2, '''folder''':seedData_integrationTest).For other dev use service,If a developer wants to add more for other important testing purposes.

'''How to use:'''
#Add it from the s3 bucket at this point
#Run batch refreshSeedData [[Developer guide for making Integration Tests#Bash script|batch RefreshSeedData]]
'''Logic''':Process by storage resouse (graph or dynamodb)
:To clean up the seed data in the table after it creates seed data form service deploy and pulls seed data from s3.

=== Refresh Seed Data ===
:ProcessRefreshSeedData use seedDataTag for create data environment of '''test''' and can be refresh seeddata re-test agian.
:'''canbe share''' seed data for other test by seed data tag.
'''How to use:'''
:Save file in s3 (for other dav keep in floder dev name) or testConfig/seedData_config(for admin)

'''Folder'''
*dynamoDBSeedDataTags.json
*graphSeedDataTags.json

'''Example'''
==== dynamoDBSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource dynammodb.
Example
<syntaxhighlight lang="JavaScript">
{
"seedDynamodb_abc_ver2": [ // seedDataTag
{
"tableName": "DelivMethodSTDTestLogicalResultsData", // servcieTag+stage+tablename
"partitionKey": "logicalResultId",
"sortKey": "identifiersId",
"datas": [
{
logicalResultId: {
value: "eeeeeeeeee4"
},
identifiersId: {
value: "lllll123456"
},
processLogicalResultExpiryTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustmentInSeconds: 300 // Seconds eg 5 minite = 5*60 = 300 Seconds. or 2 day = 2*(24*60*60) = 172800
}
},
{
logicalResultId: {
value: "eeeeeeeeee4"
},
"identifiersId": {
value: "lllll777777"
},
processLogicalResultExpiryTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "add", // add|subtract
adjustmentInSeconds: 172800 // Seconds eg 5 minite = 5*60 = 300 Seconds. or 2 day = 2*(24*60*60) = 172800
}
}
],
},
{
"tableName": "MLocationsTestFloatingRelationships",// servcieTag+stage+tablename
"partitionKey": "importBatchId",
"sortKey": "identifierRelationshipsId",
"datas": [
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll123456"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll777777"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll99999999"
}
]
},
{
"tableName": "MLocationsTestFindDataMain",
"partitionKey": "findDataId",
"datas": [
{
"findDataId": "111111"
},
{
"findDataId": "22222"
},
{
"findDataId": "333333"
}
]
}
]
}
</syntaxhighlight>

==== graphSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource graphHanler.
Example
<syntaxhighlight lang="JavaScript">
{
"seedData_testTag_GG": [ // seedDataTag
{
"nodes": [
{
"nodeLabels": [
"SellOfferPlan_sellOfferPlanDeliveryMethodLink"
],
"objectDetail": {
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": {
"value": "minttestrefreshSeedData_01",
},
},
"fields": {
"productId": {
"value": "ddddd",
},
"price": {
"value": 9999
},
exampleTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustmentInSeconds: 300 // Seconds eg 5 minite = 5*60 = 300 Seconds. or 2 day = 2*(24*60*60) = 172800
}
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMall"
],
"objectDetail": {
"identifiers": {
"shoppingMallId": {"value":"minttestrefreshSeedData_shoppingMallId"}
},
"fields": {
"name": {"value":"hotpot-man"},
"totalPrice": {"value":500}
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMallCalculateSetting"
],
"objectDetail": {
"identifiers": {
"versionedDataId": {"value":"minttestrefreshSeedData_versionedDataId"}
},
"fields": {
"addToCalculatedValuePerOrder": {"value":10},
"addToRateTableValuePerOrder": {"value":77}
}
}
}
],
"relationships": [
{
"fromObject": {
"nodeLabel": "SellOfferPlan_sellOfferPlanDeliveryMethodLink",
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": {"value":"minttestrefreshSeedData_01"}
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": {"value":"minttestrefreshSeedData_shoppingMallId"}
}
},
"relationships": [
{
"relTypeConcat": "SellOfferPlan_hasCCCCCCC",
"relId": "uuid-4s56df74s9df79w-w6de4f5w689ef"
}
]
},
{
"fromObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": {"value":"minttestrefreshSeedData_shoppingMallId"}
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMallCalculateSetting",
"identifiers": {
"versionedDataId": {"value":"minttestrefreshSeedData_versionedDataId"}
}
},
"relationships": [
{
"relTypeConcat": "servcieMintTest_shoppingMall_currentShoppingMallCalculateSetting",
"relId": "uuid-s122df5-s21df",
"relationshipProperty": {
"timeStamp":{"value": 1234567879},
"statusName": {"value":true}
}
},
{
"relTypeConcat": "servcieMintTest_shoppingMall_hasShoppingMallCalculateSetting",
"relId": "uuid-77777-99999",
"relationshipProperties": {
"statusName": {
"value": true
},
exampleTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustmentInSeconds: 300 // Seconds eg 5 minite = 5*60 = 300 Seconds. or 2 day = 2*(24*60*60) = 172800
}
}
]
}
]
}
],

"seedData_testTag_LL": []
}
</syntaxhighlight>

=== Cleaning Seed Data ===
:Delete seed data for set environment of '''test'''.
*cleaningeDynamoOneRecordsTags.json
*cleaningeDynamoManyRecordsTags.json

====cleaningeDynamoOneRecordsTags====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_TestFindData_and_Education_case_invalid01": [
{
"tableName": "MLocationsTestFindDataMain",
"primaryKeys": [
{
"findDataId": "cleaning-1"
},
{
"findDataId": "cleaning-2"
}
]
},
{
"tableName": "MLocationsTestEducation",
"primaryKeys": [
{
"studentId": "cleaning-AA"
},
{
"studentId": "cleaning-BB"
},
{
"studentId": "cleaning-CC"
}
]
}
],
"cleaningSeed_TestMemberPersonnel_case_invalid01": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "namtan",
"passwordId": "qqqww"
},
{
"userId": "jack",
"passwordId": "q1"
},
{
"userId": "Momay",
"passwordId": "ttr"
}
]
}
]
}
</syntaxhighlight>

==== cleaningeDynamoManyRecordsTags ====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_manyData_partitionKey_only_miss_sort": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "many-data"
}
]
}
]
}
</syntaxhighlight>

*logic query table MLocationsTestMemberPersonnel use primary Keys "userId" and then delete all data from primary Keys.

=resources=
syntax is object
<syntaxhighlight lang="JavaScript">
{
"Lambda":{
"{FunctionNameHdrSqs}":{ // FunctionNameHdrSqs is match resourceName in file tests
"localLacation":"/src/FunctionNameHdrSqs.js",
"localHandler":"main",
"functionName":"FunctionNameHdrSqs" // FunctionName is function name match key of function.yml of servcie.
},
"ProcessComplexFilterHdrSqs":{
"localLacation":"/src/ProcessComplexFilterHdrSqs.js",
"localHandler":"main",
"functionName":"ProcessComplexFilterHdrSqs"
},
...
},
"Dynamodb": {
"filterMain":{ // match resourceName in file tests(dynamodbOutputEventIdentifiers)
"tableName":"filterMain"
},
"tableNameBB":{
"tableName":"tableNameBB"
},
...
}
}
</syntaxhighlight>

=events=
Syntax is object
==Syntax Name==
===FileName===
::Event_{inputEventTag}

===eventTag===
#inputEventTag
#outputEventTag
#dynamodbTag

*file events.js is have eventTag (inputEventTag,outputEventTag,dynamodbTag)
**How to create name eventTag
***Example case : "test in service complexFilter functionname ProcessComplexFilter case element type is logical basic".
::*'''inputEventTag'''
::::{serviceName}_{functionName}_{caseTest}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''outputEventTag'''
::::output_{inputEventTag}
''output_Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''dynamodbTag'''
::::{inputEventTag}__Dynamodb__{'''action*'''}_{tableName}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic___Dynamodb__putItem_filterMain''
: '''{action}''' is only ''put'' or ''update'', and in case of ''update'' must only test the last step of update 

=== Syntax event===
====initiate by handlerServcie====
=====Sqs=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Sns
{
"LambdaFunctionHdrSqs_input__pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
},
"propertyB":{
"properties":{
"propertyB1":{
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"value":"msgTag"
},
"propertyD":{
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
<syntaxhighlight lang="JavaScript" linein>
"snsSqsTrigger":true
</syntaxhighlight>

=====Dsq=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Direct Sqs
{
"LambdaFunctionHdrDsq_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"DirectSqs":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrDsq_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
* DirectSqs = true
:: for initialStage of Dsq
* messageAttributes is optional

=====Inv=====
<syntaxhighlight lang="JavaScript">
{
"LambdaFunctionHdrInv_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
}
}
},
{
"output_LambdaFunctionHdrInv_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>

=====Api=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of API
{
"LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"forstageMatvhing": true,
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1",
},
"propertyB": {
"properties": {
"propertyB1": {
"value": "valuePropertyB1",
}
}
},
"propertyC": {
"eventValue": [
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3",
]
},
...
}
}
}
},
"Output_LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1"
},
...
}
}
}
}
}
</syntaxhighlight>

=====S3=====

====dynamodb====
<syntaxhighlight lang="JavaScript">
// An example event of Dynamodb //optional
{
{inputEventTag}__dynamodb_{action}_{tablename}: { // eg. "Complexfilter_ProcessComplexfilter_logical_basic__dynamodb_update_FilterMain"
"forStageMatching": true,
"properties": {
"filterMainUniqueRequestId": {
"testValueMatches": fase,
"value": "bbc4f4a9-2032-4dec-9129-8c7d169fecc5"
},
"filterObject": {
"forStageMatching": true,
"properties": {
"logicalType": {
"value": "partitionKey"
},
"comparison": {
"value": "equals"
},
"type": {
"value": "logical"
},
"partitionKey": {
"forStageMatching": true,
"value": "mockIntegratioTestCPF"
}
}
},
"filterMainExpiryTime": {
"testValueMatches": fase,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": fase,
"value": 1731894402678
},
"objType": {
"forStageMatching": true,
"properties": {
"serviceTag": {
"forStageMatching": true,
"value": "IntTesting"
},
"objectType": {
"forStageMatching": true,
"value": "TestRecord"
}
}
}
},
"keyValues": {
"filterMainId": "4865d2451a621cb7f71225cfabf2df4f98e20801",
"objTypeId": "cdb170690571df7522b3850920fce02507c077ee"
}
}
}
</syntaxhighlight>

* partition key: filterMainId
* sort key: objTypeId

[[2021-01-15 - Integration Testing - Adding DynamoDB result tests]]

===Type paramiter===
use for evnet and dyanmodb event
====Normal====
<syntaxhighlight lang="JavaScript">

object: {
forStageMatching: true,
properties: {
name:{
forStageMatching: true,
value:"Tom"
}
}
},
array: {
forStageMatching: true,
useIsEqual: true,
eventValue: [
{
"relTypeAndDirection": {
"relType": {
"serviceTag": "maxxCart2",
"relationshipTag": "hasCartOrder"
},
"relationshipDirection": "from"
},
"targetObjects": [
{
"objType": {
"serviceTag": "maxxCart2",
"objectType": "cartOrder"
}
}
]
}
]
},
number: {
forStageMatching: true,
value: 1111
},
string: {
forStageMatching: true,
value: "hi"
},
boolean: {
forStageMatching: true,
value: true
}
</syntaxhighlight>

<syntaxhighlight lang="JavaScript">
forStageMatching: true
</syntaxhighlight>
::set true for check match value,It is not necessary to set every value
:::use in test importent paramiter

<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
::setting paramiter require on create but can not test random value eg: identifier or timeStamp or uuid

====Empty====
<syntaxhighlight lang="JavaScript">
EmptyString:{
forStageMatching: true,
value:""
},
EmptyArray:{
forStageMatching: true,
useIsEqual: true,
eventValue: []
},
EmptyObject:{
forStageMatching: true,
value:{}
}
</syntaxhighlight>

====Error====
can test noRetryError
<syntaxhighlight lang="JavaScript">
"errorMessage": {
forStageMatching: true,
"value": "Not found schema of {serviceTag:TestGraphHandler, objectType:notFoundObjType}"
}
</syntaxhighlight>

====Paramiter random====
Can not test case random numbber or uuid.
But requriOnCreate mush be set
<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
or set
<syntaxhighlight lang="JavaScript">
forStageMatching:false
</syntaxhighlight>

=tests=
Syntax is array of object
==Syntax name==
===Testtag name ===
*{integrationTestTag}
#Test Own servcie or not a lot stage
<syntaxhighlight lang="JavaScript">
Test_{inputEventTag}
</syntaxhighlight>
#Mix multiple servcie and multiple stage
<syntaxhighlight lang="JavaScript">
IntegrationTest_{inputEventTag}
</syntaxhighlight>

===File name ===
<syntaxhighlight lang="JavaScript">
{integrationTestTag}.json
</syntaxhighlight>

==Setting of test==
[[Service - Integration Test Config#tests.js Syntax|syntax test]]

<syntaxhighlight lang="JavaScript">
{
integrationTestTag: {integrationTestTag},
productionSafe: true|false, //default false
noInitialStage: true, // default false, if set to true, no error when no foundInitialStages found
errorIfStageUndefined: true|false, //default false
errorIfInvokeUndefined: true|false, //default false,
dynamoDBSeedDataTags:["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
graphSeedDataTags:["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
cleaningeDynamoOneRecordsTags: ["cleaningSeed_partitionKey_sortKey_normol"], //optional
cleaningeDynamoManyRecordsTags: [], // optional
stages:[
...
]
}
</syntaxhighlight>
*[[2025-11-20 IntegrationTest#dynamoDBSeedDataTags|dynamoDBSeedDataTags]]
*[[2025-11-20 IntegrationTest#graphSeedDataTags|graphSeedDataTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoOneRecordsTags|cleaningeDynamoOneRecordsTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoManyRecordsTags|cleaningeDynamoManyRecordsTags]]

==Stages==
====Initiate stage====
:'''"initialStage":true'''
[[Service_-_Integration_Test_Config#tests.js Syntax|detail property of test]]
=====HandlerService=====
======Sqs======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"Locations_ProcessLocationNodeSomting_casenotHaveData",
"serviceName":"Locations",
"resourceType":"Lambda",
"resourceName":"ProcessLocationNodeSomtingHdrDsq",
"outputEventTag":"Output_Locations_ProcessLocationNodeSomting_casenotHaveData"
}
]
</syntaxhighlight>
======Dsq======
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'LambdaFunctionHdrDsq_input_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'LambdaFunctionHdrDsq_output__returnvalue_pass',
// **** not set snsServiceName and snsTopic
// can be test dynamodbOutput
}
]
</syntaxhighlight>

======Api======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrApi_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrApi",
"outputEventTag":"LambdaFunctionHdrApi_output__pass"
}
]
</syntaxhighlight>

======Inv======
*'''single stage'''
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": ["cleaningSeed_partitionKey_sortKey_normol"], //optional
"cleaningeDynamoManyRecordsTags": []
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass"
}
]
}]
</syntaxhighlight>
*'''invoke multiple stage'''
:*Each stage test can invoke multiple lambda by use "eventStage Tag" point to stage for test integration test.
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv_invokes__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": [], //optional
"cleaningeDynamoManyRecordsTags": [], // optional
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass",
"invokes":[
{
"eventStageTag":"service_invokesB__pass"
},
{
"eventStageTag":"service_invokesD__pass"
}
]
},
{
"eventStageTag":"service_invokesB__pass",
"inputEventTag":"input_service_invokes__pass",
"serviceName":"ServiceTemplate_B",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_B_HdrInv",
"outputEventTag":"output_service_invokes__pass"
},
{
"eventStageTag":"service_invokesD__pass",
"inputEventTag":"input_service_invokesD__pass",
"serviceName":"ServiceTemplate_D",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_D_HdrInv",
"outputEventTag":"output_service_invokesD__pass"
}
]
}]
</syntaxhighlight>

======S3======
======Batch======

====GeneratedSeedData====
*Integrationtest must be delete identifier every time before test.
*Set 'generatedSeedData' in file tests.json case by case of stage eg: stages[0] create identifier is randomOnCreate will set 'generatedSeedData' and stages[1] create relationship is randomOnCreate(It is usually random, except in the case of relationship version) set generatedSeedData this stages[1].
*How to delete case identifier rendomOnCreate?: set in stage use setting generateSeedData "randomOnCreateIdentifier"
#randomOnCreateIdentifier
#notRandomOnIdentifier
#relationships
=====randomOnCreateIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"randomOnCreateIdentifier": [
{
"objType": {
"serviceTag": "MLocations",
"objectType": "Member"
},
"identifierValue": "Jaya-member-001"
}
]
}
}
]
</syntaxhighlight>
=====notRandomOnIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"notRandomOnIdentifier": [
{
"objType": {
"serviceTag": "gggg",
"objectType": "ssssss"
},
"identifiers": {
"topId": "123456"
}
}
]
}
}
]
</syntaxhighlight>
=====relationships=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"relationships": [
{
"relType": {
"serviceTag": "PaymentMethodGeneric",
"relationshipTag": "disabledPaymentMethodGenericPropertyValue"
},
"relId": "f4f73de7-647c-4b3b-8043-87cc002f361a"
}
]
}
}
]

</syntaxhighlight>

==Dynamodb==
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'output_Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
dynamodbOutputEventIdentifiers: [
{
serviceName: {tableName}, //service that deployed the DynamoDB table, so can build table's full resource name
resourceName: {resourceName}, //DynamoDB resourceName
eventTag: {eventTagDynamoDB}
}
],
}
]
</syntaxhighlight>

= Result of integrationtest =
Data have 2 table "TestRecord" and "TestUnit".
:- TestRecord is table all unti of stage inside eg input output invokes and dynamodb
:- TestUnit is store status each unit
each unit save in table TestUnit
testRecordId is name of test concat with testTime.
testUnitId is point to position of unti instage.
resultStatus is status of unit.
<syntaxhighlight lang="JavaScript">
eg:
input_0 = stages index 0 result '''input'''
output_1 = stages index 1 result '''output'''
invokeInput_0_1 = stages index 0 result '''invokes''' index 1 position input
invokeOutput_0_1 = stages index 0 result '''invokes''' index 1 position output
dynamodb_0_1 = stages index 0 result '''dynamodb''' index 1.
</syntaxhighlight>

after all TestUnit finish (check by awaitingMultiplestep penditnStep is integrationtestTag awaitingStepId is each TestUnit )
check all awaitingStep finish send message to ultimateIntegrationtest for sumla all test is status

== Summary of test status ==
:1.testStatus is "passed" all unit passed.
:2.testStatus is "failed" have some is failed.
:3.testStatus is "processing" have some is have status processing after check all awaiting step is finish.
:4.testStatus is "failed" have record "errorsTest" in case "not match stage invoke", 'found multiple matchingInvokes

*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

=How to test integrationtest s3=
[[Developer guide for making Integration Tests]]

[[Category:Working documents| 2025-11-20]]
[[Category:Working documents - Integration Testing| 2025-11-20]]

2025-11-20 IntegrationTest

2026-08-17T03:23:18Z

Mint: /* graphSeedDataTags */

Reference:

*[[2020-10-01 - Integration Test Config - Functions|IntegrationtestConfig]]
*[[2020-10-01 - Integration Testing - Lambda Functions|Integrationtesting]]
*[[2025-02-20 - Integration Test examples|Example]]

= File extension =

uploadS3: ".json"
integrationtestConfig: ".js"

=TestRecord=

<syntaxhighlight lang="JSON">
[
{
integrationTestTag: "Integrationtest_xx",
testStartedTimestamp: 111111111, // start time
bucketName: "integrationtest-config-us-east-2",
lastUpdateUniqueRequestId: "sssss", //_izContext.uniqueRequestId protacts race coditionn dynamodb
testStatus: "passed",//failed,processing,passed
testCompleteTimestamp: 1111113, // all test finish
stages: [
{
stageConfig: {
//straight copy of this stage from integration test config
inputEventTag: "xx",
inputEventConfig: {//event input
},
outputEventTag: "output_xx",
outputEventConfig: {//event out put
},
resourceName: "ComplexfilterTestProcessComplexfilter",// function name
resourceType: "Lambda", // function name
serviceTag: "Complexfilter",// (initeate sqs)
snsServiceName: "Complexfilter",// (initeate sqs)
snsTopic: "PorcessComplexfilter_In"// (initeate sqs)

},
stageStatus: "waiting", //waiting|passed|failed,
stageFinishedTimestamp: 111111111,// time that all tests finished and testRecord.stages.{stageKey}.stageStatus updated
stageResults: {
//results at the point of entering the resource (eg a Lambda function is invoked)
inputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of returning from the resource (eg a Lambda function returns)
outputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of invoking an external resource (eg the tested Lambda function is invoking another Lambda function)
invokes: {
"serviceName_resourceType_resourceName_inputEventTag ": {
invokeTimestamp: 111111111,//{ time result saved },
resultTimestamp: 111111112,//{ time result saved },
resultStatus: "passed",//passed | failed,
invokeParams: {},//{event invoke input config }
requestParams: {}// event invoke input request
},
},
dynamodbResults: [
{
indexOfDynamodbOutput: 0,
requestParams,
resultStatus: "passed",//
resultTimestamp: 22222
}]

},
stageErrors: [
//misc errors encountered
]
}]

}
]
</syntaxhighlight>

=Seed Data=
integrationtest manager seed date 2 process

=== Main Seed Data===
:Save file in s3 (in '''buckname''' :integrationtest-config-us-east-2, '''folder''':seedData_integrationTest).For other dev use service,If a developer wants to add more for other important testing purposes.

'''How to use:'''
#Add it from the s3 bucket at this point
#Run batch refreshSeedData [[Developer guide for making Integration Tests#Bash script|batch RefreshSeedData]]
'''Logic''':Process by storage resouse (graph or dynamodb)
:To clean up the seed data in the table after it creates seed data form service deploy and pulls seed data from s3.

=== Refresh Seed Data ===
:ProcessRefreshSeedData use seedDataTag for create data environment of '''test''' and can be refresh seeddata re-test agian.
:'''canbe share''' seed data for other test by seed data tag.
'''How to use:'''
:Save file in s3 (for other dav keep in floder dev name) or testConfig/seedData_config(for admin)

'''Folder'''
*dynamoDBSeedDataTags.json
*graphSeedDataTags.json

'''Example'''
==== dynamoDBSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource dynammodb.
Example
<syntaxhighlight lang="JavaScript">
{
"seedDynamodb_abc_ver2": [ // seedDataTag
{
"tableName": "DelivMethodSTDTestLogicalResultsData", // servcieTag+stage+tablename
"partitionKey": "logicalResultId",
"sortKey": "identifiersId",
"datas": [
{
logicalResultId: {
value: "eeeeeeeeee4"
},
identifiersId: {
value: "lllll123456"
},
processLogicalResultExpiryTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustmentInSeconds: 300 // Seconds eg 5 minite = 5*60 = 300 Seconds. or 2 day = 2*(24*60*60) = 172800
}
},
{
logicalResultId: {
value: "eeeeeeeeee4"
},
"identifiersId": {
value: "lllll777777"
},
processLogicalResultExpiryTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "add", // add|subtract
adjustmentInSeconds: 172800 // Seconds eg 5 minite = 5*60 = 300 Seconds. or 2 day = 2*(24*60*60) = 172800
}
}
],
},
{
"tableName": "MLocationsTestFloatingRelationships",// servcieTag+stage+tablename
"partitionKey": "importBatchId",
"sortKey": "identifierRelationshipsId",
"datas": [
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll123456"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll777777"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll99999999"
}
]
},
{
"tableName": "MLocationsTestFindDataMain",
"partitionKey": "findDataId",
"datas": [
{
"findDataId": "111111"
},
{
"findDataId": "22222"
},
{
"findDataId": "333333"
}
]
}
]
}
</syntaxhighlight>

==== graphSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource graphHanler.
Example
<syntaxhighlight lang="JavaScript">
{
"seedData_testTag_GG": [ // seedDataTag
{
"nodes": [
{
"nodeLabels": [
"SellOfferPlan_sellOfferPlanDeliveryMethodLink"
],
"objectDetail": {
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": {
"value": "minttestrefreshSeedData_01",
},
},
"fields": {
"productId": {
"value": "ddddd",
},
"price": {
"value": 9999
},
exampleTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustmentInSeconds: 300 // Seconds eg 5 minite = 5*60 = 300 Seconds. or 2 day = 2*(24*60*60) = 172800
}
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMall"
],
"objectDetail": {
"identifiers": {
"shoppingMallId": {"value":"minttestrefreshSeedData_shoppingMallId"}
},
"fields": {
"name": {"value":"hotpot-man"},
"totalPrice": {"value":500}
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMallCalculateSetting"
],
"objectDetail": {
"identifiers": {
"versionedDataId": {"value":"minttestrefreshSeedData_versionedDataId"}
},
"fields": {
"addToCalculatedValuePerOrder": {"value":10},
"addToRateTableValuePerOrder": {"value":77}
}
}
}
],
"relationships": [
{
"fromObject": {
"nodeLabel": "SellOfferPlan_sellOfferPlanDeliveryMethodLink",
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": {"value":"minttestrefreshSeedData_01"}
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": {"value":"minttestrefreshSeedData_shoppingMallId"}
}
},
"relationships": [
{
"relTypeConcat": "SellOfferPlan_hasCCCCCCC",
"relId": "uuid-4s56df74s9df79w-w6de4f5w689ef"
}
]
},
{
"fromObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": {"value":"minttestrefreshSeedData_shoppingMallId"}
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMallCalculateSetting",
"identifiers": {
"versionedDataId": {"value":"minttestrefreshSeedData_versionedDataId"}
}
},
"relationships": [
{
"relTypeConcat": "servcieMintTest_shoppingMall_currentShoppingMallCalculateSetting",
"relId": "uuid-s122df5-s21df",
"relationshipProperty": {
"timeStamp":{"value": 1234567879},
"statusName": {"value":true}
}
},
{
"relTypeConcat": "servcieMintTest_shoppingMall_hasShoppingMallCalculateSetting",
"relId": "uuid-77777-99999",
"relationshipProperties": {
"statusName": {
"value": true
},
exampleTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustmentInSeconds: 300 // Seconds eg 5 minite = 5*60 = 300 Seconds. or 2 day = 2*(24*60*60) = 172800
}
}
]
}
]
}
],
"seedData_testTag_ABC": [
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId":{"value": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"}
},
"fields": {}
},
"relationships": [
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "hasProductAttributeLink"
},
"relationshipDirection": "to",
"targetObjType": {
"serviceTag": "ProductStandard",
"objectType": "productStandard"
},
"targetIdentifiers": {
"productId": {"value":"f526a367a2b66cb0f37ca61b6c43f419929f521d"}
},
"relationshipProperties": {}
},
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "isProductAttribute"
},
"relationshipDirection": "from",
"targetObjType": {
"serviceTag": "ProductAttribute",
"objectType": "productAttribute"
},
"targetIdentifiers": {
"productAttributeId": {"value":"f4bf7a078071d54036656df544197ba638bc3a68"}
},
"relationshipProperties": {}
}
]
},
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId":{"value": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"}
},
"fields": {}
},
"relationships": []
}
],
"seedData_testTag_LL": []
}
</syntaxhighlight>

=== Cleaning Seed Data ===
:Delete seed data for set environment of '''test'''.
*cleaningeDynamoOneRecordsTags.json
*cleaningeDynamoManyRecordsTags.json

====cleaningeDynamoOneRecordsTags====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_TestFindData_and_Education_case_invalid01": [
{
"tableName": "MLocationsTestFindDataMain",
"primaryKeys": [
{
"findDataId": "cleaning-1"
},
{
"findDataId": "cleaning-2"
}
]
},
{
"tableName": "MLocationsTestEducation",
"primaryKeys": [
{
"studentId": "cleaning-AA"
},
{
"studentId": "cleaning-BB"
},
{
"studentId": "cleaning-CC"
}
]
}
],
"cleaningSeed_TestMemberPersonnel_case_invalid01": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "namtan",
"passwordId": "qqqww"
},
{
"userId": "jack",
"passwordId": "q1"
},
{
"userId": "Momay",
"passwordId": "ttr"
}
]
}
]
}
</syntaxhighlight>

==== cleaningeDynamoManyRecordsTags ====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_manyData_partitionKey_only_miss_sort": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "many-data"
}
]
}
]
}
</syntaxhighlight>

*logic query table MLocationsTestMemberPersonnel use primary Keys "userId" and then delete all data from primary Keys.

=resources=
syntax is object
<syntaxhighlight lang="JavaScript">
{
"Lambda":{
"{FunctionNameHdrSqs}":{ // FunctionNameHdrSqs is match resourceName in file tests
"localLacation":"/src/FunctionNameHdrSqs.js",
"localHandler":"main",
"functionName":"FunctionNameHdrSqs" // FunctionName is function name match key of function.yml of servcie.
},
"ProcessComplexFilterHdrSqs":{
"localLacation":"/src/ProcessComplexFilterHdrSqs.js",
"localHandler":"main",
"functionName":"ProcessComplexFilterHdrSqs"
},
...
},
"Dynamodb": {
"filterMain":{ // match resourceName in file tests(dynamodbOutputEventIdentifiers)
"tableName":"filterMain"
},
"tableNameBB":{
"tableName":"tableNameBB"
},
...
}
}
</syntaxhighlight>

=events=
Syntax is object
==Syntax Name==
===FileName===
::Event_{inputEventTag}

===eventTag===
#inputEventTag
#outputEventTag
#dynamodbTag

*file events.js is have eventTag (inputEventTag,outputEventTag,dynamodbTag)
**How to create name eventTag
***Example case : "test in service complexFilter functionname ProcessComplexFilter case element type is logical basic".
::*'''inputEventTag'''
::::{serviceName}_{functionName}_{caseTest}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''outputEventTag'''
::::output_{inputEventTag}
''output_Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''dynamodbTag'''
::::{inputEventTag}__Dynamodb__{'''action*'''}_{tableName}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic___Dynamodb__putItem_filterMain''
: '''{action}''' is only ''put'' or ''update'', and in case of ''update'' must only test the last step of update 

=== Syntax event===
====initiate by handlerServcie====
=====Sqs=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Sns
{
"LambdaFunctionHdrSqs_input__pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
},
"propertyB":{
"properties":{
"propertyB1":{
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"value":"msgTag"
},
"propertyD":{
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
<syntaxhighlight lang="JavaScript" linein>
"snsSqsTrigger":true
</syntaxhighlight>

=====Dsq=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Direct Sqs
{
"LambdaFunctionHdrDsq_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"DirectSqs":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrDsq_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
* DirectSqs = true
:: for initialStage of Dsq
* messageAttributes is optional

=====Inv=====
<syntaxhighlight lang="JavaScript">
{
"LambdaFunctionHdrInv_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
}
}
},
{
"output_LambdaFunctionHdrInv_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>

=====Api=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of API
{
"LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"forstageMatvhing": true,
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1",
},
"propertyB": {
"properties": {
"propertyB1": {
"value": "valuePropertyB1",
}
}
},
"propertyC": {
"eventValue": [
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3",
]
},
...
}
}
}
},
"Output_LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1"
},
...
}
}
}
}
}
</syntaxhighlight>

=====S3=====

====dynamodb====
<syntaxhighlight lang="JavaScript">
// An example event of Dynamodb //optional
{
{inputEventTag}__dynamodb_{action}_{tablename}: { // eg. "Complexfilter_ProcessComplexfilter_logical_basic__dynamodb_update_FilterMain"
"forStageMatching": true,
"properties": {
"filterMainUniqueRequestId": {
"testValueMatches": fase,
"value": "bbc4f4a9-2032-4dec-9129-8c7d169fecc5"
},
"filterObject": {
"forStageMatching": true,
"properties": {
"logicalType": {
"value": "partitionKey"
},
"comparison": {
"value": "equals"
},
"type": {
"value": "logical"
},
"partitionKey": {
"forStageMatching": true,
"value": "mockIntegratioTestCPF"
}
}
},
"filterMainExpiryTime": {
"testValueMatches": fase,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": fase,
"value": 1731894402678
},
"objType": {
"forStageMatching": true,
"properties": {
"serviceTag": {
"forStageMatching": true,
"value": "IntTesting"
},
"objectType": {
"forStageMatching": true,
"value": "TestRecord"
}
}
}
},
"keyValues": {
"filterMainId": "4865d2451a621cb7f71225cfabf2df4f98e20801",
"objTypeId": "cdb170690571df7522b3850920fce02507c077ee"
}
}
}
</syntaxhighlight>

* partition key: filterMainId
* sort key: objTypeId

[[2021-01-15 - Integration Testing - Adding DynamoDB result tests]]

===Type paramiter===
use for evnet and dyanmodb event
====Normal====
<syntaxhighlight lang="JavaScript">

object: {
forStageMatching: true,
properties: {
name:{
forStageMatching: true,
value:"Tom"
}
}
},
array: {
forStageMatching: true,
useIsEqual: true,
eventValue: [
{
"relTypeAndDirection": {
"relType": {
"serviceTag": "maxxCart2",
"relationshipTag": "hasCartOrder"
},
"relationshipDirection": "from"
},
"targetObjects": [
{
"objType": {
"serviceTag": "maxxCart2",
"objectType": "cartOrder"
}
}
]
}
]
},
number: {
forStageMatching: true,
value: 1111
},
string: {
forStageMatching: true,
value: "hi"
},
boolean: {
forStageMatching: true,
value: true
}
</syntaxhighlight>

<syntaxhighlight lang="JavaScript">
forStageMatching: true
</syntaxhighlight>
::set true for check match value,It is not necessary to set every value
:::use in test importent paramiter

<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
::setting paramiter require on create but can not test random value eg: identifier or timeStamp or uuid

====Empty====
<syntaxhighlight lang="JavaScript">
EmptyString:{
forStageMatching: true,
value:""
},
EmptyArray:{
forStageMatching: true,
useIsEqual: true,
eventValue: []
},
EmptyObject:{
forStageMatching: true,
value:{}
}
</syntaxhighlight>

====Error====
can test noRetryError
<syntaxhighlight lang="JavaScript">
"errorMessage": {
forStageMatching: true,
"value": "Not found schema of {serviceTag:TestGraphHandler, objectType:notFoundObjType}"
}
</syntaxhighlight>

====Paramiter random====
Can not test case random numbber or uuid.
But requriOnCreate mush be set
<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
or set
<syntaxhighlight lang="JavaScript">
forStageMatching:false
</syntaxhighlight>

=tests=
Syntax is array of object
==Syntax name==
===Testtag name ===
*{integrationTestTag}
#Test Own servcie or not a lot stage
<syntaxhighlight lang="JavaScript">
Test_{inputEventTag}
</syntaxhighlight>
#Mix multiple servcie and multiple stage
<syntaxhighlight lang="JavaScript">
IntegrationTest_{inputEventTag}
</syntaxhighlight>

===File name ===
<syntaxhighlight lang="JavaScript">
{integrationTestTag}.json
</syntaxhighlight>

==Setting of test==
[[Service - Integration Test Config#tests.js Syntax|syntax test]]

<syntaxhighlight lang="JavaScript">
{
integrationTestTag: {integrationTestTag},
productionSafe: true|false, //default false
noInitialStage: true, // default false, if set to true, no error when no foundInitialStages found
errorIfStageUndefined: true|false, //default false
errorIfInvokeUndefined: true|false, //default false,
dynamoDBSeedDataTags:["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
graphSeedDataTags:["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
cleaningeDynamoOneRecordsTags: ["cleaningSeed_partitionKey_sortKey_normol"], //optional
cleaningeDynamoManyRecordsTags: [], // optional
stages:[
...
]
}
</syntaxhighlight>
*[[2025-11-20 IntegrationTest#dynamoDBSeedDataTags|dynamoDBSeedDataTags]]
*[[2025-11-20 IntegrationTest#graphSeedDataTags|graphSeedDataTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoOneRecordsTags|cleaningeDynamoOneRecordsTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoManyRecordsTags|cleaningeDynamoManyRecordsTags]]

==Stages==
====Initiate stage====
:'''"initialStage":true'''
[[Service_-_Integration_Test_Config#tests.js Syntax|detail property of test]]
=====HandlerService=====
======Sqs======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"Locations_ProcessLocationNodeSomting_casenotHaveData",
"serviceName":"Locations",
"resourceType":"Lambda",
"resourceName":"ProcessLocationNodeSomtingHdrDsq",
"outputEventTag":"Output_Locations_ProcessLocationNodeSomting_casenotHaveData"
}
]
</syntaxhighlight>
======Dsq======
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'LambdaFunctionHdrDsq_input_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'LambdaFunctionHdrDsq_output__returnvalue_pass',
// **** not set snsServiceName and snsTopic
// can be test dynamodbOutput
}
]
</syntaxhighlight>

======Api======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrApi_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrApi",
"outputEventTag":"LambdaFunctionHdrApi_output__pass"
}
]
</syntaxhighlight>

======Inv======
*'''single stage'''
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": ["cleaningSeed_partitionKey_sortKey_normol"], //optional
"cleaningeDynamoManyRecordsTags": []
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass"
}
]
}]
</syntaxhighlight>
*'''invoke multiple stage'''
:*Each stage test can invoke multiple lambda by use "eventStage Tag" point to stage for test integration test.
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv_invokes__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": [], //optional
"cleaningeDynamoManyRecordsTags": [], // optional
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass",
"invokes":[
{
"eventStageTag":"service_invokesB__pass"
},
{
"eventStageTag":"service_invokesD__pass"
}
]
},
{
"eventStageTag":"service_invokesB__pass",
"inputEventTag":"input_service_invokes__pass",
"serviceName":"ServiceTemplate_B",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_B_HdrInv",
"outputEventTag":"output_service_invokes__pass"
},
{
"eventStageTag":"service_invokesD__pass",
"inputEventTag":"input_service_invokesD__pass",
"serviceName":"ServiceTemplate_D",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_D_HdrInv",
"outputEventTag":"output_service_invokesD__pass"
}
]
}]
</syntaxhighlight>

======S3======
======Batch======

====GeneratedSeedData====
*Integrationtest must be delete identifier every time before test.
*Set 'generatedSeedData' in file tests.json case by case of stage eg: stages[0] create identifier is randomOnCreate will set 'generatedSeedData' and stages[1] create relationship is randomOnCreate(It is usually random, except in the case of relationship version) set generatedSeedData this stages[1].
*How to delete case identifier rendomOnCreate?: set in stage use setting generateSeedData "randomOnCreateIdentifier"
#randomOnCreateIdentifier
#notRandomOnIdentifier
#relationships
=====randomOnCreateIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"randomOnCreateIdentifier": [
{
"objType": {
"serviceTag": "MLocations",
"objectType": "Member"
},
"identifierValue": "Jaya-member-001"
}
]
}
}
]
</syntaxhighlight>
=====notRandomOnIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"notRandomOnIdentifier": [
{
"objType": {
"serviceTag": "gggg",
"objectType": "ssssss"
},
"identifiers": {
"topId": "123456"
}
}
]
}
}
]
</syntaxhighlight>
=====relationships=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"relationships": [
{
"relType": {
"serviceTag": "PaymentMethodGeneric",
"relationshipTag": "disabledPaymentMethodGenericPropertyValue"
},
"relId": "f4f73de7-647c-4b3b-8043-87cc002f361a"
}
]
}
}
]

</syntaxhighlight>

==Dynamodb==
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'output_Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
dynamodbOutputEventIdentifiers: [
{
serviceName: {tableName}, //service that deployed the DynamoDB table, so can build table's full resource name
resourceName: {resourceName}, //DynamoDB resourceName
eventTag: {eventTagDynamoDB}
}
],
}
]
</syntaxhighlight>

= Result of integrationtest =
Data have 2 table "TestRecord" and "TestUnit".
:- TestRecord is table all unti of stage inside eg input output invokes and dynamodb
:- TestUnit is store status each unit
each unit save in table TestUnit
testRecordId is name of test concat with testTime.
testUnitId is point to position of unti instage.
resultStatus is status of unit.
<syntaxhighlight lang="JavaScript">
eg:
input_0 = stages index 0 result '''input'''
output_1 = stages index 1 result '''output'''
invokeInput_0_1 = stages index 0 result '''invokes''' index 1 position input
invokeOutput_0_1 = stages index 0 result '''invokes''' index 1 position output
dynamodb_0_1 = stages index 0 result '''dynamodb''' index 1.
</syntaxhighlight>

after all TestUnit finish (check by awaitingMultiplestep penditnStep is integrationtestTag awaitingStepId is each TestUnit )
check all awaitingStep finish send message to ultimateIntegrationtest for sumla all test is status

== Summary of test status ==
:1.testStatus is "passed" all unit passed.
:2.testStatus is "failed" have some is failed.
:3.testStatus is "processing" have some is have status processing after check all awaiting step is finish.
:4.testStatus is "failed" have record "errorsTest" in case "not match stage invoke", 'found multiple matchingInvokes

*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

=How to test integrationtest s3=
[[Developer guide for making Integration Tests]]

[[Category:Working documents| 2025-11-20]]
[[Category:Working documents - Integration Testing| 2025-11-20]]

2025-11-20 IntegrationTest

2026-08-17T03:19:40Z

Mint: /* dynamoDBSeedDataTags */

Reference:

*[[2020-10-01 - Integration Test Config - Functions|IntegrationtestConfig]]
*[[2020-10-01 - Integration Testing - Lambda Functions|Integrationtesting]]
*[[2025-02-20 - Integration Test examples|Example]]

= File extension =

uploadS3: ".json"
integrationtestConfig: ".js"

=TestRecord=

<syntaxhighlight lang="JSON">
[
{
integrationTestTag: "Integrationtest_xx",
testStartedTimestamp: 111111111, // start time
bucketName: "integrationtest-config-us-east-2",
lastUpdateUniqueRequestId: "sssss", //_izContext.uniqueRequestId protacts race coditionn dynamodb
testStatus: "passed",//failed,processing,passed
testCompleteTimestamp: 1111113, // all test finish
stages: [
{
stageConfig: {
//straight copy of this stage from integration test config
inputEventTag: "xx",
inputEventConfig: {//event input
},
outputEventTag: "output_xx",
outputEventConfig: {//event out put
},
resourceName: "ComplexfilterTestProcessComplexfilter",// function name
resourceType: "Lambda", // function name
serviceTag: "Complexfilter",// (initeate sqs)
snsServiceName: "Complexfilter",// (initeate sqs)
snsTopic: "PorcessComplexfilter_In"// (initeate sqs)

},
stageStatus: "waiting", //waiting|passed|failed,
stageFinishedTimestamp: 111111111,// time that all tests finished and testRecord.stages.{stageKey}.stageStatus updated
stageResults: {
//results at the point of entering the resource (eg a Lambda function is invoked)
inputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of returning from the resource (eg a Lambda function returns)
outputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of invoking an external resource (eg the tested Lambda function is invoking another Lambda function)
invokes: {
"serviceName_resourceType_resourceName_inputEventTag ": {
invokeTimestamp: 111111111,//{ time result saved },
resultTimestamp: 111111112,//{ time result saved },
resultStatus: "passed",//passed | failed,
invokeParams: {},//{event invoke input config }
requestParams: {}// event invoke input request
},
},
dynamodbResults: [
{
indexOfDynamodbOutput: 0,
requestParams,
resultStatus: "passed",//
resultTimestamp: 22222
}]

},
stageErrors: [
//misc errors encountered
]
}]

}
]
</syntaxhighlight>

=Seed Data=
integrationtest manager seed date 2 process

=== Main Seed Data===
:Save file in s3 (in '''buckname''' :integrationtest-config-us-east-2, '''folder''':seedData_integrationTest).For other dev use service,If a developer wants to add more for other important testing purposes.

'''How to use:'''
#Add it from the s3 bucket at this point
#Run batch refreshSeedData [[Developer guide for making Integration Tests#Bash script|batch RefreshSeedData]]
'''Logic''':Process by storage resouse (graph or dynamodb)
:To clean up the seed data in the table after it creates seed data form service deploy and pulls seed data from s3.

=== Refresh Seed Data ===
:ProcessRefreshSeedData use seedDataTag for create data environment of '''test''' and can be refresh seeddata re-test agian.
:'''canbe share''' seed data for other test by seed data tag.
'''How to use:'''
:Save file in s3 (for other dav keep in floder dev name) or testConfig/seedData_config(for admin)

'''Folder'''
*dynamoDBSeedDataTags.json
*graphSeedDataTags.json

'''Example'''
==== dynamoDBSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource dynammodb.
Example
<syntaxhighlight lang="JavaScript">
{
"seedDynamodb_abc_ver2": [ // seedDataTag
{
"tableName": "DelivMethodSTDTestLogicalResultsData", // servcieTag+stage+tablename
"partitionKey": "logicalResultId",
"sortKey": "identifiersId",
"datas": [
{
logicalResultId: {
value: "eeeeeeeeee4"
},
identifiersId: {
value: "lllll123456"
},
processLogicalResultExpiryTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustmentInSeconds: 300 // Seconds eg 5 minite = 5*60 = 300 Seconds. or 2 day = 2*(24*60*60) = 172800
}
},
{
logicalResultId: {
value: "eeeeeeeeee4"
},
"identifiersId": {
value: "lllll777777"
},
processLogicalResultExpiryTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "add", // add|subtract
adjustmentInSeconds: 172800 // Seconds eg 5 minite = 5*60 = 300 Seconds. or 2 day = 2*(24*60*60) = 172800
}
}
],
},
{
"tableName": "MLocationsTestFloatingRelationships",// servcieTag+stage+tablename
"partitionKey": "importBatchId",
"sortKey": "identifierRelationshipsId",
"datas": [
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll123456"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll777777"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll99999999"
}
]
},
{
"tableName": "MLocationsTestFindDataMain",
"partitionKey": "findDataId",
"datas": [
{
"findDataId": "111111"
},
{
"findDataId": "22222"
},
{
"findDataId": "333333"
}
]
}
]
}
</syntaxhighlight>

==== graphSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource graphHanler.
Example
<syntaxhighlight lang="JavaScript">
{
"seedData_testTag_GG": [ // seedDataTag
{
"nodes": [
{
"nodeLabels": [
"SellOfferPlan_sellOfferPlanDeliveryMethodLink"
],
"objectDetail": {
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": {
"value": "minttestrefreshSeedData_01",
},
},
"fields": {
"productId": {
"value": "ddddd",
},
"price": {
"value": 9999
},
exampleTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format //Month,Months|Week,Weeks|day,days|Hour,Hours|Minute,Minutes|Second,Seconds|
}
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMall"
],
"objectDetail": {
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
},
"fields": {
"name": "hotpot-man",
"totalPrice": 500
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMallCalculateSetting"
],
"objectDetail": {
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
},
"fields": {
"addToCalculatedValuePerOrder": 10,
"addToRateTableValuePerOrder": 77
}
}
}
],
"relationships": [
{
"fromObject": {
"nodeLabel": "SellOfferPlan_sellOfferPlanDeliveryMethodLink",
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": "minttestrefreshSeedData_01"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"relationships": [
{
"relTypeConcat": "SellOfferPlan_hasCCCCCCC",
"relId": "uuid-4s56df74s9df79w-w6de4f5w689ef"
}
]
},
{
"fromObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMallCalculateSetting",
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
}
},
"relationships": [
{
"relTypeConcat": "servcieMintTest_shoppingMall_currentShoppingMallCalculateSetting",
"relId": "uuid-s122df5-s21df",
"relationshipProperty": {
"timeStamp": 1234567879,
"statusName": true
}
},
{
"relTypeConcat": "servcieMintTest_shoppingMall_hasShoppingMallCalculateSetting",
"relId": "uuid-77777-99999",
"relationshipProperties": {
"statusName": {
"value": true
},
exampleTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format //Month,Months|Week,Weeks|day,days|Hour,Hours|Minute,Minutes|Second,Seconds|
}
}
}
]
}
]
}
],
"seedData_testTag_ABC": [
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": [
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "hasProductAttributeLink"
},
"relationshipDirection": "to",
"targetObjType": {
"serviceTag": "ProductStandard",
"objectType": "productStandard"
},
"targetIdentifiers": {
"productId": "f526a367a2b66cb0f37ca61b6c43f419929f521d"
},
"relationshipProperties": {}
},
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "isProductAttribute"
},
"relationshipDirection": "from",
"targetObjType": {
"serviceTag": "ProductAttribute",
"objectType": "productAttribute"
},
"targetIdentifiers": {
"productAttributeId": "f4bf7a078071d54036656df544197ba638bc3a68"
},
"relationshipProperties": {}
}
]
},
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": []
}
],
"seedData_testTag_LL": []
}
</syntaxhighlight>

=== Cleaning Seed Data ===
:Delete seed data for set environment of '''test'''.
*cleaningeDynamoOneRecordsTags.json
*cleaningeDynamoManyRecordsTags.json

====cleaningeDynamoOneRecordsTags====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_TestFindData_and_Education_case_invalid01": [
{
"tableName": "MLocationsTestFindDataMain",
"primaryKeys": [
{
"findDataId": "cleaning-1"
},
{
"findDataId": "cleaning-2"
}
]
},
{
"tableName": "MLocationsTestEducation",
"primaryKeys": [
{
"studentId": "cleaning-AA"
},
{
"studentId": "cleaning-BB"
},
{
"studentId": "cleaning-CC"
}
]
}
],
"cleaningSeed_TestMemberPersonnel_case_invalid01": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "namtan",
"passwordId": "qqqww"
},
{
"userId": "jack",
"passwordId": "q1"
},
{
"userId": "Momay",
"passwordId": "ttr"
}
]
}
]
}
</syntaxhighlight>

==== cleaningeDynamoManyRecordsTags ====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_manyData_partitionKey_only_miss_sort": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "many-data"
}
]
}
]
}
</syntaxhighlight>

*logic query table MLocationsTestMemberPersonnel use primary Keys "userId" and then delete all data from primary Keys.

=resources=
syntax is object
<syntaxhighlight lang="JavaScript">
{
"Lambda":{
"{FunctionNameHdrSqs}":{ // FunctionNameHdrSqs is match resourceName in file tests
"localLacation":"/src/FunctionNameHdrSqs.js",
"localHandler":"main",
"functionName":"FunctionNameHdrSqs" // FunctionName is function name match key of function.yml of servcie.
},
"ProcessComplexFilterHdrSqs":{
"localLacation":"/src/ProcessComplexFilterHdrSqs.js",
"localHandler":"main",
"functionName":"ProcessComplexFilterHdrSqs"
},
...
},
"Dynamodb": {
"filterMain":{ // match resourceName in file tests(dynamodbOutputEventIdentifiers)
"tableName":"filterMain"
},
"tableNameBB":{
"tableName":"tableNameBB"
},
...
}
}
</syntaxhighlight>

=events=
Syntax is object
==Syntax Name==
===FileName===
::Event_{inputEventTag}

===eventTag===
#inputEventTag
#outputEventTag
#dynamodbTag

*file events.js is have eventTag (inputEventTag,outputEventTag,dynamodbTag)
**How to create name eventTag
***Example case : "test in service complexFilter functionname ProcessComplexFilter case element type is logical basic".
::*'''inputEventTag'''
::::{serviceName}_{functionName}_{caseTest}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''outputEventTag'''
::::output_{inputEventTag}
''output_Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''dynamodbTag'''
::::{inputEventTag}__Dynamodb__{'''action*'''}_{tableName}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic___Dynamodb__putItem_filterMain''
: '''{action}''' is only ''put'' or ''update'', and in case of ''update'' must only test the last step of update 

=== Syntax event===
====initiate by handlerServcie====
=====Sqs=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Sns
{
"LambdaFunctionHdrSqs_input__pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
},
"propertyB":{
"properties":{
"propertyB1":{
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"value":"msgTag"
},
"propertyD":{
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
<syntaxhighlight lang="JavaScript" linein>
"snsSqsTrigger":true
</syntaxhighlight>

=====Dsq=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Direct Sqs
{
"LambdaFunctionHdrDsq_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"DirectSqs":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrDsq_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
* DirectSqs = true
:: for initialStage of Dsq
* messageAttributes is optional

=====Inv=====
<syntaxhighlight lang="JavaScript">
{
"LambdaFunctionHdrInv_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
}
}
},
{
"output_LambdaFunctionHdrInv_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>

=====Api=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of API
{
"LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"forstageMatvhing": true,
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1",
},
"propertyB": {
"properties": {
"propertyB1": {
"value": "valuePropertyB1",
}
}
},
"propertyC": {
"eventValue": [
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3",
]
},
...
}
}
}
},
"Output_LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1"
},
...
}
}
}
}
}
</syntaxhighlight>

=====S3=====

====dynamodb====
<syntaxhighlight lang="JavaScript">
// An example event of Dynamodb //optional
{
{inputEventTag}__dynamodb_{action}_{tablename}: { // eg. "Complexfilter_ProcessComplexfilter_logical_basic__dynamodb_update_FilterMain"
"forStageMatching": true,
"properties": {
"filterMainUniqueRequestId": {
"testValueMatches": fase,
"value": "bbc4f4a9-2032-4dec-9129-8c7d169fecc5"
},
"filterObject": {
"forStageMatching": true,
"properties": {
"logicalType": {
"value": "partitionKey"
},
"comparison": {
"value": "equals"
},
"type": {
"value": "logical"
},
"partitionKey": {
"forStageMatching": true,
"value": "mockIntegratioTestCPF"
}
}
},
"filterMainExpiryTime": {
"testValueMatches": fase,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": fase,
"value": 1731894402678
},
"objType": {
"forStageMatching": true,
"properties": {
"serviceTag": {
"forStageMatching": true,
"value": "IntTesting"
},
"objectType": {
"forStageMatching": true,
"value": "TestRecord"
}
}
}
},
"keyValues": {
"filterMainId": "4865d2451a621cb7f71225cfabf2df4f98e20801",
"objTypeId": "cdb170690571df7522b3850920fce02507c077ee"
}
}
}
</syntaxhighlight>

* partition key: filterMainId
* sort key: objTypeId

[[2021-01-15 - Integration Testing - Adding DynamoDB result tests]]

===Type paramiter===
use for evnet and dyanmodb event
====Normal====
<syntaxhighlight lang="JavaScript">

object: {
forStageMatching: true,
properties: {
name:{
forStageMatching: true,
value:"Tom"
}
}
},
array: {
forStageMatching: true,
useIsEqual: true,
eventValue: [
{
"relTypeAndDirection": {
"relType": {
"serviceTag": "maxxCart2",
"relationshipTag": "hasCartOrder"
},
"relationshipDirection": "from"
},
"targetObjects": [
{
"objType": {
"serviceTag": "maxxCart2",
"objectType": "cartOrder"
}
}
]
}
]
},
number: {
forStageMatching: true,
value: 1111
},
string: {
forStageMatching: true,
value: "hi"
},
boolean: {
forStageMatching: true,
value: true
}
</syntaxhighlight>

<syntaxhighlight lang="JavaScript">
forStageMatching: true
</syntaxhighlight>
::set true for check match value,It is not necessary to set every value
:::use in test importent paramiter

<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
::setting paramiter require on create but can not test random value eg: identifier or timeStamp or uuid

====Empty====
<syntaxhighlight lang="JavaScript">
EmptyString:{
forStageMatching: true,
value:""
},
EmptyArray:{
forStageMatching: true,
useIsEqual: true,
eventValue: []
},
EmptyObject:{
forStageMatching: true,
value:{}
}
</syntaxhighlight>

====Error====
can test noRetryError
<syntaxhighlight lang="JavaScript">
"errorMessage": {
forStageMatching: true,
"value": "Not found schema of {serviceTag:TestGraphHandler, objectType:notFoundObjType}"
}
</syntaxhighlight>

====Paramiter random====
Can not test case random numbber or uuid.
But requriOnCreate mush be set
<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
or set
<syntaxhighlight lang="JavaScript">
forStageMatching:false
</syntaxhighlight>

=tests=
Syntax is array of object
==Syntax name==
===Testtag name ===
*{integrationTestTag}
#Test Own servcie or not a lot stage
<syntaxhighlight lang="JavaScript">
Test_{inputEventTag}
</syntaxhighlight>
#Mix multiple servcie and multiple stage
<syntaxhighlight lang="JavaScript">
IntegrationTest_{inputEventTag}
</syntaxhighlight>

===File name ===
<syntaxhighlight lang="JavaScript">
{integrationTestTag}.json
</syntaxhighlight>

==Setting of test==
[[Service - Integration Test Config#tests.js Syntax|syntax test]]

<syntaxhighlight lang="JavaScript">
{
integrationTestTag: {integrationTestTag},
productionSafe: true|false, //default false
noInitialStage: true, // default false, if set to true, no error when no foundInitialStages found
errorIfStageUndefined: true|false, //default false
errorIfInvokeUndefined: true|false, //default false,
dynamoDBSeedDataTags:["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
graphSeedDataTags:["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
cleaningeDynamoOneRecordsTags: ["cleaningSeed_partitionKey_sortKey_normol"], //optional
cleaningeDynamoManyRecordsTags: [], // optional
stages:[
...
]
}
</syntaxhighlight>
*[[2025-11-20 IntegrationTest#dynamoDBSeedDataTags|dynamoDBSeedDataTags]]
*[[2025-11-20 IntegrationTest#graphSeedDataTags|graphSeedDataTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoOneRecordsTags|cleaningeDynamoOneRecordsTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoManyRecordsTags|cleaningeDynamoManyRecordsTags]]

==Stages==
====Initiate stage====
:'''"initialStage":true'''
[[Service_-_Integration_Test_Config#tests.js Syntax|detail property of test]]
=====HandlerService=====
======Sqs======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"Locations_ProcessLocationNodeSomting_casenotHaveData",
"serviceName":"Locations",
"resourceType":"Lambda",
"resourceName":"ProcessLocationNodeSomtingHdrDsq",
"outputEventTag":"Output_Locations_ProcessLocationNodeSomting_casenotHaveData"
}
]
</syntaxhighlight>
======Dsq======
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'LambdaFunctionHdrDsq_input_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'LambdaFunctionHdrDsq_output__returnvalue_pass',
// **** not set snsServiceName and snsTopic
// can be test dynamodbOutput
}
]
</syntaxhighlight>

======Api======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrApi_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrApi",
"outputEventTag":"LambdaFunctionHdrApi_output__pass"
}
]
</syntaxhighlight>

======Inv======
*'''single stage'''
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": ["cleaningSeed_partitionKey_sortKey_normol"], //optional
"cleaningeDynamoManyRecordsTags": []
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass"
}
]
}]
</syntaxhighlight>
*'''invoke multiple stage'''
:*Each stage test can invoke multiple lambda by use "eventStage Tag" point to stage for test integration test.
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv_invokes__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": [], //optional
"cleaningeDynamoManyRecordsTags": [], // optional
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass",
"invokes":[
{
"eventStageTag":"service_invokesB__pass"
},
{
"eventStageTag":"service_invokesD__pass"
}
]
},
{
"eventStageTag":"service_invokesB__pass",
"inputEventTag":"input_service_invokes__pass",
"serviceName":"ServiceTemplate_B",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_B_HdrInv",
"outputEventTag":"output_service_invokes__pass"
},
{
"eventStageTag":"service_invokesD__pass",
"inputEventTag":"input_service_invokesD__pass",
"serviceName":"ServiceTemplate_D",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_D_HdrInv",
"outputEventTag":"output_service_invokesD__pass"
}
]
}]
</syntaxhighlight>

======S3======
======Batch======

====GeneratedSeedData====
*Integrationtest must be delete identifier every time before test.
*Set 'generatedSeedData' in file tests.json case by case of stage eg: stages[0] create identifier is randomOnCreate will set 'generatedSeedData' and stages[1] create relationship is randomOnCreate(It is usually random, except in the case of relationship version) set generatedSeedData this stages[1].
*How to delete case identifier rendomOnCreate?: set in stage use setting generateSeedData "randomOnCreateIdentifier"
#randomOnCreateIdentifier
#notRandomOnIdentifier
#relationships
=====randomOnCreateIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"randomOnCreateIdentifier": [
{
"objType": {
"serviceTag": "MLocations",
"objectType": "Member"
},
"identifierValue": "Jaya-member-001"
}
]
}
}
]
</syntaxhighlight>
=====notRandomOnIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"notRandomOnIdentifier": [
{
"objType": {
"serviceTag": "gggg",
"objectType": "ssssss"
},
"identifiers": {
"topId": "123456"
}
}
]
}
}
]
</syntaxhighlight>
=====relationships=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"relationships": [
{
"relType": {
"serviceTag": "PaymentMethodGeneric",
"relationshipTag": "disabledPaymentMethodGenericPropertyValue"
},
"relId": "f4f73de7-647c-4b3b-8043-87cc002f361a"
}
]
}
}
]

</syntaxhighlight>

==Dynamodb==
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'output_Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
dynamodbOutputEventIdentifiers: [
{
serviceName: {tableName}, //service that deployed the DynamoDB table, so can build table's full resource name
resourceName: {resourceName}, //DynamoDB resourceName
eventTag: {eventTagDynamoDB}
}
],
}
]
</syntaxhighlight>

= Result of integrationtest =
Data have 2 table "TestRecord" and "TestUnit".
:- TestRecord is table all unti of stage inside eg input output invokes and dynamodb
:- TestUnit is store status each unit
each unit save in table TestUnit
testRecordId is name of test concat with testTime.
testUnitId is point to position of unti instage.
resultStatus is status of unit.
<syntaxhighlight lang="JavaScript">
eg:
input_0 = stages index 0 result '''input'''
output_1 = stages index 1 result '''output'''
invokeInput_0_1 = stages index 0 result '''invokes''' index 1 position input
invokeOutput_0_1 = stages index 0 result '''invokes''' index 1 position output
dynamodb_0_1 = stages index 0 result '''dynamodb''' index 1.
</syntaxhighlight>

after all TestUnit finish (check by awaitingMultiplestep penditnStep is integrationtestTag awaitingStepId is each TestUnit )
check all awaitingStep finish send message to ultimateIntegrationtest for sumla all test is status

== Summary of test status ==
:1.testStatus is "passed" all unit passed.
:2.testStatus is "failed" have some is failed.
:3.testStatus is "processing" have some is have status processing after check all awaiting step is finish.
:4.testStatus is "failed" have record "errorsTest" in case "not match stage invoke", 'found multiple matchingInvokes

*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

=How to test integrationtest s3=
[[Developer guide for making Integration Tests]]

[[Category:Working documents| 2025-11-20]]
[[Category:Working documents - Integration Testing| 2025-11-20]]

2025-11-20 IntegrationTest

2026-08-17T03:19:10Z

Mint: /* dynamoDBSeedDataTags */

Reference:

*[[2020-10-01 - Integration Test Config - Functions|IntegrationtestConfig]]
*[[2020-10-01 - Integration Testing - Lambda Functions|Integrationtesting]]
*[[2025-02-20 - Integration Test examples|Example]]

= File extension =

uploadS3: ".json"
integrationtestConfig: ".js"

=TestRecord=

<syntaxhighlight lang="JSON">
[
{
integrationTestTag: "Integrationtest_xx",
testStartedTimestamp: 111111111, // start time
bucketName: "integrationtest-config-us-east-2",
lastUpdateUniqueRequestId: "sssss", //_izContext.uniqueRequestId protacts race coditionn dynamodb
testStatus: "passed",//failed,processing,passed
testCompleteTimestamp: 1111113, // all test finish
stages: [
{
stageConfig: {
//straight copy of this stage from integration test config
inputEventTag: "xx",
inputEventConfig: {//event input
},
outputEventTag: "output_xx",
outputEventConfig: {//event out put
},
resourceName: "ComplexfilterTestProcessComplexfilter",// function name
resourceType: "Lambda", // function name
serviceTag: "Complexfilter",// (initeate sqs)
snsServiceName: "Complexfilter",// (initeate sqs)
snsTopic: "PorcessComplexfilter_In"// (initeate sqs)

},
stageStatus: "waiting", //waiting|passed|failed,
stageFinishedTimestamp: 111111111,// time that all tests finished and testRecord.stages.{stageKey}.stageStatus updated
stageResults: {
//results at the point of entering the resource (eg a Lambda function is invoked)
inputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of returning from the resource (eg a Lambda function returns)
outputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of invoking an external resource (eg the tested Lambda function is invoking another Lambda function)
invokes: {
"serviceName_resourceType_resourceName_inputEventTag ": {
invokeTimestamp: 111111111,//{ time result saved },
resultTimestamp: 111111112,//{ time result saved },
resultStatus: "passed",//passed | failed,
invokeParams: {},//{event invoke input config }
requestParams: {}// event invoke input request
},
},
dynamodbResults: [
{
indexOfDynamodbOutput: 0,
requestParams,
resultStatus: "passed",//
resultTimestamp: 22222
}]

},
stageErrors: [
//misc errors encountered
]
}]

}
]
</syntaxhighlight>

=Seed Data=
integrationtest manager seed date 2 process

=== Main Seed Data===
:Save file in s3 (in '''buckname''' :integrationtest-config-us-east-2, '''folder''':seedData_integrationTest).For other dev use service,If a developer wants to add more for other important testing purposes.

'''How to use:'''
#Add it from the s3 bucket at this point
#Run batch refreshSeedData [[Developer guide for making Integration Tests#Bash script|batch RefreshSeedData]]
'''Logic''':Process by storage resouse (graph or dynamodb)
:To clean up the seed data in the table after it creates seed data form service deploy and pulls seed data from s3.

=== Refresh Seed Data ===
:ProcessRefreshSeedData use seedDataTag for create data environment of '''test''' and can be refresh seeddata re-test agian.
:'''canbe share''' seed data for other test by seed data tag.
'''How to use:'''
:Save file in s3 (for other dav keep in floder dev name) or testConfig/seedData_config(for admin)

'''Folder'''
*dynamoDBSeedDataTags.json
*graphSeedDataTags.json

'''Example'''
==== dynamoDBSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource dynammodb.
Example
<syntaxhighlight lang="JavaScript">
{
"seedDynamodb_abc_ver2": [ // seedDataTag
{
"tableName": "DelivMethodSTDTestLogicalResultsData", // servcieTag+stage+tablename
"partitionKey": "logicalResultId",
"sortKey": "identifiersId",
"datas": [
{
logicalResultId: {
value: "eeeeeeeeee4"
},
identifiersId: {
value: "lllll123456"
},
processLogicalResultExpiryTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustmentInSeconds: 300 // Seconds eg 5 minite = 5*60 = 300 Seconds. or 2 day = 2*(24*60*60) = 172800
}
},
{
logicalResultId: {
value: "eeeeeeeeee4"
},
"identifiersId": {
value: "lllll777777"
},
processLogicalResultExpiryTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "add", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format , //Month,Months|Week,Weeks|day,days|Hour,Hours|Minute,Minutes|Second,Seconds|
}
}
],
},
{
"tableName": "MLocationsTestFloatingRelationships",// servcieTag+stage+tablename
"partitionKey": "importBatchId",
"sortKey": "identifierRelationshipsId",
"datas": [
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll123456"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll777777"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll99999999"
}
]
},
{
"tableName": "MLocationsTestFindDataMain",
"partitionKey": "findDataId",
"datas": [
{
"findDataId": "111111"
},
{
"findDataId": "22222"
},
{
"findDataId": "333333"
}
]
}
]
}
</syntaxhighlight>

==== graphSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource graphHanler.
Example
<syntaxhighlight lang="JavaScript">
{
"seedData_testTag_GG": [ // seedDataTag
{
"nodes": [
{
"nodeLabels": [
"SellOfferPlan_sellOfferPlanDeliveryMethodLink"
],
"objectDetail": {
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": {
"value": "minttestrefreshSeedData_01",
},
},
"fields": {
"productId": {
"value": "ddddd",
},
"price": {
"value": 9999
},
exampleTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format //Month,Months|Week,Weeks|day,days|Hour,Hours|Minute,Minutes|Second,Seconds|
}
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMall"
],
"objectDetail": {
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
},
"fields": {
"name": "hotpot-man",
"totalPrice": 500
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMallCalculateSetting"
],
"objectDetail": {
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
},
"fields": {
"addToCalculatedValuePerOrder": 10,
"addToRateTableValuePerOrder": 77
}
}
}
],
"relationships": [
{
"fromObject": {
"nodeLabel": "SellOfferPlan_sellOfferPlanDeliveryMethodLink",
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": "minttestrefreshSeedData_01"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"relationships": [
{
"relTypeConcat": "SellOfferPlan_hasCCCCCCC",
"relId": "uuid-4s56df74s9df79w-w6de4f5w689ef"
}
]
},
{
"fromObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMallCalculateSetting",
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
}
},
"relationships": [
{
"relTypeConcat": "servcieMintTest_shoppingMall_currentShoppingMallCalculateSetting",
"relId": "uuid-s122df5-s21df",
"relationshipProperty": {
"timeStamp": 1234567879,
"statusName": true
}
},
{
"relTypeConcat": "servcieMintTest_shoppingMall_hasShoppingMallCalculateSetting",
"relId": "uuid-77777-99999",
"relationshipProperties": {
"statusName": {
"value": true
},
exampleTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format //Month,Months|Week,Weeks|day,days|Hour,Hours|Minute,Minutes|Second,Seconds|
}
}
}
]
}
]
}
],
"seedData_testTag_ABC": [
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": [
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "hasProductAttributeLink"
},
"relationshipDirection": "to",
"targetObjType": {
"serviceTag": "ProductStandard",
"objectType": "productStandard"
},
"targetIdentifiers": {
"productId": "f526a367a2b66cb0f37ca61b6c43f419929f521d"
},
"relationshipProperties": {}
},
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "isProductAttribute"
},
"relationshipDirection": "from",
"targetObjType": {
"serviceTag": "ProductAttribute",
"objectType": "productAttribute"
},
"targetIdentifiers": {
"productAttributeId": "f4bf7a078071d54036656df544197ba638bc3a68"
},
"relationshipProperties": {}
}
]
},
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": []
}
],
"seedData_testTag_LL": []
}
</syntaxhighlight>

=== Cleaning Seed Data ===
:Delete seed data for set environment of '''test'''.
*cleaningeDynamoOneRecordsTags.json
*cleaningeDynamoManyRecordsTags.json

====cleaningeDynamoOneRecordsTags====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_TestFindData_and_Education_case_invalid01": [
{
"tableName": "MLocationsTestFindDataMain",
"primaryKeys": [
{
"findDataId": "cleaning-1"
},
{
"findDataId": "cleaning-2"
}
]
},
{
"tableName": "MLocationsTestEducation",
"primaryKeys": [
{
"studentId": "cleaning-AA"
},
{
"studentId": "cleaning-BB"
},
{
"studentId": "cleaning-CC"
}
]
}
],
"cleaningSeed_TestMemberPersonnel_case_invalid01": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "namtan",
"passwordId": "qqqww"
},
{
"userId": "jack",
"passwordId": "q1"
},
{
"userId": "Momay",
"passwordId": "ttr"
}
]
}
]
}
</syntaxhighlight>

==== cleaningeDynamoManyRecordsTags ====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_manyData_partitionKey_only_miss_sort": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "many-data"
}
]
}
]
}
</syntaxhighlight>

*logic query table MLocationsTestMemberPersonnel use primary Keys "userId" and then delete all data from primary Keys.

=resources=
syntax is object
<syntaxhighlight lang="JavaScript">
{
"Lambda":{
"{FunctionNameHdrSqs}":{ // FunctionNameHdrSqs is match resourceName in file tests
"localLacation":"/src/FunctionNameHdrSqs.js",
"localHandler":"main",
"functionName":"FunctionNameHdrSqs" // FunctionName is function name match key of function.yml of servcie.
},
"ProcessComplexFilterHdrSqs":{
"localLacation":"/src/ProcessComplexFilterHdrSqs.js",
"localHandler":"main",
"functionName":"ProcessComplexFilterHdrSqs"
},
...
},
"Dynamodb": {
"filterMain":{ // match resourceName in file tests(dynamodbOutputEventIdentifiers)
"tableName":"filterMain"
},
"tableNameBB":{
"tableName":"tableNameBB"
},
...
}
}
</syntaxhighlight>

=events=
Syntax is object
==Syntax Name==
===FileName===
::Event_{inputEventTag}

===eventTag===
#inputEventTag
#outputEventTag
#dynamodbTag

*file events.js is have eventTag (inputEventTag,outputEventTag,dynamodbTag)
**How to create name eventTag
***Example case : "test in service complexFilter functionname ProcessComplexFilter case element type is logical basic".
::*'''inputEventTag'''
::::{serviceName}_{functionName}_{caseTest}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''outputEventTag'''
::::output_{inputEventTag}
''output_Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''dynamodbTag'''
::::{inputEventTag}__Dynamodb__{'''action*'''}_{tableName}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic___Dynamodb__putItem_filterMain''
: '''{action}''' is only ''put'' or ''update'', and in case of ''update'' must only test the last step of update 

=== Syntax event===
====initiate by handlerServcie====
=====Sqs=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Sns
{
"LambdaFunctionHdrSqs_input__pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
},
"propertyB":{
"properties":{
"propertyB1":{
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"value":"msgTag"
},
"propertyD":{
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
<syntaxhighlight lang="JavaScript" linein>
"snsSqsTrigger":true
</syntaxhighlight>

=====Dsq=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Direct Sqs
{
"LambdaFunctionHdrDsq_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"DirectSqs":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrDsq_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
* DirectSqs = true
:: for initialStage of Dsq
* messageAttributes is optional

=====Inv=====
<syntaxhighlight lang="JavaScript">
{
"LambdaFunctionHdrInv_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
}
}
},
{
"output_LambdaFunctionHdrInv_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>

=====Api=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of API
{
"LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"forstageMatvhing": true,
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1",
},
"propertyB": {
"properties": {
"propertyB1": {
"value": "valuePropertyB1",
}
}
},
"propertyC": {
"eventValue": [
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3",
]
},
...
}
}
}
},
"Output_LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1"
},
...
}
}
}
}
}
</syntaxhighlight>

=====S3=====

====dynamodb====
<syntaxhighlight lang="JavaScript">
// An example event of Dynamodb //optional
{
{inputEventTag}__dynamodb_{action}_{tablename}: { // eg. "Complexfilter_ProcessComplexfilter_logical_basic__dynamodb_update_FilterMain"
"forStageMatching": true,
"properties": {
"filterMainUniqueRequestId": {
"testValueMatches": fase,
"value": "bbc4f4a9-2032-4dec-9129-8c7d169fecc5"
},
"filterObject": {
"forStageMatching": true,
"properties": {
"logicalType": {
"value": "partitionKey"
},
"comparison": {
"value": "equals"
},
"type": {
"value": "logical"
},
"partitionKey": {
"forStageMatching": true,
"value": "mockIntegratioTestCPF"
}
}
},
"filterMainExpiryTime": {
"testValueMatches": fase,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": fase,
"value": 1731894402678
},
"objType": {
"forStageMatching": true,
"properties": {
"serviceTag": {
"forStageMatching": true,
"value": "IntTesting"
},
"objectType": {
"forStageMatching": true,
"value": "TestRecord"
}
}
}
},
"keyValues": {
"filterMainId": "4865d2451a621cb7f71225cfabf2df4f98e20801",
"objTypeId": "cdb170690571df7522b3850920fce02507c077ee"
}
}
}
</syntaxhighlight>

* partition key: filterMainId
* sort key: objTypeId

[[2021-01-15 - Integration Testing - Adding DynamoDB result tests]]

===Type paramiter===
use for evnet and dyanmodb event
====Normal====
<syntaxhighlight lang="JavaScript">

object: {
forStageMatching: true,
properties: {
name:{
forStageMatching: true,
value:"Tom"
}
}
},
array: {
forStageMatching: true,
useIsEqual: true,
eventValue: [
{
"relTypeAndDirection": {
"relType": {
"serviceTag": "maxxCart2",
"relationshipTag": "hasCartOrder"
},
"relationshipDirection": "from"
},
"targetObjects": [
{
"objType": {
"serviceTag": "maxxCart2",
"objectType": "cartOrder"
}
}
]
}
]
},
number: {
forStageMatching: true,
value: 1111
},
string: {
forStageMatching: true,
value: "hi"
},
boolean: {
forStageMatching: true,
value: true
}
</syntaxhighlight>

<syntaxhighlight lang="JavaScript">
forStageMatching: true
</syntaxhighlight>
::set true for check match value,It is not necessary to set every value
:::use in test importent paramiter

<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
::setting paramiter require on create but can not test random value eg: identifier or timeStamp or uuid

====Empty====
<syntaxhighlight lang="JavaScript">
EmptyString:{
forStageMatching: true,
value:""
},
EmptyArray:{
forStageMatching: true,
useIsEqual: true,
eventValue: []
},
EmptyObject:{
forStageMatching: true,
value:{}
}
</syntaxhighlight>

====Error====
can test noRetryError
<syntaxhighlight lang="JavaScript">
"errorMessage": {
forStageMatching: true,
"value": "Not found schema of {serviceTag:TestGraphHandler, objectType:notFoundObjType}"
}
</syntaxhighlight>

====Paramiter random====
Can not test case random numbber or uuid.
But requriOnCreate mush be set
<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
or set
<syntaxhighlight lang="JavaScript">
forStageMatching:false
</syntaxhighlight>

=tests=
Syntax is array of object
==Syntax name==
===Testtag name ===
*{integrationTestTag}
#Test Own servcie or not a lot stage
<syntaxhighlight lang="JavaScript">
Test_{inputEventTag}
</syntaxhighlight>
#Mix multiple servcie and multiple stage
<syntaxhighlight lang="JavaScript">
IntegrationTest_{inputEventTag}
</syntaxhighlight>

===File name ===
<syntaxhighlight lang="JavaScript">
{integrationTestTag}.json
</syntaxhighlight>

==Setting of test==
[[Service - Integration Test Config#tests.js Syntax|syntax test]]

<syntaxhighlight lang="JavaScript">
{
integrationTestTag: {integrationTestTag},
productionSafe: true|false, //default false
noInitialStage: true, // default false, if set to true, no error when no foundInitialStages found
errorIfStageUndefined: true|false, //default false
errorIfInvokeUndefined: true|false, //default false,
dynamoDBSeedDataTags:["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
graphSeedDataTags:["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
cleaningeDynamoOneRecordsTags: ["cleaningSeed_partitionKey_sortKey_normol"], //optional
cleaningeDynamoManyRecordsTags: [], // optional
stages:[
...
]
}
</syntaxhighlight>
*[[2025-11-20 IntegrationTest#dynamoDBSeedDataTags|dynamoDBSeedDataTags]]
*[[2025-11-20 IntegrationTest#graphSeedDataTags|graphSeedDataTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoOneRecordsTags|cleaningeDynamoOneRecordsTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoManyRecordsTags|cleaningeDynamoManyRecordsTags]]

==Stages==
====Initiate stage====
:'''"initialStage":true'''
[[Service_-_Integration_Test_Config#tests.js Syntax|detail property of test]]
=====HandlerService=====
======Sqs======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"Locations_ProcessLocationNodeSomting_casenotHaveData",
"serviceName":"Locations",
"resourceType":"Lambda",
"resourceName":"ProcessLocationNodeSomtingHdrDsq",
"outputEventTag":"Output_Locations_ProcessLocationNodeSomting_casenotHaveData"
}
]
</syntaxhighlight>
======Dsq======
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'LambdaFunctionHdrDsq_input_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'LambdaFunctionHdrDsq_output__returnvalue_pass',
// **** not set snsServiceName and snsTopic
// can be test dynamodbOutput
}
]
</syntaxhighlight>

======Api======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrApi_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrApi",
"outputEventTag":"LambdaFunctionHdrApi_output__pass"
}
]
</syntaxhighlight>

======Inv======
*'''single stage'''
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": ["cleaningSeed_partitionKey_sortKey_normol"], //optional
"cleaningeDynamoManyRecordsTags": []
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass"
}
]
}]
</syntaxhighlight>
*'''invoke multiple stage'''
:*Each stage test can invoke multiple lambda by use "eventStage Tag" point to stage for test integration test.
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv_invokes__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": [], //optional
"cleaningeDynamoManyRecordsTags": [], // optional
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass",
"invokes":[
{
"eventStageTag":"service_invokesB__pass"
},
{
"eventStageTag":"service_invokesD__pass"
}
]
},
{
"eventStageTag":"service_invokesB__pass",
"inputEventTag":"input_service_invokes__pass",
"serviceName":"ServiceTemplate_B",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_B_HdrInv",
"outputEventTag":"output_service_invokes__pass"
},
{
"eventStageTag":"service_invokesD__pass",
"inputEventTag":"input_service_invokesD__pass",
"serviceName":"ServiceTemplate_D",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_D_HdrInv",
"outputEventTag":"output_service_invokesD__pass"
}
]
}]
</syntaxhighlight>

======S3======
======Batch======

====GeneratedSeedData====
*Integrationtest must be delete identifier every time before test.
*Set 'generatedSeedData' in file tests.json case by case of stage eg: stages[0] create identifier is randomOnCreate will set 'generatedSeedData' and stages[1] create relationship is randomOnCreate(It is usually random, except in the case of relationship version) set generatedSeedData this stages[1].
*How to delete case identifier rendomOnCreate?: set in stage use setting generateSeedData "randomOnCreateIdentifier"
#randomOnCreateIdentifier
#notRandomOnIdentifier
#relationships
=====randomOnCreateIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"randomOnCreateIdentifier": [
{
"objType": {
"serviceTag": "MLocations",
"objectType": "Member"
},
"identifierValue": "Jaya-member-001"
}
]
}
}
]
</syntaxhighlight>
=====notRandomOnIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"notRandomOnIdentifier": [
{
"objType": {
"serviceTag": "gggg",
"objectType": "ssssss"
},
"identifiers": {
"topId": "123456"
}
}
]
}
}
]
</syntaxhighlight>
=====relationships=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"relationships": [
{
"relType": {
"serviceTag": "PaymentMethodGeneric",
"relationshipTag": "disabledPaymentMethodGenericPropertyValue"
},
"relId": "f4f73de7-647c-4b3b-8043-87cc002f361a"
}
]
}
}
]

</syntaxhighlight>

==Dynamodb==
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'output_Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
dynamodbOutputEventIdentifiers: [
{
serviceName: {tableName}, //service that deployed the DynamoDB table, so can build table's full resource name
resourceName: {resourceName}, //DynamoDB resourceName
eventTag: {eventTagDynamoDB}
}
],
}
]
</syntaxhighlight>

= Result of integrationtest =
Data have 2 table "TestRecord" and "TestUnit".
:- TestRecord is table all unti of stage inside eg input output invokes and dynamodb
:- TestUnit is store status each unit
each unit save in table TestUnit
testRecordId is name of test concat with testTime.
testUnitId is point to position of unti instage.
resultStatus is status of unit.
<syntaxhighlight lang="JavaScript">
eg:
input_0 = stages index 0 result '''input'''
output_1 = stages index 1 result '''output'''
invokeInput_0_1 = stages index 0 result '''invokes''' index 1 position input
invokeOutput_0_1 = stages index 0 result '''invokes''' index 1 position output
dynamodb_0_1 = stages index 0 result '''dynamodb''' index 1.
</syntaxhighlight>

after all TestUnit finish (check by awaitingMultiplestep penditnStep is integrationtestTag awaitingStepId is each TestUnit )
check all awaitingStep finish send message to ultimateIntegrationtest for sumla all test is status

== Summary of test status ==
:1.testStatus is "passed" all unit passed.
:2.testStatus is "failed" have some is failed.
:3.testStatus is "processing" have some is have status processing after check all awaiting step is finish.
:4.testStatus is "failed" have record "errorsTest" in case "not match stage invoke", 'found multiple matchingInvokes

*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

=How to test integrationtest s3=
[[Developer guide for making Integration Tests]]

[[Category:Working documents| 2025-11-20]]
[[Category:Working documents - Integration Testing| 2025-11-20]]

2025-11-20 IntegrationTest

2026-08-14T05:14:22Z

Mint: /* graphSeedDataTags */

Reference:

*[[2020-10-01 - Integration Test Config - Functions|IntegrationtestConfig]]
*[[2020-10-01 - Integration Testing - Lambda Functions|Integrationtesting]]
*[[2025-02-20 - Integration Test examples|Example]]

= File extension =

uploadS3: ".json"
integrationtestConfig: ".js"

=TestRecord=

<syntaxhighlight lang="JSON">
[
{
integrationTestTag: "Integrationtest_xx",
testStartedTimestamp: 111111111, // start time
bucketName: "integrationtest-config-us-east-2",
lastUpdateUniqueRequestId: "sssss", //_izContext.uniqueRequestId protacts race coditionn dynamodb
testStatus: "passed",//failed,processing,passed
testCompleteTimestamp: 1111113, // all test finish
stages: [
{
stageConfig: {
//straight copy of this stage from integration test config
inputEventTag: "xx",
inputEventConfig: {//event input
},
outputEventTag: "output_xx",
outputEventConfig: {//event out put
},
resourceName: "ComplexfilterTestProcessComplexfilter",// function name
resourceType: "Lambda", // function name
serviceTag: "Complexfilter",// (initeate sqs)
snsServiceName: "Complexfilter",// (initeate sqs)
snsTopic: "PorcessComplexfilter_In"// (initeate sqs)

},
stageStatus: "waiting", //waiting|passed|failed,
stageFinishedTimestamp: 111111111,// time that all tests finished and testRecord.stages.{stageKey}.stageStatus updated
stageResults: {
//results at the point of entering the resource (eg a Lambda function is invoked)
inputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of returning from the resource (eg a Lambda function returns)
outputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of invoking an external resource (eg the tested Lambda function is invoking another Lambda function)
invokes: {
"serviceName_resourceType_resourceName_inputEventTag ": {
invokeTimestamp: 111111111,//{ time result saved },
resultTimestamp: 111111112,//{ time result saved },
resultStatus: "passed",//passed | failed,
invokeParams: {},//{event invoke input config }
requestParams: {}// event invoke input request
},
},
dynamodbResults: [
{
indexOfDynamodbOutput: 0,
requestParams,
resultStatus: "passed",//
resultTimestamp: 22222
}]

},
stageErrors: [
//misc errors encountered
]
}]

}
]
</syntaxhighlight>

=Seed Data=
integrationtest manager seed date 2 process

=== Main Seed Data===
:Save file in s3 (in '''buckname''' :integrationtest-config-us-east-2, '''folder''':seedData_integrationTest).For other dev use service,If a developer wants to add more for other important testing purposes.

'''How to use:'''
#Add it from the s3 bucket at this point
#Run batch refreshSeedData [[Developer guide for making Integration Tests#Bash script|batch RefreshSeedData]]
'''Logic''':Process by storage resouse (graph or dynamodb)
:To clean up the seed data in the table after it creates seed data form service deploy and pulls seed data from s3.

=== Refresh Seed Data ===
:ProcessRefreshSeedData use seedDataTag for create data environment of '''test''' and can be refresh seeddata re-test agian.
:'''canbe share''' seed data for other test by seed data tag.
'''How to use:'''
:Save file in s3 (for other dav keep in floder dev name) or testConfig/seedData_config(for admin)

'''Folder'''
*dynamoDBSeedDataTags.json
*graphSeedDataTags.json

'''Example'''
==== dynamoDBSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource dynammodb.
Example
<syntaxhighlight lang="JavaScript">
{
"seedDynamodb_abc_ver2": [ // seedDataTag
{
"tableName": "DelivMethodSTDTestLogicalResultsData", // servcieTag+stage+tablename
"partitionKey": "logicalResultId",
"sortKey": "identifiersId",
"datas": [
{
logicalResultId: {
value: "eeeeeeeeee4"
},
identifiersId: {
value: "lllll123456"
},
processLogicalResultExpiryTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format , //Month,Months|Week,Weeks|day,days|Hour,Hours|Minute,Minutes|Second,Seconds|
}
},
{
logicalResultId: {
value: "eeeeeeeeee4"
},
"identifiersId": {
value: "lllll777777"
},
processLogicalResultExpiryTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "add", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format , //Month,Months|Week,Weeks|day,days|Hour,Hours|Minute,Minutes|Second,Seconds|
}
}
],
},
{
"tableName": "MLocationsTestFloatingRelationships",// servcieTag+stage+tablename
"partitionKey": "importBatchId",
"sortKey": "identifierRelationshipsId",
"datas": [
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll123456"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll777777"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll99999999"
}
]
},
{
"tableName": "MLocationsTestFindDataMain",
"partitionKey": "findDataId",
"datas": [
{
"findDataId": "111111"
},
{
"findDataId": "22222"
},
{
"findDataId": "333333"
}
]
}
]
}
</syntaxhighlight>

==== graphSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource graphHanler.
Example
<syntaxhighlight lang="JavaScript">
{
"seedData_testTag_GG": [ // seedDataTag
{
"nodes": [
{
"nodeLabels": [
"SellOfferPlan_sellOfferPlanDeliveryMethodLink"
],
"objectDetail": {
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": {
"value": "minttestrefreshSeedData_01",
},
},
"fields": {
"productId": {
"value": "ddddd",
},
"price": {
"value": 9999
},
exampleTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format //Month,Months|Week,Weeks|day,days|Hour,Hours|Minute,Minutes|Second,Seconds|
}
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMall"
],
"objectDetail": {
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
},
"fields": {
"name": "hotpot-man",
"totalPrice": 500
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMallCalculateSetting"
],
"objectDetail": {
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
},
"fields": {
"addToCalculatedValuePerOrder": 10,
"addToRateTableValuePerOrder": 77
}
}
}
],
"relationships": [
{
"fromObject": {
"nodeLabel": "SellOfferPlan_sellOfferPlanDeliveryMethodLink",
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": "minttestrefreshSeedData_01"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"relationships": [
{
"relTypeConcat": "SellOfferPlan_hasCCCCCCC",
"relId": "uuid-4s56df74s9df79w-w6de4f5w689ef"
}
]
},
{
"fromObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMallCalculateSetting",
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
}
},
"relationships": [
{
"relTypeConcat": "servcieMintTest_shoppingMall_currentShoppingMallCalculateSetting",
"relId": "uuid-s122df5-s21df",
"relationshipProperty": {
"timeStamp": 1234567879,
"statusName": true
}
},
{
"relTypeConcat": "servcieMintTest_shoppingMall_hasShoppingMallCalculateSetting",
"relId": "uuid-77777-99999",
"relationshipProperties": {
"statusName": {
"value": true
},
exampleTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format //Month,Months|Week,Weeks|day,days|Hour,Hours|Minute,Minutes|Second,Seconds|
}
}
}
]
}
]
}
],
"seedData_testTag_ABC": [
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": [
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "hasProductAttributeLink"
},
"relationshipDirection": "to",
"targetObjType": {
"serviceTag": "ProductStandard",
"objectType": "productStandard"
},
"targetIdentifiers": {
"productId": "f526a367a2b66cb0f37ca61b6c43f419929f521d"
},
"relationshipProperties": {}
},
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "isProductAttribute"
},
"relationshipDirection": "from",
"targetObjType": {
"serviceTag": "ProductAttribute",
"objectType": "productAttribute"
},
"targetIdentifiers": {
"productAttributeId": "f4bf7a078071d54036656df544197ba638bc3a68"
},
"relationshipProperties": {}
}
]
},
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": []
}
],
"seedData_testTag_LL": []
}
</syntaxhighlight>

=== Cleaning Seed Data ===
:Delete seed data for set environment of '''test'''.
*cleaningeDynamoOneRecordsTags.json
*cleaningeDynamoManyRecordsTags.json

====cleaningeDynamoOneRecordsTags====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_TestFindData_and_Education_case_invalid01": [
{
"tableName": "MLocationsTestFindDataMain",
"primaryKeys": [
{
"findDataId": "cleaning-1"
},
{
"findDataId": "cleaning-2"
}
]
},
{
"tableName": "MLocationsTestEducation",
"primaryKeys": [
{
"studentId": "cleaning-AA"
},
{
"studentId": "cleaning-BB"
},
{
"studentId": "cleaning-CC"
}
]
}
],
"cleaningSeed_TestMemberPersonnel_case_invalid01": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "namtan",
"passwordId": "qqqww"
},
{
"userId": "jack",
"passwordId": "q1"
},
{
"userId": "Momay",
"passwordId": "ttr"
}
]
}
]
}
</syntaxhighlight>

==== cleaningeDynamoManyRecordsTags ====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_manyData_partitionKey_only_miss_sort": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "many-data"
}
]
}
]
}
</syntaxhighlight>

*logic query table MLocationsTestMemberPersonnel use primary Keys "userId" and then delete all data from primary Keys.

=resources=
syntax is object
<syntaxhighlight lang="JavaScript">
{
"Lambda":{
"{FunctionNameHdrSqs}":{ // FunctionNameHdrSqs is match resourceName in file tests
"localLacation":"/src/FunctionNameHdrSqs.js",
"localHandler":"main",
"functionName":"FunctionNameHdrSqs" // FunctionName is function name match key of function.yml of servcie.
},
"ProcessComplexFilterHdrSqs":{
"localLacation":"/src/ProcessComplexFilterHdrSqs.js",
"localHandler":"main",
"functionName":"ProcessComplexFilterHdrSqs"
},
...
},
"Dynamodb": {
"filterMain":{ // match resourceName in file tests(dynamodbOutputEventIdentifiers)
"tableName":"filterMain"
},
"tableNameBB":{
"tableName":"tableNameBB"
},
...
}
}
</syntaxhighlight>

=events=
Syntax is object
==Syntax Name==
===FileName===
::Event_{inputEventTag}

===eventTag===
#inputEventTag
#outputEventTag
#dynamodbTag

*file events.js is have eventTag (inputEventTag,outputEventTag,dynamodbTag)
**How to create name eventTag
***Example case : "test in service complexFilter functionname ProcessComplexFilter case element type is logical basic".
::*'''inputEventTag'''
::::{serviceName}_{functionName}_{caseTest}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''outputEventTag'''
::::output_{inputEventTag}
''output_Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''dynamodbTag'''
::::{inputEventTag}__Dynamodb__{'''action*'''}_{tableName}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic___Dynamodb__putItem_filterMain''
: '''{action}''' is only ''put'' or ''update'', and in case of ''update'' must only test the last step of update 

=== Syntax event===
====initiate by handlerServcie====
=====Sqs=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Sns
{
"LambdaFunctionHdrSqs_input__pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
},
"propertyB":{
"properties":{
"propertyB1":{
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"value":"msgTag"
},
"propertyD":{
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
<syntaxhighlight lang="JavaScript" linein>
"snsSqsTrigger":true
</syntaxhighlight>

=====Dsq=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Direct Sqs
{
"LambdaFunctionHdrDsq_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"DirectSqs":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrDsq_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
* DirectSqs = true
:: for initialStage of Dsq
* messageAttributes is optional

=====Inv=====
<syntaxhighlight lang="JavaScript">
{
"LambdaFunctionHdrInv_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
}
}
},
{
"output_LambdaFunctionHdrInv_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>

=====Api=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of API
{
"LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"forstageMatvhing": true,
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1",
},
"propertyB": {
"properties": {
"propertyB1": {
"value": "valuePropertyB1",
}
}
},
"propertyC": {
"eventValue": [
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3",
]
},
...
}
}
}
},
"Output_LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1"
},
...
}
}
}
}
}
</syntaxhighlight>

=====S3=====

====dynamodb====
<syntaxhighlight lang="JavaScript">
// An example event of Dynamodb //optional
{
{inputEventTag}__dynamodb_{action}_{tablename}: { // eg. "Complexfilter_ProcessComplexfilter_logical_basic__dynamodb_update_FilterMain"
"forStageMatching": true,
"properties": {
"filterMainUniqueRequestId": {
"testValueMatches": fase,
"value": "bbc4f4a9-2032-4dec-9129-8c7d169fecc5"
},
"filterObject": {
"forStageMatching": true,
"properties": {
"logicalType": {
"value": "partitionKey"
},
"comparison": {
"value": "equals"
},
"type": {
"value": "logical"
},
"partitionKey": {
"forStageMatching": true,
"value": "mockIntegratioTestCPF"
}
}
},
"filterMainExpiryTime": {
"testValueMatches": fase,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": fase,
"value": 1731894402678
},
"objType": {
"forStageMatching": true,
"properties": {
"serviceTag": {
"forStageMatching": true,
"value": "IntTesting"
},
"objectType": {
"forStageMatching": true,
"value": "TestRecord"
}
}
}
},
"keyValues": {
"filterMainId": "4865d2451a621cb7f71225cfabf2df4f98e20801",
"objTypeId": "cdb170690571df7522b3850920fce02507c077ee"
}
}
}
</syntaxhighlight>

* partition key: filterMainId
* sort key: objTypeId

[[2021-01-15 - Integration Testing - Adding DynamoDB result tests]]

===Type paramiter===
use for evnet and dyanmodb event
====Normal====
<syntaxhighlight lang="JavaScript">

object: {
forStageMatching: true,
properties: {
name:{
forStageMatching: true,
value:"Tom"
}
}
},
array: {
forStageMatching: true,
useIsEqual: true,
eventValue: [
{
"relTypeAndDirection": {
"relType": {
"serviceTag": "maxxCart2",
"relationshipTag": "hasCartOrder"
},
"relationshipDirection": "from"
},
"targetObjects": [
{
"objType": {
"serviceTag": "maxxCart2",
"objectType": "cartOrder"
}
}
]
}
]
},
number: {
forStageMatching: true,
value: 1111
},
string: {
forStageMatching: true,
value: "hi"
},
boolean: {
forStageMatching: true,
value: true
}
</syntaxhighlight>

<syntaxhighlight lang="JavaScript">
forStageMatching: true
</syntaxhighlight>
::set true for check match value,It is not necessary to set every value
:::use in test importent paramiter

<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
::setting paramiter require on create but can not test random value eg: identifier or timeStamp or uuid

====Empty====
<syntaxhighlight lang="JavaScript">
EmptyString:{
forStageMatching: true,
value:""
},
EmptyArray:{
forStageMatching: true,
useIsEqual: true,
eventValue: []
},
EmptyObject:{
forStageMatching: true,
value:{}
}
</syntaxhighlight>

====Error====
can test noRetryError
<syntaxhighlight lang="JavaScript">
"errorMessage": {
forStageMatching: true,
"value": "Not found schema of {serviceTag:TestGraphHandler, objectType:notFoundObjType}"
}
</syntaxhighlight>

====Paramiter random====
Can not test case random numbber or uuid.
But requriOnCreate mush be set
<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
or set
<syntaxhighlight lang="JavaScript">
forStageMatching:false
</syntaxhighlight>

=tests=
Syntax is array of object
==Syntax name==
===Testtag name ===
*{integrationTestTag}
#Test Own servcie or not a lot stage
<syntaxhighlight lang="JavaScript">
Test_{inputEventTag}
</syntaxhighlight>
#Mix multiple servcie and multiple stage
<syntaxhighlight lang="JavaScript">
IntegrationTest_{inputEventTag}
</syntaxhighlight>

===File name ===
<syntaxhighlight lang="JavaScript">
{integrationTestTag}.json
</syntaxhighlight>

==Setting of test==
[[Service - Integration Test Config#tests.js Syntax|syntax test]]

<syntaxhighlight lang="JavaScript">
{
integrationTestTag: {integrationTestTag},
productionSafe: true|false, //default false
noInitialStage: true, // default false, if set to true, no error when no foundInitialStages found
errorIfStageUndefined: true|false, //default false
errorIfInvokeUndefined: true|false, //default false,
dynamoDBSeedDataTags:["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
graphSeedDataTags:["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
cleaningeDynamoOneRecordsTags: ["cleaningSeed_partitionKey_sortKey_normol"], //optional
cleaningeDynamoManyRecordsTags: [], // optional
stages:[
...
]
}
</syntaxhighlight>
*[[2025-11-20 IntegrationTest#dynamoDBSeedDataTags|dynamoDBSeedDataTags]]
*[[2025-11-20 IntegrationTest#graphSeedDataTags|graphSeedDataTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoOneRecordsTags|cleaningeDynamoOneRecordsTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoManyRecordsTags|cleaningeDynamoManyRecordsTags]]

==Stages==
====Initiate stage====
:'''"initialStage":true'''
[[Service_-_Integration_Test_Config#tests.js Syntax|detail property of test]]
=====HandlerService=====
======Sqs======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"Locations_ProcessLocationNodeSomting_casenotHaveData",
"serviceName":"Locations",
"resourceType":"Lambda",
"resourceName":"ProcessLocationNodeSomtingHdrDsq",
"outputEventTag":"Output_Locations_ProcessLocationNodeSomting_casenotHaveData"
}
]
</syntaxhighlight>
======Dsq======
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'LambdaFunctionHdrDsq_input_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'LambdaFunctionHdrDsq_output__returnvalue_pass',
// **** not set snsServiceName and snsTopic
// can be test dynamodbOutput
}
]
</syntaxhighlight>

======Api======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrApi_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrApi",
"outputEventTag":"LambdaFunctionHdrApi_output__pass"
}
]
</syntaxhighlight>

======Inv======
*'''single stage'''
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": ["cleaningSeed_partitionKey_sortKey_normol"], //optional
"cleaningeDynamoManyRecordsTags": []
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass"
}
]
}]
</syntaxhighlight>
*'''invoke multiple stage'''
:*Each stage test can invoke multiple lambda by use "eventStage Tag" point to stage for test integration test.
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv_invokes__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": [], //optional
"cleaningeDynamoManyRecordsTags": [], // optional
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass",
"invokes":[
{
"eventStageTag":"service_invokesB__pass"
},
{
"eventStageTag":"service_invokesD__pass"
}
]
},
{
"eventStageTag":"service_invokesB__pass",
"inputEventTag":"input_service_invokes__pass",
"serviceName":"ServiceTemplate_B",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_B_HdrInv",
"outputEventTag":"output_service_invokes__pass"
},
{
"eventStageTag":"service_invokesD__pass",
"inputEventTag":"input_service_invokesD__pass",
"serviceName":"ServiceTemplate_D",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_D_HdrInv",
"outputEventTag":"output_service_invokesD__pass"
}
]
}]
</syntaxhighlight>

======S3======
======Batch======

====GeneratedSeedData====
*Integrationtest must be delete identifier every time before test.
*Set 'generatedSeedData' in file tests.json case by case of stage eg: stages[0] create identifier is randomOnCreate will set 'generatedSeedData' and stages[1] create relationship is randomOnCreate(It is usually random, except in the case of relationship version) set generatedSeedData this stages[1].
*How to delete case identifier rendomOnCreate?: set in stage use setting generateSeedData "randomOnCreateIdentifier"
#randomOnCreateIdentifier
#notRandomOnIdentifier
#relationships
=====randomOnCreateIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"randomOnCreateIdentifier": [
{
"objType": {
"serviceTag": "MLocations",
"objectType": "Member"
},
"identifierValue": "Jaya-member-001"
}
]
}
}
]
</syntaxhighlight>
=====notRandomOnIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"notRandomOnIdentifier": [
{
"objType": {
"serviceTag": "gggg",
"objectType": "ssssss"
},
"identifiers": {
"topId": "123456"
}
}
]
}
}
]
</syntaxhighlight>
=====relationships=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"relationships": [
{
"relType": {
"serviceTag": "PaymentMethodGeneric",
"relationshipTag": "disabledPaymentMethodGenericPropertyValue"
},
"relId": "f4f73de7-647c-4b3b-8043-87cc002f361a"
}
]
}
}
]

</syntaxhighlight>

==Dynamodb==
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'output_Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
dynamodbOutputEventIdentifiers: [
{
serviceName: {tableName}, //service that deployed the DynamoDB table, so can build table's full resource name
resourceName: {resourceName}, //DynamoDB resourceName
eventTag: {eventTagDynamoDB}
}
],
}
]
</syntaxhighlight>

= Result of integrationtest =
Data have 2 table "TestRecord" and "TestUnit".
:- TestRecord is table all unti of stage inside eg input output invokes and dynamodb
:- TestUnit is store status each unit
each unit save in table TestUnit
testRecordId is name of test concat with testTime.
testUnitId is point to position of unti instage.
resultStatus is status of unit.
<syntaxhighlight lang="JavaScript">
eg:
input_0 = stages index 0 result '''input'''
output_1 = stages index 1 result '''output'''
invokeInput_0_1 = stages index 0 result '''invokes''' index 1 position input
invokeOutput_0_1 = stages index 0 result '''invokes''' index 1 position output
dynamodb_0_1 = stages index 0 result '''dynamodb''' index 1.
</syntaxhighlight>

after all TestUnit finish (check by awaitingMultiplestep penditnStep is integrationtestTag awaitingStepId is each TestUnit )
check all awaitingStep finish send message to ultimateIntegrationtest for sumla all test is status

== Summary of test status ==
:1.testStatus is "passed" all unit passed.
:2.testStatus is "failed" have some is failed.
:3.testStatus is "processing" have some is have status processing after check all awaiting step is finish.
:4.testStatus is "failed" have record "errorsTest" in case "not match stage invoke", 'found multiple matchingInvokes

*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

=How to test integrationtest s3=
[[Developer guide for making Integration Tests]]

[[Category:Working documents| 2025-11-20]]
[[Category:Working documents - Integration Testing| 2025-11-20]]

2025-11-20 IntegrationTest

2026-08-14T05:11:18Z

Mint: /* dynamoDBSeedDataTags */

Reference:

*[[2020-10-01 - Integration Test Config - Functions|IntegrationtestConfig]]
*[[2020-10-01 - Integration Testing - Lambda Functions|Integrationtesting]]
*[[2025-02-20 - Integration Test examples|Example]]

= File extension =

uploadS3: ".json"
integrationtestConfig: ".js"

=TestRecord=

<syntaxhighlight lang="JSON">
[
{
integrationTestTag: "Integrationtest_xx",
testStartedTimestamp: 111111111, // start time
bucketName: "integrationtest-config-us-east-2",
lastUpdateUniqueRequestId: "sssss", //_izContext.uniqueRequestId protacts race coditionn dynamodb
testStatus: "passed",//failed,processing,passed
testCompleteTimestamp: 1111113, // all test finish
stages: [
{
stageConfig: {
//straight copy of this stage from integration test config
inputEventTag: "xx",
inputEventConfig: {//event input
},
outputEventTag: "output_xx",
outputEventConfig: {//event out put
},
resourceName: "ComplexfilterTestProcessComplexfilter",// function name
resourceType: "Lambda", // function name
serviceTag: "Complexfilter",// (initeate sqs)
snsServiceName: "Complexfilter",// (initeate sqs)
snsTopic: "PorcessComplexfilter_In"// (initeate sqs)

},
stageStatus: "waiting", //waiting|passed|failed,
stageFinishedTimestamp: 111111111,// time that all tests finished and testRecord.stages.{stageKey}.stageStatus updated
stageResults: {
//results at the point of entering the resource (eg a Lambda function is invoked)
inputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of returning from the resource (eg a Lambda function returns)
outputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of invoking an external resource (eg the tested Lambda function is invoking another Lambda function)
invokes: {
"serviceName_resourceType_resourceName_inputEventTag ": {
invokeTimestamp: 111111111,//{ time result saved },
resultTimestamp: 111111112,//{ time result saved },
resultStatus: "passed",//passed | failed,
invokeParams: {},//{event invoke input config }
requestParams: {}// event invoke input request
},
},
dynamodbResults: [
{
indexOfDynamodbOutput: 0,
requestParams,
resultStatus: "passed",//
resultTimestamp: 22222
}]

},
stageErrors: [
//misc errors encountered
]
}]

}
]
</syntaxhighlight>

=Seed Data=
integrationtest manager seed date 2 process

=== Main Seed Data===
:Save file in s3 (in '''buckname''' :integrationtest-config-us-east-2, '''folder''':seedData_integrationTest).For other dev use service,If a developer wants to add more for other important testing purposes.

'''How to use:'''
#Add it from the s3 bucket at this point
#Run batch refreshSeedData [[Developer guide for making Integration Tests#Bash script|batch RefreshSeedData]]
'''Logic''':Process by storage resouse (graph or dynamodb)
:To clean up the seed data in the table after it creates seed data form service deploy and pulls seed data from s3.

=== Refresh Seed Data ===
:ProcessRefreshSeedData use seedDataTag for create data environment of '''test''' and can be refresh seeddata re-test agian.
:'''canbe share''' seed data for other test by seed data tag.
'''How to use:'''
:Save file in s3 (for other dav keep in floder dev name) or testConfig/seedData_config(for admin)

'''Folder'''
*dynamoDBSeedDataTags.json
*graphSeedDataTags.json

'''Example'''
==== dynamoDBSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource dynammodb.
Example
<syntaxhighlight lang="JavaScript">
{
"seedDynamodb_abc_ver2": [ // seedDataTag
{
"tableName": "DelivMethodSTDTestLogicalResultsData", // servcieTag+stage+tablename
"partitionKey": "logicalResultId",
"sortKey": "identifiersId",
"datas": [
{
logicalResultId: {
value: "eeeeeeeeee4"
},
identifiersId: {
value: "lllll123456"
},
processLogicalResultExpiryTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format , //Month,Months|Week,Weeks|day,days|Hour,Hours|Minute,Minutes|Second,Seconds|
}
},
{
logicalResultId: {
value: "eeeeeeeeee4"
},
"identifiersId": {
value: "lllll777777"
},
processLogicalResultExpiryTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "add", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format , //Month,Months|Week,Weeks|day,days|Hour,Hours|Minute,Minutes|Second,Seconds|
}
}
],
},
{
"tableName": "MLocationsTestFloatingRelationships",// servcieTag+stage+tablename
"partitionKey": "importBatchId",
"sortKey": "identifierRelationshipsId",
"datas": [
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll123456"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll777777"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll99999999"
}
]
},
{
"tableName": "MLocationsTestFindDataMain",
"partitionKey": "findDataId",
"datas": [
{
"findDataId": "111111"
},
{
"findDataId": "22222"
},
{
"findDataId": "333333"
}
]
}
]
}
</syntaxhighlight>

==== graphSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource graphHanler.
Example
<syntaxhighlight lang="JavaScript">
{
"seedData_testTag_GG": [ // seedDataTag
{
"nodes": [
{
"nodeLabels": [
"SellOfferPlan_sellOfferPlanDeliveryMethodLink"
],
"objectDetail": {
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": {
"value": "minttestrefreshSeedData_01",
},
},
"fields": {
"productId": {
"value": "ddddd",
},
"price": {
"value": 9999
},
exampleTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format
}
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMall"
],
"objectDetail": {
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
},
"fields": {
"name": "hotpot-man",
"totalPrice": 500
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMallCalculateSetting"
],
"objectDetail": {
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
},
"fields": {
"addToCalculatedValuePerOrder": 10,
"addToRateTableValuePerOrder": 77
}
}
}
],
"relationships": [
{
"fromObject": {
"nodeLabel": "SellOfferPlan_sellOfferPlanDeliveryMethodLink",
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": "minttestrefreshSeedData_01"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"relationships": [
{
"relTypeConcat": "SellOfferPlan_hasCCCCCCC",
"relId": "uuid-4s56df74s9df79w-w6de4f5w689ef"
}
]
},
{
"fromObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMallCalculateSetting",
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
}
},
"relationships": [
{
"relTypeConcat": "servcieMintTest_shoppingMall_currentShoppingMallCalculateSetting",
"relId": "uuid-s122df5-s21df",
"relationshipProperty": {
"timeStamp": 1234567879,
"statusName": true
}
},
{
"relTypeConcat": "servcieMintTest_shoppingMall_hasShoppingMallCalculateSetting",
"relId": "uuid-77777-99999",
"relationshipProperties": {
"statusName": {
"value": true
},
exampleTimestamp: {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format
}
}
}
]
}
]
}
],
"seedData_testTag_ABC": [
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": [
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "hasProductAttributeLink"
},
"relationshipDirection": "to",
"targetObjType": {
"serviceTag": "ProductStandard",
"objectType": "productStandard"
},
"targetIdentifiers": {
"productId": "f526a367a2b66cb0f37ca61b6c43f419929f521d"
},
"relationshipProperties": {}
},
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "isProductAttribute"
},
"relationshipDirection": "from",
"targetObjType": {
"serviceTag": "ProductAttribute",
"objectType": "productAttribute"
},
"targetIdentifiers": {
"productAttributeId": "f4bf7a078071d54036656df544197ba638bc3a68"
},
"relationshipProperties": {}
}
]
},
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": []
}
],
"seedData_testTag_LL": []
}
</syntaxhighlight>

=== Cleaning Seed Data ===
:Delete seed data for set environment of '''test'''.
*cleaningeDynamoOneRecordsTags.json
*cleaningeDynamoManyRecordsTags.json

====cleaningeDynamoOneRecordsTags====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_TestFindData_and_Education_case_invalid01": [
{
"tableName": "MLocationsTestFindDataMain",
"primaryKeys": [
{
"findDataId": "cleaning-1"
},
{
"findDataId": "cleaning-2"
}
]
},
{
"tableName": "MLocationsTestEducation",
"primaryKeys": [
{
"studentId": "cleaning-AA"
},
{
"studentId": "cleaning-BB"
},
{
"studentId": "cleaning-CC"
}
]
}
],
"cleaningSeed_TestMemberPersonnel_case_invalid01": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "namtan",
"passwordId": "qqqww"
},
{
"userId": "jack",
"passwordId": "q1"
},
{
"userId": "Momay",
"passwordId": "ttr"
}
]
}
]
}
</syntaxhighlight>

==== cleaningeDynamoManyRecordsTags ====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_manyData_partitionKey_only_miss_sort": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "many-data"
}
]
}
]
}
</syntaxhighlight>

*logic query table MLocationsTestMemberPersonnel use primary Keys "userId" and then delete all data from primary Keys.

=resources=
syntax is object
<syntaxhighlight lang="JavaScript">
{
"Lambda":{
"{FunctionNameHdrSqs}":{ // FunctionNameHdrSqs is match resourceName in file tests
"localLacation":"/src/FunctionNameHdrSqs.js",
"localHandler":"main",
"functionName":"FunctionNameHdrSqs" // FunctionName is function name match key of function.yml of servcie.
},
"ProcessComplexFilterHdrSqs":{
"localLacation":"/src/ProcessComplexFilterHdrSqs.js",
"localHandler":"main",
"functionName":"ProcessComplexFilterHdrSqs"
},
...
},
"Dynamodb": {
"filterMain":{ // match resourceName in file tests(dynamodbOutputEventIdentifiers)
"tableName":"filterMain"
},
"tableNameBB":{
"tableName":"tableNameBB"
},
...
}
}
</syntaxhighlight>

=events=
Syntax is object
==Syntax Name==
===FileName===
::Event_{inputEventTag}

===eventTag===
#inputEventTag
#outputEventTag
#dynamodbTag

*file events.js is have eventTag (inputEventTag,outputEventTag,dynamodbTag)
**How to create name eventTag
***Example case : "test in service complexFilter functionname ProcessComplexFilter case element type is logical basic".
::*'''inputEventTag'''
::::{serviceName}_{functionName}_{caseTest}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''outputEventTag'''
::::output_{inputEventTag}
''output_Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''dynamodbTag'''
::::{inputEventTag}__Dynamodb__{'''action*'''}_{tableName}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic___Dynamodb__putItem_filterMain''
: '''{action}''' is only ''put'' or ''update'', and in case of ''update'' must only test the last step of update 

=== Syntax event===
====initiate by handlerServcie====
=====Sqs=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Sns
{
"LambdaFunctionHdrSqs_input__pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
},
"propertyB":{
"properties":{
"propertyB1":{
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"value":"msgTag"
},
"propertyD":{
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
<syntaxhighlight lang="JavaScript" linein>
"snsSqsTrigger":true
</syntaxhighlight>

=====Dsq=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Direct Sqs
{
"LambdaFunctionHdrDsq_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"DirectSqs":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrDsq_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
* DirectSqs = true
:: for initialStage of Dsq
* messageAttributes is optional

=====Inv=====
<syntaxhighlight lang="JavaScript">
{
"LambdaFunctionHdrInv_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
}
}
},
{
"output_LambdaFunctionHdrInv_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>

=====Api=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of API
{
"LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"forstageMatvhing": true,
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1",
},
"propertyB": {
"properties": {
"propertyB1": {
"value": "valuePropertyB1",
}
}
},
"propertyC": {
"eventValue": [
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3",
]
},
...
}
}
}
},
"Output_LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1"
},
...
}
}
}
}
}
</syntaxhighlight>

=====S3=====

====dynamodb====
<syntaxhighlight lang="JavaScript">
// An example event of Dynamodb //optional
{
{inputEventTag}__dynamodb_{action}_{tablename}: { // eg. "Complexfilter_ProcessComplexfilter_logical_basic__dynamodb_update_FilterMain"
"forStageMatching": true,
"properties": {
"filterMainUniqueRequestId": {
"testValueMatches": fase,
"value": "bbc4f4a9-2032-4dec-9129-8c7d169fecc5"
},
"filterObject": {
"forStageMatching": true,
"properties": {
"logicalType": {
"value": "partitionKey"
},
"comparison": {
"value": "equals"
},
"type": {
"value": "logical"
},
"partitionKey": {
"forStageMatching": true,
"value": "mockIntegratioTestCPF"
}
}
},
"filterMainExpiryTime": {
"testValueMatches": fase,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": fase,
"value": 1731894402678
},
"objType": {
"forStageMatching": true,
"properties": {
"serviceTag": {
"forStageMatching": true,
"value": "IntTesting"
},
"objectType": {
"forStageMatching": true,
"value": "TestRecord"
}
}
}
},
"keyValues": {
"filterMainId": "4865d2451a621cb7f71225cfabf2df4f98e20801",
"objTypeId": "cdb170690571df7522b3850920fce02507c077ee"
}
}
}
</syntaxhighlight>

* partition key: filterMainId
* sort key: objTypeId

[[2021-01-15 - Integration Testing - Adding DynamoDB result tests]]

===Type paramiter===
use for evnet and dyanmodb event
====Normal====
<syntaxhighlight lang="JavaScript">

object: {
forStageMatching: true,
properties: {
name:{
forStageMatching: true,
value:"Tom"
}
}
},
array: {
forStageMatching: true,
useIsEqual: true,
eventValue: [
{
"relTypeAndDirection": {
"relType": {
"serviceTag": "maxxCart2",
"relationshipTag": "hasCartOrder"
},
"relationshipDirection": "from"
},
"targetObjects": [
{
"objType": {
"serviceTag": "maxxCart2",
"objectType": "cartOrder"
}
}
]
}
]
},
number: {
forStageMatching: true,
value: 1111
},
string: {
forStageMatching: true,
value: "hi"
},
boolean: {
forStageMatching: true,
value: true
}
</syntaxhighlight>

<syntaxhighlight lang="JavaScript">
forStageMatching: true
</syntaxhighlight>
::set true for check match value,It is not necessary to set every value
:::use in test importent paramiter

<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
::setting paramiter require on create but can not test random value eg: identifier or timeStamp or uuid

====Empty====
<syntaxhighlight lang="JavaScript">
EmptyString:{
forStageMatching: true,
value:""
},
EmptyArray:{
forStageMatching: true,
useIsEqual: true,
eventValue: []
},
EmptyObject:{
forStageMatching: true,
value:{}
}
</syntaxhighlight>

====Error====
can test noRetryError
<syntaxhighlight lang="JavaScript">
"errorMessage": {
forStageMatching: true,
"value": "Not found schema of {serviceTag:TestGraphHandler, objectType:notFoundObjType}"
}
</syntaxhighlight>

====Paramiter random====
Can not test case random numbber or uuid.
But requriOnCreate mush be set
<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
or set
<syntaxhighlight lang="JavaScript">
forStageMatching:false
</syntaxhighlight>

=tests=
Syntax is array of object
==Syntax name==
===Testtag name ===
*{integrationTestTag}
#Test Own servcie or not a lot stage
<syntaxhighlight lang="JavaScript">
Test_{inputEventTag}
</syntaxhighlight>
#Mix multiple servcie and multiple stage
<syntaxhighlight lang="JavaScript">
IntegrationTest_{inputEventTag}
</syntaxhighlight>

===File name ===
<syntaxhighlight lang="JavaScript">
{integrationTestTag}.json
</syntaxhighlight>

==Setting of test==
[[Service - Integration Test Config#tests.js Syntax|syntax test]]

<syntaxhighlight lang="JavaScript">
{
integrationTestTag: {integrationTestTag},
productionSafe: true|false, //default false
noInitialStage: true, // default false, if set to true, no error when no foundInitialStages found
errorIfStageUndefined: true|false, //default false
errorIfInvokeUndefined: true|false, //default false,
dynamoDBSeedDataTags:["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
graphSeedDataTags:["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
cleaningeDynamoOneRecordsTags: ["cleaningSeed_partitionKey_sortKey_normol"], //optional
cleaningeDynamoManyRecordsTags: [], // optional
stages:[
...
]
}
</syntaxhighlight>
*[[2025-11-20 IntegrationTest#dynamoDBSeedDataTags|dynamoDBSeedDataTags]]
*[[2025-11-20 IntegrationTest#graphSeedDataTags|graphSeedDataTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoOneRecordsTags|cleaningeDynamoOneRecordsTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoManyRecordsTags|cleaningeDynamoManyRecordsTags]]

==Stages==
====Initiate stage====
:'''"initialStage":true'''
[[Service_-_Integration_Test_Config#tests.js Syntax|detail property of test]]
=====HandlerService=====
======Sqs======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"Locations_ProcessLocationNodeSomting_casenotHaveData",
"serviceName":"Locations",
"resourceType":"Lambda",
"resourceName":"ProcessLocationNodeSomtingHdrDsq",
"outputEventTag":"Output_Locations_ProcessLocationNodeSomting_casenotHaveData"
}
]
</syntaxhighlight>
======Dsq======
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'LambdaFunctionHdrDsq_input_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'LambdaFunctionHdrDsq_output__returnvalue_pass',
// **** not set snsServiceName and snsTopic
// can be test dynamodbOutput
}
]
</syntaxhighlight>

======Api======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrApi_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrApi",
"outputEventTag":"LambdaFunctionHdrApi_output__pass"
}
]
</syntaxhighlight>

======Inv======
*'''single stage'''
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": ["cleaningSeed_partitionKey_sortKey_normol"], //optional
"cleaningeDynamoManyRecordsTags": []
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass"
}
]
}]
</syntaxhighlight>
*'''invoke multiple stage'''
:*Each stage test can invoke multiple lambda by use "eventStage Tag" point to stage for test integration test.
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv_invokes__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": [], //optional
"cleaningeDynamoManyRecordsTags": [], // optional
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass",
"invokes":[
{
"eventStageTag":"service_invokesB__pass"
},
{
"eventStageTag":"service_invokesD__pass"
}
]
},
{
"eventStageTag":"service_invokesB__pass",
"inputEventTag":"input_service_invokes__pass",
"serviceName":"ServiceTemplate_B",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_B_HdrInv",
"outputEventTag":"output_service_invokes__pass"
},
{
"eventStageTag":"service_invokesD__pass",
"inputEventTag":"input_service_invokesD__pass",
"serviceName":"ServiceTemplate_D",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_D_HdrInv",
"outputEventTag":"output_service_invokesD__pass"
}
]
}]
</syntaxhighlight>

======S3======
======Batch======

====GeneratedSeedData====
*Integrationtest must be delete identifier every time before test.
*Set 'generatedSeedData' in file tests.json case by case of stage eg: stages[0] create identifier is randomOnCreate will set 'generatedSeedData' and stages[1] create relationship is randomOnCreate(It is usually random, except in the case of relationship version) set generatedSeedData this stages[1].
*How to delete case identifier rendomOnCreate?: set in stage use setting generateSeedData "randomOnCreateIdentifier"
#randomOnCreateIdentifier
#notRandomOnIdentifier
#relationships
=====randomOnCreateIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"randomOnCreateIdentifier": [
{
"objType": {
"serviceTag": "MLocations",
"objectType": "Member"
},
"identifierValue": "Jaya-member-001"
}
]
}
}
]
</syntaxhighlight>
=====notRandomOnIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"notRandomOnIdentifier": [
{
"objType": {
"serviceTag": "gggg",
"objectType": "ssssss"
},
"identifiers": {
"topId": "123456"
}
}
]
}
}
]
</syntaxhighlight>
=====relationships=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"relationships": [
{
"relType": {
"serviceTag": "PaymentMethodGeneric",
"relationshipTag": "disabledPaymentMethodGenericPropertyValue"
},
"relId": "f4f73de7-647c-4b3b-8043-87cc002f361a"
}
]
}
}
]

</syntaxhighlight>

==Dynamodb==
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'output_Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
dynamodbOutputEventIdentifiers: [
{
serviceName: {tableName}, //service that deployed the DynamoDB table, so can build table's full resource name
resourceName: {resourceName}, //DynamoDB resourceName
eventTag: {eventTagDynamoDB}
}
],
}
]
</syntaxhighlight>

= Result of integrationtest =
Data have 2 table "TestRecord" and "TestUnit".
:- TestRecord is table all unti of stage inside eg input output invokes and dynamodb
:- TestUnit is store status each unit
each unit save in table TestUnit
testRecordId is name of test concat with testTime.
testUnitId is point to position of unti instage.
resultStatus is status of unit.
<syntaxhighlight lang="JavaScript">
eg:
input_0 = stages index 0 result '''input'''
output_1 = stages index 1 result '''output'''
invokeInput_0_1 = stages index 0 result '''invokes''' index 1 position input
invokeOutput_0_1 = stages index 0 result '''invokes''' index 1 position output
dynamodb_0_1 = stages index 0 result '''dynamodb''' index 1.
</syntaxhighlight>

after all TestUnit finish (check by awaitingMultiplestep penditnStep is integrationtestTag awaitingStepId is each TestUnit )
check all awaitingStep finish send message to ultimateIntegrationtest for sumla all test is status

== Summary of test status ==
:1.testStatus is "passed" all unit passed.
:2.testStatus is "failed" have some is failed.
:3.testStatus is "processing" have some is have status processing after check all awaiting step is finish.
:4.testStatus is "failed" have record "errorsTest" in case "not match stage invoke", 'found multiple matchingInvokes

*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

=How to test integrationtest s3=
[[Developer guide for making Integration Tests]]

[[Category:Working documents| 2025-11-20]]
[[Category:Working documents - Integration Testing| 2025-11-20]]

2025-11-20 IntegrationTest

2026-08-11T07:18:47Z

Mint: /* graphSeedDataTags */

Reference:

*[[2020-10-01 - Integration Test Config - Functions|IntegrationtestConfig]]
*[[2020-10-01 - Integration Testing - Lambda Functions|Integrationtesting]]
*[[2025-02-20 - Integration Test examples|Example]]

= File extension =

uploadS3: ".json"
integrationtestConfig: ".js"

=TestRecord=

<syntaxhighlight lang="JSON">
[
{
integrationTestTag: "Integrationtest_xx",
testStartedTimestamp: 111111111, // start time
bucketName: "integrationtest-config-us-east-2",
lastUpdateUniqueRequestId: "sssss", //_izContext.uniqueRequestId protacts race coditionn dynamodb
testStatus: "passed",//failed,processing,passed
testCompleteTimestamp: 1111113, // all test finish
stages: [
{
stageConfig: {
//straight copy of this stage from integration test config
inputEventTag: "xx",
inputEventConfig: {//event input
},
outputEventTag: "output_xx",
outputEventConfig: {//event out put
},
resourceName: "ComplexfilterTestProcessComplexfilter",// function name
resourceType: "Lambda", // function name
serviceTag: "Complexfilter",// (initeate sqs)
snsServiceName: "Complexfilter",// (initeate sqs)
snsTopic: "PorcessComplexfilter_In"// (initeate sqs)

},
stageStatus: "waiting", //waiting|passed|failed,
stageFinishedTimestamp: 111111111,// time that all tests finished and testRecord.stages.{stageKey}.stageStatus updated
stageResults: {
//results at the point of entering the resource (eg a Lambda function is invoked)
inputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of returning from the resource (eg a Lambda function returns)
outputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of invoking an external resource (eg the tested Lambda function is invoking another Lambda function)
invokes: {
"serviceName_resourceType_resourceName_inputEventTag ": {
invokeTimestamp: 111111111,//{ time result saved },
resultTimestamp: 111111112,//{ time result saved },
resultStatus: "passed",//passed | failed,
invokeParams: {},//{event invoke input config }
requestParams: {}// event invoke input request
},
},
dynamodbResults: [
{
indexOfDynamodbOutput: 0,
requestParams,
resultStatus: "passed",//
resultTimestamp: 22222
}]

},
stageErrors: [
//misc errors encountered
]
}]

}
]
</syntaxhighlight>

=Seed Data=
integrationtest manager seed date 2 process

=== Main Seed Data===
:Save file in s3 (in '''buckname''' :integrationtest-config-us-east-2, '''folder''':seedData_integrationTest).For other dev use service,If a developer wants to add more for other important testing purposes.

'''How to use:'''
#Add it from the s3 bucket at this point
#Run batch refreshSeedData [[Developer guide for making Integration Tests#Bash script|batch RefreshSeedData]]
'''Logic''':Process by storage resouse (graph or dynamodb)
:To clean up the seed data in the table after it creates seed data form service deploy and pulls seed data from s3.

=== Refresh Seed Data ===
:ProcessRefreshSeedData use seedDataTag for create data environment of '''test''' and can be refresh seeddata re-test agian.
:'''canbe share''' seed data for other test by seed data tag.
'''How to use:'''
:Save file in s3 (for other dav keep in floder dev name) or testConfig/seedData_config(for admin)

'''Folder'''
*dynamoDBSeedDataTags.json
*graphSeedDataTags.json

'''Example'''
==== dynamoDBSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource dynammodb.
Example
<syntaxhighlight lang="JavaScript">
{
"seedDynamodb_abc_ver2": [ // seedDataTag
{
"tableName": "DelivMethodSTDTestLogicalResultsData", // servcieTag+stage+tablename
"partitionKey": "logicalResultId",
"sortKey": "identifiersId",
"datas": [
{
logicalResultId: {
value: "eeeeeeeeee4"
},
"identifiersId": {
"value: "lllll123456"
},
"processLogicalResultExpiryTimestamp" {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format
}
},
{
logicalResultId: {
value: "eeeeeeeeee4"
},
"identifiersId": {
"value: "lllll777777"
},
"processLogicalResultExpiryTimestamp" {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "add", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format
}
}
],
},
},
{
"tableName": "MLocationsTestFloatingRelationships",// servcieTag+stage+tablename
"partitionKey": "importBatchId",
"sortKey": "identifierRelationshipsId",
"datas": [
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll123456"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll777777"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll99999999"
}
]
},
{
"tableName": "MLocationsTestFindDataMain",
"partitionKey": "findDataId",
"datas": [
{
"findDataId": "111111"
},
{
"findDataId": "22222"
},
{
"findDataId": "333333"
}
]
}
]
}
</syntaxhighlight>

==== graphSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource graphHanler.
Example
<syntaxhighlight lang="JavaScript">
{
"seedData_testTag_GG": [ // seedDataTag
{
"nodes": [
{
"nodeLabels": [
"SellOfferPlan_sellOfferPlanDeliveryMethodLink"
],
"objectDetail": {
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": {
"value": "minttestrefreshSeedData_01",
},
},
"fields": {
"productId": {
"value": "ddddd",
},
"price": {
"value": 9999
},
exampleTimestamp:{
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format
}
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMall"
],
"objectDetail": {
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
},
"fields": {
"name": "hotpot-man",
"totalPrice": 500
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMallCalculateSetting"
],
"objectDetail": {
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
},
"fields": {
"addToCalculatedValuePerOrder": 10,
"addToRateTableValuePerOrder": 77
}
}
}
],
"relationships": [
{
"fromObject": {
"nodeLabel": "SellOfferPlan_sellOfferPlanDeliveryMethodLink",
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": "minttestrefreshSeedData_01"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"relationships": [
{
"relTypeConcat": "SellOfferPlan_hasCCCCCCC",
"relId": "uuid-4s56df74s9df79w-w6de4f5w689ef"
}
]
},
{
"fromObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMallCalculateSetting",
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
}
},
"relationships": [
{
"relTypeConcat": "servcieMintTest_shoppingMall_currentShoppingMallCalculateSetting",
"relId": "uuid-s122df5-s21df",
"relationshipProperty": {
"timeStamp": 1234567879,
"statusName": true
}
},
{
"relTypeConcat": "servcieMintTest_shoppingMall_hasShoppingMallCalculateSetting",
"relId": "uuid-77777-99999",
"relationshipProperties": {
"statusName": {
"value": true
},
exampleTimestamp:{
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format
}
}
}
]
}
]
}
],
"seedData_testTag_ABC": [
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": [
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "hasProductAttributeLink"
},
"relationshipDirection": "to",
"targetObjType": {
"serviceTag": "ProductStandard",
"objectType": "productStandard"
},
"targetIdentifiers": {
"productId": "f526a367a2b66cb0f37ca61b6c43f419929f521d"
},
"relationshipProperties": {}
},
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "isProductAttribute"
},
"relationshipDirection": "from",
"targetObjType": {
"serviceTag": "ProductAttribute",
"objectType": "productAttribute"
},
"targetIdentifiers": {
"productAttributeId": "f4bf7a078071d54036656df544197ba638bc3a68"
},
"relationshipProperties": {}
}
]
},
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": []
}
],
"seedData_testTag_LL": []
}
</syntaxhighlight>

=== Cleaning Seed Data ===
:Delete seed data for set environment of '''test'''.
*cleaningeDynamoOneRecordsTags.json
*cleaningeDynamoManyRecordsTags.json

====cleaningeDynamoOneRecordsTags====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_TestFindData_and_Education_case_invalid01": [
{
"tableName": "MLocationsTestFindDataMain",
"primaryKeys": [
{
"findDataId": "cleaning-1"
},
{
"findDataId": "cleaning-2"
}
]
},
{
"tableName": "MLocationsTestEducation",
"primaryKeys": [
{
"studentId": "cleaning-AA"
},
{
"studentId": "cleaning-BB"
},
{
"studentId": "cleaning-CC"
}
]
}
],
"cleaningSeed_TestMemberPersonnel_case_invalid01": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "namtan",
"passwordId": "qqqww"
},
{
"userId": "jack",
"passwordId": "q1"
},
{
"userId": "Momay",
"passwordId": "ttr"
}
]
}
]
}
</syntaxhighlight>

==== cleaningeDynamoManyRecordsTags ====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_manyData_partitionKey_only_miss_sort": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "many-data"
}
]
}
]
}
</syntaxhighlight>

*logic query table MLocationsTestMemberPersonnel use primary Keys "userId" and then delete all data from primary Keys.

=resources=
syntax is object
<syntaxhighlight lang="JavaScript">
{
"Lambda":{
"{FunctionNameHdrSqs}":{ // FunctionNameHdrSqs is match resourceName in file tests
"localLacation":"/src/FunctionNameHdrSqs.js",
"localHandler":"main",
"functionName":"FunctionNameHdrSqs" // FunctionName is function name match key of function.yml of servcie.
},
"ProcessComplexFilterHdrSqs":{
"localLacation":"/src/ProcessComplexFilterHdrSqs.js",
"localHandler":"main",
"functionName":"ProcessComplexFilterHdrSqs"
},
...
},
"Dynamodb": {
"filterMain":{ // match resourceName in file tests(dynamodbOutputEventIdentifiers)
"tableName":"filterMain"
},
"tableNameBB":{
"tableName":"tableNameBB"
},
...
}
}
</syntaxhighlight>

=events=
Syntax is object
==Syntax Name==
===FileName===
::Event_{inputEventTag}

===eventTag===
#inputEventTag
#outputEventTag
#dynamodbTag

*file events.js is have eventTag (inputEventTag,outputEventTag,dynamodbTag)
**How to create name eventTag
***Example case : "test in service complexFilter functionname ProcessComplexFilter case element type is logical basic".
::*'''inputEventTag'''
::::{serviceName}_{functionName}_{caseTest}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''outputEventTag'''
::::output_{inputEventTag}
''output_Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''dynamodbTag'''
::::{inputEventTag}__Dynamodb__{'''action*'''}_{tableName}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic___Dynamodb__putItem_filterMain''
: '''{action}''' is only ''put'' or ''update'', and in case of ''update'' must only test the last step of update 

=== Syntax event===
====initiate by handlerServcie====
=====Sqs=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Sns
{
"LambdaFunctionHdrSqs_input__pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
},
"propertyB":{
"properties":{
"propertyB1":{
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"value":"msgTag"
},
"propertyD":{
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
<syntaxhighlight lang="JavaScript" linein>
"snsSqsTrigger":true
</syntaxhighlight>

=====Dsq=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Direct Sqs
{
"LambdaFunctionHdrDsq_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"DirectSqs":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrDsq_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
* DirectSqs = true
:: for initialStage of Dsq
* messageAttributes is optional

=====Inv=====
<syntaxhighlight lang="JavaScript">
{
"LambdaFunctionHdrInv_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
}
}
},
{
"output_LambdaFunctionHdrInv_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>

=====Api=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of API
{
"LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"forstageMatvhing": true,
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1",
},
"propertyB": {
"properties": {
"propertyB1": {
"value": "valuePropertyB1",
}
}
},
"propertyC": {
"eventValue": [
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3",
]
},
...
}
}
}
},
"Output_LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1"
},
...
}
}
}
}
}
</syntaxhighlight>

=====S3=====

====dynamodb====
<syntaxhighlight lang="JavaScript">
// An example event of Dynamodb //optional
{
{inputEventTag}__dynamodb_{action}_{tablename}: { // eg. "Complexfilter_ProcessComplexfilter_logical_basic__dynamodb_update_FilterMain"
"forStageMatching": true,
"properties": {
"filterMainUniqueRequestId": {
"testValueMatches": fase,
"value": "bbc4f4a9-2032-4dec-9129-8c7d169fecc5"
},
"filterObject": {
"forStageMatching": true,
"properties": {
"logicalType": {
"value": "partitionKey"
},
"comparison": {
"value": "equals"
},
"type": {
"value": "logical"
},
"partitionKey": {
"forStageMatching": true,
"value": "mockIntegratioTestCPF"
}
}
},
"filterMainExpiryTime": {
"testValueMatches": fase,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": fase,
"value": 1731894402678
},
"objType": {
"forStageMatching": true,
"properties": {
"serviceTag": {
"forStageMatching": true,
"value": "IntTesting"
},
"objectType": {
"forStageMatching": true,
"value": "TestRecord"
}
}
}
},
"keyValues": {
"filterMainId": "4865d2451a621cb7f71225cfabf2df4f98e20801",
"objTypeId": "cdb170690571df7522b3850920fce02507c077ee"
}
}
}
</syntaxhighlight>

* partition key: filterMainId
* sort key: objTypeId

[[2021-01-15 - Integration Testing - Adding DynamoDB result tests]]

===Type paramiter===
use for evnet and dyanmodb event
====Normal====
<syntaxhighlight lang="JavaScript">

object: {
forStageMatching: true,
properties: {
name:{
forStageMatching: true,
value:"Tom"
}
}
},
array: {
forStageMatching: true,
useIsEqual: true,
eventValue: [
{
"relTypeAndDirection": {
"relType": {
"serviceTag": "maxxCart2",
"relationshipTag": "hasCartOrder"
},
"relationshipDirection": "from"
},
"targetObjects": [
{
"objType": {
"serviceTag": "maxxCart2",
"objectType": "cartOrder"
}
}
]
}
]
},
number: {
forStageMatching: true,
value: 1111
},
string: {
forStageMatching: true,
value: "hi"
},
boolean: {
forStageMatching: true,
value: true
}
</syntaxhighlight>

<syntaxhighlight lang="JavaScript">
forStageMatching: true
</syntaxhighlight>
::set true for check match value,It is not necessary to set every value
:::use in test importent paramiter

<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
::setting paramiter require on create but can not test random value eg: identifier or timeStamp or uuid

====Empty====
<syntaxhighlight lang="JavaScript">
EmptyString:{
forStageMatching: true,
value:""
},
EmptyArray:{
forStageMatching: true,
useIsEqual: true,
eventValue: []
},
EmptyObject:{
forStageMatching: true,
value:{}
}
</syntaxhighlight>

====Error====
can test noRetryError
<syntaxhighlight lang="JavaScript">
"errorMessage": {
forStageMatching: true,
"value": "Not found schema of {serviceTag:TestGraphHandler, objectType:notFoundObjType}"
}
</syntaxhighlight>

====Paramiter random====
Can not test case random numbber or uuid.
But requriOnCreate mush be set
<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
or set
<syntaxhighlight lang="JavaScript">
forStageMatching:false
</syntaxhighlight>

=tests=
Syntax is array of object
==Syntax name==
===Testtag name ===
*{integrationTestTag}
#Test Own servcie or not a lot stage
<syntaxhighlight lang="JavaScript">
Test_{inputEventTag}
</syntaxhighlight>
#Mix multiple servcie and multiple stage
<syntaxhighlight lang="JavaScript">
IntegrationTest_{inputEventTag}
</syntaxhighlight>

===File name ===
<syntaxhighlight lang="JavaScript">
{integrationTestTag}.json
</syntaxhighlight>

==Setting of test==
[[Service - Integration Test Config#tests.js Syntax|syntax test]]

<syntaxhighlight lang="JavaScript">
{
integrationTestTag: {integrationTestTag},
productionSafe: true|false, //default false
noInitialStage: true, // default false, if set to true, no error when no foundInitialStages found
errorIfStageUndefined: true|false, //default false
errorIfInvokeUndefined: true|false, //default false,
dynamoDBSeedDataTags:["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
graphSeedDataTags:["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
cleaningeDynamoOneRecordsTags: ["cleaningSeed_partitionKey_sortKey_normol"], //optional
cleaningeDynamoManyRecordsTags: [], // optional
stages:[
...
]
}
</syntaxhighlight>
*[[2025-11-20 IntegrationTest#dynamoDBSeedDataTags|dynamoDBSeedDataTags]]
*[[2025-11-20 IntegrationTest#graphSeedDataTags|graphSeedDataTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoOneRecordsTags|cleaningeDynamoOneRecordsTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoManyRecordsTags|cleaningeDynamoManyRecordsTags]]

==Stages==
====Initiate stage====
:'''"initialStage":true'''
[[Service_-_Integration_Test_Config#tests.js Syntax|detail property of test]]
=====HandlerService=====
======Sqs======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"Locations_ProcessLocationNodeSomting_casenotHaveData",
"serviceName":"Locations",
"resourceType":"Lambda",
"resourceName":"ProcessLocationNodeSomtingHdrDsq",
"outputEventTag":"Output_Locations_ProcessLocationNodeSomting_casenotHaveData"
}
]
</syntaxhighlight>
======Dsq======
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'LambdaFunctionHdrDsq_input_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'LambdaFunctionHdrDsq_output__returnvalue_pass',
// **** not set snsServiceName and snsTopic
// can be test dynamodbOutput
}
]
</syntaxhighlight>

======Api======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrApi_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrApi",
"outputEventTag":"LambdaFunctionHdrApi_output__pass"
}
]
</syntaxhighlight>

======Inv======
*'''single stage'''
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": ["cleaningSeed_partitionKey_sortKey_normol"], //optional
"cleaningeDynamoManyRecordsTags": []
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass"
}
]
}]
</syntaxhighlight>
*'''invoke multiple stage'''
:*Each stage test can invoke multiple lambda by use "eventStage Tag" point to stage for test integration test.
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv_invokes__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": [], //optional
"cleaningeDynamoManyRecordsTags": [], // optional
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass",
"invokes":[
{
"eventStageTag":"service_invokesB__pass"
},
{
"eventStageTag":"service_invokesD__pass"
}
]
},
{
"eventStageTag":"service_invokesB__pass",
"inputEventTag":"input_service_invokes__pass",
"serviceName":"ServiceTemplate_B",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_B_HdrInv",
"outputEventTag":"output_service_invokes__pass"
},
{
"eventStageTag":"service_invokesD__pass",
"inputEventTag":"input_service_invokesD__pass",
"serviceName":"ServiceTemplate_D",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_D_HdrInv",
"outputEventTag":"output_service_invokesD__pass"
}
]
}]
</syntaxhighlight>

======S3======
======Batch======

====GeneratedSeedData====
*Integrationtest must be delete identifier every time before test.
*Set 'generatedSeedData' in file tests.json case by case of stage eg: stages[0] create identifier is randomOnCreate will set 'generatedSeedData' and stages[1] create relationship is randomOnCreate(It is usually random, except in the case of relationship version) set generatedSeedData this stages[1].
*How to delete case identifier rendomOnCreate?: set in stage use setting generateSeedData "randomOnCreateIdentifier"
#randomOnCreateIdentifier
#notRandomOnIdentifier
#relationships
=====randomOnCreateIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"randomOnCreateIdentifier": [
{
"objType": {
"serviceTag": "MLocations",
"objectType": "Member"
},
"identifierValue": "Jaya-member-001"
}
]
}
}
]
</syntaxhighlight>
=====notRandomOnIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"notRandomOnIdentifier": [
{
"objType": {
"serviceTag": "gggg",
"objectType": "ssssss"
},
"identifiers": {
"topId": "123456"
}
}
]
}
}
]
</syntaxhighlight>
=====relationships=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"relationships": [
{
"relType": {
"serviceTag": "PaymentMethodGeneric",
"relationshipTag": "disabledPaymentMethodGenericPropertyValue"
},
"relId": "f4f73de7-647c-4b3b-8043-87cc002f361a"
}
]
}
}
]

</syntaxhighlight>

==Dynamodb==
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'output_Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
dynamodbOutputEventIdentifiers: [
{
serviceName: {tableName}, //service that deployed the DynamoDB table, so can build table's full resource name
resourceName: {resourceName}, //DynamoDB resourceName
eventTag: {eventTagDynamoDB}
}
],
}
]
</syntaxhighlight>

= Result of integrationtest =
Data have 2 table "TestRecord" and "TestUnit".
:- TestRecord is table all unti of stage inside eg input output invokes and dynamodb
:- TestUnit is store status each unit
each unit save in table TestUnit
testRecordId is name of test concat with testTime.
testUnitId is point to position of unti instage.
resultStatus is status of unit.
<syntaxhighlight lang="JavaScript">
eg:
input_0 = stages index 0 result '''input'''
output_1 = stages index 1 result '''output'''
invokeInput_0_1 = stages index 0 result '''invokes''' index 1 position input
invokeOutput_0_1 = stages index 0 result '''invokes''' index 1 position output
dynamodb_0_1 = stages index 0 result '''dynamodb''' index 1.
</syntaxhighlight>

after all TestUnit finish (check by awaitingMultiplestep penditnStep is integrationtestTag awaitingStepId is each TestUnit )
check all awaitingStep finish send message to ultimateIntegrationtest for sumla all test is status

== Summary of test status ==
:1.testStatus is "passed" all unit passed.
:2.testStatus is "failed" have some is failed.
:3.testStatus is "processing" have some is have status processing after check all awaiting step is finish.
:4.testStatus is "failed" have record "errorsTest" in case "not match stage invoke", 'found multiple matchingInvokes

*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

=How to test integrationtest s3=
[[Developer guide for making Integration Tests]]

[[Category:Working documents| 2025-11-20]]
[[Category:Working documents - Integration Testing| 2025-11-20]]

2025-11-20 IntegrationTest

2026-08-11T07:12:33Z

Mint: /* dynamoDBSeedDataTags */

Reference:

*[[2020-10-01 - Integration Test Config - Functions|IntegrationtestConfig]]
*[[2020-10-01 - Integration Testing - Lambda Functions|Integrationtesting]]
*[[2025-02-20 - Integration Test examples|Example]]

= File extension =

uploadS3: ".json"
integrationtestConfig: ".js"

=TestRecord=

<syntaxhighlight lang="JSON">
[
{
integrationTestTag: "Integrationtest_xx",
testStartedTimestamp: 111111111, // start time
bucketName: "integrationtest-config-us-east-2",
lastUpdateUniqueRequestId: "sssss", //_izContext.uniqueRequestId protacts race coditionn dynamodb
testStatus: "passed",//failed,processing,passed
testCompleteTimestamp: 1111113, // all test finish
stages: [
{
stageConfig: {
//straight copy of this stage from integration test config
inputEventTag: "xx",
inputEventConfig: {//event input
},
outputEventTag: "output_xx",
outputEventConfig: {//event out put
},
resourceName: "ComplexfilterTestProcessComplexfilter",// function name
resourceType: "Lambda", // function name
serviceTag: "Complexfilter",// (initeate sqs)
snsServiceName: "Complexfilter",// (initeate sqs)
snsTopic: "PorcessComplexfilter_In"// (initeate sqs)

},
stageStatus: "waiting", //waiting|passed|failed,
stageFinishedTimestamp: 111111111,// time that all tests finished and testRecord.stages.{stageKey}.stageStatus updated
stageResults: {
//results at the point of entering the resource (eg a Lambda function is invoked)
inputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of returning from the resource (eg a Lambda function returns)
outputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of invoking an external resource (eg the tested Lambda function is invoking another Lambda function)
invokes: {
"serviceName_resourceType_resourceName_inputEventTag ": {
invokeTimestamp: 111111111,//{ time result saved },
resultTimestamp: 111111112,//{ time result saved },
resultStatus: "passed",//passed | failed,
invokeParams: {},//{event invoke input config }
requestParams: {}// event invoke input request
},
},
dynamodbResults: [
{
indexOfDynamodbOutput: 0,
requestParams,
resultStatus: "passed",//
resultTimestamp: 22222
}]

},
stageErrors: [
//misc errors encountered
]
}]

}
]
</syntaxhighlight>

=Seed Data=
integrationtest manager seed date 2 process

=== Main Seed Data===
:Save file in s3 (in '''buckname''' :integrationtest-config-us-east-2, '''folder''':seedData_integrationTest).For other dev use service,If a developer wants to add more for other important testing purposes.

'''How to use:'''
#Add it from the s3 bucket at this point
#Run batch refreshSeedData [[Developer guide for making Integration Tests#Bash script|batch RefreshSeedData]]
'''Logic''':Process by storage resouse (graph or dynamodb)
:To clean up the seed data in the table after it creates seed data form service deploy and pulls seed data from s3.

=== Refresh Seed Data ===
:ProcessRefreshSeedData use seedDataTag for create data environment of '''test''' and can be refresh seeddata re-test agian.
:'''canbe share''' seed data for other test by seed data tag.
'''How to use:'''
:Save file in s3 (for other dav keep in floder dev name) or testConfig/seedData_config(for admin)

'''Folder'''
*dynamoDBSeedDataTags.json
*graphSeedDataTags.json

'''Example'''
==== dynamoDBSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource dynammodb.
Example
<syntaxhighlight lang="JavaScript">
{
"seedDynamodb_abc_ver2": [ // seedDataTag
{
"tableName": "DelivMethodSTDTestLogicalResultsData", // servcieTag+stage+tablename
"partitionKey": "logicalResultId",
"sortKey": "identifiersId",
"datas": [
{
logicalResultId: {
value: "eeeeeeeeee4"
},
"identifiersId": {
"value: "lllll123456"
},
"processLogicalResultExpiryTimestamp" {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "subtract", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format
}
},
{
logicalResultId: {
value: "eeeeeeeeee4"
},
"identifiersId": {
"value: "lllll777777"
},
"processLogicalResultExpiryTimestamp" {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "add", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format
}
}
],
},
},
{
"tableName": "MLocationsTestFloatingRelationships",// servcieTag+stage+tablename
"partitionKey": "importBatchId",
"sortKey": "identifierRelationshipsId",
"datas": [
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll123456"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll777777"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll99999999"
}
]
},
{
"tableName": "MLocationsTestFindDataMain",
"partitionKey": "findDataId",
"datas": [
{
"findDataId": "111111"
},
{
"findDataId": "22222"
},
{
"findDataId": "333333"
}
]
}
]
}
</syntaxhighlight>

==== graphSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource graphHanler.
Example
<syntaxhighlight lang="JavaScript">
{
"seedData_testTag_GG": [ // seedDataTag
{
"nodes": [
{
"nodeLabels": [
"SellOfferPlan_sellOfferPlanDeliveryMethodLink"
],
"objectDetail": {
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": "minttestrefreshSeedData_01"
},
"fields": {
"productId": "ddddd",
"price": 9999
}
"calculatedFields": {
"exampleTimestamp": {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "add", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format
},
// ...
},
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMall"
],
"objectDetail": {
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
},
"fields": {
"name": "hotpot-man",
"totalPrice": 500
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMallCalculateSetting"
],
"objectDetail": {
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
},
"fields": {
"addToCalculatedValuePerOrder": 10,
"addToRateTableValuePerOrder": 77
}
}
}
],
"relationships": [
{
"fromObject": {
"nodeLabel": "SellOfferPlan_sellOfferPlanDeliveryMethodLink",
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": "minttestrefreshSeedData_01"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"relationships": [
{
"relTypeConcat": "SellOfferPlan_hasCCCCCCC",
"relId": "uuid-4s56df74s9df79w-w6de4f5w689ef"
}
]
},
{
"fromObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMallCalculateSetting",
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
}
},
"relationships": [
{
"relTypeConcat": "servcieMintTest_shoppingMall_currentShoppingMallCalculateSetting",
"relId": "uuid-s122df5-s21df",
"relationshipProperty": {
"timeStamp": 1234567879,
"statusName": true
}
},
{
"relTypeConcat": "servcieMintTest_shoppingMall_hasShoppingMallCalculateSetting",
"relId": "uuid-77777-99999",
"relationshipProperty": {
"statusName": true
}
"calculatedRelationshipProperties": {
"exampleTimestamp": {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "add", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format
},
// ...
},
}
]
}
]
}
],
"seedData_testTag_ABC": [
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": [
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "hasProductAttributeLink"
},
"relationshipDirection": "to",
"targetObjType": {
"serviceTag": "ProductStandard",
"objectType": "productStandard"
},
"targetIdentifiers": {
"productId": "f526a367a2b66cb0f37ca61b6c43f419929f521d"
},
"relationshipProperties": {}
},
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "isProductAttribute"
},
"relationshipDirection": "from",
"targetObjType": {
"serviceTag": "ProductAttribute",
"objectType": "productAttribute"
},
"targetIdentifiers": {
"productAttributeId": "f4bf7a078071d54036656df544197ba638bc3a68"
},
"relationshipProperties": {}
}
]
},
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": []
}
],
"seedData_testTag_LL": []
}
</syntaxhighlight>

=== Cleaning Seed Data ===
:Delete seed data for set environment of '''test'''.
*cleaningeDynamoOneRecordsTags.json
*cleaningeDynamoManyRecordsTags.json

====cleaningeDynamoOneRecordsTags====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_TestFindData_and_Education_case_invalid01": [
{
"tableName": "MLocationsTestFindDataMain",
"primaryKeys": [
{
"findDataId": "cleaning-1"
},
{
"findDataId": "cleaning-2"
}
]
},
{
"tableName": "MLocationsTestEducation",
"primaryKeys": [
{
"studentId": "cleaning-AA"
},
{
"studentId": "cleaning-BB"
},
{
"studentId": "cleaning-CC"
}
]
}
],
"cleaningSeed_TestMemberPersonnel_case_invalid01": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "namtan",
"passwordId": "qqqww"
},
{
"userId": "jack",
"passwordId": "q1"
},
{
"userId": "Momay",
"passwordId": "ttr"
}
]
}
]
}
</syntaxhighlight>

==== cleaningeDynamoManyRecordsTags ====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_manyData_partitionKey_only_miss_sort": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "many-data"
}
]
}
]
}
</syntaxhighlight>

*logic query table MLocationsTestMemberPersonnel use primary Keys "userId" and then delete all data from primary Keys.

=resources=
syntax is object
<syntaxhighlight lang="JavaScript">
{
"Lambda":{
"{FunctionNameHdrSqs}":{ // FunctionNameHdrSqs is match resourceName in file tests
"localLacation":"/src/FunctionNameHdrSqs.js",
"localHandler":"main",
"functionName":"FunctionNameHdrSqs" // FunctionName is function name match key of function.yml of servcie.
},
"ProcessComplexFilterHdrSqs":{
"localLacation":"/src/ProcessComplexFilterHdrSqs.js",
"localHandler":"main",
"functionName":"ProcessComplexFilterHdrSqs"
},
...
},
"Dynamodb": {
"filterMain":{ // match resourceName in file tests(dynamodbOutputEventIdentifiers)
"tableName":"filterMain"
},
"tableNameBB":{
"tableName":"tableNameBB"
},
...
}
}
</syntaxhighlight>

=events=
Syntax is object
==Syntax Name==
===FileName===
::Event_{inputEventTag}

===eventTag===
#inputEventTag
#outputEventTag
#dynamodbTag

*file events.js is have eventTag (inputEventTag,outputEventTag,dynamodbTag)
**How to create name eventTag
***Example case : "test in service complexFilter functionname ProcessComplexFilter case element type is logical basic".
::*'''inputEventTag'''
::::{serviceName}_{functionName}_{caseTest}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''outputEventTag'''
::::output_{inputEventTag}
''output_Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''dynamodbTag'''
::::{inputEventTag}__Dynamodb__{'''action*'''}_{tableName}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic___Dynamodb__putItem_filterMain''
: '''{action}''' is only ''put'' or ''update'', and in case of ''update'' must only test the last step of update 

=== Syntax event===
====initiate by handlerServcie====
=====Sqs=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Sns
{
"LambdaFunctionHdrSqs_input__pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
},
"propertyB":{
"properties":{
"propertyB1":{
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"value":"msgTag"
},
"propertyD":{
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
<syntaxhighlight lang="JavaScript" linein>
"snsSqsTrigger":true
</syntaxhighlight>

=====Dsq=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Direct Sqs
{
"LambdaFunctionHdrDsq_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"DirectSqs":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrDsq_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
* DirectSqs = true
:: for initialStage of Dsq
* messageAttributes is optional

=====Inv=====
<syntaxhighlight lang="JavaScript">
{
"LambdaFunctionHdrInv_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
}
}
},
{
"output_LambdaFunctionHdrInv_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>

=====Api=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of API
{
"LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"forstageMatvhing": true,
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1",
},
"propertyB": {
"properties": {
"propertyB1": {
"value": "valuePropertyB1",
}
}
},
"propertyC": {
"eventValue": [
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3",
]
},
...
}
}
}
},
"Output_LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1"
},
...
}
}
}
}
}
</syntaxhighlight>

=====S3=====

====dynamodb====
<syntaxhighlight lang="JavaScript">
// An example event of Dynamodb //optional
{
{inputEventTag}__dynamodb_{action}_{tablename}: { // eg. "Complexfilter_ProcessComplexfilter_logical_basic__dynamodb_update_FilterMain"
"forStageMatching": true,
"properties": {
"filterMainUniqueRequestId": {
"testValueMatches": fase,
"value": "bbc4f4a9-2032-4dec-9129-8c7d169fecc5"
},
"filterObject": {
"forStageMatching": true,
"properties": {
"logicalType": {
"value": "partitionKey"
},
"comparison": {
"value": "equals"
},
"type": {
"value": "logical"
},
"partitionKey": {
"forStageMatching": true,
"value": "mockIntegratioTestCPF"
}
}
},
"filterMainExpiryTime": {
"testValueMatches": fase,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": fase,
"value": 1731894402678
},
"objType": {
"forStageMatching": true,
"properties": {
"serviceTag": {
"forStageMatching": true,
"value": "IntTesting"
},
"objectType": {
"forStageMatching": true,
"value": "TestRecord"
}
}
}
},
"keyValues": {
"filterMainId": "4865d2451a621cb7f71225cfabf2df4f98e20801",
"objTypeId": "cdb170690571df7522b3850920fce02507c077ee"
}
}
}
</syntaxhighlight>

* partition key: filterMainId
* sort key: objTypeId

[[2021-01-15 - Integration Testing - Adding DynamoDB result tests]]

===Type paramiter===
use for evnet and dyanmodb event
====Normal====
<syntaxhighlight lang="JavaScript">

object: {
forStageMatching: true,
properties: {
name:{
forStageMatching: true,
value:"Tom"
}
}
},
array: {
forStageMatching: true,
useIsEqual: true,
eventValue: [
{
"relTypeAndDirection": {
"relType": {
"serviceTag": "maxxCart2",
"relationshipTag": "hasCartOrder"
},
"relationshipDirection": "from"
},
"targetObjects": [
{
"objType": {
"serviceTag": "maxxCart2",
"objectType": "cartOrder"
}
}
]
}
]
},
number: {
forStageMatching: true,
value: 1111
},
string: {
forStageMatching: true,
value: "hi"
},
boolean: {
forStageMatching: true,
value: true
}
</syntaxhighlight>

<syntaxhighlight lang="JavaScript">
forStageMatching: true
</syntaxhighlight>
::set true for check match value,It is not necessary to set every value
:::use in test importent paramiter

<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
::setting paramiter require on create but can not test random value eg: identifier or timeStamp or uuid

====Empty====
<syntaxhighlight lang="JavaScript">
EmptyString:{
forStageMatching: true,
value:""
},
EmptyArray:{
forStageMatching: true,
useIsEqual: true,
eventValue: []
},
EmptyObject:{
forStageMatching: true,
value:{}
}
</syntaxhighlight>

====Error====
can test noRetryError
<syntaxhighlight lang="JavaScript">
"errorMessage": {
forStageMatching: true,
"value": "Not found schema of {serviceTag:TestGraphHandler, objectType:notFoundObjType}"
}
</syntaxhighlight>

====Paramiter random====
Can not test case random numbber or uuid.
But requriOnCreate mush be set
<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
or set
<syntaxhighlight lang="JavaScript">
forStageMatching:false
</syntaxhighlight>

=tests=
Syntax is array of object
==Syntax name==
===Testtag name ===
*{integrationTestTag}
#Test Own servcie or not a lot stage
<syntaxhighlight lang="JavaScript">
Test_{inputEventTag}
</syntaxhighlight>
#Mix multiple servcie and multiple stage
<syntaxhighlight lang="JavaScript">
IntegrationTest_{inputEventTag}
</syntaxhighlight>

===File name ===
<syntaxhighlight lang="JavaScript">
{integrationTestTag}.json
</syntaxhighlight>

==Setting of test==
[[Service - Integration Test Config#tests.js Syntax|syntax test]]

<syntaxhighlight lang="JavaScript">
{
integrationTestTag: {integrationTestTag},
productionSafe: true|false, //default false
noInitialStage: true, // default false, if set to true, no error when no foundInitialStages found
errorIfStageUndefined: true|false, //default false
errorIfInvokeUndefined: true|false, //default false,
dynamoDBSeedDataTags:["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
graphSeedDataTags:["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
cleaningeDynamoOneRecordsTags: ["cleaningSeed_partitionKey_sortKey_normol"], //optional
cleaningeDynamoManyRecordsTags: [], // optional
stages:[
...
]
}
</syntaxhighlight>
*[[2025-11-20 IntegrationTest#dynamoDBSeedDataTags|dynamoDBSeedDataTags]]
*[[2025-11-20 IntegrationTest#graphSeedDataTags|graphSeedDataTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoOneRecordsTags|cleaningeDynamoOneRecordsTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoManyRecordsTags|cleaningeDynamoManyRecordsTags]]

==Stages==
====Initiate stage====
:'''"initialStage":true'''
[[Service_-_Integration_Test_Config#tests.js Syntax|detail property of test]]
=====HandlerService=====
======Sqs======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"Locations_ProcessLocationNodeSomting_casenotHaveData",
"serviceName":"Locations",
"resourceType":"Lambda",
"resourceName":"ProcessLocationNodeSomtingHdrDsq",
"outputEventTag":"Output_Locations_ProcessLocationNodeSomting_casenotHaveData"
}
]
</syntaxhighlight>
======Dsq======
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'LambdaFunctionHdrDsq_input_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'LambdaFunctionHdrDsq_output__returnvalue_pass',
// **** not set snsServiceName and snsTopic
// can be test dynamodbOutput
}
]
</syntaxhighlight>

======Api======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrApi_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrApi",
"outputEventTag":"LambdaFunctionHdrApi_output__pass"
}
]
</syntaxhighlight>

======Inv======
*'''single stage'''
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": ["cleaningSeed_partitionKey_sortKey_normol"], //optional
"cleaningeDynamoManyRecordsTags": []
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass"
}
]
}]
</syntaxhighlight>
*'''invoke multiple stage'''
:*Each stage test can invoke multiple lambda by use "eventStage Tag" point to stage for test integration test.
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv_invokes__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": [], //optional
"cleaningeDynamoManyRecordsTags": [], // optional
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass",
"invokes":[
{
"eventStageTag":"service_invokesB__pass"
},
{
"eventStageTag":"service_invokesD__pass"
}
]
},
{
"eventStageTag":"service_invokesB__pass",
"inputEventTag":"input_service_invokes__pass",
"serviceName":"ServiceTemplate_B",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_B_HdrInv",
"outputEventTag":"output_service_invokes__pass"
},
{
"eventStageTag":"service_invokesD__pass",
"inputEventTag":"input_service_invokesD__pass",
"serviceName":"ServiceTemplate_D",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_D_HdrInv",
"outputEventTag":"output_service_invokesD__pass"
}
]
}]
</syntaxhighlight>

======S3======
======Batch======

====GeneratedSeedData====
*Integrationtest must be delete identifier every time before test.
*Set 'generatedSeedData' in file tests.json case by case of stage eg: stages[0] create identifier is randomOnCreate will set 'generatedSeedData' and stages[1] create relationship is randomOnCreate(It is usually random, except in the case of relationship version) set generatedSeedData this stages[1].
*How to delete case identifier rendomOnCreate?: set in stage use setting generateSeedData "randomOnCreateIdentifier"
#randomOnCreateIdentifier
#notRandomOnIdentifier
#relationships
=====randomOnCreateIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"randomOnCreateIdentifier": [
{
"objType": {
"serviceTag": "MLocations",
"objectType": "Member"
},
"identifierValue": "Jaya-member-001"
}
]
}
}
]
</syntaxhighlight>
=====notRandomOnIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"notRandomOnIdentifier": [
{
"objType": {
"serviceTag": "gggg",
"objectType": "ssssss"
},
"identifiers": {
"topId": "123456"
}
}
]
}
}
]
</syntaxhighlight>
=====relationships=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"relationships": [
{
"relType": {
"serviceTag": "PaymentMethodGeneric",
"relationshipTag": "disabledPaymentMethodGenericPropertyValue"
},
"relId": "f4f73de7-647c-4b3b-8043-87cc002f361a"
}
]
}
}
]

</syntaxhighlight>

==Dynamodb==
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'output_Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
dynamodbOutputEventIdentifiers: [
{
serviceName: {tableName}, //service that deployed the DynamoDB table, so can build table's full resource name
resourceName: {resourceName}, //DynamoDB resourceName
eventTag: {eventTagDynamoDB}
}
],
}
]
</syntaxhighlight>

= Result of integrationtest =
Data have 2 table "TestRecord" and "TestUnit".
:- TestRecord is table all unti of stage inside eg input output invokes and dynamodb
:- TestUnit is store status each unit
each unit save in table TestUnit
testRecordId is name of test concat with testTime.
testUnitId is point to position of unti instage.
resultStatus is status of unit.
<syntaxhighlight lang="JavaScript">
eg:
input_0 = stages index 0 result '''input'''
output_1 = stages index 1 result '''output'''
invokeInput_0_1 = stages index 0 result '''invokes''' index 1 position input
invokeOutput_0_1 = stages index 0 result '''invokes''' index 1 position output
dynamodb_0_1 = stages index 0 result '''dynamodb''' index 1.
</syntaxhighlight>

after all TestUnit finish (check by awaitingMultiplestep penditnStep is integrationtestTag awaitingStepId is each TestUnit )
check all awaitingStep finish send message to ultimateIntegrationtest for sumla all test is status

== Summary of test status ==
:1.testStatus is "passed" all unit passed.
:2.testStatus is "failed" have some is failed.
:3.testStatus is "processing" have some is have status processing after check all awaiting step is finish.
:4.testStatus is "failed" have record "errorsTest" in case "not match stage invoke", 'found multiple matchingInvokes

*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

=How to test integrationtest s3=
[[Developer guide for making Integration Tests]]

[[Category:Working documents| 2025-11-20]]
[[Category:Working documents - Integration Testing| 2025-11-20]]

2025-11-20 IntegrationTest

2026-08-11T06:34:21Z

Mint: /* graphSeedDataTags */

Reference:

*[[2020-10-01 - Integration Test Config - Functions|IntegrationtestConfig]]
*[[2020-10-01 - Integration Testing - Lambda Functions|Integrationtesting]]
*[[2025-02-20 - Integration Test examples|Example]]

= File extension =

uploadS3: ".json"
integrationtestConfig: ".js"

=TestRecord=

<syntaxhighlight lang="JSON">
[
{
integrationTestTag: "Integrationtest_xx",
testStartedTimestamp: 111111111, // start time
bucketName: "integrationtest-config-us-east-2",
lastUpdateUniqueRequestId: "sssss", //_izContext.uniqueRequestId protacts race coditionn dynamodb
testStatus: "passed",//failed,processing,passed
testCompleteTimestamp: 1111113, // all test finish
stages: [
{
stageConfig: {
//straight copy of this stage from integration test config
inputEventTag: "xx",
inputEventConfig: {//event input
},
outputEventTag: "output_xx",
outputEventConfig: {//event out put
},
resourceName: "ComplexfilterTestProcessComplexfilter",// function name
resourceType: "Lambda", // function name
serviceTag: "Complexfilter",// (initeate sqs)
snsServiceName: "Complexfilter",// (initeate sqs)
snsTopic: "PorcessComplexfilter_In"// (initeate sqs)

},
stageStatus: "waiting", //waiting|passed|failed,
stageFinishedTimestamp: 111111111,// time that all tests finished and testRecord.stages.{stageKey}.stageStatus updated
stageResults: {
//results at the point of entering the resource (eg a Lambda function is invoked)
inputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of returning from the resource (eg a Lambda function returns)
outputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of invoking an external resource (eg the tested Lambda function is invoking another Lambda function)
invokes: {
"serviceName_resourceType_resourceName_inputEventTag ": {
invokeTimestamp: 111111111,//{ time result saved },
resultTimestamp: 111111112,//{ time result saved },
resultStatus: "passed",//passed | failed,
invokeParams: {},//{event invoke input config }
requestParams: {}// event invoke input request
},
},
dynamodbResults: [
{
indexOfDynamodbOutput: 0,
requestParams,
resultStatus: "passed",//
resultTimestamp: 22222
}]

},
stageErrors: [
//misc errors encountered
]
}]

}
]
</syntaxhighlight>

=Seed Data=
integrationtest manager seed date 2 process

=== Main Seed Data===
:Save file in s3 (in '''buckname''' :integrationtest-config-us-east-2, '''folder''':seedData_integrationTest).For other dev use service,If a developer wants to add more for other important testing purposes.

'''How to use:'''
#Add it from the s3 bucket at this point
#Run batch refreshSeedData [[Developer guide for making Integration Tests#Bash script|batch RefreshSeedData]]
'''Logic''':Process by storage resouse (graph or dynamodb)
:To clean up the seed data in the table after it creates seed data form service deploy and pulls seed data from s3.

=== Refresh Seed Data ===
:ProcessRefreshSeedData use seedDataTag for create data environment of '''test''' and can be refresh seeddata re-test agian.
:'''canbe share''' seed data for other test by seed data tag.
'''How to use:'''
:Save file in s3 (for other dav keep in floder dev name) or testConfig/seedData_config(for admin)

'''Folder'''
*dynamoDBSeedDataTags.json
*graphSeedDataTags.json

'''Example'''
==== dynamoDBSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource dynammodb.
Example
<syntaxhighlight lang="JavaScript">
{
"seedDynamodb_abc_ver2": [ // seedDataTag
{
"tableName": "DelivMethodSTDTestLogicalResultsData", // servcieTag+stage+tablename
"partitionKey": "logicalResultId",
"sortKey": "identifiersId",
"datas": [
{
"logicalResultId": "eeeeeeeeee4",
"identifiersId": "lllll123456"
},
{
"logicalResultId": "eeeeeeeeee4",
"identifiersId": "lllll777777"
}
],
"calculatedDatas": {
"exampleTimestamp": {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "add", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format
},
// ...
},
},
{
"tableName": "MLocationsTestFloatingRelationships",// servcieTag+stage+tablename
"partitionKey": "importBatchId",
"sortKey": "identifierRelationshipsId",
"datas": [
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll123456"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll777777"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll99999999"
}
]
},
{
"tableName": "MLocationsTestFindDataMain",
"partitionKey": "findDataId",
"datas": [
{
"findDataId": "111111"
},
{
"findDataId": "22222"
},
{
"findDataId": "333333"
}
]
}
]
}
</syntaxhighlight>

==== graphSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource graphHanler.
Example
<syntaxhighlight lang="JavaScript">
{
"seedData_testTag_GG": [ // seedDataTag
{
"nodes": [
{
"nodeLabels": [
"SellOfferPlan_sellOfferPlanDeliveryMethodLink"
],
"objectDetail": {
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": "minttestrefreshSeedData_01"
},
"fields": {
"productId": "ddddd",
"price": 9999
}
"calculatedFields": {
"exampleTimestamp": {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "add", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format
},
// ...
},
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMall"
],
"objectDetail": {
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
},
"fields": {
"name": "hotpot-man",
"totalPrice": 500
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMallCalculateSetting"
],
"objectDetail": {
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
},
"fields": {
"addToCalculatedValuePerOrder": 10,
"addToRateTableValuePerOrder": 77
}
}
}
],
"relationships": [
{
"fromObject": {
"nodeLabel": "SellOfferPlan_sellOfferPlanDeliveryMethodLink",
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": "minttestrefreshSeedData_01"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"relationships": [
{
"relTypeConcat": "SellOfferPlan_hasCCCCCCC",
"relId": "uuid-4s56df74s9df79w-w6de4f5w689ef"
}
]
},
{
"fromObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMallCalculateSetting",
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
}
},
"relationships": [
{
"relTypeConcat": "servcieMintTest_shoppingMall_currentShoppingMallCalculateSetting",
"relId": "uuid-s122df5-s21df",
"relationshipProperty": {
"timeStamp": 1234567879,
"statusName": true
}
},
{
"relTypeConcat": "servcieMintTest_shoppingMall_hasShoppingMallCalculateSetting",
"relId": "uuid-77777-99999",
"relationshipProperty": {
"statusName": true
}
"calculatedRelationshipProperties": {
"exampleTimestamp": {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "add", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format
},
// ...
},
}
]
}
]
}
],
"seedData_testTag_ABC": [
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": [
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "hasProductAttributeLink"
},
"relationshipDirection": "to",
"targetObjType": {
"serviceTag": "ProductStandard",
"objectType": "productStandard"
},
"targetIdentifiers": {
"productId": "f526a367a2b66cb0f37ca61b6c43f419929f521d"
},
"relationshipProperties": {}
},
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "isProductAttribute"
},
"relationshipDirection": "from",
"targetObjType": {
"serviceTag": "ProductAttribute",
"objectType": "productAttribute"
},
"targetIdentifiers": {
"productAttributeId": "f4bf7a078071d54036656df544197ba638bc3a68"
},
"relationshipProperties": {}
}
]
},
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": []
}
],
"seedData_testTag_LL": []
}
</syntaxhighlight>

=== Cleaning Seed Data ===
:Delete seed data for set environment of '''test'''.
*cleaningeDynamoOneRecordsTags.json
*cleaningeDynamoManyRecordsTags.json

====cleaningeDynamoOneRecordsTags====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_TestFindData_and_Education_case_invalid01": [
{
"tableName": "MLocationsTestFindDataMain",
"primaryKeys": [
{
"findDataId": "cleaning-1"
},
{
"findDataId": "cleaning-2"
}
]
},
{
"tableName": "MLocationsTestEducation",
"primaryKeys": [
{
"studentId": "cleaning-AA"
},
{
"studentId": "cleaning-BB"
},
{
"studentId": "cleaning-CC"
}
]
}
],
"cleaningSeed_TestMemberPersonnel_case_invalid01": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "namtan",
"passwordId": "qqqww"
},
{
"userId": "jack",
"passwordId": "q1"
},
{
"userId": "Momay",
"passwordId": "ttr"
}
]
}
]
}
</syntaxhighlight>

==== cleaningeDynamoManyRecordsTags ====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_manyData_partitionKey_only_miss_sort": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "many-data"
}
]
}
]
}
</syntaxhighlight>

*logic query table MLocationsTestMemberPersonnel use primary Keys "userId" and then delete all data from primary Keys.

=resources=
syntax is object
<syntaxhighlight lang="JavaScript">
{
"Lambda":{
"{FunctionNameHdrSqs}":{ // FunctionNameHdrSqs is match resourceName in file tests
"localLacation":"/src/FunctionNameHdrSqs.js",
"localHandler":"main",
"functionName":"FunctionNameHdrSqs" // FunctionName is function name match key of function.yml of servcie.
},
"ProcessComplexFilterHdrSqs":{
"localLacation":"/src/ProcessComplexFilterHdrSqs.js",
"localHandler":"main",
"functionName":"ProcessComplexFilterHdrSqs"
},
...
},
"Dynamodb": {
"filterMain":{ // match resourceName in file tests(dynamodbOutputEventIdentifiers)
"tableName":"filterMain"
},
"tableNameBB":{
"tableName":"tableNameBB"
},
...
}
}
</syntaxhighlight>

=events=
Syntax is object
==Syntax Name==
===FileName===
::Event_{inputEventTag}

===eventTag===
#inputEventTag
#outputEventTag
#dynamodbTag

*file events.js is have eventTag (inputEventTag,outputEventTag,dynamodbTag)
**How to create name eventTag
***Example case : "test in service complexFilter functionname ProcessComplexFilter case element type is logical basic".
::*'''inputEventTag'''
::::{serviceName}_{functionName}_{caseTest}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''outputEventTag'''
::::output_{inputEventTag}
''output_Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''dynamodbTag'''
::::{inputEventTag}__Dynamodb__{'''action*'''}_{tableName}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic___Dynamodb__putItem_filterMain''
: '''{action}''' is only ''put'' or ''update'', and in case of ''update'' must only test the last step of update 

=== Syntax event===
====initiate by handlerServcie====
=====Sqs=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Sns
{
"LambdaFunctionHdrSqs_input__pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
},
"propertyB":{
"properties":{
"propertyB1":{
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"value":"msgTag"
},
"propertyD":{
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
<syntaxhighlight lang="JavaScript" linein>
"snsSqsTrigger":true
</syntaxhighlight>

=====Dsq=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Direct Sqs
{
"LambdaFunctionHdrDsq_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"DirectSqs":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrDsq_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
* DirectSqs = true
:: for initialStage of Dsq
* messageAttributes is optional

=====Inv=====
<syntaxhighlight lang="JavaScript">
{
"LambdaFunctionHdrInv_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
}
}
},
{
"output_LambdaFunctionHdrInv_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>

=====Api=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of API
{
"LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"forstageMatvhing": true,
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1",
},
"propertyB": {
"properties": {
"propertyB1": {
"value": "valuePropertyB1",
}
}
},
"propertyC": {
"eventValue": [
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3",
]
},
...
}
}
}
},
"Output_LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1"
},
...
}
}
}
}
}
</syntaxhighlight>

=====S3=====

====dynamodb====
<syntaxhighlight lang="JavaScript">
// An example event of Dynamodb //optional
{
{inputEventTag}__dynamodb_{action}_{tablename}: { // eg. "Complexfilter_ProcessComplexfilter_logical_basic__dynamodb_update_FilterMain"
"forStageMatching": true,
"properties": {
"filterMainUniqueRequestId": {
"testValueMatches": fase,
"value": "bbc4f4a9-2032-4dec-9129-8c7d169fecc5"
},
"filterObject": {
"forStageMatching": true,
"properties": {
"logicalType": {
"value": "partitionKey"
},
"comparison": {
"value": "equals"
},
"type": {
"value": "logical"
},
"partitionKey": {
"forStageMatching": true,
"value": "mockIntegratioTestCPF"
}
}
},
"filterMainExpiryTime": {
"testValueMatches": fase,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": fase,
"value": 1731894402678
},
"objType": {
"forStageMatching": true,
"properties": {
"serviceTag": {
"forStageMatching": true,
"value": "IntTesting"
},
"objectType": {
"forStageMatching": true,
"value": "TestRecord"
}
}
}
},
"keyValues": {
"filterMainId": "4865d2451a621cb7f71225cfabf2df4f98e20801",
"objTypeId": "cdb170690571df7522b3850920fce02507c077ee"
}
}
}
</syntaxhighlight>

* partition key: filterMainId
* sort key: objTypeId

[[2021-01-15 - Integration Testing - Adding DynamoDB result tests]]

===Type paramiter===
use for evnet and dyanmodb event
====Normal====
<syntaxhighlight lang="JavaScript">

object: {
forStageMatching: true,
properties: {
name:{
forStageMatching: true,
value:"Tom"
}
}
},
array: {
forStageMatching: true,
useIsEqual: true,
eventValue: [
{
"relTypeAndDirection": {
"relType": {
"serviceTag": "maxxCart2",
"relationshipTag": "hasCartOrder"
},
"relationshipDirection": "from"
},
"targetObjects": [
{
"objType": {
"serviceTag": "maxxCart2",
"objectType": "cartOrder"
}
}
]
}
]
},
number: {
forStageMatching: true,
value: 1111
},
string: {
forStageMatching: true,
value: "hi"
},
boolean: {
forStageMatching: true,
value: true
}
</syntaxhighlight>

<syntaxhighlight lang="JavaScript">
forStageMatching: true
</syntaxhighlight>
::set true for check match value,It is not necessary to set every value
:::use in test importent paramiter

<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
::setting paramiter require on create but can not test random value eg: identifier or timeStamp or uuid

====Empty====
<syntaxhighlight lang="JavaScript">
EmptyString:{
forStageMatching: true,
value:""
},
EmptyArray:{
forStageMatching: true,
useIsEqual: true,
eventValue: []
},
EmptyObject:{
forStageMatching: true,
value:{}
}
</syntaxhighlight>

====Error====
can test noRetryError
<syntaxhighlight lang="JavaScript">
"errorMessage": {
forStageMatching: true,
"value": "Not found schema of {serviceTag:TestGraphHandler, objectType:notFoundObjType}"
}
</syntaxhighlight>

====Paramiter random====
Can not test case random numbber or uuid.
But requriOnCreate mush be set
<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
or set
<syntaxhighlight lang="JavaScript">
forStageMatching:false
</syntaxhighlight>

=tests=
Syntax is array of object
==Syntax name==
===Testtag name ===
*{integrationTestTag}
#Test Own servcie or not a lot stage
<syntaxhighlight lang="JavaScript">
Test_{inputEventTag}
</syntaxhighlight>
#Mix multiple servcie and multiple stage
<syntaxhighlight lang="JavaScript">
IntegrationTest_{inputEventTag}
</syntaxhighlight>

===File name ===
<syntaxhighlight lang="JavaScript">
{integrationTestTag}.json
</syntaxhighlight>

==Setting of test==
[[Service - Integration Test Config#tests.js Syntax|syntax test]]

<syntaxhighlight lang="JavaScript">
{
integrationTestTag: {integrationTestTag},
productionSafe: true|false, //default false
noInitialStage: true, // default false, if set to true, no error when no foundInitialStages found
errorIfStageUndefined: true|false, //default false
errorIfInvokeUndefined: true|false, //default false,
dynamoDBSeedDataTags:["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
graphSeedDataTags:["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
cleaningeDynamoOneRecordsTags: ["cleaningSeed_partitionKey_sortKey_normol"], //optional
cleaningeDynamoManyRecordsTags: [], // optional
stages:[
...
]
}
</syntaxhighlight>
*[[2025-11-20 IntegrationTest#dynamoDBSeedDataTags|dynamoDBSeedDataTags]]
*[[2025-11-20 IntegrationTest#graphSeedDataTags|graphSeedDataTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoOneRecordsTags|cleaningeDynamoOneRecordsTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoManyRecordsTags|cleaningeDynamoManyRecordsTags]]

==Stages==
====Initiate stage====
:'''"initialStage":true'''
[[Service_-_Integration_Test_Config#tests.js Syntax|detail property of test]]
=====HandlerService=====
======Sqs======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"Locations_ProcessLocationNodeSomting_casenotHaveData",
"serviceName":"Locations",
"resourceType":"Lambda",
"resourceName":"ProcessLocationNodeSomtingHdrDsq",
"outputEventTag":"Output_Locations_ProcessLocationNodeSomting_casenotHaveData"
}
]
</syntaxhighlight>
======Dsq======
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'LambdaFunctionHdrDsq_input_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'LambdaFunctionHdrDsq_output__returnvalue_pass',
// **** not set snsServiceName and snsTopic
// can be test dynamodbOutput
}
]
</syntaxhighlight>

======Api======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrApi_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrApi",
"outputEventTag":"LambdaFunctionHdrApi_output__pass"
}
]
</syntaxhighlight>

======Inv======
*'''single stage'''
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": ["cleaningSeed_partitionKey_sortKey_normol"], //optional
"cleaningeDynamoManyRecordsTags": []
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass"
}
]
}]
</syntaxhighlight>
*'''invoke multiple stage'''
:*Each stage test can invoke multiple lambda by use "eventStage Tag" point to stage for test integration test.
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv_invokes__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": [], //optional
"cleaningeDynamoManyRecordsTags": [], // optional
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass",
"invokes":[
{
"eventStageTag":"service_invokesB__pass"
},
{
"eventStageTag":"service_invokesD__pass"
}
]
},
{
"eventStageTag":"service_invokesB__pass",
"inputEventTag":"input_service_invokes__pass",
"serviceName":"ServiceTemplate_B",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_B_HdrInv",
"outputEventTag":"output_service_invokes__pass"
},
{
"eventStageTag":"service_invokesD__pass",
"inputEventTag":"input_service_invokesD__pass",
"serviceName":"ServiceTemplate_D",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_D_HdrInv",
"outputEventTag":"output_service_invokesD__pass"
}
]
}]
</syntaxhighlight>

======S3======
======Batch======

====GeneratedSeedData====
*Integrationtest must be delete identifier every time before test.
*Set 'generatedSeedData' in file tests.json case by case of stage eg: stages[0] create identifier is randomOnCreate will set 'generatedSeedData' and stages[1] create relationship is randomOnCreate(It is usually random, except in the case of relationship version) set generatedSeedData this stages[1].
*How to delete case identifier rendomOnCreate?: set in stage use setting generateSeedData "randomOnCreateIdentifier"
#randomOnCreateIdentifier
#notRandomOnIdentifier
#relationships
=====randomOnCreateIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"randomOnCreateIdentifier": [
{
"objType": {
"serviceTag": "MLocations",
"objectType": "Member"
},
"identifierValue": "Jaya-member-001"
}
]
}
}
]
</syntaxhighlight>
=====notRandomOnIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"notRandomOnIdentifier": [
{
"objType": {
"serviceTag": "gggg",
"objectType": "ssssss"
},
"identifiers": {
"topId": "123456"
}
}
]
}
}
]
</syntaxhighlight>
=====relationships=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"relationships": [
{
"relType": {
"serviceTag": "PaymentMethodGeneric",
"relationshipTag": "disabledPaymentMethodGenericPropertyValue"
},
"relId": "f4f73de7-647c-4b3b-8043-87cc002f361a"
}
]
}
}
]

</syntaxhighlight>

==Dynamodb==
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'output_Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
dynamodbOutputEventIdentifiers: [
{
serviceName: {tableName}, //service that deployed the DynamoDB table, so can build table's full resource name
resourceName: {resourceName}, //DynamoDB resourceName
eventTag: {eventTagDynamoDB}
}
],
}
]
</syntaxhighlight>

= Result of integrationtest =
Data have 2 table "TestRecord" and "TestUnit".
:- TestRecord is table all unti of stage inside eg input output invokes and dynamodb
:- TestUnit is store status each unit
each unit save in table TestUnit
testRecordId is name of test concat with testTime.
testUnitId is point to position of unti instage.
resultStatus is status of unit.
<syntaxhighlight lang="JavaScript">
eg:
input_0 = stages index 0 result '''input'''
output_1 = stages index 1 result '''output'''
invokeInput_0_1 = stages index 0 result '''invokes''' index 1 position input
invokeOutput_0_1 = stages index 0 result '''invokes''' index 1 position output
dynamodb_0_1 = stages index 0 result '''dynamodb''' index 1.
</syntaxhighlight>

after all TestUnit finish (check by awaitingMultiplestep penditnStep is integrationtestTag awaitingStepId is each TestUnit )
check all awaitingStep finish send message to ultimateIntegrationtest for sumla all test is status

== Summary of test status ==
:1.testStatus is "passed" all unit passed.
:2.testStatus is "failed" have some is failed.
:3.testStatus is "processing" have some is have status processing after check all awaiting step is finish.
:4.testStatus is "failed" have record "errorsTest" in case "not match stage invoke", 'found multiple matchingInvokes

*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

=How to test integrationtest s3=
[[Developer guide for making Integration Tests]]

[[Category:Working documents| 2025-11-20]]
[[Category:Working documents - Integration Testing| 2025-11-20]]

2025-11-20 IntegrationTest

2026-08-11T06:29:23Z

Mint: /* graphSeedDataTags */

Reference:

*[[2020-10-01 - Integration Test Config - Functions|IntegrationtestConfig]]
*[[2020-10-01 - Integration Testing - Lambda Functions|Integrationtesting]]
*[[2025-02-20 - Integration Test examples|Example]]

= File extension =

uploadS3: ".json"
integrationtestConfig: ".js"

=TestRecord=

<syntaxhighlight lang="JSON">
[
{
integrationTestTag: "Integrationtest_xx",
testStartedTimestamp: 111111111, // start time
bucketName: "integrationtest-config-us-east-2",
lastUpdateUniqueRequestId: "sssss", //_izContext.uniqueRequestId protacts race coditionn dynamodb
testStatus: "passed",//failed,processing,passed
testCompleteTimestamp: 1111113, // all test finish
stages: [
{
stageConfig: {
//straight copy of this stage from integration test config
inputEventTag: "xx",
inputEventConfig: {//event input
},
outputEventTag: "output_xx",
outputEventConfig: {//event out put
},
resourceName: "ComplexfilterTestProcessComplexfilter",// function name
resourceType: "Lambda", // function name
serviceTag: "Complexfilter",// (initeate sqs)
snsServiceName: "Complexfilter",// (initeate sqs)
snsTopic: "PorcessComplexfilter_In"// (initeate sqs)

},
stageStatus: "waiting", //waiting|passed|failed,
stageFinishedTimestamp: 111111111,// time that all tests finished and testRecord.stages.{stageKey}.stageStatus updated
stageResults: {
//results at the point of entering the resource (eg a Lambda function is invoked)
inputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of returning from the resource (eg a Lambda function returns)
outputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of invoking an external resource (eg the tested Lambda function is invoking another Lambda function)
invokes: {
"serviceName_resourceType_resourceName_inputEventTag ": {
invokeTimestamp: 111111111,//{ time result saved },
resultTimestamp: 111111112,//{ time result saved },
resultStatus: "passed",//passed | failed,
invokeParams: {},//{event invoke input config }
requestParams: {}// event invoke input request
},
},
dynamodbResults: [
{
indexOfDynamodbOutput: 0,
requestParams,
resultStatus: "passed",//
resultTimestamp: 22222
}]

},
stageErrors: [
//misc errors encountered
]
}]

}
]
</syntaxhighlight>

=Seed Data=
integrationtest manager seed date 2 process

=== Main Seed Data===
:Save file in s3 (in '''buckname''' :integrationtest-config-us-east-2, '''folder''':seedData_integrationTest).For other dev use service,If a developer wants to add more for other important testing purposes.

'''How to use:'''
#Add it from the s3 bucket at this point
#Run batch refreshSeedData [[Developer guide for making Integration Tests#Bash script|batch RefreshSeedData]]
'''Logic''':Process by storage resouse (graph or dynamodb)
:To clean up the seed data in the table after it creates seed data form service deploy and pulls seed data from s3.

=== Refresh Seed Data ===
:ProcessRefreshSeedData use seedDataTag for create data environment of '''test''' and can be refresh seeddata re-test agian.
:'''canbe share''' seed data for other test by seed data tag.
'''How to use:'''
:Save file in s3 (for other dav keep in floder dev name) or testConfig/seedData_config(for admin)

'''Folder'''
*dynamoDBSeedDataTags.json
*graphSeedDataTags.json

'''Example'''
==== dynamoDBSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource dynammodb.
Example
<syntaxhighlight lang="JavaScript">
{
"seedDynamodb_abc_ver2": [ // seedDataTag
{
"tableName": "DelivMethodSTDTestLogicalResultsData", // servcieTag+stage+tablename
"partitionKey": "logicalResultId",
"sortKey": "identifiersId",
"datas": [
{
"logicalResultId": "eeeeeeeeee4",
"identifiersId": "lllll123456"
},
{
"logicalResultId": "eeeeeeeeee4",
"identifiersId": "lllll777777"
}
],
"calculatedDatas": {
"exampleTimestamp": {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "add", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format
},
// ...
},
},
{
"tableName": "MLocationsTestFloatingRelationships",// servcieTag+stage+tablename
"partitionKey": "importBatchId",
"sortKey": "identifierRelationshipsId",
"datas": [
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll123456"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll777777"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll99999999"
}
]
},
{
"tableName": "MLocationsTestFindDataMain",
"partitionKey": "findDataId",
"datas": [
{
"findDataId": "111111"
},
{
"findDataId": "22222"
},
{
"findDataId": "333333"
}
]
}
]
}
</syntaxhighlight>

==== graphSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource graphHanler.
Example
<syntaxhighlight lang="JavaScript">
{
"seedData_testTag_GG": [ // seedDataTag
{
"nodes": [
{
"nodeLabels": [
"SellOfferPlan_sellOfferPlanDeliveryMethodLink"
],
"objectDetail": {
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": "minttestrefreshSeedData_01"
},
"fields": {
"productId": "ddddd",
"price": 9999
}
"calculatedFields": {
"exampleTimestamp": {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "add", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format
},
// ...
},
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMall"
],
"objectDetail": {
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
},
"fields": {
"name": "hotpot-man",
"totalPrice": 500
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMallCalculateSetting"
],
"objectDetail": {
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
},
"fields": {
"addToCalculatedValuePerOrder": 10,
"addToRateTableValuePerOrder": 77
}
}
}
],
"relationships": [
{
"fromObject": {
"nodeLabel": "SellOfferPlan_sellOfferPlanDeliveryMethodLink",
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": "minttestrefreshSeedData_01"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"relationships": [
{
"relTypeConcat": "SellOfferPlan_hasCCCCCCC",
"relId": "uuid-4s56df74s9df79w-w6de4f5w689ef"
}
]
},
{
"fromObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMallCalculateSetting",
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
}
},
"relationships": [
{
"relTypeConcat": "servcieMintTest_shoppingMall_currentShoppingMallCalculateSetting",
"relId": "uuid-s122df5-s21df",
"relationshipProperty": {
"timeStamp": 1234567879,
"statusName": true
}
},
{
"relTypeConcat": "servcieMintTest_shoppingMall_hasShoppingMallCalculateSetting",
"relId": "uuid-77777-99999",
"relationshipProperty": {
"statusName": true
}
}
]
}
]
}
],
"seedData_testTag_ABC": [
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": [
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "hasProductAttributeLink"
},
"relationshipDirection": "to",
"targetObjType": {
"serviceTag": "ProductStandard",
"objectType": "productStandard"
},
"targetIdentifiers": {
"productId": "f526a367a2b66cb0f37ca61b6c43f419929f521d"
},
"relationshipProperties": {}
},
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "isProductAttribute"
},
"relationshipDirection": "from",
"targetObjType": {
"serviceTag": "ProductAttribute",
"objectType": "productAttribute"
},
"targetIdentifiers": {
"productAttributeId": "f4bf7a078071d54036656df544197ba638bc3a68"
},
"relationshipProperties": {}
}
]
},
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": []
}
],
"seedData_testTag_LL": []
}
</syntaxhighlight>

=== Cleaning Seed Data ===
:Delete seed data for set environment of '''test'''.
*cleaningeDynamoOneRecordsTags.json
*cleaningeDynamoManyRecordsTags.json

====cleaningeDynamoOneRecordsTags====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_TestFindData_and_Education_case_invalid01": [
{
"tableName": "MLocationsTestFindDataMain",
"primaryKeys": [
{
"findDataId": "cleaning-1"
},
{
"findDataId": "cleaning-2"
}
]
},
{
"tableName": "MLocationsTestEducation",
"primaryKeys": [
{
"studentId": "cleaning-AA"
},
{
"studentId": "cleaning-BB"
},
{
"studentId": "cleaning-CC"
}
]
}
],
"cleaningSeed_TestMemberPersonnel_case_invalid01": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "namtan",
"passwordId": "qqqww"
},
{
"userId": "jack",
"passwordId": "q1"
},
{
"userId": "Momay",
"passwordId": "ttr"
}
]
}
]
}
</syntaxhighlight>

==== cleaningeDynamoManyRecordsTags ====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_manyData_partitionKey_only_miss_sort": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "many-data"
}
]
}
]
}
</syntaxhighlight>

*logic query table MLocationsTestMemberPersonnel use primary Keys "userId" and then delete all data from primary Keys.

=resources=
syntax is object
<syntaxhighlight lang="JavaScript">
{
"Lambda":{
"{FunctionNameHdrSqs}":{ // FunctionNameHdrSqs is match resourceName in file tests
"localLacation":"/src/FunctionNameHdrSqs.js",
"localHandler":"main",
"functionName":"FunctionNameHdrSqs" // FunctionName is function name match key of function.yml of servcie.
},
"ProcessComplexFilterHdrSqs":{
"localLacation":"/src/ProcessComplexFilterHdrSqs.js",
"localHandler":"main",
"functionName":"ProcessComplexFilterHdrSqs"
},
...
},
"Dynamodb": {
"filterMain":{ // match resourceName in file tests(dynamodbOutputEventIdentifiers)
"tableName":"filterMain"
},
"tableNameBB":{
"tableName":"tableNameBB"
},
...
}
}
</syntaxhighlight>

=events=
Syntax is object
==Syntax Name==
===FileName===
::Event_{inputEventTag}

===eventTag===
#inputEventTag
#outputEventTag
#dynamodbTag

*file events.js is have eventTag (inputEventTag,outputEventTag,dynamodbTag)
**How to create name eventTag
***Example case : "test in service complexFilter functionname ProcessComplexFilter case element type is logical basic".
::*'''inputEventTag'''
::::{serviceName}_{functionName}_{caseTest}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''outputEventTag'''
::::output_{inputEventTag}
''output_Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''dynamodbTag'''
::::{inputEventTag}__Dynamodb__{'''action*'''}_{tableName}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic___Dynamodb__putItem_filterMain''
: '''{action}''' is only ''put'' or ''update'', and in case of ''update'' must only test the last step of update 

=== Syntax event===
====initiate by handlerServcie====
=====Sqs=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Sns
{
"LambdaFunctionHdrSqs_input__pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
},
"propertyB":{
"properties":{
"propertyB1":{
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"value":"msgTag"
},
"propertyD":{
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
<syntaxhighlight lang="JavaScript" linein>
"snsSqsTrigger":true
</syntaxhighlight>

=====Dsq=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Direct Sqs
{
"LambdaFunctionHdrDsq_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"DirectSqs":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrDsq_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
* DirectSqs = true
:: for initialStage of Dsq
* messageAttributes is optional

=====Inv=====
<syntaxhighlight lang="JavaScript">
{
"LambdaFunctionHdrInv_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
}
}
},
{
"output_LambdaFunctionHdrInv_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>

=====Api=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of API
{
"LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"forstageMatvhing": true,
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1",
},
"propertyB": {
"properties": {
"propertyB1": {
"value": "valuePropertyB1",
}
}
},
"propertyC": {
"eventValue": [
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3",
]
},
...
}
}
}
},
"Output_LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1"
},
...
}
}
}
}
}
</syntaxhighlight>

=====S3=====

====dynamodb====
<syntaxhighlight lang="JavaScript">
// An example event of Dynamodb //optional
{
{inputEventTag}__dynamodb_{action}_{tablename}: { // eg. "Complexfilter_ProcessComplexfilter_logical_basic__dynamodb_update_FilterMain"
"forStageMatching": true,
"properties": {
"filterMainUniqueRequestId": {
"testValueMatches": fase,
"value": "bbc4f4a9-2032-4dec-9129-8c7d169fecc5"
},
"filterObject": {
"forStageMatching": true,
"properties": {
"logicalType": {
"value": "partitionKey"
},
"comparison": {
"value": "equals"
},
"type": {
"value": "logical"
},
"partitionKey": {
"forStageMatching": true,
"value": "mockIntegratioTestCPF"
}
}
},
"filterMainExpiryTime": {
"testValueMatches": fase,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": fase,
"value": 1731894402678
},
"objType": {
"forStageMatching": true,
"properties": {
"serviceTag": {
"forStageMatching": true,
"value": "IntTesting"
},
"objectType": {
"forStageMatching": true,
"value": "TestRecord"
}
}
}
},
"keyValues": {
"filterMainId": "4865d2451a621cb7f71225cfabf2df4f98e20801",
"objTypeId": "cdb170690571df7522b3850920fce02507c077ee"
}
}
}
</syntaxhighlight>

* partition key: filterMainId
* sort key: objTypeId

[[2021-01-15 - Integration Testing - Adding DynamoDB result tests]]

===Type paramiter===
use for evnet and dyanmodb event
====Normal====
<syntaxhighlight lang="JavaScript">

object: {
forStageMatching: true,
properties: {
name:{
forStageMatching: true,
value:"Tom"
}
}
},
array: {
forStageMatching: true,
useIsEqual: true,
eventValue: [
{
"relTypeAndDirection": {
"relType": {
"serviceTag": "maxxCart2",
"relationshipTag": "hasCartOrder"
},
"relationshipDirection": "from"
},
"targetObjects": [
{
"objType": {
"serviceTag": "maxxCart2",
"objectType": "cartOrder"
}
}
]
}
]
},
number: {
forStageMatching: true,
value: 1111
},
string: {
forStageMatching: true,
value: "hi"
},
boolean: {
forStageMatching: true,
value: true
}
</syntaxhighlight>

<syntaxhighlight lang="JavaScript">
forStageMatching: true
</syntaxhighlight>
::set true for check match value,It is not necessary to set every value
:::use in test importent paramiter

<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
::setting paramiter require on create but can not test random value eg: identifier or timeStamp or uuid

====Empty====
<syntaxhighlight lang="JavaScript">
EmptyString:{
forStageMatching: true,
value:""
},
EmptyArray:{
forStageMatching: true,
useIsEqual: true,
eventValue: []
},
EmptyObject:{
forStageMatching: true,
value:{}
}
</syntaxhighlight>

====Error====
can test noRetryError
<syntaxhighlight lang="JavaScript">
"errorMessage": {
forStageMatching: true,
"value": "Not found schema of {serviceTag:TestGraphHandler, objectType:notFoundObjType}"
}
</syntaxhighlight>

====Paramiter random====
Can not test case random numbber or uuid.
But requriOnCreate mush be set
<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
or set
<syntaxhighlight lang="JavaScript">
forStageMatching:false
</syntaxhighlight>

=tests=
Syntax is array of object
==Syntax name==
===Testtag name ===
*{integrationTestTag}
#Test Own servcie or not a lot stage
<syntaxhighlight lang="JavaScript">
Test_{inputEventTag}
</syntaxhighlight>
#Mix multiple servcie and multiple stage
<syntaxhighlight lang="JavaScript">
IntegrationTest_{inputEventTag}
</syntaxhighlight>

===File name ===
<syntaxhighlight lang="JavaScript">
{integrationTestTag}.json
</syntaxhighlight>

==Setting of test==
[[Service - Integration Test Config#tests.js Syntax|syntax test]]

<syntaxhighlight lang="JavaScript">
{
integrationTestTag: {integrationTestTag},
productionSafe: true|false, //default false
noInitialStage: true, // default false, if set to true, no error when no foundInitialStages found
errorIfStageUndefined: true|false, //default false
errorIfInvokeUndefined: true|false, //default false,
dynamoDBSeedDataTags:["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
graphSeedDataTags:["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
cleaningeDynamoOneRecordsTags: ["cleaningSeed_partitionKey_sortKey_normol"], //optional
cleaningeDynamoManyRecordsTags: [], // optional
stages:[
...
]
}
</syntaxhighlight>
*[[2025-11-20 IntegrationTest#dynamoDBSeedDataTags|dynamoDBSeedDataTags]]
*[[2025-11-20 IntegrationTest#graphSeedDataTags|graphSeedDataTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoOneRecordsTags|cleaningeDynamoOneRecordsTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoManyRecordsTags|cleaningeDynamoManyRecordsTags]]

==Stages==
====Initiate stage====
:'''"initialStage":true'''
[[Service_-_Integration_Test_Config#tests.js Syntax|detail property of test]]
=====HandlerService=====
======Sqs======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"Locations_ProcessLocationNodeSomting_casenotHaveData",
"serviceName":"Locations",
"resourceType":"Lambda",
"resourceName":"ProcessLocationNodeSomtingHdrDsq",
"outputEventTag":"Output_Locations_ProcessLocationNodeSomting_casenotHaveData"
}
]
</syntaxhighlight>
======Dsq======
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'LambdaFunctionHdrDsq_input_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'LambdaFunctionHdrDsq_output__returnvalue_pass',
// **** not set snsServiceName and snsTopic
// can be test dynamodbOutput
}
]
</syntaxhighlight>

======Api======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrApi_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrApi",
"outputEventTag":"LambdaFunctionHdrApi_output__pass"
}
]
</syntaxhighlight>

======Inv======
*'''single stage'''
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": ["cleaningSeed_partitionKey_sortKey_normol"], //optional
"cleaningeDynamoManyRecordsTags": []
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass"
}
]
}]
</syntaxhighlight>
*'''invoke multiple stage'''
:*Each stage test can invoke multiple lambda by use "eventStage Tag" point to stage for test integration test.
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv_invokes__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": [], //optional
"cleaningeDynamoManyRecordsTags": [], // optional
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass",
"invokes":[
{
"eventStageTag":"service_invokesB__pass"
},
{
"eventStageTag":"service_invokesD__pass"
}
]
},
{
"eventStageTag":"service_invokesB__pass",
"inputEventTag":"input_service_invokes__pass",
"serviceName":"ServiceTemplate_B",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_B_HdrInv",
"outputEventTag":"output_service_invokes__pass"
},
{
"eventStageTag":"service_invokesD__pass",
"inputEventTag":"input_service_invokesD__pass",
"serviceName":"ServiceTemplate_D",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_D_HdrInv",
"outputEventTag":"output_service_invokesD__pass"
}
]
}]
</syntaxhighlight>

======S3======
======Batch======

====GeneratedSeedData====
*Integrationtest must be delete identifier every time before test.
*Set 'generatedSeedData' in file tests.json case by case of stage eg: stages[0] create identifier is randomOnCreate will set 'generatedSeedData' and stages[1] create relationship is randomOnCreate(It is usually random, except in the case of relationship version) set generatedSeedData this stages[1].
*How to delete case identifier rendomOnCreate?: set in stage use setting generateSeedData "randomOnCreateIdentifier"
#randomOnCreateIdentifier
#notRandomOnIdentifier
#relationships
=====randomOnCreateIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"randomOnCreateIdentifier": [
{
"objType": {
"serviceTag": "MLocations",
"objectType": "Member"
},
"identifierValue": "Jaya-member-001"
}
]
}
}
]
</syntaxhighlight>
=====notRandomOnIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"notRandomOnIdentifier": [
{
"objType": {
"serviceTag": "gggg",
"objectType": "ssssss"
},
"identifiers": {
"topId": "123456"
}
}
]
}
}
]
</syntaxhighlight>
=====relationships=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"relationships": [
{
"relType": {
"serviceTag": "PaymentMethodGeneric",
"relationshipTag": "disabledPaymentMethodGenericPropertyValue"
},
"relId": "f4f73de7-647c-4b3b-8043-87cc002f361a"
}
]
}
}
]

</syntaxhighlight>

==Dynamodb==
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'output_Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
dynamodbOutputEventIdentifiers: [
{
serviceName: {tableName}, //service that deployed the DynamoDB table, so can build table's full resource name
resourceName: {resourceName}, //DynamoDB resourceName
eventTag: {eventTagDynamoDB}
}
],
}
]
</syntaxhighlight>

= Result of integrationtest =
Data have 2 table "TestRecord" and "TestUnit".
:- TestRecord is table all unti of stage inside eg input output invokes and dynamodb
:- TestUnit is store status each unit
each unit save in table TestUnit
testRecordId is name of test concat with testTime.
testUnitId is point to position of unti instage.
resultStatus is status of unit.
<syntaxhighlight lang="JavaScript">
eg:
input_0 = stages index 0 result '''input'''
output_1 = stages index 1 result '''output'''
invokeInput_0_1 = stages index 0 result '''invokes''' index 1 position input
invokeOutput_0_1 = stages index 0 result '''invokes''' index 1 position output
dynamodb_0_1 = stages index 0 result '''dynamodb''' index 1.
</syntaxhighlight>

after all TestUnit finish (check by awaitingMultiplestep penditnStep is integrationtestTag awaitingStepId is each TestUnit )
check all awaitingStep finish send message to ultimateIntegrationtest for sumla all test is status

== Summary of test status ==
:1.testStatus is "passed" all unit passed.
:2.testStatus is "failed" have some is failed.
:3.testStatus is "processing" have some is have status processing after check all awaiting step is finish.
:4.testStatus is "failed" have record "errorsTest" in case "not match stage invoke", 'found multiple matchingInvokes

*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

=How to test integrationtest s3=
[[Developer guide for making Integration Tests]]

[[Category:Working documents| 2025-11-20]]
[[Category:Working documents - Integration Testing| 2025-11-20]]

2025-11-20 IntegrationTest

2026-08-11T06:26:52Z

Mint: /* dynamoDBSeedDataTags */

Reference:

*[[2020-10-01 - Integration Test Config - Functions|IntegrationtestConfig]]
*[[2020-10-01 - Integration Testing - Lambda Functions|Integrationtesting]]
*[[2025-02-20 - Integration Test examples|Example]]

= File extension =

uploadS3: ".json"
integrationtestConfig: ".js"

=TestRecord=

<syntaxhighlight lang="JSON">
[
{
integrationTestTag: "Integrationtest_xx",
testStartedTimestamp: 111111111, // start time
bucketName: "integrationtest-config-us-east-2",
lastUpdateUniqueRequestId: "sssss", //_izContext.uniqueRequestId protacts race coditionn dynamodb
testStatus: "passed",//failed,processing,passed
testCompleteTimestamp: 1111113, // all test finish
stages: [
{
stageConfig: {
//straight copy of this stage from integration test config
inputEventTag: "xx",
inputEventConfig: {//event input
},
outputEventTag: "output_xx",
outputEventConfig: {//event out put
},
resourceName: "ComplexfilterTestProcessComplexfilter",// function name
resourceType: "Lambda", // function name
serviceTag: "Complexfilter",// (initeate sqs)
snsServiceName: "Complexfilter",// (initeate sqs)
snsTopic: "PorcessComplexfilter_In"// (initeate sqs)

},
stageStatus: "waiting", //waiting|passed|failed,
stageFinishedTimestamp: 111111111,// time that all tests finished and testRecord.stages.{stageKey}.stageStatus updated
stageResults: {
//results at the point of entering the resource (eg a Lambda function is invoked)
inputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of returning from the resource (eg a Lambda function returns)
outputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of invoking an external resource (eg the tested Lambda function is invoking another Lambda function)
invokes: {
"serviceName_resourceType_resourceName_inputEventTag ": {
invokeTimestamp: 111111111,//{ time result saved },
resultTimestamp: 111111112,//{ time result saved },
resultStatus: "passed",//passed | failed,
invokeParams: {},//{event invoke input config }
requestParams: {}// event invoke input request
},
},
dynamodbResults: [
{
indexOfDynamodbOutput: 0,
requestParams,
resultStatus: "passed",//
resultTimestamp: 22222
}]

},
stageErrors: [
//misc errors encountered
]
}]

}
]
</syntaxhighlight>

=Seed Data=
integrationtest manager seed date 2 process

=== Main Seed Data===
:Save file in s3 (in '''buckname''' :integrationtest-config-us-east-2, '''folder''':seedData_integrationTest).For other dev use service,If a developer wants to add more for other important testing purposes.

'''How to use:'''
#Add it from the s3 bucket at this point
#Run batch refreshSeedData [[Developer guide for making Integration Tests#Bash script|batch RefreshSeedData]]
'''Logic''':Process by storage resouse (graph or dynamodb)
:To clean up the seed data in the table after it creates seed data form service deploy and pulls seed data from s3.

=== Refresh Seed Data ===
:ProcessRefreshSeedData use seedDataTag for create data environment of '''test''' and can be refresh seeddata re-test agian.
:'''canbe share''' seed data for other test by seed data tag.
'''How to use:'''
:Save file in s3 (for other dav keep in floder dev name) or testConfig/seedData_config(for admin)

'''Folder'''
*dynamoDBSeedDataTags.json
*graphSeedDataTags.json

'''Example'''
==== dynamoDBSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource dynammodb.
Example
<syntaxhighlight lang="JavaScript">
{
"seedDynamodb_abc_ver2": [ // seedDataTag
{
"tableName": "DelivMethodSTDTestLogicalResultsData", // servcieTag+stage+tablename
"partitionKey": "logicalResultId",
"sortKey": "identifiersId",
"datas": [
{
"logicalResultId": "eeeeeeeeee4",
"identifiersId": "lllll123456"
},
{
"logicalResultId": "eeeeeeeeee4",
"identifiersId": "lllll777777"
}
],
"calculatedDatas": {
"exampleTimestamp": {
calcType: "currentTimestampAdjustment", // can add other types of calculated data in future
action: "add", // add|subtract
adjustment: "2 days", // Human-Readable Relative Format
},
// ...
},
},
{
"tableName": "MLocationsTestFloatingRelationships",// servcieTag+stage+tablename
"partitionKey": "importBatchId",
"sortKey": "identifierRelationshipsId",
"datas": [
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll123456"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll777777"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll99999999"
}
]
},
{
"tableName": "MLocationsTestFindDataMain",
"partitionKey": "findDataId",
"datas": [
{
"findDataId": "111111"
},
{
"findDataId": "22222"
},
{
"findDataId": "333333"
}
]
}
]
}
</syntaxhighlight>

==== graphSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource graphHanler.
Example
<syntaxhighlight lang="JavaScript">
{
"seedData_testTag_GG": [ // seedDataTag
{
"nodes": [
{
"nodeLabels": [
"SellOfferPlan_sellOfferPlanDeliveryMethodLink"
],
"objectDetail": {
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": "minttestrefreshSeedData_01"
},
"fields": {
"productId": "ddddd",
"price": 9999
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMall"
],
"objectDetail": {
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
},
"fields": {
"name": "hotpot-man",
"totalPrice": 500
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMallCalculateSetting"
],
"objectDetail": {
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
},
"fields": {
"addToCalculatedValuePerOrder": 10,
"addToRateTableValuePerOrder": 77
}
}
}
],
"relationships": [
{
"fromObject": {
"nodeLabel": "SellOfferPlan_sellOfferPlanDeliveryMethodLink",
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": "minttestrefreshSeedData_01"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"relationships": [
{
"relTypeConcat": "SellOfferPlan_hasCCCCCCC",
"relId": "uuid-4s56df74s9df79w-w6de4f5w689ef"
}
]
},
{
"fromObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMallCalculateSetting",
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
}
},
"relationships": [
{
"relTypeConcat": "servcieMintTest_shoppingMall_currentShoppingMallCalculateSetting",
"relId": "uuid-s122df5-s21df",
"relationshipProperty": {
"timeStamp": 1234567879,
"statusName": true
}
},
{
"relTypeConcat": "servcieMintTest_shoppingMall_hasShoppingMallCalculateSetting",
"relId": "uuid-77777-99999",
"relationshipProperty": {
"statusName": true
}
}
]
}
]
}
],
"seedData_testTag_ABC": [
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": [
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "hasProductAttributeLink"
},
"relationshipDirection": "to",
"targetObjType": {
"serviceTag": "ProductStandard",
"objectType": "productStandard"
},
"targetIdentifiers": {
"productId": "f526a367a2b66cb0f37ca61b6c43f419929f521d"
},
"relationshipProperties": {}
},
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "isProductAttribute"
},
"relationshipDirection": "from",
"targetObjType": {
"serviceTag": "ProductAttribute",
"objectType": "productAttribute"
},
"targetIdentifiers": {
"productAttributeId": "f4bf7a078071d54036656df544197ba638bc3a68"
},
"relationshipProperties": {}
}
]
},
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": []
}
],
"seedData_testTag_LL": []
}
</syntaxhighlight>

=== Cleaning Seed Data ===
:Delete seed data for set environment of '''test'''.
*cleaningeDynamoOneRecordsTags.json
*cleaningeDynamoManyRecordsTags.json

====cleaningeDynamoOneRecordsTags====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_TestFindData_and_Education_case_invalid01": [
{
"tableName": "MLocationsTestFindDataMain",
"primaryKeys": [
{
"findDataId": "cleaning-1"
},
{
"findDataId": "cleaning-2"
}
]
},
{
"tableName": "MLocationsTestEducation",
"primaryKeys": [
{
"studentId": "cleaning-AA"
},
{
"studentId": "cleaning-BB"
},
{
"studentId": "cleaning-CC"
}
]
}
],
"cleaningSeed_TestMemberPersonnel_case_invalid01": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "namtan",
"passwordId": "qqqww"
},
{
"userId": "jack",
"passwordId": "q1"
},
{
"userId": "Momay",
"passwordId": "ttr"
}
]
}
]
}
</syntaxhighlight>

==== cleaningeDynamoManyRecordsTags ====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_manyData_partitionKey_only_miss_sort": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "many-data"
}
]
}
]
}
</syntaxhighlight>

*logic query table MLocationsTestMemberPersonnel use primary Keys "userId" and then delete all data from primary Keys.

=resources=
syntax is object
<syntaxhighlight lang="JavaScript">
{
"Lambda":{
"{FunctionNameHdrSqs}":{ // FunctionNameHdrSqs is match resourceName in file tests
"localLacation":"/src/FunctionNameHdrSqs.js",
"localHandler":"main",
"functionName":"FunctionNameHdrSqs" // FunctionName is function name match key of function.yml of servcie.
},
"ProcessComplexFilterHdrSqs":{
"localLacation":"/src/ProcessComplexFilterHdrSqs.js",
"localHandler":"main",
"functionName":"ProcessComplexFilterHdrSqs"
},
...
},
"Dynamodb": {
"filterMain":{ // match resourceName in file tests(dynamodbOutputEventIdentifiers)
"tableName":"filterMain"
},
"tableNameBB":{
"tableName":"tableNameBB"
},
...
}
}
</syntaxhighlight>

=events=
Syntax is object
==Syntax Name==
===FileName===
::Event_{inputEventTag}

===eventTag===
#inputEventTag
#outputEventTag
#dynamodbTag

*file events.js is have eventTag (inputEventTag,outputEventTag,dynamodbTag)
**How to create name eventTag
***Example case : "test in service complexFilter functionname ProcessComplexFilter case element type is logical basic".
::*'''inputEventTag'''
::::{serviceName}_{functionName}_{caseTest}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''outputEventTag'''
::::output_{inputEventTag}
''output_Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''dynamodbTag'''
::::{inputEventTag}__Dynamodb__{'''action*'''}_{tableName}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic___Dynamodb__putItem_filterMain''
: '''{action}''' is only ''put'' or ''update'', and in case of ''update'' must only test the last step of update 

=== Syntax event===
====initiate by handlerServcie====
=====Sqs=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Sns
{
"LambdaFunctionHdrSqs_input__pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
},
"propertyB":{
"properties":{
"propertyB1":{
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"value":"msgTag"
},
"propertyD":{
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
<syntaxhighlight lang="JavaScript" linein>
"snsSqsTrigger":true
</syntaxhighlight>

=====Dsq=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Direct Sqs
{
"LambdaFunctionHdrDsq_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"DirectSqs":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrDsq_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
* DirectSqs = true
:: for initialStage of Dsq
* messageAttributes is optional

=====Inv=====
<syntaxhighlight lang="JavaScript">
{
"LambdaFunctionHdrInv_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
}
}
},
{
"output_LambdaFunctionHdrInv_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>

=====Api=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of API
{
"LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"forstageMatvhing": true,
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1",
},
"propertyB": {
"properties": {
"propertyB1": {
"value": "valuePropertyB1",
}
}
},
"propertyC": {
"eventValue": [
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3",
]
},
...
}
}
}
},
"Output_LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1"
},
...
}
}
}
}
}
</syntaxhighlight>

=====S3=====

====dynamodb====
<syntaxhighlight lang="JavaScript">
// An example event of Dynamodb //optional
{
{inputEventTag}__dynamodb_{action}_{tablename}: { // eg. "Complexfilter_ProcessComplexfilter_logical_basic__dynamodb_update_FilterMain"
"forStageMatching": true,
"properties": {
"filterMainUniqueRequestId": {
"testValueMatches": fase,
"value": "bbc4f4a9-2032-4dec-9129-8c7d169fecc5"
},
"filterObject": {
"forStageMatching": true,
"properties": {
"logicalType": {
"value": "partitionKey"
},
"comparison": {
"value": "equals"
},
"type": {
"value": "logical"
},
"partitionKey": {
"forStageMatching": true,
"value": "mockIntegratioTestCPF"
}
}
},
"filterMainExpiryTime": {
"testValueMatches": fase,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": fase,
"value": 1731894402678
},
"objType": {
"forStageMatching": true,
"properties": {
"serviceTag": {
"forStageMatching": true,
"value": "IntTesting"
},
"objectType": {
"forStageMatching": true,
"value": "TestRecord"
}
}
}
},
"keyValues": {
"filterMainId": "4865d2451a621cb7f71225cfabf2df4f98e20801",
"objTypeId": "cdb170690571df7522b3850920fce02507c077ee"
}
}
}
</syntaxhighlight>

* partition key: filterMainId
* sort key: objTypeId

[[2021-01-15 - Integration Testing - Adding DynamoDB result tests]]

===Type paramiter===
use for evnet and dyanmodb event
====Normal====
<syntaxhighlight lang="JavaScript">

object: {
forStageMatching: true,
properties: {
name:{
forStageMatching: true,
value:"Tom"
}
}
},
array: {
forStageMatching: true,
useIsEqual: true,
eventValue: [
{
"relTypeAndDirection": {
"relType": {
"serviceTag": "maxxCart2",
"relationshipTag": "hasCartOrder"
},
"relationshipDirection": "from"
},
"targetObjects": [
{
"objType": {
"serviceTag": "maxxCart2",
"objectType": "cartOrder"
}
}
]
}
]
},
number: {
forStageMatching: true,
value: 1111
},
string: {
forStageMatching: true,
value: "hi"
},
boolean: {
forStageMatching: true,
value: true
}
</syntaxhighlight>

<syntaxhighlight lang="JavaScript">
forStageMatching: true
</syntaxhighlight>
::set true for check match value,It is not necessary to set every value
:::use in test importent paramiter

<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
::setting paramiter require on create but can not test random value eg: identifier or timeStamp or uuid

====Empty====
<syntaxhighlight lang="JavaScript">
EmptyString:{
forStageMatching: true,
value:""
},
EmptyArray:{
forStageMatching: true,
useIsEqual: true,
eventValue: []
},
EmptyObject:{
forStageMatching: true,
value:{}
}
</syntaxhighlight>

====Error====
can test noRetryError
<syntaxhighlight lang="JavaScript">
"errorMessage": {
forStageMatching: true,
"value": "Not found schema of {serviceTag:TestGraphHandler, objectType:notFoundObjType}"
}
</syntaxhighlight>

====Paramiter random====
Can not test case random numbber or uuid.
But requriOnCreate mush be set
<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
or set
<syntaxhighlight lang="JavaScript">
forStageMatching:false
</syntaxhighlight>

=tests=
Syntax is array of object
==Syntax name==
===Testtag name ===
*{integrationTestTag}
#Test Own servcie or not a lot stage
<syntaxhighlight lang="JavaScript">
Test_{inputEventTag}
</syntaxhighlight>
#Mix multiple servcie and multiple stage
<syntaxhighlight lang="JavaScript">
IntegrationTest_{inputEventTag}
</syntaxhighlight>

===File name ===
<syntaxhighlight lang="JavaScript">
{integrationTestTag}.json
</syntaxhighlight>

==Setting of test==
[[Service - Integration Test Config#tests.js Syntax|syntax test]]

<syntaxhighlight lang="JavaScript">
{
integrationTestTag: {integrationTestTag},
productionSafe: true|false, //default false
noInitialStage: true, // default false, if set to true, no error when no foundInitialStages found
errorIfStageUndefined: true|false, //default false
errorIfInvokeUndefined: true|false, //default false,
dynamoDBSeedDataTags:["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
graphSeedDataTags:["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
cleaningeDynamoOneRecordsTags: ["cleaningSeed_partitionKey_sortKey_normol"], //optional
cleaningeDynamoManyRecordsTags: [], // optional
stages:[
...
]
}
</syntaxhighlight>
*[[2025-11-20 IntegrationTest#dynamoDBSeedDataTags|dynamoDBSeedDataTags]]
*[[2025-11-20 IntegrationTest#graphSeedDataTags|graphSeedDataTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoOneRecordsTags|cleaningeDynamoOneRecordsTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoManyRecordsTags|cleaningeDynamoManyRecordsTags]]

==Stages==
====Initiate stage====
:'''"initialStage":true'''
[[Service_-_Integration_Test_Config#tests.js Syntax|detail property of test]]
=====HandlerService=====
======Sqs======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"Locations_ProcessLocationNodeSomting_casenotHaveData",
"serviceName":"Locations",
"resourceType":"Lambda",
"resourceName":"ProcessLocationNodeSomtingHdrDsq",
"outputEventTag":"Output_Locations_ProcessLocationNodeSomting_casenotHaveData"
}
]
</syntaxhighlight>
======Dsq======
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'LambdaFunctionHdrDsq_input_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'LambdaFunctionHdrDsq_output__returnvalue_pass',
// **** not set snsServiceName and snsTopic
// can be test dynamodbOutput
}
]
</syntaxhighlight>

======Api======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrApi_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrApi",
"outputEventTag":"LambdaFunctionHdrApi_output__pass"
}
]
</syntaxhighlight>

======Inv======
*'''single stage'''
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": ["cleaningSeed_partitionKey_sortKey_normol"], //optional
"cleaningeDynamoManyRecordsTags": []
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass"
}
]
}]
</syntaxhighlight>
*'''invoke multiple stage'''
:*Each stage test can invoke multiple lambda by use "eventStage Tag" point to stage for test integration test.
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv_invokes__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": [], //optional
"cleaningeDynamoManyRecordsTags": [], // optional
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass",
"invokes":[
{
"eventStageTag":"service_invokesB__pass"
},
{
"eventStageTag":"service_invokesD__pass"
}
]
},
{
"eventStageTag":"service_invokesB__pass",
"inputEventTag":"input_service_invokes__pass",
"serviceName":"ServiceTemplate_B",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_B_HdrInv",
"outputEventTag":"output_service_invokes__pass"
},
{
"eventStageTag":"service_invokesD__pass",
"inputEventTag":"input_service_invokesD__pass",
"serviceName":"ServiceTemplate_D",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_D_HdrInv",
"outputEventTag":"output_service_invokesD__pass"
}
]
}]
</syntaxhighlight>

======S3======
======Batch======

====GeneratedSeedData====
*Integrationtest must be delete identifier every time before test.
*Set 'generatedSeedData' in file tests.json case by case of stage eg: stages[0] create identifier is randomOnCreate will set 'generatedSeedData' and stages[1] create relationship is randomOnCreate(It is usually random, except in the case of relationship version) set generatedSeedData this stages[1].
*How to delete case identifier rendomOnCreate?: set in stage use setting generateSeedData "randomOnCreateIdentifier"
#randomOnCreateIdentifier
#notRandomOnIdentifier
#relationships
=====randomOnCreateIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"randomOnCreateIdentifier": [
{
"objType": {
"serviceTag": "MLocations",
"objectType": "Member"
},
"identifierValue": "Jaya-member-001"
}
]
}
}
]
</syntaxhighlight>
=====notRandomOnIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"notRandomOnIdentifier": [
{
"objType": {
"serviceTag": "gggg",
"objectType": "ssssss"
},
"identifiers": {
"topId": "123456"
}
}
]
}
}
]
</syntaxhighlight>
=====relationships=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"relationships": [
{
"relType": {
"serviceTag": "PaymentMethodGeneric",
"relationshipTag": "disabledPaymentMethodGenericPropertyValue"
},
"relId": "f4f73de7-647c-4b3b-8043-87cc002f361a"
}
]
}
}
]

</syntaxhighlight>

==Dynamodb==
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'output_Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
dynamodbOutputEventIdentifiers: [
{
serviceName: {tableName}, //service that deployed the DynamoDB table, so can build table's full resource name
resourceName: {resourceName}, //DynamoDB resourceName
eventTag: {eventTagDynamoDB}
}
],
}
]
</syntaxhighlight>

= Result of integrationtest =
Data have 2 table "TestRecord" and "TestUnit".
:- TestRecord is table all unti of stage inside eg input output invokes and dynamodb
:- TestUnit is store status each unit
each unit save in table TestUnit
testRecordId is name of test concat with testTime.
testUnitId is point to position of unti instage.
resultStatus is status of unit.
<syntaxhighlight lang="JavaScript">
eg:
input_0 = stages index 0 result '''input'''
output_1 = stages index 1 result '''output'''
invokeInput_0_1 = stages index 0 result '''invokes''' index 1 position input
invokeOutput_0_1 = stages index 0 result '''invokes''' index 1 position output
dynamodb_0_1 = stages index 0 result '''dynamodb''' index 1.
</syntaxhighlight>

after all TestUnit finish (check by awaitingMultiplestep penditnStep is integrationtestTag awaitingStepId is each TestUnit )
check all awaitingStep finish send message to ultimateIntegrationtest for sumla all test is status

== Summary of test status ==
:1.testStatus is "passed" all unit passed.
:2.testStatus is "failed" have some is failed.
:3.testStatus is "processing" have some is have status processing after check all awaiting step is finish.
:4.testStatus is "failed" have record "errorsTest" in case "not match stage invoke", 'found multiple matchingInvokes

*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

=How to test integrationtest s3=
[[Developer guide for making Integration Tests]]

[[Category:Working documents| 2025-11-20]]
[[Category:Working documents - Integration Testing| 2025-11-20]]

Service - CommerceAccounting Services

2026-08-10T03:52:29Z

Mint: /* comAccServicesTypeLink */

= Overview =

Links Services objects to Accounting structures.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccServicesLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccServicesLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccServicesLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// servicesId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "servicesId"],
name: "comAccLinkSerId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccServicesTemplateLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccServicesTemplateLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccServicesTemplateLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// servicesTemplateId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "servicesTemplateId"],
name: "comAccLinkSerTemId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccServicesTypeLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccServicesTypeLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccServicesTypeLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// servicesType // pointInTime|overTime
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "servicesType"],
name: "comAccLinkSerTypId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== Relationships ==

...

= flowSchemas =

...

= Working documents =

[[:Category:Working_documents - CommerceAccounting Services| CommerceAccounting Services]]

[[Category:Backend services| CommerceAccounting Services]]

Service - CommerceAccounting Services

2026-08-10T03:52:21Z

Mint: /* comAccServicesTemplateLink */

= Overview =

Links Services objects to Accounting structures.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccServicesLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccServicesLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccServicesLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// servicesId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "servicesId"],
name: "comAccLinkSerId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccServicesTemplateLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccServicesTemplateLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccServicesTemplateLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// servicesTemplateId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "servicesTemplateId"],
name: "comAccLinkSerTemId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccServicesTypeLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccServicesTypeLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccServicesTypeLink",
}
},
fieldNames: {
// businessId
// organizationId
// servicesType // pointInTime|overTime
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "servicesType"],
name: "comAccLinkSerTypId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== Relationships ==

...

= flowSchemas =

...

= Working documents =

[[:Category:Working_documents - CommerceAccounting Services| CommerceAccounting Services]]

[[Category:Backend services| CommerceAccounting Services]]

Service - CommerceAccounting Customer

2026-08-10T03:52:12Z

Mint: /* Object Schemas */

= Overview =

Connects each customer to their Accounting accounts, such as accountsReceivable

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccCustomerLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccCustomerLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccCustomerLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// customerId
// accountLinkTag // type of link: accountsReceivable|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "customerId"],
name: "comAccLinkCusId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccCustomerDefaultLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccCustomerDefaultLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccCustomerDefaultLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// accountLinkTag // type of link: accountsReceivable|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId"],
name: "comAccLinkId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== Relationships ==

...

= flowSchemas =

== createSale ==

* sends request to Accounting to create entries in comAccCustomerLink.accountlinkTag = accountsReceivable account
* or maybe returns accountId to Sales createSale flow which sends to Accounting

= accountLinkTag =

== accountsReceivable ==

= Working documents =

[[:Category:Working_documents - CommerceAccounting Customer| CommerceAccounting Customer]]

[[Category:Backend services| CommerceAccounting Customer]]

Service - CommerceAccounting Expense

2026-08-10T03:51:42Z

Mint: /* Object Schemas */

= Overview =

Links Expense objects to Accounting structures.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccExpenseLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccExpenseLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccExpenseLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// expenseId
// accountLinkTag // type of link: ..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "expenseId"],
name: "comAccLinkExpId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccExpenseTypeLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccExpenseTypeLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccExpenseTypeLink",
}
},
fieldNames: {
// businessId
// organizationId
// expenseType // pointInTime|overTime
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "expenseType"],
name: "comAccLinkExpTypId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== RelationshipSchemas ==

...

= Working documents =

[[:Category:Working_documents - CommerceAccounting Expenses|CommerceAccounting Expenses]]

[[Category:Backend services| CommerceAccounting Expenses]]

Service - CommerceAccounting Freight In

2026-08-10T03:51:10Z

Mint: /* Object Schemas */

= Overview =

Links Freight In objects to Accounting structures.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccFreightInLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccFreightInLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccFreightInLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// freightInId
// accountLinkTag // type of link: purchaseLineItem
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "freightInId"],
name: "comAccLinkFreInId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccFreightInTypeLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccFreightInTypeLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccFreightInTypeLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// freightInType // standard|..
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "freightInType"],
name: "comAccLinkFreInTypId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== Relationships ==

...

= flowSchemas =

...

= Working documents =

[[:Category:Working_documents - CommerceAccounting Freight In| CommerceAccounting Freight In]]

[[Category:Backend services| CommerceAccounting Freight In]]

Service - CommerceAccounting Other Purchase Item

2026-08-10T03:50:57Z

Mint: /* Object Schemas */

= Overview =

Links Other Purchase Item objects to Accounting structures.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccOtherPurchaseItemLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccOtherPurchaseItemLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccOtherPurchaseItemLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// otherPurchaseItemId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "otherPurchaseItemId"],
name: "comAccLinkOthPurId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccOtherPurchaseItemTypeLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccOtherPurchaseItemTypeLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccOtherPurchaseItemTypeLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// otherPurchaseItemType // standard
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "otherPurchaseItemType"],
name: "comAccLinkOthPurTypId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== Relationships ==

...

= flowSchemas =

...

= Working documents =

[[:Category:Working_documents - CommerceAccounting Other Purchase Item| CommerceAccounting Other Purchase Item]]

[[Category:Backend services| CommerceAccounting Other Purchase Item]]

Service - CommerceAccounting Other Purchase Item

2026-08-10T03:50:45Z

Mint: /* comAccOtherPurchaseItemLink */

= Overview =

Links Other Purchase Item objects to Accounting structures.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccOtherPurchaseItemLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccOtherPurchaseItemLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccOtherPurchaseItemLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// otherPurchaseItemId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "otherPurchaseItemId"],
name: "comAccLinkOthPurId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccOtherPurchaseItemTypeLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccOtherPurchaseItemTypeLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccOtherPurchaseItemTypeLink",
}
},
fieldNames: {
// businessId
// organizationId
// otherPurchaseItemType // standard
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "otherPurchaseItemType"],
name: "comAccLinkOthPurTypId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== Relationships ==

...

= flowSchemas =

...

= Working documents =

[[:Category:Working_documents - CommerceAccounting Other Purchase Item| CommerceAccounting Other Purchase Item]]

[[Category:Backend services| CommerceAccounting Other Purchase Item]]

Service - CommerceAccounting Vendor

2026-08-10T03:50:12Z

Mint: /* comAccVendorDefaultLink */

= Overview =

Connects each vendor to their Accounting accounts, such as accountsPayable

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccVendorLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccVendorLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccVendorLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// vendorId
// accountLinkTag // type of link: accountsPayable|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "vendorId"],
name: "comAccLinkVenId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccVendorDefaultLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccVendorDefaultLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccVendorDefaultLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// accountLinkTag // type of link: accountsPayable|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId"],
name: "comAccLinkId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== Relationships ==

...

= flowSchemas =

== createSale ==

* creates a Accounting AccountsPayable account and a link in comAccVendorAccountsPayableLink

= accountLinkTag =

== accountsPayable ==

* when receive bill from vendor and before payment made

== goodsReceivedNotInvoiced ==

* clearing account used when receive goods from vendor before recieving invoice

== purchasesInTransit ==

* clearing account used when receive invoice from vendor before recieving goods

= Working documents =

[[:Category:Working_documents - CommerceAccounting Vendor| CommerceAccounting Vendor]]

[[Category:Backend services| CommerceAccounting Vendor]]

Service - CommerceAccounting Vendor

2026-08-10T03:50:06Z

Mint: /* comAccVendorLink */

= Overview =

Connects each vendor to their Accounting accounts, such as accountsPayable

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccVendorLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccVendorLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccVendorLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// vendorId
// accountLinkTag // type of link: accountsPayable|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "vendorId"],
name: "comAccLinkVenId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccVendorDefaultLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccVendorDefaultLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccVendorDefaultLink",
}
},
fieldNames: {
// businessId
// organizationId
// accountLinkTag // type of link: accountsPayable|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId"],
name: "comAccLinkId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== Relationships ==

...

= flowSchemas =

== createSale ==

* creates a Accounting AccountsPayable account and a link in comAccVendorAccountsPayableLink

= accountLinkTag =

== accountsPayable ==

* when receive bill from vendor and before payment made

== goodsReceivedNotInvoiced ==

* clearing account used when receive goods from vendor before recieving invoice

== purchasesInTransit ==

* clearing account used when receive invoice from vendor before recieving goods

= Working documents =

[[:Category:Working_documents - CommerceAccounting Vendor| CommerceAccounting Vendor]]

[[Category:Backend services| CommerceAccounting Vendor]]

Service - CommerceAccounting Inventory

2026-08-10T03:49:04Z

Mint: /* comAccInventoryTypeLink */

= Overview =

Links Inventory objects to Accounting structures.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccInventoryLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// inventoryId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryId"],
name: "comAccLinkInvId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccInventoryLocationLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryLocationLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryLocationLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// inventoryLocationId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryLocationId"],
name: "comAccLinkInvLocId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccInventoryTemplateLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryTemplateLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryTemplateLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// inventoryTemplateId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryTemplateId"],
name: "comAccLinkInvTemId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccInventoryTypeLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryTypeLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryTypeLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// inventoryType // goods|intangibleGoods|rawMaterial|asset|intangibleAsset
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryType"],
name: "comAccLinkInvTypId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== Relationships ==

...

= flowSchemas =

...

= Working documents =

[[:Category:Working_documents - CommerceAccounting Inventory| CommerceAccounting Inventory]]

[[Category:Backend services| CommerceAccounting Inventory]]

Service - CommerceAccounting Inventory

2026-08-10T03:48:56Z

Mint: /* comAccInventoryTemplateLink */

= Overview =

Links Inventory objects to Accounting structures.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccInventoryLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// inventoryId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryId"],
name: "comAccLinkInvId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccInventoryLocationLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryLocationLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryLocationLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// inventoryLocationId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryLocationId"],
name: "comAccLinkInvLocId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccInventoryTemplateLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryTemplateLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryTemplateLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// inventoryTemplateId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryTemplateId"],
name: "comAccLinkInvTemId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccInventoryTypeLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryTypeLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryTypeLink",
}
},
fieldNames: {
// businessId
// organizationId
// inventoryType // goods|intangibleGoods|rawMaterial|asset|intangibleAsset
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryType"],
name: "comAccLinkInvTypId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== Relationships ==

...

= flowSchemas =

...

= Working documents =

[[:Category:Working_documents - CommerceAccounting Inventory| CommerceAccounting Inventory]]

[[Category:Backend services| CommerceAccounting Inventory]]

Service - CommerceAccounting Inventory

2026-08-10T03:48:45Z

Mint: /* comAccInventoryLocationLink */

= Overview =

Links Inventory objects to Accounting structures.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccInventoryLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// inventoryId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryId"],
name: "comAccLinkInvId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccInventoryLocationLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryLocationLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryLocationLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// inventoryLocationId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryLocationId"],
name: "comAccLinkInvLocId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccInventoryTemplateLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryTemplateLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryTemplateLink",
}
},
fieldNames: {
// businessId
// organizationId
// inventoryTemplateId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryTemplateId"],
name: "comAccLinkInvTemId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccInventoryTypeLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryTypeLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryTypeLink",
}
},
fieldNames: {
// businessId
// organizationId
// inventoryType // goods|intangibleGoods|rawMaterial|asset|intangibleAsset
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryType"],
name: "comAccLinkInvTypId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== Relationships ==

...

= flowSchemas =

...

= Working documents =

[[:Category:Working_documents - CommerceAccounting Inventory| CommerceAccounting Inventory]]

[[Category:Backend services| CommerceAccounting Inventory]]

Service - CommerceAccounting Inventory

2026-08-10T03:40:21Z

Mint: /* comAccInventoryLink */

= Overview =

Links Inventory objects to Accounting structures.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccInventoryLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// inventoryId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryId"],
name: "comAccLinkInvId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccInventoryLocationLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryLocationLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryLocationLink",
}
},
fieldNames: {
// businessId
// organizationId
// inventoryLocationId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryLocationId"],
name: "comAccLinkInvLocId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccInventoryTemplateLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryTemplateLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryTemplateLink",
}
},
fieldNames: {
// businessId
// organizationId
// inventoryTemplateId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryTemplateId"],
name: "comAccLinkInvTemId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccInventoryTypeLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryTypeLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryTypeLink",
}
},
fieldNames: {
// businessId
// organizationId
// inventoryType // goods|intangibleGoods|rawMaterial|asset|intangibleAsset
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryType"],
name: "comAccLinkInvTypId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== Relationships ==

...

= flowSchemas =

...

= Working documents =

[[:Category:Working_documents - CommerceAccounting Inventory| CommerceAccounting Inventory]]

[[Category:Backend services| CommerceAccounting Inventory]]

Service - CommerceAccounting Inventory

2026-08-10T03:40:04Z

Mint: /* comAccInventoryLink */

= Overview =

Links Inventory objects to Accounting structures.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccInventoryLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// inventoryId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryId"],
name: "comAccLinkInvId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccInventoryLocationLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryLocationLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryLocationLink",
}
},
fieldNames: {
// businessId
// organizationId
// inventoryLocationId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryLocationId"],
name: "comAccLinkInvLocId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccInventoryTemplateLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryTemplateLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryTemplateLink",
}
},
fieldNames: {
// businessId
// organizationId
// inventoryTemplateId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryTemplateId"],
name: "comAccLinkInvTemId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccInventoryTypeLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccInventoryTypeLink",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccInventoryTypeLink",
}
},
fieldNames: {
// businessId
// organizationId
// inventoryType // goods|intangibleGoods|rawMaterial|asset|intangibleAsset
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "inventoryType"],
name: "comAccLinkInvTypId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== Relationships ==

...

= flowSchemas =

...

= Working documents =

[[:Category:Working_documents - CommerceAccounting Inventory| CommerceAccounting Inventory]]

[[Category:Backend services| CommerceAccounting Inventory]]

Service - CommerceAccounting Services

2026-08-10T03:36:11Z

Mint: /* comAccServicesLink */

= Overview =

Links Services objects to Accounting structures.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccServicesLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccServicesLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccServicesLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId
// organizationId
// servicesId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "servicesId"],
name: "comAccLinkSerId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccServicesTemplateLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccServicesTemplateLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccServicesTemplateLink",
}
},
fieldNames: {
// businessId
// organizationId
// servicesTemplateId
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "servicesTemplateId"],
name: "comAccLinkSerTemId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== comAccServicesTypeLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccServicesTypeLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccServicesTypeLink",
}
},
fieldNames: {
// businessId
// organizationId
// servicesType // pointInTime|overTime
// accountLinkTag // type of link: purchaseLineItem|..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId", "servicesType"],
name: "comAccLinkSerTypId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

== Relationships ==

...

= flowSchemas =

...

= Working documents =

[[:Category:Working_documents - CommerceAccounting Services| CommerceAccounting Services]]

[[Category:Backend services| CommerceAccounting Services]]

Service - CommerceAccounting Sale

2026-08-10T03:36:03Z

Mint: /* comAccSaleLink */

= Overview =

Handle sales in one service because some Accounting entries include the full amount, some break up according to saleLineItems.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccSaleLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccSaleLink",
generatedBy: "userGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"myGraph":{
"storageType": "graph",
"graphServerTag": "GraphHandler"
},
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccSaleLink",
}
},
fieldNames: {
businessId:{
fromObjType:{
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
},
organizationId: {
fromObjType:{
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByOrganization"
},
},
accountLinkTag:{ // type of link: ..
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph', 'dynamo']
}
accountId:{
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph', 'dynamo']
}
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId"],
name: "comAccLinkId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

* sets which Accounting accountId journal entries are added to

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccSale",
generatedBy: "systemGenerated",
canDelete: false,
belongTo: {
serviceTag: "CommerceAccountingLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccSaleLink",
},
"myGraph": {
"storageType": "graph",
"graphServerTag": "GraphHandler"
}
},
fieldNames: {
// businessId,
// organizationId,
// saleId,

// record lock eg: prefix: "updateSale"
// updateSale_status: {requiredOnCreate: true}, // open|lock,
// updateSale_uniqueRequestId: {requiredOnCreate: true},
// updateSale_timestamp: {requiredOnCreate: true},

saleValueJournalId: {
type: "string",
optionalOnCreate: true,
canUpdate: true,
storageResourceTags: ["dynamo"],
},
inventoryAdjustJournalId: {
type: "string",
optionalOnCreate: true,
canUpdate: true,
storageResourceTags: ["dynamo"],
},
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId", "organizationId"],
name: "comAccLinkId",
},
{
type: "sortKey",
fieldName: "saleId"
},
]
}
</syntaxhighlight>

* one saleId links to two journalIds, sale value and inventory adjustment entries
* maintains a link between saleId and journalIds, so can adjust if changes made to sale

== Relationships ==

...

= flowSchemas =

== saleCommitted ==

* when creating a sale, iterate saleLineItems to decide which journal entries are created
* accountsReceivable accountId will need to come from [[Service - CommerceAccounting Customer]]

=== Sale Value ===

* the total sale value has journal entry for all the below:
*# (debit)accountsReceivable(Asset)

* The other side (credit) is broken up depending on goods/service or assets

* For goods value an entry is entered into the below
*# (credit)goodsSale/serviceSale(Revenue)

* Assets have:
*# (credit)inventoryAsset(Asset)
*# (debit)accumulatedDepreciation(Asset)
*# (debit or credit)creditGainOnSale(Renenue)/debitLossOnSale(Expense)

* Intangible Assets have:
*# (credit)inventoryIntangibleAsset(Asset)
*# (debit)accumulatedAmortization(Asset)
*# (debit or credit)creditGainOnSale(Renenue)/debitLossOnSale(Expense)

* all credit side may have:
*# (credit)salesTaxPayable(Liability)
*# (credit)vatPayable(liability)

=== Goods Sold ===

* the total saleLineItem value for Inventory Goods has a journal entry for:
*# (debit)cogsGoods(Expense)
*# (credit)inventoryGoods(Asset)

=== Raw Material Sold ===

* the total saleLineItem value for Inventory Raw Materials has a journal entry for:
*# (debit)cogsRawMaterial(Expense)
*# (credit)inventoryRawMaterial(Asset)

=== Assets Sold ===

* might not have accumulatedDepreciation applied yet
* if sold for same amount as original value then not have creditGainOnSale/debitLossOnSale
* will need to query Accounting Assets service for depreciation amount
* may need to query ComAcc Inventory service to find link between Commerce Asset and Accounting Asset, so can find depreciation

=== Services Sold ===

* no additional entries required

=== Intangible Goods Sold ===

* no additional entries required
* entries same as physical Goods

=== Intangible Assets ===

* same as an Asset, except use the term Amortization instead of Depreciation, which are functionally the same

== saleChange ==

* make adjustment to journal entries when saleLineItemId changes
* perhaps handling removal of sale/journal entries, or creation of new entries
* basically re-calculate all entries and check against existing

= Working documents =

[[:Category:Working_documents - CommerceAccounting Sale| CommerceAccounting Sale]]

[[Category:Backend services| CommerceAccounting Sale]]

Service - CommerceAccounting Link

2026-08-07T06:48:10Z

Mint: /* comAccAccountLink */

= Overview =

Configures the link between a Business in Izara Commerce and an organization in Izara Accounting.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccLinkByBusiness ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccLinkByBusiness",
canDelete: false,
belongTo: {
serviceTag: "User",
objectType: "user"
},
addOnDataStructure: [
{
type:"rbac"
}

],
storageResources: {
"myGraph":{
"storageType": "graph",
"graphServerTag": "GraphHandler"
},
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccLinkByBusiness",
}
},
fieldNames: {
businessId:{
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
},
organizationId:{
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
}
},
identifiers: [
{
// businessId
}
]
}
</syntaxhighlight>

== comAccLinkByOrganization ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccLinkByOrganization",
canDelete: false,
belongTo: {
serviceTag: "User",
objectType: "user"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccLinkByOrganization",
}
},
fieldNames: {
// organizationId
// businessId
},
identifiers: [
{
// organizationId
}
]
}
</syntaxhighlight>

== comAccAccountLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccAccountLink",
canDelete: true,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccAccountLink",
}
},
fieldNames: {
businessId: {
fromObjType:{
serviceTag: "CommerceAccountingLink",
objectType: "comAccLink"
},
},
organizationId: {
fromObjType:{
serviceTag: "CommerceAccountingLink",
objectType: "comAccLink"
},
},
accountTag: { // this is the granular accounting classification that actions need to add entries to
type: "string",
requiredOnCreate: true,
canUpdate: false,
userCanUpdate: false,
storageResourceTags: ["dynamo"],
},
accountId: { // accountId from Izara Accounting
type: "string",
requiredOnCreate: true,
canUpdate: true,
userCanUpdate: true,
storageResourceTags: ["dynamo"],
},
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId","organizationId"],
name: "comAccLinkId",
},
{
type: "sortKey",
fieldName: "accountTag"
},
]
}
</syntaxhighlight>

* sets up which Accounting Accounts are used for different connection tasks
* example: which Accounting Account is adjusted when stock increases/decreases
* will need to have a plugIn level shared const lib of all accountTags

== Relationships ==

...

= Working documents =

[[:Category:Working_documents - CommerceAccounting Link| CommerceAccounting Link]]

[[Category:Backend services| CommerceAccounting Link]]

Service - CommerceAccounting Purchase

2026-08-07T06:47:03Z

Mint: /* comAccPurchaseLink */

= Overview =

Handle links between purchases and Accounting records.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccPurchaseLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLink",
generatedBy: "userGenerated",
canDelete: false,
addOnDataStructure: [],
belongTo: {
serviceTag: "ComAccLink",
objectType: "comAccLinkByBusiness"
},
storageResources: {
"myGraph":{
"storageType": "graph",
"graphServerTag": "GraphHandler"
},
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLink",
}
},
fieldNames: {
businessId:{
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
},
accountLinkTag:{ // type of link: inputVAT|salesTax|vatTax..
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
}
accountId:{
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
}
},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

* sets which Accounting accountId journal entries are added to

== comAccPurchase ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchase",
generatedBy: "systemGenerated",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchase",
}
},
fieldNames: {
// businessId,
// purchaseId,

// record lock eg: prefix: "updatePurchase"
// updatePurchase_status:{requiredOnCreate: true}, // open|lock,
// updatePurchase_uniqueRequestId :{requiredOnCreate: true},
// updatePurchase_timestamp :{requiredOnCreate: true},

journalId: {
type: "string",
optionalOnCreate: true,
canUpdate: true,
storageResourceTags: ["dynamo"],
},

},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "purchaseId"
},
]
}
</syntaxhighlight>

== comAccPurchaseLineItem ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLineItem",
generatedBy: "systemGenerated",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLineItem",
}
},
fieldNames: {
// purchaseId,
// purchaseLineItemId,
// accountId
// lineItemQuantity
// lineItemUnitPricelineItemUnitPrice
// entryId // not sure want to record because multiple lineItems might be in the same entryId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

* This table might not be needed becasue we do not create a journal entry per line item, we make a compound journal entry per purchase
* Keep it for now so we can reconcile Commerce data matches ComAcc data

== Relationships ==

...

= flowSchemas =

== createPurchase ==

* when creating a purchase, iterate purchaseLineItems to decide which journal entries are created
* accountsPayable accountId comes from [[Service - CommerceAccounting Vendor]]
* each purchaseLineItem checks it's type then finds accountId from coresponding comAcc service

=== Example request param from Commerce ===

<syntaxhighlight lang="JavaScript">
{
belongToIdentifiers: {
businessId: "xxx"
},
purchaseId: "",
vendorId: "",
timestamp: 1111111,
purchaseCurrencyId: "",
inventoryLocationId: "", // required if have any inventory/?assets
purchaseLineItems: {
{purchaseLineItemId}: {

inventoryId: "",
inventoryTemplateId: "",
// or
expenseId: "",
// or
servicesId: "",
servicesTemplateId: "",
// or
freightInId: "",
// or

otherPurchaseItemId: "",

type: "", // inventory|expense|services|freight|salesTax|vatTax|other
subType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, other: standard

lineItemQuantity: 1,
lineItemUnitPrice: "2.00"
},
//...
}
}
</syntaxhighlight>

== updatePurchase ==

* make adjustment to journal entries when purchaseLineItemId changes
* handle removal of purchase/journal entries, or creation of new entries
* basically re-calculate all entries and check against existing
* each journalId must check Accounting that it's period/s are not locked, if locked return error, cannot make update

= Working documents =

[[:Category:Working_documents - CommerceAccounting Purchase| CommerceAccounting Purchase]]

[[Category:Backend services| CommerceAccounting Purchase]]

Service - CommerceAccounting Purchase

2026-08-07T06:46:21Z

Mint: /* comAccPurchaseLink */

= Overview =

Handle links between purchases and Accounting records.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccPurchaseLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLink",
generatedBy: "userGenerated",
canDelete: false,
addOnDataStructure: [],
belongTo: {
serviceTag: "ComAccLink",
objectType: "comAccLinkByBusiness"
},
storageResources: {
"myGraph":{
storageType: "graph",
graphServerTag: "GraphHandler"
}
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLink",
}
},
fieldNames: {
businessId:{
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
},
accountLinkTag:{ // type of link: inputVAT|salesTax|vatTax..
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
}
accountId:{
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
}
},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

* sets which Accounting accountId journal entries are added to

== comAccPurchase ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchase",
generatedBy: "systemGenerated",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchase",
}
},
fieldNames: {
// businessId,
// purchaseId,

// record lock eg: prefix: "updatePurchase"
// updatePurchase_status:{requiredOnCreate: true}, // open|lock,
// updatePurchase_uniqueRequestId :{requiredOnCreate: true},
// updatePurchase_timestamp :{requiredOnCreate: true},

journalId: {
type: "string",
optionalOnCreate: true,
canUpdate: true,
storageResourceTags: ["dynamo"],
},

},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "purchaseId"
},
]
}
</syntaxhighlight>

== comAccPurchaseLineItem ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLineItem",
generatedBy: "systemGenerated",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLineItem",
}
},
fieldNames: {
// purchaseId,
// purchaseLineItemId,
// accountId
// lineItemQuantity
// lineItemUnitPricelineItemUnitPrice
// entryId // not sure want to record because multiple lineItems might be in the same entryId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

* This table might not be needed becasue we do not create a journal entry per line item, we make a compound journal entry per purchase
* Keep it for now so we can reconcile Commerce data matches ComAcc data

== Relationships ==

...

= flowSchemas =

== createPurchase ==

* when creating a purchase, iterate purchaseLineItems to decide which journal entries are created
* accountsPayable accountId comes from [[Service - CommerceAccounting Vendor]]
* each purchaseLineItem checks it's type then finds accountId from coresponding comAcc service

=== Example request param from Commerce ===

<syntaxhighlight lang="JavaScript">
{
belongToIdentifiers: {
businessId: "xxx"
},
purchaseId: "",
vendorId: "",
timestamp: 1111111,
purchaseCurrencyId: "",
inventoryLocationId: "", // required if have any inventory/?assets
purchaseLineItems: {
{purchaseLineItemId}: {

inventoryId: "",
inventoryTemplateId: "",
// or
expenseId: "",
// or
servicesId: "",
servicesTemplateId: "",
// or
freightInId: "",
// or

otherPurchaseItemId: "",

type: "", // inventory|expense|services|freight|salesTax|vatTax|other
subType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, other: standard

lineItemQuantity: 1,
lineItemUnitPrice: "2.00"
},
//...
}
}
</syntaxhighlight>

== updatePurchase ==

* make adjustment to journal entries when purchaseLineItemId changes
* handle removal of purchase/journal entries, or creation of new entries
* basically re-calculate all entries and check against existing
* each journalId must check Accounting that it's period/s are not locked, if locked return error, cannot make update

= Working documents =

[[:Category:Working_documents - CommerceAccounting Purchase| CommerceAccounting Purchase]]

[[Category:Backend services| CommerceAccounting Purchase]]

Service - CommerceAccounting Purchase

2026-08-07T06:45:29Z

Mint: /* comAccPurchaseLineItem */

= Overview =

Handle links between purchases and Accounting records.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccPurchaseLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLink",
canDelete: false,
addOnDataStructure: [],
belongTo: {
serviceTag: "ComAccLink",
objectType: "comAccLinkByBusiness"
},
storageResources: {
"myGraph":{
storageType: "graph",
graphServerTag: "GraphHandler"
}
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLink",
}
},
fieldNames: {
businessId:{
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
},
accountLinkTag:{ // type of link: inputVAT|salesTax|vatTax..
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
}
accountId:{
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
}
},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

* sets which Accounting accountId journal entries are added to

== comAccPurchase ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchase",
generatedBy: "systemGenerated",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchase",
}
},
fieldNames: {
// businessId,
// purchaseId,

// record lock eg: prefix: "updatePurchase"
// updatePurchase_status:{requiredOnCreate: true}, // open|lock,
// updatePurchase_uniqueRequestId :{requiredOnCreate: true},
// updatePurchase_timestamp :{requiredOnCreate: true},

journalId: {
type: "string",
optionalOnCreate: true,
canUpdate: true,
storageResourceTags: ["dynamo"],
},

},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "purchaseId"
},
]
}
</syntaxhighlight>

== comAccPurchaseLineItem ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLineItem",
generatedBy: "systemGenerated",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLineItem",
}
},
fieldNames: {
// purchaseId,
// purchaseLineItemId,
// accountId
// lineItemQuantity
// lineItemUnitPricelineItemUnitPrice
// entryId // not sure want to record because multiple lineItems might be in the same entryId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

* This table might not be needed becasue we do not create a journal entry per line item, we make a compound journal entry per purchase
* Keep it for now so we can reconcile Commerce data matches ComAcc data

== Relationships ==

...

= flowSchemas =

== createPurchase ==

* when creating a purchase, iterate purchaseLineItems to decide which journal entries are created
* accountsPayable accountId comes from [[Service - CommerceAccounting Vendor]]
* each purchaseLineItem checks it's type then finds accountId from coresponding comAcc service

=== Example request param from Commerce ===

<syntaxhighlight lang="JavaScript">
{
belongToIdentifiers: {
businessId: "xxx"
},
purchaseId: "",
vendorId: "",
timestamp: 1111111,
purchaseCurrencyId: "",
inventoryLocationId: "", // required if have any inventory/?assets
purchaseLineItems: {
{purchaseLineItemId}: {

inventoryId: "",
inventoryTemplateId: "",
// or
expenseId: "",
// or
servicesId: "",
servicesTemplateId: "",
// or
freightInId: "",
// or

otherPurchaseItemId: "",

type: "", // inventory|expense|services|freight|salesTax|vatTax|other
subType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, other: standard

lineItemQuantity: 1,
lineItemUnitPrice: "2.00"
},
//...
}
}
</syntaxhighlight>

== updatePurchase ==

* make adjustment to journal entries when purchaseLineItemId changes
* handle removal of purchase/journal entries, or creation of new entries
* basically re-calculate all entries and check against existing
* each journalId must check Accounting that it's period/s are not locked, if locked return error, cannot make update

= Working documents =

[[:Category:Working_documents - CommerceAccounting Purchase| CommerceAccounting Purchase]]

[[Category:Backend services| CommerceAccounting Purchase]]

Service - CommerceAccounting Purchase

2026-08-07T06:45:08Z

Mint: /* comAccPurchase */

= Overview =

Handle links between purchases and Accounting records.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccPurchaseLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLink",
canDelete: false,
addOnDataStructure: [],
belongTo: {
serviceTag: "ComAccLink",
objectType: "comAccLinkByBusiness"
},
storageResources: {
"myGraph":{
storageType: "graph",
graphServerTag: "GraphHandler"
}
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLink",
}
},
fieldNames: {
businessId:{
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
},
accountLinkTag:{ // type of link: inputVAT|salesTax|vatTax..
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
}
accountId:{
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
}
},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

* sets which Accounting accountId journal entries are added to

== comAccPurchase ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchase",
generatedBy: "systemGenerated",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchase",
}
},
fieldNames: {
// businessId,
// purchaseId,

// record lock eg: prefix: "updatePurchase"
// updatePurchase_status:{requiredOnCreate: true}, // open|lock,
// updatePurchase_uniqueRequestId :{requiredOnCreate: true},
// updatePurchase_timestamp :{requiredOnCreate: true},

journalId: {
type: "string",
optionalOnCreate: true,
canUpdate: true,
storageResourceTags: ["dynamo"],
},

},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "purchaseId"
},
]
}
</syntaxhighlight>

== comAccPurchaseLineItem ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLineItem",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLineItem",
}
},
fieldNames: {
// purchaseId,
// purchaseLineItemId,
// accountId
// lineItemQuantity
// lineItemUnitPricelineItemUnitPrice
// entryId // not sure want to record because multiple lineItems might be in the same entryId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

* This table might not be needed becasue we do not create a journal entry per line item, we make a compound journal entry per purchase
* Keep it for now so we can reconcile Commerce data matches ComAcc data

== Relationships ==

...

= flowSchemas =

== createPurchase ==

* when creating a purchase, iterate purchaseLineItems to decide which journal entries are created
* accountsPayable accountId comes from [[Service - CommerceAccounting Vendor]]
* each purchaseLineItem checks it's type then finds accountId from coresponding comAcc service

=== Example request param from Commerce ===

<syntaxhighlight lang="JavaScript">
{
belongToIdentifiers: {
businessId: "xxx"
},
purchaseId: "",
vendorId: "",
timestamp: 1111111,
purchaseCurrencyId: "",
inventoryLocationId: "", // required if have any inventory/?assets
purchaseLineItems: {
{purchaseLineItemId}: {

inventoryId: "",
inventoryTemplateId: "",
// or
expenseId: "",
// or
servicesId: "",
servicesTemplateId: "",
// or
freightInId: "",
// or

otherPurchaseItemId: "",

type: "", // inventory|expense|services|freight|salesTax|vatTax|other
subType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, other: standard

lineItemQuantity: 1,
lineItemUnitPrice: "2.00"
},
//...
}
}
</syntaxhighlight>

== updatePurchase ==

* make adjustment to journal entries when purchaseLineItemId changes
* handle removal of purchase/journal entries, or creation of new entries
* basically re-calculate all entries and check against existing
* each journalId must check Accounting that it's period/s are not locked, if locked return error, cannot make update

= Working documents =

[[:Category:Working_documents - CommerceAccounting Purchase| CommerceAccounting Purchase]]

[[Category:Backend services| CommerceAccounting Purchase]]

Service - CommerceAccounting Purchase

2026-08-07T06:44:15Z

Mint: /* comAccPurchaseLink */

= Overview =

Handle links between purchases and Accounting records.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccPurchaseLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLink",
canDelete: false,
addOnDataStructure: [],
belongTo: {
serviceTag: "ComAccLink",
objectType: "comAccLinkByBusiness"
},
storageResources: {
"myGraph":{
storageType: "graph",
graphServerTag: "GraphHandler"
}
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLink",
}
},
fieldNames: {
businessId:{
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
},
accountLinkTag:{ // type of link: inputVAT|salesTax|vatTax..
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
}
accountId:{
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
}
},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

* sets which Accounting accountId journal entries are added to

== comAccPurchase ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchase",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchase",
}
},
fieldNames: {
// businessId,
// purchaseId,

// record lock eg: prefix: "updatePurchase"
// updatePurchase_status:{requiredOnCreate: true}, // open|lock,
// updatePurchase_uniqueRequestId :{requiredOnCreate: true},
// updatePurchase_timestamp :{requiredOnCreate: true},

journalId: {
type: "string",
optionalOnCreate: true,
canUpdate: true,
storageResourceTags: ["dynamo"],
},

},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "purchaseId"
},
]
}
</syntaxhighlight>

== comAccPurchaseLineItem ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLineItem",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLineItem",
}
},
fieldNames: {
// purchaseId,
// purchaseLineItemId,
// accountId
// lineItemQuantity
// lineItemUnitPricelineItemUnitPrice
// entryId // not sure want to record because multiple lineItems might be in the same entryId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

* This table might not be needed becasue we do not create a journal entry per line item, we make a compound journal entry per purchase
* Keep it for now so we can reconcile Commerce data matches ComAcc data

== Relationships ==

...

= flowSchemas =

== createPurchase ==

* when creating a purchase, iterate purchaseLineItems to decide which journal entries are created
* accountsPayable accountId comes from [[Service - CommerceAccounting Vendor]]
* each purchaseLineItem checks it's type then finds accountId from coresponding comAcc service

=== Example request param from Commerce ===

<syntaxhighlight lang="JavaScript">
{
belongToIdentifiers: {
businessId: "xxx"
},
purchaseId: "",
vendorId: "",
timestamp: 1111111,
purchaseCurrencyId: "",
inventoryLocationId: "", // required if have any inventory/?assets
purchaseLineItems: {
{purchaseLineItemId}: {

inventoryId: "",
inventoryTemplateId: "",
// or
expenseId: "",
// or
servicesId: "",
servicesTemplateId: "",
// or
freightInId: "",
// or

otherPurchaseItemId: "",

type: "", // inventory|expense|services|freight|salesTax|vatTax|other
subType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, other: standard

lineItemQuantity: 1,
lineItemUnitPrice: "2.00"
},
//...
}
}
</syntaxhighlight>

== updatePurchase ==

* make adjustment to journal entries when purchaseLineItemId changes
* handle removal of purchase/journal entries, or creation of new entries
* basically re-calculate all entries and check against existing
* each journalId must check Accounting that it's period/s are not locked, if locked return error, cannot make update

= Working documents =

[[:Category:Working_documents - CommerceAccounting Purchase| CommerceAccounting Purchase]]

[[Category:Backend services| CommerceAccounting Purchase]]

Service - CommerceAccounting Link

2026-08-07T06:43:43Z

Mint:

= Overview =

Configures the link between a Business in Izara Commerce and an organization in Izara Accounting.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccLinkByBusiness ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccLinkByBusiness",
canDelete: false,
belongTo: {
serviceTag: "User",
objectType: "user"
},
addOnDataStructure: [
{
type:"rbac"
}

],
storageResources: {
"myGraph":{
"storageType": "graph",
"graphServerTag": "GraphHandler"
},
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccLinkByBusiness",
}
},
fieldNames: {
businessId:{
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
},
organizationId:{
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
}
},
identifiers: [
{
// businessId
}
]
}
</syntaxhighlight>

== comAccLinkByOrganization ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccLinkByOrganization",
canDelete: false,
belongTo: {
serviceTag: "User",
objectType: "user"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccLinkByOrganization",
}
},
fieldNames: {
// organizationId
// businessId
},
identifiers: [
{
// organizationId
}
]
}
</syntaxhighlight>

== comAccAccountLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccAccountLink",
canDelete: true,
belongTo: {
serviceTag: "User",
objectType: "user"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccAccountLink",
}
},
fieldNames: {
businessId: {
fromObjType:{
serviceTag: "CommerceAccountingLink",
objectType: "comAccLink"
},
},
organizationId: {
fromObjType:{
serviceTag: "CommerceAccountingLink",
objectType: "comAccLink"
},
},
accountTag: { // this is the granular accounting classification that actions need to add entries to
type: "string",
requiredOnCreate: true,
canUpdate: false,
userCanUpdate: false,
storageResourceTags: ["dynamo"],
},
accountId: { // accountId from Izara Accounting
type: "string",
requiredOnCreate: true,
canUpdate: true,
userCanUpdate: true,
storageResourceTags: ["dynamo"],
},
},
identifiers: [
{
type: "partitionKey",
fieldNames: ["businessId","organizationId"],
name: "comAccLinkId",
},
{
type: "sortKey",
fieldName: "accountTag"
},
]
}
</syntaxhighlight>

* sets up which Accounting Accounts are used for different connection tasks
* example: which Accounting Account is adjusted when stock increases/decreases
* will need to have a plugIn level shared const lib of all accountTags

== Relationships ==

...

= Working documents =

[[:Category:Working_documents - CommerceAccounting Link| CommerceAccounting Link]]

[[Category:Backend services| CommerceAccounting Link]]

Service - CommerceAccounting Purchase

2026-08-07T06:41:24Z

Mint: /* comAccPurchaseLink */

= Overview =

Handle links between purchases and Accounting records.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccPurchaseLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLink",
canDelete: false,
addOnDataStructure: [
{
type:"rbac"
}

],
belongTo: {
serviceTag: "ComAccLink",
objectType: "comAccLinkByBusiness"
},
storageResources: {
"myGraph":{
storageType: "graph",
graphServerTag: "GraphHandler"
}
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLink",
}
},
fieldNames: {
businessId:{
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
},
accountLinkTag:{ // type of link: inputVAT|salesTax|vatTax..
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
}
accountId:{
type: "string",
requriedOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
}
},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

* sets which Accounting accountId journal entries are added to

== comAccPurchase ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchase",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchase",
}
},
fieldNames: {
// businessId,
// purchaseId,

// record lock eg: prefix: "updatePurchase"
// updatePurchase_status:{requiredOnCreate: true}, // open|lock,
// updatePurchase_uniqueRequestId :{requiredOnCreate: true},
// updatePurchase_timestamp :{requiredOnCreate: true},

journalId: {
type: "string",
optionalOnCreate: true,
canUpdate: true,
storageResourceTags: ["dynamo"],
},

},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "purchaseId"
},
]
}
</syntaxhighlight>

== comAccPurchaseLineItem ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLineItem",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLineItem",
}
},
fieldNames: {
// purchaseId,
// purchaseLineItemId,
// accountId
// lineItemQuantity
// lineItemUnitPricelineItemUnitPrice
// entryId // not sure want to record because multiple lineItems might be in the same entryId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

* This table might not be needed becasue we do not create a journal entry per line item, we make a compound journal entry per purchase
* Keep it for now so we can reconcile Commerce data matches ComAcc data

== Relationships ==

...

= flowSchemas =

== createPurchase ==

* when creating a purchase, iterate purchaseLineItems to decide which journal entries are created
* accountsPayable accountId comes from [[Service - CommerceAccounting Vendor]]
* each purchaseLineItem checks it's type then finds accountId from coresponding comAcc service

=== Example request param from Commerce ===

<syntaxhighlight lang="JavaScript">
{
belongToIdentifiers: {
businessId: "xxx"
},
purchaseId: "",
vendorId: "",
timestamp: 1111111,
purchaseCurrencyId: "",
inventoryLocationId: "", // required if have any inventory/?assets
purchaseLineItems: {
{purchaseLineItemId}: {

inventoryId: "",
inventoryTemplateId: "",
// or
expenseId: "",
// or
servicesId: "",
servicesTemplateId: "",
// or
freightInId: "",
// or

otherPurchaseItemId: "",

type: "", // inventory|expense|services|freight|salesTax|vatTax|other
subType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, other: standard

lineItemQuantity: 1,
lineItemUnitPrice: "2.00"
},
//...
}
}
</syntaxhighlight>

== updatePurchase ==

* make adjustment to journal entries when purchaseLineItemId changes
* handle removal of purchase/journal entries, or creation of new entries
* basically re-calculate all entries and check against existing
* each journalId must check Accounting that it's period/s are not locked, if locked return error, cannot make update

= Working documents =

[[:Category:Working_documents - CommerceAccounting Purchase| CommerceAccounting Purchase]]

[[Category:Backend services| CommerceAccounting Purchase]]

Service - CommerceAccounting Purchase

2026-08-05T03:43:52Z

Mint: /* comAccPurchase */

= Overview =

Handle links between purchases and Accounting records.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccPurchaseLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLink",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLink",
}
},
fieldNames: {
// businessId,
// accountLinkTag // type of link: inputVAT|salesTax|vatTax..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

* sets which Accounting accountId journal entries are added to

== comAccPurchase ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchase",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchase",
}
},
fieldNames: {
// businessId,
// purchaseId,

// record lock eg: prefix: "updatePurchase"
// updatePurchase_status:{requiredOnCreate: true}, // open|lock,
// updatePurchase_uniqueRequestId :{requiredOnCreate: true},
// updatePurchase_timestamp :{requiredOnCreate: true},

journalId: {
type: "string",
optionalOnCreate: true,
canUpdate: true,
storageResourceTags: ["dynamo"],
},

},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "purchaseId"
},
]
}
</syntaxhighlight>

== comAccPurchaseLineItem ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLineItem",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLineItem",
}
},
fieldNames: {
// purchaseId,
// purchaseLineItemId,
// accountId
// lineItemQuantity
// lineItemUnitPricelineItemUnitPrice
// entryId // not sure want to record because multiple lineItems might be in the same entryId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

* This table might not be needed becasue we do not create a journal entry per line item, we make a compound journal entry per purchase
* Keep it for now so we can reconcile Commerce data matches ComAcc data

== Relationships ==

...

= flowSchemas =

== createPurchase ==

* when creating a purchase, iterate purchaseLineItems to decide which journal entries are created
* accountsPayable accountId comes from [[Service - CommerceAccounting Vendor]]
* each purchaseLineItem checks it's type then finds accountId from coresponding comAcc service

=== Example request param from Commerce ===

<syntaxhighlight lang="JavaScript">
{
belongToIdentifiers: {
businessId: "xxx"
},
purchaseId: "",
vendorId: "",
timestamp: 1111111,
purchaseCurrencyId: "",
inventoryLocationId: "", // required if have any inventory/?assets
purchaseLineItems: {
{purchaseLineItemId}: {

inventoryId: "",
inventoryTemplateId: "",
// or
expenseId: "",
// or
servicesId: "",
servicesTemplateId: "",
// or
freightInId: "",
// or

otherPurchaseItemId: "",

type: "", // inventory|expense|services|freight|salesTax|vatTax|other
subType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, other: standard

lineItemQuantity: 1,
lineItemUnitPrice: "2.00"
},
//...
}
}
</syntaxhighlight>

== updatePurchase ==

* make adjustment to journal entries when purchaseLineItemId changes
* handle removal of purchase/journal entries, or creation of new entries
* basically re-calculate all entries and check against existing
* each journalId must check Accounting that it's period/s are not locked, if locked return error, cannot make update

= Working documents =

[[:Category:Working_documents - CommerceAccounting Purchase| CommerceAccounting Purchase]]

[[Category:Backend services| CommerceAccounting Purchase]]

Service - CommerceAccounting Purchase

2026-07-31T06:04:19Z

Mint: /* comAccPurchase */

= Overview =

Handle links between purchases and Accounting records.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccPurchaseLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLink",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLink",
}
},
fieldNames: {
// businessId,
// accountLinkTag // type of link: inputVAT|salesTax|vatTax..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

* sets which Accounting accountId journal entries are added to

== comAccPurchase ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchase",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchase",
}
},
fieldNames: {
// businessId,
// purchaseId,

// record lock
// updatePurchase_status:{requiredOnCreate: true}, // open|lock,
// prefix :{requiredOnCreate: true},// updatePurchase
// updatePurchase_uniqueRequestId :{requiredOnCreate: true},
// updatePurchase_timestamp :{requiredOnCreate: true},

journalId: {
type: "string",
optionalOnCreate: true,
canUpdate: true,
storageResourceTags: ["dynamo"],
},

},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "purchaseId"
},
]
}
</syntaxhighlight>

== comAccPurchaseLineItem ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLineItem",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLineItem",
}
},
fieldNames: {
// purchaseId,
// purchaseLineItemId,
// accountId
// lineItemQuantity
// lineItemUnitPricelineItemUnitPrice
// entryId // not sure want to record because multiple lineItems might be in the same entryId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

* This table might not be needed becasue we do not create a journal entry per line item, we make a compound journal entry per purchase
* Keep it for now so we can reconcile Commerce data matches ComAcc data

== Relationships ==

...

= flowSchemas =

== createPurchase ==

* when creating a purchase, iterate purchaseLineItems to decide which journal entries are created
* accountsPayable accountId comes from [[Service - CommerceAccounting Vendor]]
* each purchaseLineItem checks it's type then finds accountId from coresponding comAcc service

=== Example request param from Commerce ===

<syntaxhighlight lang="JavaScript">
{
belongToIdentifiers: {
businessId: "xxx"
},
purchaseId: "",
vendorId: "",
timestamp: 1111111,
purchaseCurrencyId: "",
inventoryLocationId: "", // required if have any inventory/?assets
purchaseLineItems: {
{purchaseLineItemId}: {

inventoryId: "",
inventoryTemplateId: "",
// or
expenseId: "",
// or
servicesId: "",
servicesTemplateId: "",
// or
freightInId: "",
// or

otherPurchaseItemId: "",

type: "", // inventory|expense|services|freight|salesTax|vatTax|other
subType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, other: standard

lineItemQuantity: 1,
lineItemUnitPrice: "2.00"
},
//...
}
}
</syntaxhighlight>

== updatePurchase ==

* make adjustment to journal entries when purchaseLineItemId changes
* handle removal of purchase/journal entries, or creation of new entries
* basically re-calculate all entries and check against existing
* each journalId must check Accounting that it's period/s are not locked, if locked return error, cannot make update

= Working documents =

[[:Category:Working_documents - CommerceAccounting Purchase| CommerceAccounting Purchase]]

[[Category:Backend services| CommerceAccounting Purchase]]

Service - CommerceAccounting Purchase

2026-07-31T06:04:09Z

Mint: /* comAccPurchase */

= Overview =

Handle links between purchases and Accounting records.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccPurchaseLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLink",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLink",
}
},
fieldNames: {
// businessId,
// accountLinkTag // type of link: inputVAT|salesTax|vatTax..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

* sets which Accounting accountId journal entries are added to

== comAccPurchase ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchase",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchase",
}
},
fieldNames: {
// businessId,
// purchaseId,

// record lock
// updatePurchase_status:{requiredOnCreate: true}, // open|lock,
// prefix {requiredOnCreate: true},// updatePurchase
// updatePurchase_uniqueRequestId :{requiredOnCreate: true},
// updatePurchase_timestamp :{requiredOnCreate: true},

journalId: {
type: "string",
optionalOnCreate: true,
canUpdate: true,
storageResourceTags: ["dynamo"],
},

},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "purchaseId"
},
]
}
</syntaxhighlight>

== comAccPurchaseLineItem ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLineItem",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLineItem",
}
},
fieldNames: {
// purchaseId,
// purchaseLineItemId,
// accountId
// lineItemQuantity
// lineItemUnitPricelineItemUnitPrice
// entryId // not sure want to record because multiple lineItems might be in the same entryId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

* This table might not be needed becasue we do not create a journal entry per line item, we make a compound journal entry per purchase
* Keep it for now so we can reconcile Commerce data matches ComAcc data

== Relationships ==

...

= flowSchemas =

== createPurchase ==

* when creating a purchase, iterate purchaseLineItems to decide which journal entries are created
* accountsPayable accountId comes from [[Service - CommerceAccounting Vendor]]
* each purchaseLineItem checks it's type then finds accountId from coresponding comAcc service

=== Example request param from Commerce ===

<syntaxhighlight lang="JavaScript">
{
belongToIdentifiers: {
businessId: "xxx"
},
purchaseId: "",
vendorId: "",
timestamp: 1111111,
purchaseCurrencyId: "",
inventoryLocationId: "", // required if have any inventory/?assets
purchaseLineItems: {
{purchaseLineItemId}: {

inventoryId: "",
inventoryTemplateId: "",
// or
expenseId: "",
// or
servicesId: "",
servicesTemplateId: "",
// or
freightInId: "",
// or

otherPurchaseItemId: "",

type: "", // inventory|expense|services|freight|salesTax|vatTax|other
subType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, other: standard

lineItemQuantity: 1,
lineItemUnitPrice: "2.00"
},
//...
}
}
</syntaxhighlight>

== updatePurchase ==

* make adjustment to journal entries when purchaseLineItemId changes
* handle removal of purchase/journal entries, or creation of new entries
* basically re-calculate all entries and check against existing
* each journalId must check Accounting that it's period/s are not locked, if locked return error, cannot make update

= Working documents =

[[:Category:Working_documents - CommerceAccounting Purchase| CommerceAccounting Purchase]]

[[Category:Backend services| CommerceAccounting Purchase]]

Service - CommerceAccounting Purchase

2026-07-31T06:03:29Z

Mint: /* comAccPurchase */

= Overview =

Handle links between purchases and Accounting records.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccPurchaseLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLink",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLink",
}
},
fieldNames: {
// businessId,
// accountLinkTag // type of link: inputVAT|salesTax|vatTax..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

* sets which Accounting accountId journal entries are added to

== comAccPurchase ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchase",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchase",
}
},
fieldNames: {
// businessId,
// purchaseId,

// record lock
// updatePurchase_status:{requiredOnCreate: true}, // open|lock, prefix updatePurchase
// updatePurchase_uniqueRequestId :{requiredOnCreate: true},
// updatePurchase_timestamp :{requiredOnCreate: true},

journalId: {
type: "string",
optionalOnCreate: true,
canUpdate: true,
storageResourceTags: ["dynamo"],
},

},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "purchaseId"
},
]
}
</syntaxhighlight>

== comAccPurchaseLineItem ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLineItem",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLineItem",
}
},
fieldNames: {
// purchaseId,
// purchaseLineItemId,
// accountId
// lineItemQuantity
// lineItemUnitPricelineItemUnitPrice
// entryId // not sure want to record because multiple lineItems might be in the same entryId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

* This table might not be needed becasue we do not create a journal entry per line item, we make a compound journal entry per purchase
* Keep it for now so we can reconcile Commerce data matches ComAcc data

== Relationships ==

...

= flowSchemas =

== createPurchase ==

* when creating a purchase, iterate purchaseLineItems to decide which journal entries are created
* accountsPayable accountId comes from [[Service - CommerceAccounting Vendor]]
* each purchaseLineItem checks it's type then finds accountId from coresponding comAcc service

=== Example request param from Commerce ===

<syntaxhighlight lang="JavaScript">
{
belongToIdentifiers: {
businessId: "xxx"
},
purchaseId: "",
vendorId: "",
timestamp: 1111111,
purchaseCurrencyId: "",
inventoryLocationId: "", // required if have any inventory/?assets
purchaseLineItems: {
{purchaseLineItemId}: {

inventoryId: "",
inventoryTemplateId: "",
// or
expenseId: "",
// or
servicesId: "",
servicesTemplateId: "",
// or
freightInId: "",
// or

otherPurchaseItemId: "",

type: "", // inventory|expense|services|freight|salesTax|vatTax|other
subType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, other: standard

lineItemQuantity: 1,
lineItemUnitPrice: "2.00"
},
//...
}
}
</syntaxhighlight>

== updatePurchase ==

* make adjustment to journal entries when purchaseLineItemId changes
* handle removal of purchase/journal entries, or creation of new entries
* basically re-calculate all entries and check against existing
* each journalId must check Accounting that it's period/s are not locked, if locked return error, cannot make update

= Working documents =

[[:Category:Working_documents - CommerceAccounting Purchase| CommerceAccounting Purchase]]

[[Category:Backend services| CommerceAccounting Purchase]]

Service - CommerceAccounting Purchase

2026-07-25T08:44:43Z

Mint: /* comAccPurchase */

= Overview =

Handle links between purchases and Accounting records.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccPurchaseLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLink",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLink",
}
},
fieldNames: {
// businessId,
// accountLinkTag // type of link: inputVAT|salesTax|vatTax..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

* sets which Accounting accountId journal entries are added to

== comAccPurchase ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchase",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchase",
}
},
fieldNames: {
// businessId,
// purchaseId,

// record lock
// updatePurchase_status, // open|lock, prefix updatePurchase
// updatePurchase_uniqueRequestId,
// updatePurchase_timestamp,

journalId: {
type: "string",
optionalOnCreate: true,
canUpdate: true,
storageResourceTags: ["dynamo"],
},

},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "purchaseId"
},
]
}
</syntaxhighlight>

== comAccPurchaseLineItem ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLineItem",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLineItem",
}
},
fieldNames: {
// purchaseId,
// purchaseLineItemId,
// accountId
// lineItemQuantity
// lineItemUnitPricelineItemUnitPrice
// entryId // not sure want to record because multiple lineItems might be in the same entryId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

* This table might not be needed becasue we do not create a journal entry per line item, we make a compound journal entry per purchase
* Keep it for now so we can reconcile Commerce data matches ComAcc data

== Relationships ==

...

= flowSchemas =

== createPurchase ==

* when creating a purchase, iterate purchaseLineItems to decide which journal entries are created
* accountsPayable accountId comes from [[Service - CommerceAccounting Vendor]]
* each purchaseLineItem checks it's type then finds accountId from coresponding comAcc service

=== Example request param from Commerce ===

<syntaxhighlight lang="JavaScript">
{
belongToIdentifiers: {
businessId: "xxx"
},
purchaseId: "",
vendorId: "",
timestamp: 1111111,
purchaseCurrencyId: "",
inventoryLocationId: "", // required if have any inventory/?assets
purchaseLineItems: {
{purchaseLineItemId}: {

inventoryId: "",
inventoryTemplateId: "",
// or
expenseId: "",
// or
servicesId: "",
servicesTemplateId: "",
// or
freightInId: "",
// or

otherPurchaseItemId: "",

type: "", // inventory|expense|services|freight|salesTax|vatTax|other
subType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, other: standard

lineItemQuantity: 1,
lineItemUnitPrice: "2.00"
},
//...
}
}
</syntaxhighlight>

== updatePurchase ==

* make adjustment to journal entries when purchaseLineItemId changes
* handle removal of purchase/journal entries, or creation of new entries
* basically re-calculate all entries and check against existing
* each journalId must check Accounting that it's period/s are not locked, if locked return error, cannot make update

= Working documents =

[[:Category:Working_documents - CommerceAccounting Purchase| CommerceAccounting Purchase]]

[[Category:Backend services| CommerceAccounting Purchase]]

Service - Entry

2026-06-26T08:04:31Z

Mint: /* entry */

= Overview =

A credit or debit entry linking between a journal entry and an account.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== entry ==

<syntaxhighlight lang="JavaScript">
{
objectType: "entry",
canDelete: false,
belongTo: {
serviceTag: "Organization",
objectType: "organization"
},
addOnDataStructure: [
{
type: "versionedData",
versionedDataLabel: "Detail",
storageResourceTag: "myGraph",
fieldNames: {
amount: {
type: "currencyValue", // string|integer|currency|currencyValue|float|special|object|boolean|arrayMixed|arrayNumeric|arrayString
requiredOnCreate: true, // default = false
},
functionalCurrencyAmount: {
type: "currencyValue",
requiredOnCreate: true,
}
}
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
},
"dynamo": {
"storageType": "dynamoDB",
"tableName": "entry",
}
},
fieldNames: {
entryId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
}

},
identifiers: [
{
type: "identifier",
fieldName: "entryId"
}
]
}
</syntaxhighlight>

* accountingStatus: when a period is being closed we set all entries to processing, then once the return is completed set to locked
* when beginning process of an entry, maybe trigger ComAcc plugin to check whether journalId can be locked, for example if it is connected to a sale and the sale is in saleCommitted=working/updateWorking cannot be locked
* when processing or locked entries cannot be changed (journals cannot be changed if either of the entries on each side are processing or locked
* maybe the journal also has an accountingStatus, so easy to confirm cannot make changes, or perhaps only journals because entries cannot be changed directly

== Relationships ==

=== hasEntry ===

<syntaxhighlight lang="JavaScript">
{
hasEntry: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Journal",
objectType: "journal"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "Entry",
objectType: "entry"
},
requiredOnCreate: true,
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

=== hasEntry ===

<syntaxhighlight lang="JavaScript">
{
hasEntry: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Journal",
objectType: "journal"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "Entry",
objectType: "entry"
},
requiredOnCreate: true,
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

=== oldEntry ===

<syntaxhighlight lang="JavaScript">
{
oldEntry: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Journal",
objectType: "journal"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "Entry",
objectType: "entry"
},
requiredOnCreate: true,
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

* has can change to old, but old cannot change to has, create new entry if make new that links to same account

=== inAccount ===

<syntaxhighlight lang="JavaScript">
{
inAccount: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Entry",
objectType: "entry"
},
requiredOnCreate: true,
linkType: "many"
},
to: {
objType: {
serviceTag: "AccountManager",
objectType: "account"
},
linkType: "one"
}
},
]
}
}
</syntaxhighlight>

= Working documents =

[[:Category:Working_documents - Entry| Entry]]

[[Category:Backend services| Entry]]

2025-11-20 IntegrationTest

2026-06-17T04:09:26Z

Mint: /* Empty */

Reference:

*[[2020-10-01 - Integration Test Config - Functions|IntegrationtestConfig]]
*[[2020-10-01 - Integration Testing - Lambda Functions|Integrationtesting]]
*[[2025-02-20 - Integration Test examples|Example]]

= File extension =

uploadS3: ".json"
integrationtestConfig: ".js"

=TestRecord=

<syntaxhighlight lang="JSON">
[
{
integrationTestTag: "Integrationtest_xx",
testStartedTimestamp: 111111111, // start time
bucketName: "integrationtest-config-us-east-2",
lastUpdateUniqueRequestId: "sssss", //_izContext.uniqueRequestId protacts race coditionn dynamodb
testStatus: "passed",//failed,processing,passed
testCompleteTimestamp: 1111113, // all test finish
stages: [
{
stageConfig: {
//straight copy of this stage from integration test config
inputEventTag: "xx",
inputEventConfig: {//event input
},
outputEventTag: "output_xx",
outputEventConfig: {//event out put
},
resourceName: "ComplexfilterTestProcessComplexfilter",// function name
resourceType: "Lambda", // function name
serviceTag: "Complexfilter",// (initeate sqs)
snsServiceName: "Complexfilter",// (initeate sqs)
snsTopic: "PorcessComplexfilter_In"// (initeate sqs)

},
stageStatus: "waiting", //waiting|passed|failed,
stageFinishedTimestamp: 111111111,// time that all tests finished and testRecord.stages.{stageKey}.stageStatus updated
stageResults: {
//results at the point of entering the resource (eg a Lambda function is invoked)
inputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of returning from the resource (eg a Lambda function returns)
outputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of invoking an external resource (eg the tested Lambda function is invoking another Lambda function)
invokes: {
"serviceName_resourceType_resourceName_inputEventTag ": {
invokeTimestamp: 111111111,//{ time result saved },
resultTimestamp: 111111112,//{ time result saved },
resultStatus: "passed",//passed | failed,
invokeParams: {},//{event invoke input config }
requestParams: {}// event invoke input request
},
},
dynamodbResults: [
{
indexOfDynamodbOutput: 0,
requestParams,
resultStatus: "passed",//
resultTimestamp: 22222
}]

},
stageErrors: [
//misc errors encountered
]
}]

}
]
</syntaxhighlight>

=Seed Data=
integrationtest manager seed date 2 process

=== Main Seed Data===
:Save file in s3 (in '''buckname''' :integrationtest-config-us-east-2, '''folder''':seedData_integrationTest).For other dev use service,If a developer wants to add more for other important testing purposes.

'''How to use:'''
#Add it from the s3 bucket at this point
#Run batch refreshSeedData [[Developer guide for making Integration Tests#Bash script|batch RefreshSeedData]]
'''Logic''':Process by storage resouse (graph or dynamodb)
:To clean up the seed data in the table after it creates seed data form service deploy and pulls seed data from s3.

=== Refresh Seed Data ===
:ProcessRefreshSeedData use seedDataTag for create data environment of '''test''' and can be refresh seeddata re-test agian.
:'''canbe share''' seed data for other test by seed data tag.
'''How to use:'''
:Save file in s3 (for other dav keep in floder dev name) or testConfig/seedData_config(for admin)

'''Folder'''
*dynamoDBSeedDataTags.json
*graphSeedDataTags.json

'''Example'''
==== dynamoDBSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource dynammodb.
Example
<syntaxhighlight lang="JavaScript">
{
"seedDynamodb_abc_ver2": [ // seedDataTag
{
"tableName": "DelivMethodSTDTestLogicalResultsData", // servcieTag+stage+tablename
"partitionKey": "logicalResultId",
"sortKey": "identifiersId",
"datas": [
{
"logicalResultId": "eeeeeeeeee4",
"identifiersId": "lllll123456"
},
{
"logicalResultId": "eeeeeeeeee4",
"identifiersId": "lllll777777"
}
]
},
{
"tableName": "MLocationsTestFloatingRelationships",// servcieTag+stage+tablename
"partitionKey": "importBatchId",
"sortKey": "identifierRelationshipsId",
"datas": [
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll123456"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll777777"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll99999999"
}
]
},
{
"tableName": "MLocationsTestFindDataMain",
"partitionKey": "findDataId",
"datas": [
{
"findDataId": "111111"
},
{
"findDataId": "22222"
},
{
"findDataId": "333333"
}
]
}
]
}
</syntaxhighlight>

==== graphSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource graphHanler.
Example
<syntaxhighlight lang="JavaScript">
{
"seedData_testTag_GG": [ // seedDataTag
{
"nodes": [
{
"nodeLabels": [
"SellOfferPlan_sellOfferPlanDeliveryMethodLink"
],
"objectDetail": {
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": "minttestrefreshSeedData_01"
},
"fields": {
"productId": "ddddd",
"price": 9999
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMall"
],
"objectDetail": {
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
},
"fields": {
"name": "hotpot-man",
"totalPrice": 500
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMallCalculateSetting"
],
"objectDetail": {
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
},
"fields": {
"addToCalculatedValuePerOrder": 10,
"addToRateTableValuePerOrder": 77
}
}
}
],
"relationships": [
{
"fromObject": {
"nodeLabel": "SellOfferPlan_sellOfferPlanDeliveryMethodLink",
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": "minttestrefreshSeedData_01"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"relationships": [
{
"relTypeConcat": "SellOfferPlan_hasCCCCCCC",
"relId": "uuid-4s56df74s9df79w-w6de4f5w689ef"
}
]
},
{
"fromObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMallCalculateSetting",
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
}
},
"relationships": [
{
"relTypeConcat": "servcieMintTest_shoppingMall_currentShoppingMallCalculateSetting",
"relId": "uuid-s122df5-s21df",
"relationshipProperty": {
"timeStamp": 1234567879,
"statusName": true
}
},
{
"relTypeConcat": "servcieMintTest_shoppingMall_hasShoppingMallCalculateSetting",
"relId": "uuid-77777-99999",
"relationshipProperty": {
"statusName": true
}
}
]
}
]
}
],
"seedData_testTag_ABC": [
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": [
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "hasProductAttributeLink"
},
"relationshipDirection": "to",
"targetObjType": {
"serviceTag": "ProductStandard",
"objectType": "productStandard"
},
"targetIdentifiers": {
"productId": "f526a367a2b66cb0f37ca61b6c43f419929f521d"
},
"relationshipProperties": {}
},
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "isProductAttribute"
},
"relationshipDirection": "from",
"targetObjType": {
"serviceTag": "ProductAttribute",
"objectType": "productAttribute"
},
"targetIdentifiers": {
"productAttributeId": "f4bf7a078071d54036656df544197ba638bc3a68"
},
"relationshipProperties": {}
}
]
},
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": []
}
],
"seedData_testTag_LL": []
}
</syntaxhighlight>

=== Cleaning Seed Data ===
:Delete seed data for set environment of '''test'''.
*cleaningeDynamoOneRecordsTags.json
*cleaningeDynamoManyRecordsTags.json

====cleaningeDynamoOneRecordsTags====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_TestFindData_and_Education_case_invalid01": [
{
"tableName": "MLocationsTestFindDataMain",
"primaryKeys": [
{
"findDataId": "cleaning-1"
},
{
"findDataId": "cleaning-2"
}
]
},
{
"tableName": "MLocationsTestEducation",
"primaryKeys": [
{
"studentId": "cleaning-AA"
},
{
"studentId": "cleaning-BB"
},
{
"studentId": "cleaning-CC"
}
]
}
],
"cleaningSeed_TestMemberPersonnel_case_invalid01": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "namtan",
"passwordId": "qqqww"
},
{
"userId": "jack",
"passwordId": "q1"
},
{
"userId": "Momay",
"passwordId": "ttr"
}
]
}
]
}
</syntaxhighlight>

==== cleaningeDynamoManyRecordsTags ====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_manyData_partitionKey_only_miss_sort": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "many-data"
}
]
}
]
}
</syntaxhighlight>

*logic query table MLocationsTestMemberPersonnel use primary Keys "userId" and then delete all data from primary Keys.

=resources=
syntax is object
<syntaxhighlight lang="JavaScript">
{
"Lambda":{
"{FunctionNameHdrSqs}":{ // FunctionNameHdrSqs is match resourceName in file tests
"localLacation":"/src/FunctionNameHdrSqs.js",
"localHandler":"main",
"functionName":"FunctionNameHdrSqs" // FunctionName is function name match key of function.yml of servcie.
},
"ProcessComplexFilterHdrSqs":{
"localLacation":"/src/ProcessComplexFilterHdrSqs.js",
"localHandler":"main",
"functionName":"ProcessComplexFilterHdrSqs"
},
...
},
"Dynamodb": {
"filterMain":{ // match resourceName in file tests(dynamodbOutputEventIdentifiers)
"tableName":"filterMain"
},
"tableNameBB":{
"tableName":"tableNameBB"
},
...
}
}
</syntaxhighlight>

=events=
Syntax is object
==Syntax Name==
===FileName===
::Event_{inputEventTag}

===eventTag===
#inputEventTag
#outputEventTag
#dynamodbTag

*file events.js is have eventTag (inputEventTag,outputEventTag,dynamodbTag)
**How to create name eventTag
***Example case : "test in service complexFilter functionname ProcessComplexFilter case element type is logical basic".
::*'''inputEventTag'''
::::{serviceName}_{functionName}_{caseTest}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''outputEventTag'''
::::output_{inputEventTag}
''output_Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''dynamodbTag'''
::::{inputEventTag}__Dynamodb__{'''action*'''}_{tableName}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic___Dynamodb__putItem_filterMain''
: '''{action}''' is only ''put'' or ''update'', and in case of ''update'' must only test the last step of update 

=== Syntax event===
====initiate by handlerServcie====
=====Sqs=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Sns
{
"LambdaFunctionHdrSqs_input__pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
},
"propertyB":{
"properties":{
"propertyB1":{
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"value":"msgTag"
},
"propertyD":{
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
<syntaxhighlight lang="JavaScript" linein>
"snsSqsTrigger":true
</syntaxhighlight>

=====Dsq=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Direct Sqs
{
"LambdaFunctionHdrDsq_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"DirectSqs":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrDsq_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
* DirectSqs = true
:: for initialStage of Dsq
* messageAttributes is optional

=====Inv=====
<syntaxhighlight lang="JavaScript">
{
"LambdaFunctionHdrInv_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
}
}
},
{
"output_LambdaFunctionHdrInv_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>

=====Api=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of API
{
"LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"forstageMatvhing": true,
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1",
},
"propertyB": {
"properties": {
"propertyB1": {
"value": "valuePropertyB1",
}
}
},
"propertyC": {
"eventValue": [
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3",
]
},
...
}
}
}
},
"Output_LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1"
},
...
}
}
}
}
}
</syntaxhighlight>

=====S3=====

====dynamodb====
<syntaxhighlight lang="JavaScript">
// An example event of Dynamodb //optional
{
{inputEventTag}__dynamodb_{action}_{tablename}: { // eg. "Complexfilter_ProcessComplexfilter_logical_basic__dynamodb_update_FilterMain"
"forStageMatching": true,
"properties": {
"filterMainUniqueRequestId": {
"testValueMatches": fase,
"value": "bbc4f4a9-2032-4dec-9129-8c7d169fecc5"
},
"filterObject": {
"forStageMatching": true,
"properties": {
"logicalType": {
"value": "partitionKey"
},
"comparison": {
"value": "equals"
},
"type": {
"value": "logical"
},
"partitionKey": {
"forStageMatching": true,
"value": "mockIntegratioTestCPF"
}
}
},
"filterMainExpiryTime": {
"testValueMatches": fase,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": fase,
"value": 1731894402678
},
"objType": {
"forStageMatching": true,
"properties": {
"serviceTag": {
"forStageMatching": true,
"value": "IntTesting"
},
"objectType": {
"forStageMatching": true,
"value": "TestRecord"
}
}
}
},
"keyValues": {
"filterMainId": "4865d2451a621cb7f71225cfabf2df4f98e20801",
"objTypeId": "cdb170690571df7522b3850920fce02507c077ee"
}
}
}
</syntaxhighlight>

* partition key: filterMainId
* sort key: objTypeId

[[2021-01-15 - Integration Testing - Adding DynamoDB result tests]]

===Type paramiter===
use for evnet and dyanmodb event
====Normal====
<syntaxhighlight lang="JavaScript">

object: {
forStageMatching: true,
properties: {
name:{
forStageMatching: true,
value:"Tom"
}
}
},
array: {
forStageMatching: true,
useIsEqual: true,
eventValue: [
{
"relTypeAndDirection": {
"relType": {
"serviceTag": "maxxCart2",
"relationshipTag": "hasCartOrder"
},
"relationshipDirection": "from"
},
"targetObjects": [
{
"objType": {
"serviceTag": "maxxCart2",
"objectType": "cartOrder"
}
}
]
}
]
},
number: {
forStageMatching: true,
value: 1111
},
string: {
forStageMatching: true,
value: "hi"
},
boolean: {
forStageMatching: true,
value: true
}
</syntaxhighlight>

<syntaxhighlight lang="JavaScript">
forStageMatching: true
</syntaxhighlight>
::set true for check match value,It is not necessary to set every value
:::use in test importent paramiter

<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
::setting paramiter require on create but can not test random value eg: identifier or timeStamp or uuid

====Empty====
<syntaxhighlight lang="JavaScript">
EmptyString:{
forStageMatching: true,
value:""
},
EmptyArray:{
forStageMatching: true,
useIsEqual: true,
eventValue: []
},
EmptyObject:{
forStageMatching: true,
value:{}
}
</syntaxhighlight>

====Error====
can test noRetryError
<syntaxhighlight lang="JavaScript">
"errorMessage": {
forStageMatching: true,
"value": "Not found schema of {serviceTag:TestGraphHandler, objectType:notFoundObjType}"
}
</syntaxhighlight>

====Paramiter random====
Can not test case random numbber or uuid.
But requriOnCreate mush be set
<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
or set
<syntaxhighlight lang="JavaScript">
forStageMatching:false
</syntaxhighlight>

=tests=
Syntax is array of object
==Syntax name==
===Testtag name ===
*{integrationTestTag}
#Test Own servcie or not a lot stage
<syntaxhighlight lang="JavaScript">
Test_{inputEventTag}
</syntaxhighlight>
#Mix multiple servcie and multiple stage
<syntaxhighlight lang="JavaScript">
IntegrationTest_{inputEventTag}
</syntaxhighlight>

===File name ===
<syntaxhighlight lang="JavaScript">
{integrationTestTag}.json
</syntaxhighlight>

==Setting of test==
[[Service - Integration Test Config#tests.js Syntax|syntax test]]

<syntaxhighlight lang="JavaScript">
{
integrationTestTag: {integrationTestTag},
productionSafe: true|false, //default false
noInitialStage: true, // default false, if set to true, no error when no foundInitialStages found
errorIfStageUndefined: true|false, //default false
errorIfInvokeUndefined: true|false, //default false,
dynamoDBSeedDataTags:["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
graphSeedDataTags:["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
cleaningeDynamoOneRecordsTags: ["cleaningSeed_partitionKey_sortKey_normol"], //optional
cleaningeDynamoManyRecordsTags: [], // optional
stages:[
...
]
}
</syntaxhighlight>
*[[2025-11-20 IntegrationTest#dynamoDBSeedDataTags|dynamoDBSeedDataTags]]
*[[2025-11-20 IntegrationTest#graphSeedDataTags|graphSeedDataTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoOneRecordsTags|cleaningeDynamoOneRecordsTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoManyRecordsTags|cleaningeDynamoManyRecordsTags]]

==Stages==
====Initiate stage====
:'''"initialStage":true'''
[[Service_-_Integration_Test_Config#tests.js Syntax|detail property of test]]
=====HandlerService=====
======Sqs======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"Locations_ProcessLocationNodeSomting_casenotHaveData",
"serviceName":"Locations",
"resourceType":"Lambda",
"resourceName":"ProcessLocationNodeSomtingHdrDsq",
"outputEventTag":"Output_Locations_ProcessLocationNodeSomting_casenotHaveData"
}
]
</syntaxhighlight>
======Dsq======
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'LambdaFunctionHdrDsq_input_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'LambdaFunctionHdrDsq_output__returnvalue_pass',
// **** not set snsServiceName and snsTopic
// can be test dynamodbOutput
}
]
</syntaxhighlight>

======Api======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrApi_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrApi",
"outputEventTag":"LambdaFunctionHdrApi_output__pass"
}
]
</syntaxhighlight>

======Inv======
*'''single stage'''
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": ["cleaningSeed_partitionKey_sortKey_normol"], //optional
"cleaningeDynamoManyRecordsTags": []
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass"
}
]
}]
</syntaxhighlight>
*'''invoke multiple stage'''
:*Each stage test can invoke multiple lambda by use "eventStage Tag" point to stage for test integration test.
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv_invokes__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": [], //optional
"cleaningeDynamoManyRecordsTags": [], // optional
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass",
"invokes":[
{
"eventStageTag":"service_invokesB__pass"
},
{
"eventStageTag":"service_invokesD__pass"
}
]
},
{
"eventStageTag":"service_invokesB__pass",
"inputEventTag":"input_service_invokes__pass",
"serviceName":"ServiceTemplate_B",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_B_HdrInv",
"outputEventTag":"output_service_invokes__pass"
},
{
"eventStageTag":"service_invokesD__pass",
"inputEventTag":"input_service_invokesD__pass",
"serviceName":"ServiceTemplate_D",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_D_HdrInv",
"outputEventTag":"output_service_invokesD__pass"
}
]
}]
</syntaxhighlight>

======S3======
======Batch======

====GeneratedSeedData====
*Integrationtest must be delete identifier every time before test.
*Set 'generatedSeedData' in file tests.json case by case of stage eg: stages[0] create identifier is randomOnCreate will set 'generatedSeedData' and stages[1] create relationship is randomOnCreate(It is usually random, except in the case of relationship version) set generatedSeedData this stages[1].
*How to delete case identifier rendomOnCreate?: set in stage use setting generateSeedData "randomOnCreateIdentifier"
#randomOnCreateIdentifier
#notRandomOnIdentifier
#relationships
=====randomOnCreateIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"randomOnCreateIdentifier": [
{
"objType": {
"serviceTag": "MLocations",
"objectType": "Member"
},
"identifierValue": "Jaya-member-001"
}
]
}
}
]
</syntaxhighlight>
=====notRandomOnIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"notRandomOnIdentifier": [
{
"objType": {
"serviceTag": "gggg",
"objectType": "ssssss"
},
"identifiers": {
"topId": "123456"
}
}
]
}
}
]
</syntaxhighlight>
=====relationships=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"relationships": [
{
"relType": {
"serviceTag": "PaymentMethodGeneric",
"relationshipTag": "disabledPaymentMethodGenericPropertyValue"
},
"relId": "f4f73de7-647c-4b3b-8043-87cc002f361a"
}
]
}
}
]

</syntaxhighlight>

==Dynamodb==
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'output_Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
dynamodbOutputEventIdentifiers: [
{
serviceName: {tableName}, //service that deployed the DynamoDB table, so can build table's full resource name
resourceName: {resourceName}, //DynamoDB resourceName
eventTag: {eventTagDynamoDB}
}
],
}
]
</syntaxhighlight>

= Result of integrationtest =
Data have 2 table "TestRecord" and "TestUnit".
:- TestRecord is table all unti of stage inside eg input output invokes and dynamodb
:- TestUnit is store status each unit
each unit save in table TestUnit
testRecordId is name of test concat with testTime.
testUnitId is point to position of unti instage.
resultStatus is status of unit.
<syntaxhighlight lang="JavaScript">
eg:
input_0 = stages index 0 result '''input'''
output_1 = stages index 1 result '''output'''
invokeInput_0_1 = stages index 0 result '''invokes''' index 1 position input
invokeOutput_0_1 = stages index 0 result '''invokes''' index 1 position output
dynamodb_0_1 = stages index 0 result '''dynamodb''' index 1.
</syntaxhighlight>

after all TestUnit finish (check by awaitingMultiplestep penditnStep is integrationtestTag awaitingStepId is each TestUnit )
check all awaitingStep finish send message to ultimateIntegrationtest for sumla all test is status

== Summary of test status ==
:1.testStatus is "passed" all unit passed.
:2.testStatus is "failed" have some is failed.
:3.testStatus is "processing" have some is have status processing after check all awaiting step is finish.
:4.testStatus is "failed" have record "errorsTest" in case "not match stage invoke", 'found multiple matchingInvokes

*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

=How to test integrationtest s3=
[[Developer guide for making Integration Tests]]

[[Category:Working documents| 2025-11-20]]
[[Category:Working documents - Integration Testing| 2025-11-20]]

Service - Organization

2026-06-11T04:25:28Z

Mint: /* organization */

= Overview =

A user can have many organizations, each organization has it's independent accounting.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== organization ==

<syntaxhighlight lang="JavaScript">
{
objectType: "organization",
canDelete: false,
addOnDataStructure: [
{
type: "propertyValue"
},
{
type:"versionedData",
versionedDataLabel: "Detail",
storageResourceTag : "myGraph",
fieldNames: {
"organizationName":{
type: "string",
requiredOnCreate: true,
canUpdate: true,
userCanUpdate: true,
},
"dailyRateCurrencyTableId":{
type: "string",
requiredOnCreate: true,
canUpdate: true,
userCanUpdate: true,
},
}
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
fieldNames: {
organizationId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph']
},
functionalCurrency: {
type: "currency",
requiredOnCreate: true,
canUpdate: false,
userCanUpdate: false,
storageResourceTags: ['myGraph']
},

precision: {
type: "integer",
randomOnCreate: false,
optionalOnCreate: true,
requiredOnCreate: false,
validation: {
pattern: pattern
},
storageResourceTags: ['graph'],
}
},
identifiers: [
{
type: "identifier",
fieldName: "organizationId"
}
]
}
</syntaxhighlight>

== Relationships ==

=== hasOrganization ===

<syntaxhighlight lang="JavaScript">
{
hasOrganization: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
canChangeToRelTypes: [
{
serviceTag:"Organization",
relationshipTag: "removedOrganization"
},
],
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "User",
objectType: "user"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "Organization",
objectType: "organization"
},
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

=== removedOrganization ===

<syntaxhighlight lang="JavaScript">
{
removedOrganization: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
canChangeToRelTypes: [
{
serviceTag:"Organization",
relationshipTag: "hasOrganization"
},
],
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "User",
objectType: "user"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "Organization",
objectType: "organization"
},
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

* links a user to the organization they manage
* does not convey ownership, each organization is a standalone organization that has it's own RBAC
* this allows for simple transfer of ownership of data

= Addresses =

* use same structure as users in Izara Market

= Working documents =

[[:Category:Working_documents - Organization| Organization]]

[[Category:Backend services| Organization]]

Service - Entry

2026-06-11T04:24:27Z

Mint: /* entry */

= Overview =

A credit or debit entry linking between a journal entry and an account.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== entry ==

<syntaxhighlight lang="JavaScript">
{
objectType: "entry",
canDelete: false,
belongTo: {
serviceTag: "Organization",
objectType: "organization"
},
addOnDataStructure: [
{
type: "versionedData",
versionedDataLabel: "Detail",
storageResourceTag: "myGraph",
fieldNames: {
amount: {
type: "currencyValue", // string|integer|currency|currencyValue|float|special|object|boolean|arrayMixed|arrayNumeric|arrayString
requiredOnCreate: true, // default = false
},
functionalCurrencyAmount: {
type: "currencyValue",
requiredOnCreate: true,
}
}
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
},
"dynamo": {
"storageType": "dynamoDB",
"tableName": "entry",
}
},
fieldNames: {
entryId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
},
amount: {
type: "numeric",
requiredOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
},
functionalCurrencyAmount: {
type: "currencyValue",
storageResourceTags: ['myGraph']
}

},
identifiers: [
{
type: "identifier",
fieldName: "entryId"
}
]
}
</syntaxhighlight>

* accountingStatus: when a period is being closed we set all entries to processing, then once the return is completed set to locked
* when beginning process of an entry, maybe trigger ComAcc plugin to check whether journalId can be locked, for example if it is connected to a sale and the sale is in saleCommitted=working/updateWorking cannot be locked
* when processing or locked entries cannot be changed (journals cannot be changed if either of the entries on each side are processing or locked
* maybe the journal also has an accountingStatus, so easy to confirm cannot make changes, or perhaps only journals because entries cannot be changed directly

== Relationships ==

=== hasEntry ===

<syntaxhighlight lang="JavaScript">
{
hasEntry: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Journal",
objectType: "journal"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "Entry",
objectType: "entry"
},
requiredOnCreate: true,
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

=== hasEntry ===

<syntaxhighlight lang="JavaScript">
{
hasEntry: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Journal",
objectType: "journal"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "Entry",
objectType: "entry"
},
requiredOnCreate: true,
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

=== oldEntry ===

<syntaxhighlight lang="JavaScript">
{
oldEntry: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Journal",
objectType: "journal"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "Entry",
objectType: "entry"
},
requiredOnCreate: true,
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

* has can change to old, but old cannot change to has, create new entry if make new that links to same account

=== inAccount ===

<syntaxhighlight lang="JavaScript">
{
inAccount: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Entry",
objectType: "entry"
},
requiredOnCreate: true,
linkType: "many"
},
to: {
objType: {
serviceTag: "AccountManager",
objectType: "account"
},
linkType: "one"
}
},
]
}
}
</syntaxhighlight>

= Working documents =

[[:Category:Working_documents - Entry| Entry]]

[[Category:Backend services| Entry]]

Service - CommerceAccounting Purchase

2026-06-10T08:37:04Z

Mint:

= Overview =

Handle links between purchases and Accounting records.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== comAccPurchaseLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLink",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLink",
}
},
fieldNames: {
// businessId,
// accountLinkTag // type of link: inputVAT|salesTax|vatTax..
// accountId
},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "accountLinkTag"
},
]
}
</syntaxhighlight>

* sets which Accounting accountId journal entries are added to

== comAccPurchase ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchase",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchase",
}
},
fieldNames: {
// businessId,
// purchaseId,
journalId: {
type: "string",
optionalOnCreate: true,
canUpdate: true,
storageResourceTags: ["dynamo"],
},

},
identifiers: [
{
type: "partitionKey",
fieldName: "businessId",
},
{
type: "sortKey",
fieldName: "purchaseId"
},
]
}
</syntaxhighlight>

== comAccPurchaseLineItem ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLineItem",
canDelete: false,
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLineItem",
}
},
fieldNames: {
// purchaseId,
// purchaseLineItemId,
// accountId
// lineItemQuantity
// lineItemUnitPricelineItemUnitPrice
// entryId // not sure want to record because multiple lineItems might be in the same entryId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

* This table might not be needed becasue we do not create a journal entry per line item, we make a compound journal entry per purchase
* Keep it for now so we can reconcile Commerce data matches ComAcc data

== Relationships ==

...

= flowSchemas =

== createPurchase ==

* when creating a purchase, iterate purchaseLineItems to decide which journal entries are created
* accountsPayable accountId comes from [[Service - CommerceAccounting Vendor]]
* each purchaseLineItem checks it's type then finds accountId from coresponding comAcc service

=== Example request param from Commerce ===

<syntaxhighlight lang="JavaScript">
{
belongToIdentifiers: {
businessId: "xxx"
},
purchaseId: "",
vendorId: "",
timestamp: 1111111,
purchaseCurrencyId: "",
inventoryLocationId: "", // required if have any inventory/?assets
purchaseLineItems: {
{purchaseLineItemId}: {

inventoryId: "",
inventoryTemplateId: "",
// or
expenseId: "",
// or
servicesId: "",
servicesTemplateId: "",
// or
freightInId: "",
// or

otherPurchaseItemId: "",

type: "", // inventory|expense|services|freight|salesTax|vatTax|other
subType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, other: standard

lineItemQuantity: 1,
lineItemUnitPrice: "2.00"
},
//...
}
}
</syntaxhighlight>

== updatePurchase ==

* make adjustment to journal entries when purchaseLineItemId changes
* handle removal of purchase/journal entries, or creation of new entries
* basically re-calculate all entries and check against existing
* each journalId must check Accounting that it's period/s are not locked, if locked return error, cannot make update

= Working documents =

[[:Category:Working_documents - CommerceAccounting Purchase| CommerceAccounting Purchase]]

[[Category:Backend services| CommerceAccounting Purchase]]

Service - Entry

2026-06-10T04:53:47Z

Mint:

= Overview =

A credit or debit entry linking between a journal entry and an account.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== entry ==

<syntaxhighlight lang="JavaScript">
{
objectType: "entry",
canDelete: false,
belongTo: {
serviceTag: "Organization",
objectType: "organization"
},
addOnDataStructure: [],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
},
"dynamo": {
"storageType": "dynamoDB",
"tableName": "entry",
}
},
fieldNames: {
entryId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
},
amount: {
type: "numeric",
requiredOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
},
functionalCurrencyAmount: {
type: "currencyValue",
storageResourceTags: ['myGraph']
}

},
identifiers: [
{
type: "identifier",
fieldName: "entryId"
}
]
}
</syntaxhighlight>

* accountingStatus: when a period is being closed we set all entries to processing, then once the return is completed set to locked
* when beginning process of an entry, maybe trigger ComAcc plugin to check whether journalId can be locked, for example if it is connected to a sale and the sale is in saleCommitted=working/updateWorking cannot be locked
* when processing or locked entries cannot be changed (journals cannot be changed if either of the entries on each side are processing or locked
* maybe the journal also has an accountingStatus, so easy to confirm cannot make changes, or perhaps only journals because entries cannot be changed directly

== Relationships ==

=== hasEntry ===

<syntaxhighlight lang="JavaScript">
{
hasEntry: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Journal",
objectType: "journal"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "Entry",
objectType: "entry"
},
requiredOnCreate: true,
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

=== hasEntry ===

<syntaxhighlight lang="JavaScript">
{
hasEntry: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Journal",
objectType: "journal"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "Entry",
objectType: "entry"
},
requiredOnCreate: true,
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

=== oldEntry ===

<syntaxhighlight lang="JavaScript">
{
oldEntry: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Journal",
objectType: "journal"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "Entry",
objectType: "entry"
},
requiredOnCreate: true,
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

* has can change to old, but old cannot change to has, create new entry if make new that links to same account

=== inAccount ===

<syntaxhighlight lang="JavaScript">
{
inAccount: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Entry",
objectType: "entry"
},
requiredOnCreate: true,
linkType: "many"
},
to: {
objType: {
serviceTag: "AccountManager",
objectType: "account"
},
linkType: "one"
}
},
]
}
}
</syntaxhighlight>

= Working documents =

[[:Category:Working_documents - Entry| Entry]]

[[Category:Backend services| Entry]]

2025-11-20 IntegrationTest

2026-06-05T03:36:51Z

Mint: /* Table test */

Reference:

*[[2020-10-01 - Integration Test Config - Functions|IntegrationtestConfig]]
*[[2020-10-01 - Integration Testing - Lambda Functions|Integrationtesting]]
*[[2025-02-20 - Integration Test examples|Example]]

= File extension =

uploadS3: ".json"
integrationtestConfig: ".js"

=TestRecord=

<syntaxhighlight lang="JSON">
[
{
integrationTestTag: "Integrationtest_xx",
testStartedTimestamp: 111111111, // start time
bucketName: "integrationtest-config-us-east-2",
lastUpdateUniqueRequestId: "sssss", //_izContext.uniqueRequestId protacts race coditionn dynamodb
testStatus: "passed",//failed,processing,passed
testCompleteTimestamp: 1111113, // all test finish
stages: [
{
stageConfig: {
//straight copy of this stage from integration test config
inputEventTag: "xx",
inputEventConfig: {//event input
},
outputEventTag: "output_xx",
outputEventConfig: {//event out put
},
resourceName: "ComplexfilterTestProcessComplexfilter",// function name
resourceType: "Lambda", // function name
serviceTag: "Complexfilter",// (initeate sqs)
snsServiceName: "Complexfilter",// (initeate sqs)
snsTopic: "PorcessComplexfilter_In"// (initeate sqs)

},
stageStatus: "waiting", //waiting|passed|failed,
stageFinishedTimestamp: 111111111,// time that all tests finished and testRecord.stages.{stageKey}.stageStatus updated
stageResults: {
//results at the point of entering the resource (eg a Lambda function is invoked)
inputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of returning from the resource (eg a Lambda function returns)
outputResult: {
resultTimestamp: 111111111,//{time result saved},
resultStatus: "passed",//passed|failed,
requestParams: {//event input
}
},
//results at the point of invoking an external resource (eg the tested Lambda function is invoking another Lambda function)
invokes: {
"serviceName_resourceType_resourceName_inputEventTag ": {
invokeTimestamp: 111111111,//{ time result saved },
resultTimestamp: 111111112,//{ time result saved },
resultStatus: "passed",//passed | failed,
invokeParams: {},//{event invoke input config }
requestParams: {}// event invoke input request
},
},
dynamodbResults: [
{
indexOfDynamodbOutput: 0,
requestParams,
resultStatus: "passed",//
resultTimestamp: 22222
}]

},
stageErrors: [
//misc errors encountered
]
}]

}
]
</syntaxhighlight>

=Seed Data=
integrationtest manager seed date 2 process

=== Main Seed Data===
:Save file in s3 (in '''buckname''' :integrationtest-config-us-east-2, '''folder''':seedData_integrationTest).For other dev use service,If a developer wants to add more for other important testing purposes.

'''How to use:'''
#Add it from the s3 bucket at this point
#Run batch refreshSeedData [[Developer guide for making Integration Tests#Bash script|batch RefreshSeedData]]
'''Logic''':Process by storage resouse (graph or dynamodb)
:To clean up the seed data in the table after it creates seed data form service deploy and pulls seed data from s3.

=== Refresh Seed Data ===
:ProcessRefreshSeedData use seedDataTag for create data environment of '''test''' and can be refresh seeddata re-test agian.
:'''canbe share''' seed data for other test by seed data tag.
'''How to use:'''
:Save file in s3 (for other dav keep in floder dev name) or testConfig/seedData_config(for admin)

'''Folder'''
*dynamoDBSeedDataTags.json
*graphSeedDataTags.json

'''Example'''
==== dynamoDBSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource dynammodb.
Example
<syntaxhighlight lang="JavaScript">
{
"seedDynamodb_abc_ver2": [ // seedDataTag
{
"tableName": "DelivMethodSTDTestLogicalResultsData", // servcieTag+stage+tablename
"partitionKey": "logicalResultId",
"sortKey": "identifiersId",
"datas": [
{
"logicalResultId": "eeeeeeeeee4",
"identifiersId": "lllll123456"
},
{
"logicalResultId": "eeeeeeeeee4",
"identifiersId": "lllll777777"
}
]
},
{
"tableName": "MLocationsTestFloatingRelationships",// servcieTag+stage+tablename
"partitionKey": "importBatchId",
"sortKey": "identifierRelationshipsId",
"datas": [
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll123456"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll777777"
},
{
"importBatchId": "2-uuuuuuuuuuuuuu",
"identifierRelationshipsId": "lllll99999999"
}
]
},
{
"tableName": "MLocationsTestFindDataMain",
"partitionKey": "findDataId",
"datas": [
{
"findDataId": "111111"
},
{
"findDataId": "22222"
},
{
"findDataId": "333333"
}
]
}
]
}
</syntaxhighlight>

==== graphSeedDataTags ====
:If set tag in this setting integrationtest is generate seed data. in storage resource graphHanler.
Example
<syntaxhighlight lang="JavaScript">
{
"seedData_testTag_GG": [ // seedDataTag
{
"nodes": [
{
"nodeLabels": [
"SellOfferPlan_sellOfferPlanDeliveryMethodLink"
],
"objectDetail": {
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": "minttestrefreshSeedData_01"
},
"fields": {
"productId": "ddddd",
"price": 9999
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMall"
],
"objectDetail": {
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
},
"fields": {
"name": "hotpot-man",
"totalPrice": 500
}
}
},
{
"nodeLabels": [
"servcieMintTest_shoppingMallCalculateSetting"
],
"objectDetail": {
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
},
"fields": {
"addToCalculatedValuePerOrder": 10,
"addToRateTableValuePerOrder": 77
}
}
}
],
"relationships": [
{
"fromObject": {
"nodeLabel": "SellOfferPlan_sellOfferPlanDeliveryMethodLink",
"identifiers": {
"sellOfferPlanDeliveryMethodLinkId": "minttestrefreshSeedData_01"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"relationships": [
{
"relTypeConcat": "SellOfferPlan_hasCCCCCCC",
"relId": "uuid-4s56df74s9df79w-w6de4f5w689ef"
}
]
},
{
"fromObject": {
"nodeLabel": "servcieMintTest_shoppingMall",
"identifiers": {
"shoppingMallId": "minttestrefreshSeedData_shoppingMallId"
}
},
"toObject": {
"nodeLabel": "servcieMintTest_shoppingMallCalculateSetting",
"identifiers": {
"versionedDataId": "minttestrefreshSeedData_versionedDataId"
}
},
"relationships": [
{
"relTypeConcat": "servcieMintTest_shoppingMall_currentShoppingMallCalculateSetting",
"relId": "uuid-s122df5-s21df",
"relationshipProperty": {
"timeStamp": 1234567879,
"statusName": true
}
},
{
"relTypeConcat": "servcieMintTest_shoppingMall_hasShoppingMallCalculateSetting",
"relId": "uuid-77777-99999",
"relationshipProperty": {
"statusName": true
}
}
]
}
]
}
],
"seedData_testTag_ABC": [
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": [
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "hasProductAttributeLink"
},
"relationshipDirection": "to",
"targetObjType": {
"serviceTag": "ProductStandard",
"objectType": "productStandard"
},
"targetIdentifiers": {
"productId": "f526a367a2b66cb0f37ca61b6c43f419929f521d"
},
"relationshipProperties": {}
},
{
"relType": {
"serviceTag": "ProductAttribute",
"relationshipTag": "isProductAttribute"
},
"relationshipDirection": "from",
"targetObjType": {
"serviceTag": "ProductAttribute",
"objectType": "productAttribute"
},
"targetIdentifiers": {
"productAttributeId": "f4bf7a078071d54036656df544197ba638bc3a68"
},
"relationshipProperties": {}
}
]
},
{
"objType": {
"objectType": "productAttributeLink",
"serviceTag": "ProductAttribute"
},
"objInstanceFull": {
"identifiers": {
"productAttributeLinkId": "f90b57ca8b2fe1a83459d57da038cf50fb6d40e6"
},
"fields": {}
},
"relationships": []
}
],
"seedData_testTag_LL": []
}
</syntaxhighlight>

=== Cleaning Seed Data ===
:Delete seed data for set environment of '''test'''.
*cleaningeDynamoOneRecordsTags.json
*cleaningeDynamoManyRecordsTags.json

====cleaningeDynamoOneRecordsTags====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_TestFindData_and_Education_case_invalid01": [
{
"tableName": "MLocationsTestFindDataMain",
"primaryKeys": [
{
"findDataId": "cleaning-1"
},
{
"findDataId": "cleaning-2"
}
]
},
{
"tableName": "MLocationsTestEducation",
"primaryKeys": [
{
"studentId": "cleaning-AA"
},
{
"studentId": "cleaning-BB"
},
{
"studentId": "cleaning-CC"
}
]
}
],
"cleaningSeed_TestMemberPersonnel_case_invalid01": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "namtan",
"passwordId": "qqqww"
},
{
"userId": "jack",
"passwordId": "q1"
},
{
"userId": "Momay",
"passwordId": "ttr"
}
]
}
]
}
</syntaxhighlight>

==== cleaningeDynamoManyRecordsTags ====
<syntaxhighlight lang="JavaScript">
{
"cleaningSeed_manyData_partitionKey_only_miss_sort": [
{
"tableName": "MLocationsTestMemberPersonnel",
"primaryKeys": [
{
"userId": "many-data"
}
]
}
]
}
</syntaxhighlight>

*logic query table MLocationsTestMemberPersonnel use primary Keys "userId" and then delete all data from primary Keys.

=resources=
syntax is object
<syntaxhighlight lang="JavaScript">
{
"Lambda":{
"{FunctionNameHdrSqs}":{ // FunctionNameHdrSqs is match resourceName in file tests
"localLacation":"/src/FunctionNameHdrSqs.js",
"localHandler":"main",
"functionName":"FunctionNameHdrSqs" // FunctionName is function name match key of function.yml of servcie.
},
"ProcessComplexFilterHdrSqs":{
"localLacation":"/src/ProcessComplexFilterHdrSqs.js",
"localHandler":"main",
"functionName":"ProcessComplexFilterHdrSqs"
},
...
},
"Dynamodb": {
"filterMain":{ // match resourceName in file tests(dynamodbOutputEventIdentifiers)
"tableName":"filterMain"
},
"tableNameBB":{
"tableName":"tableNameBB"
},
...
}
}
</syntaxhighlight>

=events=
Syntax is object
==Syntax Name==
===FileName===
::Event_{inputEventTag}

===eventTag===
#inputEventTag
#outputEventTag
#dynamodbTag

*file events.js is have eventTag (inputEventTag,outputEventTag,dynamodbTag)
**How to create name eventTag
***Example case : "test in service complexFilter functionname ProcessComplexFilter case element type is logical basic".
::*'''inputEventTag'''
::::{serviceName}_{functionName}_{caseTest}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''outputEventTag'''
::::output_{inputEventTag}
''output_Conplexfilter_ProcessComplexFilter_Typelogical_basic''
::*'''dynamodbTag'''
::::{inputEventTag}__Dynamodb__{'''action*'''}_{tableName}
''Conplexfilter_ProcessComplexFilter_Typelogical_basic___Dynamodb__putItem_filterMain''
: '''{action}''' is only ''put'' or ''update'', and in case of ''update'' must only test the last step of update 

=== Syntax event===
====initiate by handlerServcie====
=====Sqs=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Sns
{
"LambdaFunctionHdrSqs_input__pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
},
"propertyB":{
"properties":{
"propertyB1":{
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"value":"msgTag"
},
"propertyD":{
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
<syntaxhighlight lang="JavaScript" linein>
"snsSqsTrigger":true
</syntaxhighlight>

=====Dsq=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of Direct Sqs
{
"LambdaFunctionHdrDsq_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"DirectSqs":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrDsq_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
* DirectSqs = true
:: for initialStage of Dsq
* messageAttributes is optional

=====Inv=====
<syntaxhighlight lang="JavaScript">
{
"LambdaFunctionHdrInv_input__pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
}
}
},
{
"output_LambdaFunctionHdrInv_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>

=====Api=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of API
{
"LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"forstageMatvhing": true,
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1",
},
"propertyB": {
"properties": {
"propertyB1": {
"value": "valuePropertyB1",
}
}
},
"propertyC": {
"eventValue": [
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3",
]
},
...
}
}
}
},
"Output_LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"properties": {
"body": {
"properties": {
"propertyA": {
"testValueMatches": false,
"value": "valueProperty1"
},
...
}
}
}
}
}
</syntaxhighlight>

=====S3=====

====dynamodb====
<syntaxhighlight lang="JavaScript">
// An example event of Dynamodb //optional
{
{inputEventTag}__dynamodb_{action}_{tablename}: { // eg. "Complexfilter_ProcessComplexfilter_logical_basic__dynamodb_update_FilterMain"
"forStageMatching": true,
"properties": {
"filterMainUniqueRequestId": {
"testValueMatches": fase,
"value": "bbc4f4a9-2032-4dec-9129-8c7d169fecc5"
},
"filterObject": {
"forStageMatching": true,
"properties": {
"logicalType": {
"value": "partitionKey"
},
"comparison": {
"value": "equals"
},
"type": {
"value": "logical"
},
"partitionKey": {
"forStageMatching": true,
"value": "mockIntegratioTestCPF"
}
}
},
"filterMainExpiryTime": {
"testValueMatches": fase,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": fase,
"value": 1731894402678
},
"objType": {
"forStageMatching": true,
"properties": {
"serviceTag": {
"forStageMatching": true,
"value": "IntTesting"
},
"objectType": {
"forStageMatching": true,
"value": "TestRecord"
}
}
}
},
"keyValues": {
"filterMainId": "4865d2451a621cb7f71225cfabf2df4f98e20801",
"objTypeId": "cdb170690571df7522b3850920fce02507c077ee"
}
}
}
</syntaxhighlight>

* partition key: filterMainId
* sort key: objTypeId

[[2021-01-15 - Integration Testing - Adding DynamoDB result tests]]

===Type paramiter===
use for evnet and dyanmodb event
====Normal====
<syntaxhighlight lang="JavaScript">

object: {
forStageMatching: true,
properties: {
name:{
forStageMatching: true,
value:"Tom"
}
}
},
array: {
forStageMatching: true,
useIsEqual: true,
eventValue: [
{
"relTypeAndDirection": {
"relType": {
"serviceTag": "maxxCart2",
"relationshipTag": "hasCartOrder"
},
"relationshipDirection": "from"
},
"targetObjects": [
{
"objType": {
"serviceTag": "maxxCart2",
"objectType": "cartOrder"
}
}
]
}
]
},
number: {
forStageMatching: true,
value: 1111
},
string: {
forStageMatching: true,
value: "hi"
},
boolean: {
forStageMatching: true,
value: true
}
</syntaxhighlight>

<syntaxhighlight lang="JavaScript">
forStageMatching: true
</syntaxhighlight>
::set true for check match value,It is not necessary to set every value
:::use in test importent paramiter

<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
::setting paramiter require on create but can not test random value eg: identifier or timeStamp or uuid

====Empty====
<syntaxhighlight lang="JavaScript">
EmptyString:{
value:""
},
EmptyArray:{
forStageMatching: true,
useIsEqual: true,
eventValue: []
},
EmptyObject:{
forStageMatching: true,
value:{}
}
</syntaxhighlight>

====Error====
can test noRetryError
<syntaxhighlight lang="JavaScript">
"errorMessage": {
forStageMatching: true,
"value": "Not found schema of {serviceTag:TestGraphHandler, objectType:notFoundObjType}"
}
</syntaxhighlight>

====Paramiter random====
Can not test case random numbber or uuid.
But requriOnCreate mush be set
<syntaxhighlight lang="JavaScript">
testValueMatches:false
</syntaxhighlight>
or set
<syntaxhighlight lang="JavaScript">
forStageMatching:false
</syntaxhighlight>

=tests=
Syntax is array of object
==Syntax name==
===Testtag name ===
*{integrationTestTag}
#Test Own servcie or not a lot stage
<syntaxhighlight lang="JavaScript">
Test_{inputEventTag}
</syntaxhighlight>
#Mix multiple servcie and multiple stage
<syntaxhighlight lang="JavaScript">
IntegrationTest_{inputEventTag}
</syntaxhighlight>

===File name ===
<syntaxhighlight lang="JavaScript">
{integrationTestTag}.json
</syntaxhighlight>

==Setting of test==
[[Service - Integration Test Config#tests.js Syntax|syntax test]]

<syntaxhighlight lang="JavaScript">
{
integrationTestTag: {integrationTestTag},
productionSafe: true|false, //default false
noInitialStage: true, // default false, if set to true, no error when no foundInitialStages found
errorIfStageUndefined: true|false, //default false
errorIfInvokeUndefined: true|false, //default false,
dynamoDBSeedDataTags:["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
graphSeedDataTags:["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
cleaningeDynamoOneRecordsTags: ["cleaningSeed_partitionKey_sortKey_normol"], //optional
cleaningeDynamoManyRecordsTags: [], // optional
stages:[
...
]
}
</syntaxhighlight>
*[[2025-11-20 IntegrationTest#dynamoDBSeedDataTags|dynamoDBSeedDataTags]]
*[[2025-11-20 IntegrationTest#graphSeedDataTags|graphSeedDataTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoOneRecordsTags|cleaningeDynamoOneRecordsTags]]
*[[2025-11-20 IntegrationTest#cleaningeDynamoManyRecordsTags|cleaningeDynamoManyRecordsTags]]

==Stages==
====Initiate stage====
:'''"initialStage":true'''
[[Service_-_Integration_Test_Config#tests.js Syntax|detail property of test]]
=====HandlerService=====
======Sqs======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"Locations_ProcessLocationNodeSomting_casenotHaveData",
"serviceName":"Locations",
"resourceType":"Lambda",
"resourceName":"ProcessLocationNodeSomtingHdrDsq",
"outputEventTag":"Output_Locations_ProcessLocationNodeSomting_casenotHaveData"
}
]
</syntaxhighlight>
======Dsq======
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'LambdaFunctionHdrDsq_input_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'LambdaFunctionHdrDsq_output__returnvalue_pass',
// **** not set snsServiceName and snsTopic
// can be test dynamodbOutput
}
]
</syntaxhighlight>

======Api======
<syntaxhighlight lang="JavaScript">
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrApi_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrApi",
"outputEventTag":"LambdaFunctionHdrApi_output__pass"
}
]
</syntaxhighlight>

======Inv======
*'''single stage'''
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":["seedDataDB_test_case_xx"], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":["seedDataGraph_test_case_xx"], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": ["cleaningSeed_partitionKey_sortKey_normol"], //optional
"cleaningeDynamoManyRecordsTags": []
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass"
}
]
}]
</syntaxhighlight>
*'''invoke multiple stage'''
:*Each stage test can invoke multiple lambda by use "eventStage Tag" point to stage for test integration test.
<syntaxhighlight lang="JavaScript">
[{
"integrationTestTag":"LambdaFunctionHdrInv_invokes__pass",
"productionSafe":false,
"errorIfStageUndefined":false,
"errorIfInvokeUndefined":false,
"dynamoDBSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"graphSeedDataTags":[], //[seedDataTag] optional if have seed data for test
"cleaningeDynamoOneRecordsTags": [], //optional
"cleaningeDynamoManyRecordsTags": [], // optional
"stages":[
{
"initialStage":true,
"inputEventTag":"LambdaFunctionHdrInv_input__pass",
"serviceName":"ServiceTemplate",
"resourceType":"Lambda",
"resourceName":"LambdaFunctionHdrInv",
"outputEventTag":"LambdaFunctionHdrInv_output__pass",
"invokes":[
{
"eventStageTag":"service_invokesB__pass"
},
{
"eventStageTag":"service_invokesD__pass"
}
]
},
{
"eventStageTag":"service_invokesB__pass",
"inputEventTag":"input_service_invokes__pass",
"serviceName":"ServiceTemplate_B",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_B_HdrInv",
"outputEventTag":"output_service_invokes__pass"
},
{
"eventStageTag":"service_invokesD__pass",
"inputEventTag":"input_service_invokesD__pass",
"serviceName":"ServiceTemplate_D",
"resourceType":"Lambda",
"resourceName":"LambdaFunction_D_HdrInv",
"outputEventTag":"output_service_invokesD__pass"
}
]
}]
</syntaxhighlight>

======S3======
======Batch======

====GeneratedSeedData====
*Integrationtest must be delete identifier every time before test.
*Set 'generatedSeedData' in file tests.json case by case of stage eg: stages[0] create identifier is randomOnCreate will set 'generatedSeedData' and stages[1] create relationship is randomOnCreate(It is usually random, except in the case of relationship version) set generatedSeedData this stages[1].
*How to delete case identifier rendomOnCreate?: set in stage use setting generateSeedData "randomOnCreateIdentifier"
#randomOnCreateIdentifier
#notRandomOnIdentifier
#relationships
=====randomOnCreateIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"randomOnCreateIdentifier": [
{
"objType": {
"serviceTag": "MLocations",
"objectType": "Member"
},
"identifierValue": "Jaya-member-001"
}
]
}
}
]
</syntaxhighlight>
=====notRandomOnIdentifier=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"notRandomOnIdentifier": [
{
"objType": {
"serviceTag": "gggg",
"objectType": "ssssss"
},
"identifiers": {
"topId": "123456"
}
}
]
}
}
]
</syntaxhighlight>
=====relationships=====
<syntaxhighlight lang="JavaScript">
"stages": [
{
"initialStage": true,
"inputEventTag": "MLocation_CreateHdrSqs__case_NodeVersionData_Jaya",
"serviceTag": "MLocations",
"resourceType": "Lambda",
"resourceName": "CreateHdrSqs",
"snsServiceName": "MLocations",
"snsTopic": "Create_In",
"generatedSeedData": {
"relationships": [
{
"relType": {
"serviceTag": "PaymentMethodGeneric",
"relationshipTag": "disabledPaymentMethodGenericPropertyValue"
},
"relId": "f4f73de7-647c-4b3b-8043-87cc002f361a"
}
]
}
}
]

</syntaxhighlight>

==Dynamodb==
<syntaxhighlight lang="JavaScript">
stages: [
{
initialStage: true,
inputEventTag: 'Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
serviceName: 'ServiceTemplate',
resourceType: 'Lambda',
resourceName: 'LambdaFunctionHdrDsq',
outputEventTag: 'output_Locations_LambdaFunctionHdrDsq_singleStage_directSqs__pass',
dynamodbOutputEventIdentifiers: [
{
serviceName: {tableName}, //service that deployed the DynamoDB table, so can build table's full resource name
resourceName: {resourceName}, //DynamoDB resourceName
eventTag: {eventTagDynamoDB}
}
],
}
]
</syntaxhighlight>

= Result of integrationtest =
Data have 2 table "TestRecord" and "TestUnit".
:- TestRecord is table all unti of stage inside eg input output invokes and dynamodb
:- TestUnit is store status each unit
each unit save in table TestUnit
testRecordId is name of test concat with testTime.
testUnitId is point to position of unti instage.
resultStatus is status of unit.
<syntaxhighlight lang="JavaScript">
eg:
input_0 = stages index 0 result '''input'''
output_1 = stages index 1 result '''output'''
invokeInput_0_1 = stages index 0 result '''invokes''' index 1 position input
invokeOutput_0_1 = stages index 0 result '''invokes''' index 1 position output
dynamodb_0_1 = stages index 0 result '''dynamodb''' index 1.
</syntaxhighlight>

after all TestUnit finish (check by awaitingMultiplestep penditnStep is integrationtestTag awaitingStepId is each TestUnit )
check all awaitingStep finish send message to ultimateIntegrationtest for sumla all test is status

== Summary of test status ==
:1.testStatus is "passed" all unit passed.
:2.testStatus is "failed" have some is failed.
:3.testStatus is "processing" have some is have status processing after check all awaiting step is finish.
:4.testStatus is "failed" have record "errorsTest" in case "not match stage invoke", 'found multiple matchingInvokes

*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

=How to test integrationtest s3=
[[Developer guide for making Integration Tests]]

[[Category:Working documents| 2025-11-20]]
[[Category:Working documents - Integration Testing| 2025-11-20]]

Service - Purchase

2026-06-01T03:10:56Z

Mint: /* sale */

= Overview =

Purchases from vendors including inventory, services, and expenses.

= Repository =

...

= Object Schemas =
; Additional Information: [[Per Service Schemas]]

== sale ==

<syntaxhighlight lang="JavaScript">
{
objectType: "purchase",
canDelete: false,
belongTo: {
serviceTag: "Business",
objectType: "business"
},
addOnDataStructure: [
{
type:"versionedData",
versionedDataLabel: "Detail",
storageResourceTag : "myGraph",
fieldNames: {
purchaseCurrencyId: {
type: "string",
storageResourceTags: ['myGraph']
},
}
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
},
"dynamo": {
"storageType": "dynamoDB",
"tableName": "purchase",
}
},
fieldNames: {
purchaseId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph']
},
purchaseTotal: {
type: "numeric",
storageResourceTags: ['myGraph']
},
purchaseCommitted: { // "working"|"updateWorking"|"processing"|"committed"
type: "string",
storageResourceTags: ['dynamo']
},
},
identifiers: [
{
type: "identifier",
fieldName: "purchaseId"
}
]
}
</syntaxhighlight>

* when building a purchase it is in working stage, must click complete to become an actual purchase
* purchaseCompleted sets to processing once compeltePurchase begins, probably needs uniqueRequestId also
* when a change is made to a purchase (that affects accounting data) purchaseCompleted resets to updateWorking

== purchaseGroup ==

<syntaxhighlight lang="JavaScript">
{
objectType: "purchaseGroup",
canDelete: false,
belongTo: {
serviceTag: "Business",
objectType: "business"
},
addOnDataStructure: [],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
fieldNames: {
purchaseGroupId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph']
},
numberingSettings: {
type: "object",
storageResourceTags: ['myGraph']
},
},
identifiers: [
{
type: "identifier",
fieldName: "purchaseGroupId"
}
]
}
</syntaxhighlight>

* groups purchases into classifications
* purchase numbers can be separated by groups, eg separate sequencial numbering
* numberingSettings saves details such as prefix, suffix, method of sequencial ordering, period when numbering resets

== Relationships ==

=== hasPurchase ===

<syntaxhighlight lang="JavaScript">
{
hasPurchase: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Vendor",
objectType: "vendor"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "Purchase",
objectType: "purchase"
},
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

=== hasPurchaseLineItem ===

<syntaxhighlight lang="JavaScript">
{
hasPurchaseLineItem: {
canChangeToRelTypes: [
{
serviceTag:"PurchaseLineItemManager",
relationshipTag: "oldPurchaseLineItem"
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Purchase",
objectType: "purchase"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "PurchaseLineItemManager",
objectType: "purchaseLineItem"
},
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

=== oldPurchaseLineItem ===

<syntaxhighlight lang="JavaScript">
{
oldPurchaseLineItem: {
canChangeToRelTypes: [
{
serviceTag:"PurchaseLineItemManager",
relationshipTag: "hasPurchaseLineItem"
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Purchase",
objectType: "purchase"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "PurchaseLineItemManager",
objectType: "purchaseLineItem"
},
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

= flowSchemas =

== commitNewPurchase ==

* uses purchaseCommitted setting to complete purchase, which sends purchaseLineItems and details to ComAcc plugin to create account entries

== commitUpdatePurchase ==

* after changes made uses purchaseCommitted setting to complete the purchase update, sending purchaseLineItems and details to ComAcc plugin to update account entries

== updatePurchase ==

* if have ComAcc plugin enabled, send request to plugin to check if purchase has been locked on Accounting

= Addresses =

* use same structure as orders in Izara Market

= Working documents =

[[:Category:Working_documents - Purchase|Purchase]]

[[Category:Backend services| Purchase]]