Izara Wiki - User contributions [en]

Service - CommerceAccounting Purchase

2026-05-04T04:11:47Z

Mint: /* Example request param from Commerce */

= 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|..
// 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,
inputVatJournalId: {
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,
// journalId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

== 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: "",
type: "", // inventory|expense|services|freight|salesTax|vatTax|other
subType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, order: 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-05-04T03:45:53Z

Mint: /* entry */

= Overview =

A credit or debit entry linked 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']
}
},
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>

=== 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 - Entry

2026-05-04T03:45:26Z

Mint: /* entry */

= Overview =

A credit or debit entry linked 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']
},
accountingStatus: { // "open"|"processing"|"locked"
type: "string",
storageResourceTags: ['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>

=== 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-05-04T02:30: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: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLink",
}
},
fieldNames: {
// businessId,
// accountLinkTag // type of link: inputVAT|..
// 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,
inputVatJournalId: {
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,
// journalId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

== 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: "",
purchaseCurrencyId: "",
inventoryLocationId: "", // required if have any inventory/?assets
purchaseLineItems: {
{purchaseLineItemId}: {
inventoryId: "",
inventoryTemplateId: "",
type: "", // inventory|expense|services|freight|salesTax|vatTax|other
subType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, order: 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-05-04T02:23:00Z

Mint: /* Object Schemas */

= 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|..
// 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,
inputVatJournalId: {
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,
// journalId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

== 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: "",
purchaseCurrencyId: "",
inventoryLocationId: "", // required if have any inventory/?assets
purchaseLineItems: {
{purchaseLineItemId}: {
inventoryId: "",
inventoryTemplateId: "",
type: "", // inventory|expense|services|freight|salesTax|vatTax|other
subType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, order: 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-05-04T02:21:54Z

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: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLink",
}
},
fieldNames: {
// businessId,
// accountLinkTag // type of link: inputVAT|..
// 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,
belongTo: {
serviceTag: "ComAccLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchase",
}
},
fieldNames: {
// businessId,
// purchaseId,
inputVatJournalId: {
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,
belongTo: {
serviceTag: "ComAccLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLineItem",
}
},
fieldNames: {
// purchaseId,
// purchaseLineItemId,
// journalId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

== 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: "",
purchaseCurrencyId: "",
inventoryLocationId: "", // required if have any inventory/?assets
purchaseLineItems: {
{purchaseLineItemId}: {
inventoryId: "",
inventoryTemplateId: "",
type: "", // inventory|expense|services|freight|salesTax|vatTax|other
subType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, order: 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-05-01T03:12:15Z

Mint: /* entry */

= Overview =

A credit or debit entry linked 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: "entryDetail",
storageResourceTag : "myGraph",
fieldNames: {
amount: {
type: "currencyValue",
storageResourceTags: ['myGraph']
},
}
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
},
"dynamo": {
"storageType": "dynamoDB",
"tableName": "entry",
}
},
fieldNames: {
entryId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
},
accountingStatus: { // "open"|"processing"|"locked"
type: "string",
storageResourceTags: ['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>

=== 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 - Journal

2026-05-01T03:11:54Z

Mint: /* organization */

= Overview =

A journal entry is a single transaction, each journal entry will have credit and debit entries that add up to each other and match the functionalCurrencyAmount.

= Repository =

...

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

== organization ==

<syntaxhighlight lang="JavaScript">
{
objectType: "journal",
canDelete: false,
belongTo: {
serviceTag: "Organization",
objectType: "organization"
},
addOnDataStructure: [
{
type: "propertyValue"
},
{
type:"versionedData",
versionedDataLabel: "journalDetail",
storageResourceTag : "myGraph",
fieldNames: {
timestamp: {
type: "timestamp",
storageResourceTags: ['myGraph']
},
amount: {
type: "currencyValue",
storageResourceTags: ['myGraph']
},
amountCurrency: {
type: "currency",
storageResourceTags: ['myGraph']
},
functionalCurrencyAmount: {
type: "currencyValue",
storageResourceTags: ['myGraph']
},
exchangeRate: {
type: "number",
storageResourceTags: ['myGraph']
},
},
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
},
"dynamo": {
"storageType": "dynamoDB",
"tableName": "entry",
}
},
fieldNames: {
journalId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph','dynamo']
},
accountingStatus: { // "open"|"processing"|"locked"
type: "string",
storageResourceTags: ['dynamo']
},
},
identifiers: [
{
type: "identifier",
fieldName: "journalId"
}
]
}
</syntaxhighlight>

* maybe add accountingStatus, same as entry, so can check if journal can be adjusted, or perhaps only journals because entries cannot be changed directly

== Relationships ==

* probably need relationship to organization that owns the entry, because will be floating initially (until entries connect to accounts)
* maybe adjust relationship to organization according to open or locked status, to make it easier to see which journals are awaiting processing end of period?

= Working documents =

[[:Category:Working_documents - Journal| Journal]]

[[Category:Backend services| Journal]]

Service - CommerceAccounting Purchase

2026-04-30T09:14:58Z

Mint: /* Example request param from Commerce */

= Overview =

Handle links between purchases and Accounting records.

= Repository =

...

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

== comAccPurchaseLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLink",
canDelete: false,
belongTo: {
serviceTag: "ComAccLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLink",
}
},
fieldNames: {
// businessId,
// accountLinkTag // type of link: inputVAT|..
// 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,
belongTo: {
serviceTag: "ComAccLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchase",
}
},
fieldNames: {
// businessId,
// purchaseId,
inputVatJournalId: {
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,
belongTo: {
serviceTag: "ComAccLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLineItem",
}
},
fieldNames: {
// purchaseId,
// purchaseLineItemId,
// journalId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

== 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: "",
purchaseCurrencyId: "",
inventoryLocationId: "", // required if have any inventory/?assets
purchaseLineItems: {
{purchaseLineItemId}: {
inventoryId: "",
inventoryTemplateId: "",
type: "", // inventory|expense|services|freight|salesTax|vatTax|other
subType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, order: 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-04-30T09:10:30Z

Mint: /* Example request param from Commerce */

= Overview =

Handle links between purchases and Accounting records.

= Repository =

...

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

== comAccPurchaseLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLink",
canDelete: false,
belongTo: {
serviceTag: "ComAccLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLink",
}
},
fieldNames: {
// businessId,
// accountLinkTag // type of link: inputVAT|..
// 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,
belongTo: {
serviceTag: "ComAccLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchase",
}
},
fieldNames: {
// businessId,
// purchaseId,
inputVatJournalId: {
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,
belongTo: {
serviceTag: "ComAccLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLineItem",
}
},
fieldNames: {
// purchaseId,
// purchaseLineItemId,
// journalId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

== 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: "",
purchaseCurrencyId: "",
inventoryLocationId: "", // required if have any inventory/?assets
purchaseLineItems: {
{purchaseLineItemId}: {
inventoryId: "",
type: "", // inventory|expense|services|freight|salesTax|vatTax|other
subType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, order: 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-04-30T09:10:10Z

Mint: /* Example request param from Commerce */

= Overview =

Handle links between purchases and Accounting records.

= Repository =

...

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

== comAccPurchaseLink ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccPurchaseLink",
canDelete: false,
belongTo: {
serviceTag: "ComAccLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLink",
}
},
fieldNames: {
// businessId,
// accountLinkTag // type of link: inputVAT|..
// 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,
belongTo: {
serviceTag: "ComAccLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchase",
}
},
fieldNames: {
// businessId,
// purchaseId,
inputVatJournalId: {
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,
belongTo: {
serviceTag: "ComAccLink",
objectType: "comAccLinkByBusiness"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccPurchaseLineItem",
}
},
fieldNames: {
// purchaseId,
// purchaseLineItemId,
// journalId
},
identifiers: [
{
type: "partitionKey",
fieldName: "purchaseId"
},
{
type: "sortKey",
fieldName: "purchaseLineItemId"
},
]
}
</syntaxhighlight>

== 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: "",
purchaseCurrencyId: "",
inventoryLocationId: "", // required if have any inventory/?assets
purchaseLineItems: {
{purchaseLineItemId}: {
inventoryId: "",
Type: "", // inventory|expense|services|freight|salesTax|vatTax|other
SubType: "", // inventory: goods|intangibleGoods|rawMaterial|asset|intangibleAsset, expense: pointInTime|overTime, services: pointInTime|overTime, freight: standard, order: 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 - Account Manager

2026-04-24T08:00:46Z

Mint: /* isChildAccount */

= Overview =

Each account is handled by a [[Service - Account (handlers)]] service.

All accounts in the General Ledger account hierarchy are considered an Account, including Control Accounts, Sub-Accounts, Subsidiary Accounts, and all other account classifications businesses use.

The Account Manager service handles detail shared by all Account Handler services.

= Repository =

....

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

== objType ==

=== inventory ===

<syntaxhighlight lang="JavaScript">
{
objectType: "account",
canDelete: false,
belongTo: {
serviceTag: "Organization",
objectType: "organization"
},
addOnDataStructure: [],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
fieldNames: {
accountId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph']
},
},
identifiers: [
{
type: "identifier",
fieldName: "accountId"
}
]
}
</syntaxhighlight>

== Object Relationships ==

=== isChildAccount ===

<syntaxhighlight lang="JavaScript">
{
isChildAccount: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "accountManager",
objectType: "account"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "accountManager",
objectType: "account"
},
linkType: "many"
}
}

]
}
}
</syntaxhighlight>

= Working documents =

[[:Category:Working_documents - Account Manager| Account Manager]]

[[Category:Backend services| Account Manager]]

Service - CommerceAccounting Link

2026-04-18T06:55:46Z

Mint: /* comAccLinkByOrganization */

= 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: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccLinkByBusiness",
}
},
fieldNames: {
// businessId
// organizationId
},
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 Link

2026-04-18T06:53:09Z

Mint: /* comAccLinkByBusiness */

= 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: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccLinkByBusiness",
}
},
fieldNames: {
// businessId
// organizationId
},
identifiers: [
{
// businessId
}
]
}
</syntaxhighlight>

== comAccLinkByOrganization ==

<syntaxhighlight lang="JavaScript">
{
objectType: "comAccLinkByOrganization",
canDelete: false,
belongTo: {
serviceTag: "User",
objectType: "user"
},
addOnDataStructure: [],
storageResources: {
"dynamo": {
"storageType": "dynamoDB",
"tableName": "comAccLink",
}
},
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]]

2026-04-16 - Cross Project Account Config

2026-04-18T02:04:23Z

Mint:

[[Development - Izara Commerce to Accounting]]

= Example case =

* Commerce has option when creating a new Business to create new Organization in Izara Accounting and link through ComAcc
* Cross platform sign in system for frontend will automatically create user accounts on each project as we redirect there (ComAcc and Accounting)
* redirects to ComAcc and Accounting to make sure user data created
* ComAcc offers list of accounting configs to choose from, these configs are saved in ComAcc
* Accounting config includes:
** ImportBatch file for creating an organization, accounts, ledgers, periods etc for the user in Accounting project
** List of standard links for ComAcc, eg each inventory type
** Some values, such as period, might require confirmation (up to Accounting config setup/ui)
* After ImportBatch completes at Accounting ComAcc logic can create main comAccLinks and plugInLinks
* ComAcc query ImportBatch and pendingObjects to find eg account identifiers
* create links in ComAcc between Commerce object types and created Accounting accounts

[[Category:Working documents| 2026-04-16]]

Service - Business

2026-03-26T08:30:41Z

Mint: /* business */

= Overview =

A user can have many businesses, each business has it's independent set of data.

= Repository =

...

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

== business ==

<syntaxhighlight lang="JavaScript">
{
objectType: "business",
canDelete: false,
generatedBy: "userGenerated",
addOnDataStructure: [
{
type: "propertyValue"
},
{
type:"versionedData",
versionedDataLabel: "businessDetail",
storageResourceTag : "myGraph",
fieldNames: {
"businessName":{
type: "string",
requiredOnCreate: true,
},
}
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
fieldNames: {
businessId: {
type: "string",
randomOnCreate: true,
canUpdate: false,
userCanUpdate: false,
storageResourceTags: ['myGraph']
},
functionalCurrency: {
type: "currency",
requiredOnCreate: true,
canUpdate: false,
userCanUpdate: false,
storageResourceTags: ['myGraph']
},
},
identifiers: [
{
type: "identifier",
fieldName: "businessId"
}
]
}
</syntaxhighlight>

== RelationshipSchemas ==

=== hasBusiness ===

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

=== removedBusiness ===

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

* links a user to the businesses they manage
* does not convey ownership, each business is a standalone organization that has it's own RBAC (allowing for simple transfer of ownership of data)
* user can link themselves to any businesses so ui can present list of connected businesses

= Addresses =

* use same structure as users in Izara Market

= Working documents =

[[:Category:Working_documents - Business| Business]]

[[Category:Backend services| Business]]

Service - Manufacture Operation

2026-03-23T06:57:44Z

Mint: /* manufactureOperation */

= Overview =

A Manufacture Operation is one manufacturing job that can have multiple work in progress details attached to it.

= Repository =

...

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

== manufactureOperation ==

<syntaxhighlight lang="JavaScript">
{
objectType: "manufactureOperation",
canDelete: false,
belongTo: {
serviceTag: "Business",
objectType: "business"
},
addOnDataStructure: [
{
type:"versionedData",
versionedDataLabel: "manufactureOperationDetail",
storageResourceTag : "myGraph",
fieldNames: {
manufactureOperationUserTag: {
type: "string"
},
}
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
},
"dynamo": {
"storageType": "dynamoDB",
"tableName": "manufactureOperation",
}
},
fieldNames: {
manufactureOperationId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph']
},
status: { // "inProgress"|"processing"|"complete"
type: "string",
storageResourceTags: ['dynamo']
},
},
identifiers: [
{
type: "partitionKey",
fieldName: "manufactureOperationId"
}
]
}
</syntaxhighlight>

== Relationships ==

=== hasWorkInProgress ===

<syntaxhighlight lang="JavaScript">
{
hasWorkInProgress: {
canChangeToRelTypes: [
{
serviceTag:"ManufactureOperation",
relationshipTag: "removedWorkInProgress"
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "ManufactureOperation",
objectType: "manufactureOperation"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "WorkInProgressManager",
objectType: "workInProgress"
},
requiredOnCreate: true,
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

=== removedWorkInProgress ===

<syntaxhighlight lang="JavaScript">
{
removedWorkInProgress: {
canChangeToRelTypes: [
{
serviceTag:"ManufactureOperation",
relationshipTag: "hasWorkInProgress"
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "ManufactureOperation",
objectType: "manufactureOperation"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "WorkInProgressManager",
objectType: "workInProgress"
},
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

= flowSchemas =

== completeManufactureOperation ==

* sets status to processing which locks adding or removing workInProgress links until completed

== reopenManufactureOperation ==

* changes a ManufactureOperation from complete to inProgress
* if comAcc plugin connected needs to check Accounting entries not locked before proceeding

= Working documents =

[[:Category:Working_documents - Manufacture Operation|Manufacture Operation]]

[[Category:Backend services| Manufacture Operation]]

Service - Services Template

2026-03-19T02:25:29Z

Mint: /* servicesTemplate */

= Overview =

Same as [[Service - Inventory Template]] but for services.

= Repository =

...

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

== servicesTemplate ==

<syntaxhighlight lang="JavaScript">
{
objectType: "servicesTemplate",
canDelete: false,
belongTo: {
serviceTag: "Business",
objectType: "business"
},
addOnDataStructure: [
{
type: "attributeTree",
attributeTreeTag: "servicesTemplateDefault"
},
{
type: "attributeTree",
attributeTreeTag: "servicesTemplateFixed"
},
{
type: "versionedData",
versionedDataLabel: "servicesTemplateName",
storageResourceTag: "myGraph",
fieldNames: {
servicesTemplateName: {
type: "string"
}
}
}

],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
fieldNames: {
servicesTemplateId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph']
}
},
identifiers: [
{
type: "identifier",
fieldName: "servicesTemplateId"
}
]
}
</syntaxhighlight>

== RelationshipSchemas ==

=== hasServicesTemplate ===

<syntaxhighlight lang="JavaScript">
{
hasServicesTemplate: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "servicesManager",
objectType: "services"
},
linkType: "many",
},
to: {
objType: {
serviceTag: "servicesTemplate",
objectType: "servicesTemplate"
},
linkType: "many"
}
},
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "servicesTemplate",
objectType: "servicesTemplate"
},
linkType: "many",
},
to: {
objType: {
serviceTag: "servicesTemplate",
objectType: "servicesTemplate"
},
linkType: "many"
}
}
]
}
}
</syntaxhighlight>

= Working documents =

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

[[Category:Backend services| Services Template]]

Service - Services Template

2026-03-19T02:25:14Z

Mint: /* servicesTemplate */

= Overview =

Same as [[Service - Inventory Template]] but for services.

= Repository =

...

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

== servicesTemplate ==

<syntaxhighlight lang="JavaScript">
{
objectType: "servicesTemplate",
canDelete: false,
belongTo: {
serviceTag: "Business",
objectType: "business"
},
addOnDataStructure: [
{
type: "attributeTree",
attributeTreeTag: "servicesTemplateDefault"
},
{
type: "attributeTree",
attributeTreeTag: "servicesTemplateFixed"
},
{
type: "versionedData",
versionedDataLabel: "servicesTemplateName",
storageResourceTag: "myGraph",
fieldNames: {
servicesTemplateName: {
type: "string"
}
}
}

],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
fieldNames: {
servicesTemplateId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph']
},
servicesTemplateName: {
type: "string",
requiredOnCreate: true,
canUpdate: true,
userCanUpdate:true,
storageResourceTags: ['myGraph']
},
},
identifiers: [
{
type: "identifier",
fieldName: "servicesTemplateId"
}
]
}
</syntaxhighlight>

