cxtms 1.9.13

package/templates/module-grid.yaml

@@ -0,0 +1,229 @@
+# {{displayName}} Module
+# Generated by cxtms create module --template grid
+
+module:
+  name: "{{displayNameNoSpaces}}"
+  appModuleId: "{{uuid}}"
+  displayName:
+    en-US: "{{displayName}}"
+  description:
+    en-US: "{{displayName}} module"
+  application: System
+  filePath: "{{fileName}}"
+
+components:
+  - name: {{displayNameNoSpaces}}/List
+    displayName:
+      en-US: "{{displayName}}"
+    platforms:
+      - web
+    props:
+      toolbar:
+        - name: create{{displayNameNoSpaces}}Btn
+          component: button
+          props:
+            label:
+              en-US: "Create {{displayName}}"
+            icon: plus
+            options:
+              variant: primary
+            onClick:
+              - navigate: {{name}}/create
+    layout:
+      component: layout
+      name: list
+      props:
+        title:
+          en-US: "{{displayName}}"
+        icon: list
+        permission: "{{displayNameNoSpaces}}/Read"
+      children:
+        - component: dataGrid
+          name: {{name}}Grid
+          props:
+            refreshHandler: "{{name}}"
+            dotsMenu:
+              items:
+                - label:
+                    en-US: Edit
+                  onClick:
+                    - navigate: "{{name}}/\{{ id }}"
+                - label:
+                    en-US: Delete
+                  onClick:
+                    - confirm:
+                        title:
+                          en-US: "Delete {{displayName}}"
+                        message:
+                          en-US: "Are you sure you want to delete this {{displayName}}?"
+                    - mutation:
+                        command: >-
+                          mutation Delete{{displayNameNoSpaces}}Mutation($input: Delete{{displayNameNoSpaces}}Input!) {
+                              delete{{displayNameNoSpaces}}(input: $input) {
+                                  deleteResult { rowsAffected }
+                              }
+                          }
+                        variables:
+                          input:
+                            organizationId: '\{{number organizationId }}'
+                            id: '\{{number id }}'
+                    - notification:
+                        message:
+                          en-US: "{{displayName}} deleted successfully"
+                        type: success
+                    - refresh: "{{name}}"
+            views:
+              - name: all
+                displayName:
+                  en-US: "All"
+                columns:
+                  - name: id
+                    isHidden: true
+                  - name: name
+                    label:
+                      en-US: "Name"
+                  - name: status
+                    label:
+                      en-US: "Status"
+                    showAs:
+                      component: Badges/StatusesBadge
+                  - name: created
+                    label:
+                      en-US: "Created"
+                    showAs:
+                      component: text
+                      props:
+                        value: '\{{ format created L }}'
+                  - name: lastModified
+                    label:
+                      en-US: "Last Modified"
+                    showAs:
+                      component: text
+                      props:
+                        value: '\{{ format lastModified L }}'
+                orderBy:
+                  - name: created
+                    direction: DESC
+              - name: active
+                displayName:
+                  en-US: "Active"
+                columns:
+                  - name: id
+                    isHidden: true
+                  - name: name
+                    label:
+                      en-US: "Name"
+                  - name: created
+                    label:
+                      en-US: "Created"
+                    showAs:
+                      component: text
+                      props:
+                        value: '\{{ format created L }}'
+                  - name: lastModified
+                    label:
+                      en-US: "Last Modified"
+                    showAs:
+                      component: text
+                      props:
+                        value: '\{{ format lastModified L }}'
+                filter: "status:Active"
+                orderBy:
+                  - name: created
+                    direction: DESC
+              - name: archived
+                displayName:
+                  en-US: "Archived"
+                columns:
+                  - name: id
+                    isHidden: true
+                  - name: name
+                    label:
+                      en-US: "Name"
+                  - name: created
+                    label:
+                      en-US: "Created"
+                    showAs:
+                      component: text
+                      props:
+                        value: '\{{ format created L }}'
+                filter: "status:Archived"
+                orderBy:
+                  - name: created
+                    direction: DESC
+            options:
+              query: {{name}}
+              rootEntityName: "{{displayNameNoSpaces}}"
+              entityKeys:
+                - id
+              navigationType: navigate
+              enableDynamicGrid: true
+              enableViews: true
+              enableSearch: true
+              enablePagination: true
+              enableColumns: true
+              enableFilter: true
+              defaultView: all
+              onRowClick:
+                - navigate: "{{name}}/\{{ id }}"
+            toolbar:
+              - component: dropdown
+                props:
+                  label:
+                    en-US: Actions
+                  name: actions{{displayNameNoSpaces}}
+                  icon: activity
+                  options:
+                    variant: secondary
+                  items:
+                    - label:
+                        en-US: "Export {{displayName}}"
+                      onClick:
+                        - notification:
+                            message:
+                              en-US: "Exporting. It may take a couple of minutes."
+                            type: success
+
+routes:
+  - name: list
+    path: /{{name}}
+    component: {{displayNameNoSpaces}}/List
+    props:
+      title:
+        en-US: "{{displayName}}"
+
+entities:
+  - name: {{displayNameNoSpaces}}
+    entityKind: Other
+    displayName:
+      en-US: "{{displayName}}"
+    fields:
+      - name: name
+        displayName:
+          en-US: "Name"
+        fieldType: text
+      - name: status
+        displayName:
+          en-US: "Status"
+        fieldType: text
+      - name: description
+        displayName:
+          en-US: "Description"
+        fieldType: text
+
+permissions:
+  - name: "{{displayNameNoSpaces}}/Read"
+    displayName:
+      en-US: "Read {{displayName}}"
+    roles:
+      - Admin
+  - name: "{{displayNameNoSpaces}}/Create"
+    displayName:
+      en-US: "Create {{displayName}}"
+    roles:
+      - Admin
+  - name: "{{displayNameNoSpaces}}/Delete"
+    displayName:
+      en-US: "Delete {{displayName}}"
+    roles:
+      - Admin

