Service - Menu Config: Difference between revisions

From Izara Wiki
Jump to navigation Jump to search
(Created page with "= Overview = Manages configuration for site menus created by users and used in different areas of the project. = Repository = https://bitbucket.org/izara-core-shared/izara-core-shared-menu-config = DynamoDB tables = == Standard Config Table Per Service == === Configuration tags === <syntaxhighlight lang="JavaScript"> { configKey: "xx", configTag: "xx", configValue: "xx", }, </syntaxhighlight> == MenuConfigMain == <syntaxhighlight lang="JavaScript"> { men...")
 
mNo edit summary
 
(15 intermediate revisions by 3 users not shown)
Line 6: Line 6:


https://bitbucket.org/izara-core-shared/izara-core-shared-menu-config
https://bitbucket.org/izara-core-shared/izara-core-shared-menu-config
= ObjectSchema =
== MenuConfig ==
<syntaxhighlight lang="JavaScript">
[
  {
    objectType: "menuConfig",
    storageResources: {
      "dynamodb": {
        storageType: "dynamoDB",
        tableName: "MenuConfigMain",
      }
    },
    fieldNames: {
      menuConfigId: {
        type: "string",
        randomOnCreate: true,
        requiredOnCreate: false,
        optionalOnCreate: false,
        canUpdate: false,
        storageResourceTags: ['dynamodb'],
      },
      menuConfig: {
        type: "object",
        randomOnCreate: false,
        requiredOnCreate: true,
        optionalOnCreate: false,
        canUpdate: true,
        storageResourceTags: ['dynamodb'],
      },
      menuConfigName: {
        type: "string",
        randomOnCreate: false,
        requiredOnCreate: true,
        optionalOnCreate: false,
        canUpdate: true,
        storageResourceTags: ['dynamodb'],
      },
      userId: { // before put check with base-user-id or targetId
        type: "string",
        randomOnCreate: false,
        requiredOnCreate: true,
        optionalOnCreate: false,
        canUpdate: false,
        storageResourceTags: ['dynamodb'],
      },
    },
    identifiers: [
      {
        type: "partitionKey",
        fieldNames: "menuConfigId"
      },
    ],
  },
]
</syntaxhighlight>


= DynamoDB tables =
= DynamoDB tables =
== [[Standard Config Table Per Service]] ==
=== Configuration tags ===
<syntaxhighlight lang="JavaScript">
{
configKey: "xx",
configTag: "xx",
configValue: "xx",
},
</syntaxhighlight>


== MenuConfigMain ==
== MenuConfigMain ==
Line 25: Line 68:
<syntaxhighlight lang="JavaScript">
<syntaxhighlight lang="JavaScript">
{
{
menuConfigId: "xx", // {useCase}_{random uuid}
menuConfigId: "xx", // {random uuid}
menuConfig: "xx", // json encoded object of configuration
menuConfig: "xx", // json encoded object of configuration
menuConfigName: "yy", // user specified name of the config
menuConfigName: "yy", // user specified name of the config
Line 34: Line 77:
* partition key: menuConfigId
* partition key: menuConfigId
* sort key: {none}
* sort key: {none}
* save menuConfig according to useCase, not yet applied but could sub areas of the project into different use cases, handled by the same Menu Config service


== UsersMenuConfigs ==
== UsersMenuConfigs ==
Line 40: Line 82:
<syntaxhighlight lang="JavaScript">
<syntaxhighlight lang="JavaScript">
{
{
userId: "xx" // user who owns the tableConfig
userId: "xx" // user who owns the menuConfig
menuConfigId: "xx",
menuConfigId: "xx",
}
}
Line 47: Line 89:
* partition key: userId
* partition key: userId
* sort key: menuConfigId
* sort key: menuConfigId
= menuConfig Object =
<syntaxhighlight lang="json">
{
menuRows:[
{
rowName: "xx", // used when configuring only as a reference
menuElements: [
{
elementType: "menu"
menuElements: [
{
elementType: "staticUrl"
url: "xxx",
},
{
elementType: "sitePage"
sitePageId: "xx",
},
{
elementType: "plainText"
plainText: "xxx",
},
],
},
{
elementType: "projectMenu", // used for the main project menu
}
// ..
]
},
// ..
]
}
</syntaxhighlight>


= Working documents =
= Working documents =

Latest revision as of 02:37, 17 July 2025

Overview

Manages configuration for site menus created by users and used in different areas of the project.

Repository

https://bitbucket.org/izara-core-shared/izara-core-shared-menu-config

ObjectSchema

MenuConfig

[
  {
    objectType: "menuConfig",
    storageResources: {
      "dynamodb": {
        storageType: "dynamoDB",
        tableName: "MenuConfigMain",
      }
    },
    fieldNames: {
      menuConfigId: {
        type: "string",
        randomOnCreate: true,
        requiredOnCreate: false,
        optionalOnCreate: false,
        canUpdate: false,
        storageResourceTags: ['dynamodb'],
      },
      menuConfig: {
        type: "object", 
        randomOnCreate: false,
        requiredOnCreate: true,
        optionalOnCreate: false,
        canUpdate: true,
        storageResourceTags: ['dynamodb'],
      },
      menuConfigName: {
        type: "string",
        randomOnCreate: false,
        requiredOnCreate: true,
        optionalOnCreate: false,
        canUpdate: true,
        storageResourceTags: ['dynamodb'],
      },
      userId: { // before put check with base-user-id or targetId
        type: "string",
        randomOnCreate: false,
        requiredOnCreate: true,
        optionalOnCreate: false,
        canUpdate: false,
        storageResourceTags: ['dynamodb'],
      },
    },
    identifiers: [
      {
        type: "partitionKey",
        fieldNames: "menuConfigId"
      },
    ],
  },
]

DynamoDB tables

MenuConfigMain

{
	menuConfigId: "xx", // {random uuid}
	menuConfig: "xx", // json encoded object of configuration
	menuConfigName: "yy", // user specified name of the config
	userId: "xx"
}
  • partition key: menuConfigId
  • sort key: {none}

UsersMenuConfigs

{
	userId: "xx" // user who owns the menuConfig
	menuConfigId: "xx",
}
  • partition key: userId
  • sort key: menuConfigId

menuConfig Object

{
	menuRows:[
		{
			rowName: "xx", // used when configuring only as a reference
			menuElements: [
				{
					elementType: "menu"
					menuElements: [
						{
							elementType: "staticUrl"
							url: "xxx",
						},
						{
							elementType: "sitePage"
							sitePageId: "xx",
						},
						{
							elementType: "plainText"
							plainText: "xxx",
						},
					],
				},
				{
					elementType: "projectMenu", // used for the main project menu
				}
				// ..
			]
		},
		// ..
	]
}

Working documents

Menu Config