== RelationshipSchemas ==

=== hasServicesTemplate ===

<syntaxhighlight lang="JavaScript">
{
hasServicesTemplate: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "servicesManager",
objectType: "services"
},
linkType: "many",
},
to: {
objType: {
serviceTag: "servicesTemplate",
objectType: "servicesTemplate"
},
linkType: "many"
}
},
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "servicesTemplate",
objectType: "servicesTemplate"
},
linkType: "many",
},
to: {
objType: {
serviceTag: "servicesTemplate",
objectType: "servicesTemplate"
},
linkType: "many"
}
}
]
}
}
</syntaxhighlight>

= Working documents =

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

[[Category:Backend services| Services Template]]

Service - Services Template

2026-03-19T01:19:31Z

Mint: /* servicesTemplate */

= Overview =

Same as [[Service - Inventory Template]] but for services.

= Repository =

...

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

== servicesTemplate ==

<syntaxhighlight lang="JavaScript">
{
objectType: "servicesTemplate",
canDelete: false,
belongTo: {
serviceTag: "Business",
objectType: "business"
},
addOnDataStructure: [
{
type: "attributeTree",
attributeTreeTag: "servicesTemplateDefault"
},
{
type: "attributeTree",
attributeTreeTag: "servicesTemplateFixed"
},
{
type: "versionedData",
versionedDataLabel: "servicesTemplateName",
storageResourceTag: "myGraph",
fieldNames: {

}
}

],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
fieldNames: {
servicesTemplateId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph']
},
servicesTemplateName: {
type: "string",
requiredOnCreate: true,
canUpdate: true,
userCanUpdate:true,
storageResourceTags: ['myGraph']
},
},
identifiers: [
{
type: "identifier",
fieldName: "servicesTemplateId"
}
]
}
</syntaxhighlight>