package/templates/module-select.yaml

@@ -0,0 +1,139 @@
+# {{displayName}} Select Module
+# Generated by cxtms create module --template select
+
+module:
+  name: "{{displayNameNoSpaces}}"
+  appModuleId: "{{uuid}}"
+  displayName:
+    en-US: "{{displayName}}"
+  description:
+    en-US: "{{displayName}} async select component"
+  application: System
+  filePath: "{{fileName}}"
+
+components:
+  - name: {{displayNameNoSpaces}}/Select
+    displayName:
+      en-US: "Select {{displayName}}"
+    platforms:
+      - web
+      - mobile
+    props:
+    layout:
+      component: field
+      name: {{name}}Id
+      inputs:
+      props:
+        type: select-async
+        dropDownToolbar:
+          - component: button
+            name: create{{displayNameNoSpaces}}Btn
+            props:
+              permission: "{{displayNameNoSpaces}}/Create"
+              label:
+                en-US: "Create {{displayName}}"
+              icon: plus
+              options:
+                className: "create-entity-select-btn btn btn-sm w-100"
+                variant: primary
+              onClick:
+                - dialog:
+                    component: {{displayNameNoSpaces}}/Create{{displayNameNoSpaces}}
+                    props:
+                      title: "Create New {{displayName}}"
+                    onClose:
+                      - selectValue: "\{{ result.{{name}}Id }}"
+        label:
+          en-US: "{{displayName}}"
+        options:
+          valueFieldName: "{{name}}Id"
+          itemLabelTemplate: "\{{name}}"
+          itemValueTemplate: "\{{{{name}}Id}}"
+          navigateActionPermission: "{{displayNameNoSpaces}}/Update"
+          searchQuery:
+            name: get{{displayNameNoSpaces}}s
+            path: {{name}}s.items
+            params:
+              search: "\{{ string search }}"
+              take: "\{{ number pageSize }}"
+              skip: "\{{ number skip }}"
+              filter: "\{{ string filter }}"
+          valueQuery:
+            name: get{{displayNameNoSpaces}}
+            path: {{name}}
+            params:
+              {{name}}Id: "\{{{{name}}Id}}"
+          allowSearch: true
+          allowClear: true
+        queries:
+          - name: get{{displayNameNoSpaces}}s
+            query:
+              command: >-
+                query($organizationId: Int!, $filter: String!, $search: String!, $take: Int!, $skip: Int!) {
+                    {{name}}s(organizationId: $organizationId, filter: $filter, search: $search, take: $take, skip: $skip) {
+                        items {
+                            {{name}}Id
+                            name
+                        }
+                        totalCount
+                    }
+                }
+              variables:
+                organizationId: '\{{number organizationId }}'
+                search: '\{{string search }}'
+                take: '\{{number pageSize }}'
+                skip: '\{{number skip }}'
+                filter: '\{{ string filter }}'
+          - name: get{{displayNameNoSpaces}}
+            query:
+              command: >-
+                query($organizationId: Int!, ${{name}}Id: Int!) {
+                    {{name}}(organizationId: $organizationId, {{name}}Id: ${{name}}Id) {
+                        {{name}}Id
+                        name
+                    }
+                }
+              variables:
+                {{name}}Id: '\{{number {{name}}Id }}'
+        onEditClick:
+          - dialog:
+              props:
+                organizationId: "\{{ organizationId }}"
+                {{name}}Id: "\{{ {{name}}Id }}"
+                title:
+                  en-US: "Update {{displayName}}"
+              onClose:
+              component:
+                layout:
+                  component: layout
+                  children:
+                    - component: {{displayNameNoSpaces}}/Update{{displayNameNoSpaces}}
+      children:
+
+entities:
+  - name: {{displayNameNoSpaces}}
+    entityKind: Other
+    displayName:
+      en-US: "{{displayName}}"
+    fields:
+      - name: name
+        displayName:
+          en-US: "Name"
+        fieldType: text
+
+permissions:
+  - name: "{{displayNameNoSpaces}}/Read"
+    displayName:
+      en-US: "Read {{displayName}}"
+    roles:
+      - Admin
+  - name: "{{displayNameNoSpaces}}/Create"
+    displayName:
+      en-US: "Create {{displayName}}"
+    roles:
+      - Admin
+  - name: "{{displayNameNoSpaces}}/Update"
+    displayName:
+      en-US: "Update {{displayName}}"
+    roles:
+      - Admin