== RelationshipSchemas ==

=== hasServicesTemplate ===

<syntaxhighlight lang="JavaScript">
{
hasServicesTemplate: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "servicesManager",
objectType: "services"
},
linkType: "many",
},
to: {
objType: {
serviceTag: "servicesTemplate",
objectType: "servicesTemplate"
},
linkType: "many"
}
},
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "servicesTemplate",
objectType: "servicesTemplate"
},
linkType: "many",
},
to: {
objType: {
serviceTag: "servicesTemplate",
objectType: "servicesTemplate"
},
linkType: "many"
}
}
]
}
}
</syntaxhighlight>

= Working documents =

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

[[Category:Backend services| Services Template]]

Service - Sale

2026-03-17T05:24:56Z

Mint: /* sale */

= Overview =

Sales of inventory to customers.

= Repository =

...

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

== sale ==

<syntaxhighlight lang="JavaScript">
{
objectType: "sale",
canDelete: false,
belongTo: {
serviceTag: "Business",
objectType: "business"
},
addOnDataStructure: [
{
type:"versionedData",
versionedDataLabel: "saleDetail",
storageResourceTag : "myGraph",
fieldNames: {
saleCurrencyId: {
type: "string",
storageResourceTags: ['myGraph']
},
}
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
},
"dynamo": {
"storageType": "dynamoDB",
"tableName": "sale",
}
},
fieldNames: {
saleId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph']
},
saleTotal: {
type: "number",
storageResourceTags: ['myGraph']
},
saleCommitted: { // "working"|"updateWorking"|"processing"|"committed"
type: "string",
storageResourceTags: ['dynamo']
},
},
identifiers: [
{
type: "partitionKey",
fieldName: "saleId"
}
]
}
</syntaxhighlight>

* when building a sale it is in working stage, must click complete to become an actual sale
* saleCompleted sets to processing once compelteSale begins, probably needs uniqueRequestId also
* when a change is made to a sale (that affects accounting data) saleCompleted resets to updateWorking

== invoiceGroup ==

<syntaxhighlight lang="JavaScript">
{
objectType: "invoiceGroup",
canDelete: false,
belongTo: {
serviceTag: "Business",
objectType: "business"
},
addOnDataStructure: [],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
fieldNames: {
invoiceGroupId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph']
},
numberingType: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph']
},
numberingSettings: {
type: "object",
storageResourceTags: ['myGraph']
},
},
identifiers: [
{
type: "identifier",
fieldName: "invoiceGroupId"
}
]
}
</syntaxhighlight>

* groups sales into classifications
* invoice 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 ==

=== hasSale ===

<syntaxhighlight lang="JavaScript">
{
hasSale: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Customer",
objectType: "customer"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "Sale",
objectType: "sale"
},
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

=== hasSaleLineItem ===

<syntaxhighlight lang="JavaScript">
{
hasSaleLineItem: {
canChangeToRelTypes: [
{
serviceTag:"SaleLineItemManager",
relationshipTag: "oldSaleLineItem"
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "sale",
objectType: "sale"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "SaleLineItemManager",
objectType: "saleLineItem"
},
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

=== oldSaleLineItem ===

<syntaxhighlight lang="JavaScript">
{
oldSaleLineItem: {
canChangeToRelTypes: [
{
serviceTag:"SaleLineItemManager",
relationshipTag: "hasSaleLineItem"
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Sale",
objectType: "sale"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "SaleLineItemManager",
objectType: "saleLineItem"
},
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

= flowSchemas =

== commitNewSale ==

* uses saleCommitted setting to complete sale, which sends saleLineItems and details to ComAcc plugin to create account entries

== commitUpdateSale ==

* after changes made uses saleCommitted setting to complete the sale update, sending saleLineItems and details to ComAcc plugin to update account entries

== updateSale ==

* if have ComAcc plugin enabled, send request to plugin to check if sale has been locked on Accounting

= Addresses =

* use same structure as orders in Izara Market

= Working documents =

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

[[Category:Backend services| Sale]]

Service - Sale

2026-03-17T01:18:30Z

Mint: /* sale */

= Overview =

Sales of inventory to customers.

= Repository =

...

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

== sale ==

<syntaxhighlight lang="JavaScript">
{
objectType: "sale",
canDelete: false,
belongTo: {
serviceTag: "Business",
objectType: "business"
},
addOnDataStructure: [
{
type:"versionedData",
versionedDataLabel: "saleDetail",
storageResourceTag : "myGraph",
fieldNames: {
saleCurrencyId: {
type: "string",
storageResourceTags: ['myGraph']
},
}
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
},
"dynamo": {
"storageType": "dynamoDB",
"tableName": "sale",
}
},
fieldNames: {
saleId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph']
},
saleTotal: {
type: "number",
storageResourceTags: ['myGraph']
},
saleCommitted: { // "working"|"updateWorking"|"processing"|"committed"
type: "string",
storageResourceTags: ['dynamo']
},
},
identifiers: [
{
type: "identifier",
fieldName: "saleId"
}
]
}
</syntaxhighlight>

* when building a sale it is in working stage, must click complete to become an actual sale
* saleCompleted sets to processing once compelteSale begins, probably needs uniqueRequestId also
* when a change is made to a sale (that affects accounting data) saleCompleted resets to updateWorking

== invoiceGroup ==

<syntaxhighlight lang="JavaScript">
{
objectType: "invoiceGroup",
canDelete: false,
belongTo: {
serviceTag: "Business",
objectType: "business"
},
addOnDataStructure: [],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
fieldNames: {
invoiceGroupId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph']
},
numberingType: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph']
},
numberingSettings: {
type: "object",
storageResourceTags: ['myGraph']
},
},
identifiers: [
{
type: "identifier",
fieldName: "invoiceGroupId"
}
]
}
</syntaxhighlight>

* groups sales into classifications
* invoice 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 ==

=== hasSale ===

<syntaxhighlight lang="JavaScript">
{
hasSale: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Customer",
objectType: "customer"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "Sale",
objectType: "sale"
},
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

=== hasSaleLineItem ===

<syntaxhighlight lang="JavaScript">
{
hasSaleLineItem: {
canChangeToRelTypes: [
{
serviceTag:"SaleLineItemManager",
relationshipTag: "oldSaleLineItem"
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "sale",
objectType: "sale"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "SaleLineItemManager",
objectType: "saleLineItem"
},
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

=== oldSaleLineItem ===

<syntaxhighlight lang="JavaScript">
{
oldSaleLineItem: {
canChangeToRelTypes: [
{
serviceTag:"SaleLineItemManager",
relationshipTag: "hasSaleLineItem"
},
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "Sale",
objectType: "sale"
},
linkType: "one",
},
to: {
objType: {
serviceTag: "SaleLineItemManager",
objectType: "saleLineItem"
},
linkType: "many"
}
},
]
}
}
</syntaxhighlight>

= flowSchemas =

== commitNewSale ==

* uses saleCommitted setting to complete sale, which sends saleLineItems and details to ComAcc plugin to create account entries

== commitUpdateSale ==

* after changes made uses saleCommitted setting to complete the sale update, sending saleLineItems and details to ComAcc plugin to update account entries

== updateSale ==

* if have ComAcc plugin enabled, send request to plugin to check if sale has been locked on Accounting

= Addresses =

* use same structure as orders in Izara Market

= Working documents =

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

[[Category:Backend services| Sale]]

Service - Inventory Location Manager

2026-03-14T06:03:17Z

Mint: /* inventoryLocation */

= Overview =

Where inventory is located, inventory location also distinguishes whether an inventoryUnit is in stock, is work in progress, was the input to other unit/s through production, or sold to a customer.

To move an inventoryUnit from one location to another (eg to sell it) requires reserving the stock, performing the movement (eg removing/adding links in graph), then confirming the reservation.

= Repository =

...

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

== objType ==

=== inventoryLocation ===

<syntaxhighlight lang="JavaScript">
{
objectType: "inventoryLocation",
canDelete: false,
belongTo: {
serviceTag: "Business",
objectType: "business"
},
addOnDataStructure: [
type: "propertyValue"
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
dynamoDB: {
storageType: "dynamoDB",
"tableName": "inventoryLocation",
}
},
fieldNames: {
inventoryLocationId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph', 'dynamoDB']
},
inventoryLocationHandlerServiceNameTag: {
type: "string",
optionalOnCreate: true,
storageResourceTags: ['dynamoDB']
},
},
identifiers: [
{
type: "partitionKey",
fieldName: "inventoryLocationId"
}
]
}
</syntaxhighlight>

== Object Relationships ==

=== atInventoryLocation ===

<syntaxhighlight lang="JavaScript">
{
atInventoryLocation: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "inventoryManager",
objectType: "inventoryUnit"
},
linkType: "many",
},
to: {
objType: {
serviceTag: "inventoryLocationManager",
objectType: "inventoryLocation"
},
linkType: "one"
}
}
]
}
}
</syntaxhighlight>