package/templates/module.yaml

@@ -0,0 +1,84 @@
+# {{displayName}} Module
+# Generated by cxtms create module
+
+module:
+  name: "{{name}}"
+  appModuleId: "{{uuid}}"
+  displayName: "{{displayName}}"
+  description: "{{displayName}} module"
+  icon: "folder"
+  version: "1.0"
+  application: System
+  filePath: "{{fileName}}"
+
+entities:
+  - name: {{name}}
+    displayName: "{{displayName}}"
+
+permissions:
+  - name: "{{displayNameNoSpaces}}/View"
+    displayName: "View {{displayName}}"
+  - name: "{{displayNameNoSpaces}}/Edit"
+    displayName: "Edit {{displayName}}"
+
+routes:
+  - name: "list"
+    path: "/{{name}}"
+    component: list
+  - name: "detail"
+    path: "/{{name}}/:id"
+    component: detail
+
+components:
+  - type: layout
+    name: list
+    title: "{{displayName}} List"
+    children:
+      - type: dataGrid
+        name: {{name}}Grid
+        props:
+          entityName: "{{name}}"
+          columns:
+            - field: "name"
+              headerName: "Name"
+              flex: 1
+            - field: "createdAt"
+              headerName: "Created"
+              type: "date"
+        actions:
+          onRowClick:
+            - type: navigate
+              props:
+                route: "detail"
+                params:
+                  id: "{{row.id}}"
+
+  - type: layout
+    name: detail
+    title: "{{displayName}} Detail"
+    children:
+      - type: form
+        name: {{name}}Form
+        props:
+          entityName: "{{name}}"
+        fields:
+          - type: text
+            name: name
+            props:
+              label: "Name"
+              required: true
+          - type: textarea
+            name: description
+            props:
+              label: "Description"
+              rows: 3
+        actions:
+          onSubmit:
+            - type: mutation
+              props:
+                operation: "update{{displayNameNoSpaces}}"
+                input: "{{form}}"
+            - type: notification
+              props:
+                message: "{{displayName}} saved successfully"
+                severity: "success"

package/templates/workflow-api-tracking.yaml