* handle history of inventoryLocations same as stockLocations

= Working documents =

[[:Category:Working_documents - Inventory Location Manager|Inventory Location Manager]]

[[Category:Backend services| Inventory Location Manager]]

Service - Inventory Location Manager

2026-03-14T05:50:16Z

Mint: /* at_InventoryLocation */

= Overview =

Where inventory is located, inventory location also distinguishes whether an inventoryUnit is in stock, is work in progress, was the input to other unit/s through production, or sold to a customer.

To move an inventoryUnit from one location to another (eg to sell it) requires reserving the stock, performing the movement (eg removing/adding links in graph), then confirming the reservation.

= Repository =

...

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

== objType ==

=== inventoryLocation ===

<syntaxhighlight lang="JavaScript">
{
objectType: "inventoryLocation",
canDelete: false,
belongTo: {
serviceTag: "Business",
objectType: "business"
},
addOnDataStructure: [
type: "propertyValue"
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
dynamoDB: {
storageType: "dynamoDB",
"tableName": "inventoryLocation",
}
},
fieldNames: {
inventoryLocationId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph', 'dynamoDB']
},
inventoryLocationHandlerServiceNameTag: {
type: "string",
optionalOnCreate: true,
storageResourceTags: ['dynamoDB']
},
},
identifiers: [
{
type: "partitionKey",
fieldName: "inventoryId"
}
]
}
</syntaxhighlight>