@@ -0,0 +1,189 @@
+# {{displayName}} Workflow
+# Generated by cxtms create workflow --template api-tracking
+
+workflow:
+  workflowId: "{{uuid}}"
+  name: "{{displayName}}"
+  description: "{{displayName}} - Fetch tracking events from carrier API and import"
+  version: "1.0"
+  executionMode: Async
+  logLevel: Information
+  isActive: true
+  enableAudit: true
+  filePath: "{{fileName}}"
+  runAs: workflowAgent
+  concurrency:
+    waitTime: 0
+  tags:
+    - "generated"
+    - "api"
+    - "tracking"
+
+variables:
+  - name: apiConfig
+    fromConfig:
+      configName: "apps.myApp.carrierApiConfig"
+  - name: pageSize
+    value: 50
+  - name: offset
+    value: 0
+  - name: hasMorePages
+    value: true
+
+schedules:
+  - cron: "*/30 * * * *"
+    displayName: "{{displayName}} - Every 30 minutes"
+
+activities:
+  # Activity 1: Query orders that need tracking updates
+  - name: FetchOrders
+    conditions: "[apiConfig?.enabled?] = true"
+    events:
+      onActivityStarted:
+        - task: "Utilities/Log@1"
+          name: LogActivityStarted
+          inputs:
+            message: "Activity FetchOrders started"
+            level: Information
+      onActivityCompleted:
+        - task: "Utilities/Log@1"
+          name: LogActivityCompleted
+          inputs:
+            message: "Activity FetchOrders completed"
+            level: Information
+      onActivityFailed:
+        - task: "Utilities/Log@1"
+          name: LogActivityFailed
+          inputs:
+            message: "Activity FetchOrders failed: {{exception.message}}"
+            level: Error
+    steps:
+      - task: "while"
+        name: PageLoop
+        conditions:
+          - expression: "[hasMorePages] = true"
+        maxIterations: 100
+        steps:
+          - task: "Query/GraphQL@1"
+            name: GetOrders
+            inputs:
+              query: |
+                query($organizationId: Int!, $first: Int!, $offset: Int!, $filter: String!) {
+                  orders(organizationId: $organizationId, first: $first, offset: $offset, filter: $filter) {
+                    totalCount
+                    items {
+                      orderId
+                      trackingNumber
+                      status
+                    }
+                  }
+                }
+              variables:
+                organizationId: "\{{int organizationId}}"
+                first: "\{{pageSize}}"
+                offset: "\{{offset}}"
+                filter: "orderType:ParcelShipment AND status:Active"
+            outputs:
+              - name: result
+                mapping: "orders?"
+
+          - task: "foreach"
+            name: ProcessOrders
+            collection: "FetchOrders?.PageLoop?.GetOrders?.result?.items?"
+            item: "order"
+            continueOnError: true
+            steps:
+              # Call carrier tracking API
+              - task: "Utilities/HttpRequest@1"
+                name: CallTrackingApi
+                inputs:
+                  url: "\{{apiConfig?.baseUrl?}}/tracking/v1/track"
+                  method: POST
+                  contentType: "application/json"
+                  headers:
+                    - name: "Authorization"
+                      value: "Bearer \{{apiConfig?.apiKey?}}"
+                    - name: "X-Api-Key"
+                      value: "\{{apiConfig?.apiKey?}}"
+                  body:
+                    trackingNumber: "\{{order.trackingNumber}}"
+                continueOnError: true
+                outputs:
+                  - name: response
+                    mapping: "response?.body?"
+
+              # Import tracking events — mapping inline
+              - task: "Order/Import@1"
+                name: ImportTrackingEvents
+                conditions: "isNullOrEmpty([FetchOrders?.CallTrackingApi?.response?]) = false"
+                inputs:
+                  orders:
+                    - trackingNumber: "\{{order.trackingNumber}}"
+                      orderType: "ParcelShipment"
+                      trackingEvents:
+                        foreach: "FetchOrders?.CallTrackingApi?.response?.events?"
+                        item: "event"
+                        mapping:
+                          eventDate: "\{{event.eventDate}}"
+                          location: "\{{event.location}}"
+                          description: "\{{event.description}}"
+                          includeInTracking: true
+                          sendEmail: false
+                          isInactive: false
+                          customValues:
+                            carrierId: "\{{apiConfig?.carrierId?}}"
+                            carrierEventCode: "\{{event.statusCode}}"
+                            carrierDescription: "\{{event.description}}"
+                            eventType: "\{{event.eventType}}"
+                  options:
+                    orderMatchByFields:
+                      - "trackingNumber"
+                    trackingEventMatchByFields:
+                      - "eventDate"
+                      - "customValues.eventType"
+                      - "customValues.carrierId"
+                    skipIfExists: true
+                    matchByEventDefinition:
+                      - "customValues.carrierId"
+                      - "customValues.carrierEventCode"
+                    createEventDefinitions: true
+                    eventDefinitionDefaults:
+                      eventName: "Unknown"
+                      includeInTracking: true
+
+          - task: "Utilities/SetVariable@1"
+            name: UpdatePagination
+            inputs:
+              variables:
+                - name: offset
+                  value:
+                    expression: "[offset] + [pageSize]"
+                - name: hasMorePages
+                  value:
+                    expression: "[offset] < [FetchOrders?.PageLoop?.GetOrders?.result?.totalCount?]"
+
+      - task: "Utilities/Log@1"
+        name: LogComplete
+        inputs:
+          message: "{{displayName}} completed"
+          level: Information
+
+events:
+  onWorkflowStarted:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowStarted
+      inputs:
+        message: "{{displayName}} workflow started"
+        level: Information
+  onWorkflowCompleted:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowCompleted
+      inputs:
+        message: "{{displayName}} workflow completed successfully"
+        level: Information
+  onWorkflowFailed:
+    - task: "Utilities/Log@1"
+      name: LogWorkflowFailed
+      inputs:
+        message: "{{displayName}} workflow failed: {{exception.message}}"
+        level: Error