== Object Relationships ==

=== atInventoryLocation ===

<syntaxhighlight lang="JavaScript">
{
atInventoryLocation: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "inventoryManager",
objectType: "inventoryUnit"
},
linkType: "many",
},
to: {
objType: {
serviceTag: "inventoryLocationManager",
objectType: "inventoryLocation"
},
linkType: "one"
}
}
]
}
}
</syntaxhighlight>

* handle history of inventoryLocations same as stockLocations

= Working documents =

[[:Category:Working_documents - Inventory Location Manager|Inventory Location Manager]]

[[Category:Backend services| Inventory Location Manager]]

Service - Inventory Location Manager

2026-03-14T02:27:45Z

Mint: /* inventoryLocation */

= Overview =

Where inventory is located, inventory location also distinguishes whether an inventoryUnit is in stock, is work in progress, was the input to other unit/s through production, or sold to a customer.

To move an inventoryUnit from one location to another (eg to sell it) requires reserving the stock, performing the movement (eg removing/adding links in graph), then confirming the reservation.

= Repository =

...

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

== objType ==

=== inventoryLocation ===

<syntaxhighlight lang="JavaScript">
{
objectType: "inventoryLocation",
canDelete: false,
belongTo: {
serviceTag: "Business",
objectType: "business"
},
addOnDataStructure: [
type: "propertyValue"
],
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
dynamoDB: {
storageType: "dynamoDB",
"tableName": "inventoryLocation",
}
},
fieldNames: {
inventoryLocationId: {
type: "string",
randomOnCreate: true,
storageResourceTags: ['myGraph', 'dynamoDB']
},
inventoryLocationHandlerServiceNameTag: {
type: "string",
optionalOnCreate: true,
storageResourceTags: ['dynamoDB']
},
},
identifiers: [
{
type: "partitionKey",
fieldName: "inventoryId"
}
]
}
</syntaxhighlight>

== Object Relationships ==

=== at_InventoryLocation ===

<syntaxhighlight lang="JavaScript">
{
at_InventoryLocation: {
storageResources: {
myGraph: {
storageType: "graph",
graphServerTag: "GraphHandler"
}
},
links: [
{
storageResourceTags: ["myGraph"],
from: {
objType: {
serviceTag: "inventoryManager",
objectType: "inventoryUnit"
},
linkType: "many",
},
to: {
objType: {
serviceTag: "inventoryLocationManager",
objectType: "inventoryLocation"
},
linkType: "one"
}
}
]
}
}
</syntaxhighlight>

* handle history of inventoryLocations same as stockLocations

= Working documents =

[[:Category:Working_documents - Inventory Location Manager|Inventory Location Manager]]

[[Category:Backend services| Inventory Location Manager]]

2025-11-20 IntegrationTest

2026-03-08T08:55:47Z

Mint: /* Syntax event */

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"

=Table test=

<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]]

2025-11-20 IntegrationTest

2026-03-08T08:55:02Z

Mint: /* Syntax event */

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"

=Table test=

<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":{
"properties":{
"propertyA":{
"value":"valueProperty1"
},
"propertyB":{
"properties":{
"propertyB1":{
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"DirectSqs":true,
"messageAttributes":{
"msgTag":{
"value":"msgTag"
},
"propertyD":{
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrDsq_pass":{
"properties":{
"propertyA":{
"value":"valueProperty1"
}
}
}
}
}
</syntaxhighlight>
* DirectSqs = true
:: for initialStage of Dsq
* messageAttributes is optional

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

=====Api=====
<syntaxhighlight lang="JavaScript">
// An example input and output event of API
{
"LambdaFunctionHdrApi_input__pass_notTestAuthorizer": {
"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": true,
"value": "bbc4f4a9-2032-4dec-9129-8c7d169fecc5"
},
"filterObject": {
"properties": {
"logicalType": {
"value": "partitionKey"
},
"comparison": {
"value": "equals"
},
"type": {
"value": "logical"
},
"partitionKey": {
"value": "mockIntegratioTestCPF"
}
}
},
"filterMainExpiryTime": {
"testValueMatches": true,
"value": 1731980802858
},
"filterMainStatus": {
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"value": 1731894402678
},
"objType": {
"properties": {
"serviceTag": {
"value": "IntTesting"
},
"objectType": {
"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]]

2025-11-20 IntegrationTest

2026-03-08T08:50:21Z

Mint: /* Sqs */

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"

=Table test=

<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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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]]

2025-11-20 IntegrationTest

2026-03-05T06:30:33Z

Mint: /* Result of integrationtest */

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"

=Table test=

<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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"forStageMatching":true,
"useIsEqual":true,
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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]]

2025-11-20 IntegrationTest

2026-03-04T04:16:56Z

Mint: /* Result of integrationtest */

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"

=Table test=

<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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"forStageMatching":true,
"useIsEqual":true,
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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 "unitTest".
:- TestRecord is table all unti of stage inside eg input output invokes and dynamodb
:- UnitTest is store status each unit
each unit save in table UnitTest
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 unitTest finish (check by awaitingMultiplestep penditnStep is integrationtestTag awaitingStepId is each unitTest )
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-03-04T04:15:38Z

Mint: /* Sumla all test is status */

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"

=Table test=

<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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"forStageMatching":true,
"useIsEqual":true,
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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 "unitTest".
:- TestRecord is table all unti of stage inside eg input output invokes and dynamodb
:- UnitTest is store status each unit
each unit save in table UnitTest
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 = point stage index 0 result input
output_1 = point stage index 1 result output
invokeInput_0_1 = point stage index 0 result invokes index 1 position input
invokeOutput_0_1 = point stage index 0 result invokes index 1 position output
dynamodb_0_1 = point stage index 0 result dynamodb index 1.
</syntaxhighlight>

after all unitTest finish (check by awaitingMultiplestep penditnStep is integrationtestTag awaitingStepId is each unitTest )
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-03-04T04:11:00Z

Mint: /* Sumla all test is status */

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"

=Table test=

<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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"forStageMatching":true,
"useIsEqual":true,
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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 "unitTest".
:- TestRecord is table all unti of stage inside eg input output invokes and dynamodb
:- UnitTest is store status each unit
each unit save in table UnitTest
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 = point stage index 0 result input
output_1 = point stage index 1 result output
invokeInput_0_1 = point stage index 0 result invokes index 1 position input
invokeOutput_0_1 = point stage index 0 result invokes index 1 position output
dynamodb_0_1 = point stage index 0 result dynamodb index 1.
</syntaxhighlight>

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

== Sumla all test is status ==
:1.testStatus is "passred" all unit passed.
:2.testStatus is "failed" have some is failse.
: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-03-04T04:10:20Z

Mint:

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"

=Table test=

<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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"forStageMatching":true,
"useIsEqual":true,
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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 "unitTest".
:- TestRecord is table all unti of stage inside eg input output invokes and dynamodb
:- UnitTest is store status each unit
each unit save in table UnitTest
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 = point stage index 0 result input
output_1 = point stage index 1 result output
invokeInput_0_1 = point stage index 0 result invokes index 1 position input
invokeOutput_0_1 = point stage index 0 result invokes index 1 position output
dynamodb_0_1 = point stage index 0 result dynamodb index 1.
</syntaxhighlight>

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

== Sumla all test is status ==
:1.testStatus is "passred" all unit passed.
:2.testStatus is "failed" have some is failse.
: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-01-09T03:21:04Z

Mint: /* Inv */

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"

=Table test=

<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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"forStageMatching":true,
"useIsEqual":true,
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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>
*[[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-01-08T09:16:05Z

Mint: /* Inv */

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"

=Table test=

<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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"forStageMatching":true,
"useIsEqual":true,
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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,
"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>
*[[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-01-05T08:20:23Z

Mint:

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"

=Table test=

<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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"forStageMatching":true,
"useIsEqual":true,
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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,
"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,
"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>
*[[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

2025-12-28T06:43:41Z

Mint: /* Dsq */

Referance:
*[[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"
=Table test=
<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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"forStageMatching":true,
"useIsEqual":true,
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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,
"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,
"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>
*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

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

2025-11-20 IntegrationTest

2025-12-28T06:42:52Z

Mint: /* Sqs */

Referance:
*[[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"
=Table test=
<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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"forStageMatching":true,
"useIsEqual":true,
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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":{
"forStageMatching":true,
"properties":{
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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,
"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,
"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>
*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

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

2025-11-20 IntegrationTest

2025-12-28T05:14:11Z

Mint: /* Setting of test */

Referance:
*[[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"
=Table test=
<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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"forStageMatching":true,
"properties":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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":{
"forStageMatching":true,
"properties":{
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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,
"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,
"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>
*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

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

2025-11-20 IntegrationTest

2025-12-28T05:13:01Z

Mint: /* Setting of test */

Referance:
*[[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"
=Table test=
<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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"forStageMatching":true,
"properties":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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":{
"forStageMatching":true,
"properties":{
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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,
"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,
"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>
*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

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

2025-11-20 IntegrationTest

2025-12-28T05:09:25Z

Mint: /* Refresh Seed Data */

Referance:
*[[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"
=Table test=
<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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"forStageMatching":true,
"properties":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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":{
"forStageMatching":true,
"properties":{
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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>

==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,
"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,
"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>
*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

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

2025-11-20 IntegrationTest

2025-12-28T05:09:18Z

Mint: /* Setting of test */

Referance:
*[[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"
=Table test=
<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.

'''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
graphSeedDataTags

=== 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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"forStageMatching":true,
"properties":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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":{
"forStageMatching":true,
"properties":{
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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>

==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,
"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,
"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>
*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

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

2025-11-20 IntegrationTest

2025-12-28T05:04:26Z

Mint: /* Refresh seed data */

Referance:
*[[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"
=Table test=
<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.

'''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
graphSeedDataTags

=== 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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"forStageMatching":true,
"properties":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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":{
"forStageMatching":true,
"properties":{
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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]]

===Refresh seed data===
:Refresh seed data use seed data tag.
*'''seedDataTag''' is dynamoDBSeedDataTags or graphSeedDataTags must be unique.
*canbe share seed data for other test by seed data tag.
<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>

====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>

====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>

==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,
"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,
"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>
*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

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

2025-11-20 IntegrationTest

2025-12-28T05:00:26Z

Mint: /* Setting of test */

Referance:
*[[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"
=Table test=
<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.

'''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
graphSeedDataTags

=== 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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"forStageMatching":true,
"properties":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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":{
"forStageMatching":true,
"properties":{
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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]]

===Refresh seed data===
:Refresh seed data use seed data tag.
*'''seedDataTag''' is dynamoDBSeedDataTags or graphSeedDataTags must be unique.
*canbe share seed data for other test by seed data tag.
<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
stages:[]
}
</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>

====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>

==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,
"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,
"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>
*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

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

2025-11-20 IntegrationTest

2025-12-28T04:58:17Z

Mint: /* Seed Data */

Referance:
*[[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"
=Table test=
<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.

'''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
graphSeedDataTags

=== 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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"forStageMatching":true,
"properties":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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":{
"forStageMatching":true,
"properties":{
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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]]

===Refresh seed data tag===
:Refresh seed data use seed data tag.
*'''seedDataTag''' is dynamoDBSeedDataTags or graphSeedDataTags must be unique.
*canbe share seed data for other test by seed data tag.
<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
stages:[]
}
</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>

====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>

==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,
"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,
"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>
*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

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

2025-11-20 IntegrationTest

2025-12-28T04:50:22Z

Mint: /* seed Data */

Referance:
*[[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"
=Table test=
<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.

'''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
graphSeedDataTags

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

*cleaningeDynamoManyRecordsTags.json

=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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"forStageMatching":true,
"properties":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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":{
"forStageMatching":true,
"properties":{
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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]]

===Refresh seed data tag===
:Refresh seed data use seed data tag.
*'''seedDataTag''' is dynamoDBSeedDataTags or graphSeedDataTags must be unique.
*canbe share seed data for other test by seed data tag.
<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
stages:[]
}
</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>

====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>

==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,
"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,
"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>
*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

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

2025-11-20 IntegrationTest

2025-12-28T04:33:00Z

Mint: /* SeedDataTag */

Referance:
*[[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"
=Table test=
<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
==MainSeedfData==
: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 dynamod)
:to clean up the seed data in the table after it creates seed data form service deploy and pulls seed data from s3.

==SeedDataTag==
Data use for create environment of ''test'' and can be refresh seeddata re-test agian.
save file in s3 (for other dav keep in floder dev name) or testConfig/seedData_config(for admin)

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

=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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"forStageMatching":true,
"properties":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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":{
"forStageMatching":true,
"properties":{
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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]]

===Refresh seed data tag===
:Refresh seed data use seed data tag.
*'''seedDataTag''' is dynamoDBSeedDataTags or graphSeedDataTags must be unique.
*canbe share seed data for other test by seed data tag.
<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
stages:[]
}
</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>

====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>

==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,
"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,
"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>
*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

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

2025-11-20 IntegrationTest

2025-11-25T05:20:25Z

Mint:

Referance:
*[[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"
=Table test=
<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
==MainSeedfData==
: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 dynamod)
:to clean up the seed data in the table after it creates seed data form service deploy and pulls seed data from s3.

==SeedDataTag==
Data use for create environment of ''test'' and can be refresh seeddata re-test agian.
save file in s3 (for other dav keep in floder dev name) or testConfig/seedData_config(for admin)
'''Folder'''
*dynamoDBSeedDataTags.json
*graphSeedDataTags.json

=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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"forStageMatching":true,
"properties":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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":{
"forStageMatching":true,
"properties":{
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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]]

===Refresh seed data tag===
:Refresh seed data use seed data tag.
*'''seedDataTag''' is dynamoDBSeedDataTags or graphSeedDataTags must be unique.
*canbe share seed data for other test by seed data tag.
<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
stages:[]
}
</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>

====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>

==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,
"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,
"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>
*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

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

2025-11-20 IntegrationTest

2025-11-25T05:19:43Z

Mint:

[[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"
=Table test=
<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
==MainSeedfData==
: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 dynamod)
:to clean up the seed data in the table after it creates seed data form service deploy and pulls seed data from s3.

==SeedDataTag==
Data use for create environment of ''test'' and can be refresh seeddata re-test agian.
save file in s3 (for other dav keep in floder dev name) or testConfig/seedData_config(for admin)
'''Folder'''
*dynamoDBSeedDataTags.json
*graphSeedDataTags.json

=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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"forStageMatching":true,
"properties":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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":{
"forStageMatching":true,
"properties":{
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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]]

===Refresh seed data tag===
:Refresh seed data use seed data tag.
*'''seedDataTag''' is dynamoDBSeedDataTags or graphSeedDataTags must be unique.
*canbe share seed data for other test by seed data tag.
<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
stages:[]
}
</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>

====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>

==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,
"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,
"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>
*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

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

2025-11-20 IntegrationTest

2025-11-25T04:31:27Z

Mint: /* seed Data */

=File extension=
uploadS3: ".json"
integrationtestConfig: ".js"
=Table test=
<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
==MainSeedfData==
: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 dynamod)
:to clean up the seed data in the table after it creates seed data form service deploy and pulls seed data from s3.

==SeedDataTag==
Data use for create environment of ''test'' and can be refresh seeddata re-test agian.
save file in s3 (for other dav keep in floder dev name) or testConfig/seedData_config(for admin)
'''Folder'''
*dynamoDBSeedDataTags.json
*graphSeedDataTags.json

=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":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"value":"valueProperty1"
},
"propertyB":{
"forStageMatching":true,
"properties":{
"propertyB1":{
"forStageMatching":true,
"value":"valuePropertyB1"
}
}
},
"propertyC":{
"eventValue":[
"valuePropertyC1",
"valuePropertyC2",
"valuePropertyC3"
]
}
},
"snsSqsTrigger":true,
"messageAttributes":{
"forStageMatching":true,
"properties":{
"msgTag":{
"forStageMatching":true,
"value":"msgTag"
},
"propertyD":{
"forStageMatching":true,
"value":"valuePropertyD"
}
}
}
},
{
"output_LambdaFunctionHdrSqs_pass":{
"forStageMatching":true,
"properties":{
"propertyA":{
"forStageMatching":true,
"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":{
"forStageMatching":true,
"properties":{
"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": true,
"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": true,
"value": 1731980802858
},
"filterMainStatus": {
"forStageMatching": true,
"value": "processing"
},
"createTime": {
"testValueMatches": true,
"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]]

===Refresh seed data tag===
:Refresh seed data use seed data tag.
*'''seedDataTag''' is dynamoDBSeedDataTags or graphSeedDataTags must be unique.
*canbe share seed data for other test by seed data tag.
<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
stages:[]
}
</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>

====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>

==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,
"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,
"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>
*[[2025-02-20 - Integration Test examples#tests.js Syntax|Syntax Dynamodb]]

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