* feat(editor): Generate custom schema from data (#4562) * feat(core): adding a type package to n8n * feat(editor): adding custom schema generator * fix: add new types package to lock file * fix: remove n8n_io/types package * fix: adding path to generated schema * fix: handling nested lists in schema generation * fix: add date support to schema generation * fix: define dates in ISO format * fix: using test instead of it in repeated tests * fix(editor): JSON schema treat nested lists as object to allow mapping each level * fix(editor): rename JSON schema type * fix(editor): make JSON schema path required * fix(editor): using JSON schema bracket notation for object props to handle exceptional keys * fix(editor): reorder JSON schema generator function args * feat(editor): Add date recognizer util function (#4620) * ✨ Implemented date recogniser fuction * ✅ Added unit tests for date recogniser * ✔️ Fixing linting errors * 👌 Updating test cases * feat(editor): Implement JSON Schema view UI functionalities (#4601) * feat(core): adding a type package to n8n * feat(editor): adding custom schema generator * fix: add new types package to lock file * fix: remove n8n_io/types package * fix: adding path to generated schema * fix: handling nested lists in schema generation * fix: add date support to schema generation * fix: define dates in ISO format * fix: using test instead of it in repeated tests * fix(editor): JSON schema treat nested lists as object to allow mapping each level * fix(editor): rename JSON schema type * fix(editor): make JSON schema path required * fix(editor): using JSON schema bracket notation for object props to handle exceptional keys * fix(editor): reorder JSON schema generator function args * fix(editor): WIP json schema view * fix(editor): formatting fix * fix(editor): WIP json schema viewer * fix(editor): fix schema generator and add deep merge * fix(editor): WIP update json schema view components * fix(editor): extend valid date checking * fix(editor): WIP improving JSON schema view * chore(editor): code formatting * feat(editor): WIP Json schema view mapping + animations * feat(editor): WIP update mergeDeep * feat(editor): adding first item of json data to the end once more to get sample data from the first item * feat(editor): adding first item of json data to the end once more to get sample data from the first item * fix(editor): improving draggable design * fix(editor): move util functions to their correct place after merge conflict * fix(editor): move some type guards * fix(editor): move some type guards * fix(editor): change import path in unit test * fix(editor): import missing interface * fix(editor): remove unused functions and parts from json schema generation * feat(editor): Add telemetry calls to JSON schema mapping (#4695) * feat(editor): WIP JSON schema telemetry call * feat(editor): make telemetry usable outside of Vue component context * chore(editor): remove unused variable * Merge branch 'feature/json-schema-view' of github.com:n8n-io/n8n into n8n-5410-add-telemetry-calls # Conflicts: # packages/editor-ui/src/components/RunDataJsonSchema.vue * fix(editor): VUE typing for telemetry * fix(editor): enable PostHog feature flag * fix(editor): Schema design review (#4740) * refactor(editor): rename JsonSchema to Schema * fix(editor): schema component name * fix(editor): schema pill style * fix(editor): schema type date as string * fix(editor): schema styles (support long text + firefox) * fix(editor): schema truncate text if it's too long * fix(editor): schema types * fix(editor): droppable styles * fix(editor): schema component props * fix(editor): fix draggable pill styles * fix(editor): schema view styles * fix(editor): schema mapping tooltip * fix(editor): schema mapping styles * fix(editor): mapping styles * fix(editor): empty schema case * fix(editor): delay mapping tooltip * test(editor): add schema view snapshot test * fix(editor): schema empty string * fix(editor): schema string without space * fix(editor): update schema test snapshot * fix(editor): applying review comments * fix(editor): make n8nExternalHooks optional * fix(editor): remove TODO comment Co-authored-by: Milorad FIlipović <milorad@n8n.io>
348 lines
7.6 KiB
Vue
348 lines
7.6 KiB
Vue
<template>
|
|
<div :class="$style.jsonDisplay">
|
|
<run-data-json-actions
|
|
v-if="!editMode.enabled"
|
|
:node="node"
|
|
:sessioId="sessionId"
|
|
:displayMode="displayMode"
|
|
:distanceFromActive="distanceFromActive"
|
|
:selectedJsonPath="selectedJsonPath"
|
|
:jsonData="jsonData"
|
|
:paneType="paneType"
|
|
/>
|
|
<draggable
|
|
type="mapping"
|
|
targetDataKey="mappable"
|
|
:disabled="!mappingEnabled"
|
|
@dragstart="onDragStart"
|
|
@dragend="onDragEnd"
|
|
>
|
|
<template #preview="{ canDrop, el }">
|
|
<div :class="[$style.dragPill, canDrop ? $style.droppablePill : $style.defaultPill]">
|
|
{{ $locale.baseText('dataMapping.mapKeyToField', { interpolate: { name: getShortKey(el) } }) }}
|
|
</div>
|
|
</template>
|
|
<template>
|
|
<vue-json-pretty
|
|
:data="jsonData"
|
|
:deep="10"
|
|
:showLength="true"
|
|
:selected-value.sync="selectedJsonPath"
|
|
rootPath=""
|
|
selectableType="single"
|
|
class="json-data"
|
|
>
|
|
<template #nodeKey="{ node }">
|
|
<span
|
|
data-target="mappable"
|
|
:data-value="getJsonParameterPath(node.path)"
|
|
:data-name="node.key"
|
|
:data-path="node.path"
|
|
:data-depth="node.level"
|
|
:class="{
|
|
[$style.mappable]: mappingEnabled,
|
|
[$style.dragged]: draggingPath === node.path,
|
|
}"
|
|
>"{{ node.key }}"</span>
|
|
</template>
|
|
<template #nodeValue="{ node }">
|
|
<span v-if="isNaN(node.index)">{{ getContent(node.content) }}</span>
|
|
<span
|
|
v-else
|
|
data-target="mappable"
|
|
:data-value="getJsonParameterPath(node.path)"
|
|
:data-name="getListItemName(node.path)"
|
|
:data-path="node.path"
|
|
:data-depth="node.level"
|
|
:class="{
|
|
[$style.mappable]: mappingEnabled,
|
|
[$style.dragged]: draggingPath === node.path,
|
|
}"
|
|
>{{ getContent(node.content) }}</span>
|
|
</template>
|
|
</vue-json-pretty>
|
|
</template>
|
|
</draggable>
|
|
</div>
|
|
</template>
|
|
|
|
<script lang="ts">
|
|
import { PropType } from "vue";
|
|
import mixins from "vue-typed-mixins";
|
|
import VueJsonPretty from 'vue-json-pretty';
|
|
import { LOCAL_STORAGE_MAPPING_FLAG } from '@/constants';
|
|
import { IDataObject, INodeExecutionData } from "n8n-workflow";
|
|
import Draggable from '@/components/Draggable.vue';
|
|
import { convertPath, executionDataToJson, isString, shorten } from '@/utils';
|
|
import { INodeUi } from "@/Interface";
|
|
import { externalHooks } from "@/mixins/externalHooks";
|
|
import { mapStores } from "pinia";
|
|
import { useNDVStore } from "@/stores/ndv";
|
|
|
|
const runDataJsonActions = () => import('@/components/RunDataJsonActions.vue');
|
|
|
|
export default mixins(externalHooks).extend({
|
|
name: 'run-data-json',
|
|
components: {
|
|
VueJsonPretty,
|
|
Draggable,
|
|
runDataJsonActions,
|
|
},
|
|
props: {
|
|
editMode: {
|
|
type: Object as () => { enabled?: boolean; value?: string; },
|
|
},
|
|
sessionId: {
|
|
type: String,
|
|
},
|
|
paneType: {
|
|
type: String,
|
|
},
|
|
node: {
|
|
type: Object as PropType<INodeUi>,
|
|
},
|
|
inputData: {
|
|
type: Array as PropType<INodeExecutionData[]>,
|
|
},
|
|
mappingEnabled: {
|
|
type: Boolean,
|
|
},
|
|
distanceFromActive: {
|
|
type: Number,
|
|
},
|
|
showMappingHint: {
|
|
type: Boolean,
|
|
},
|
|
runIndex: {
|
|
type: Number,
|
|
},
|
|
totalRuns: {
|
|
type: Number,
|
|
},
|
|
},
|
|
data() {
|
|
return {
|
|
selectedJsonPath: null as null | string,
|
|
mappingHintVisible: false,
|
|
showHintWithDelay: false,
|
|
draggingPath: null as null | string,
|
|
displayMode: 'json',
|
|
};
|
|
},
|
|
mounted() {
|
|
if (this.showMappingHint) {
|
|
this.mappingHintVisible = true;
|
|
|
|
setTimeout(() => {
|
|
this.mappingHintVisible = false;
|
|
}, 6000);
|
|
}
|
|
|
|
if (this.showMappingHint && this.showHint) {
|
|
setTimeout(() => {
|
|
this.showHintWithDelay = this.showHint;
|
|
this.$telemetry.track('User viewed JSON mapping tooltip', { type: 'param focus' });
|
|
}, 500);
|
|
}
|
|
},
|
|
computed: {
|
|
...mapStores(
|
|
useNDVStore,
|
|
),
|
|
jsonData(): IDataObject[] {
|
|
return executionDataToJson(this.inputData);
|
|
},
|
|
showHint(): boolean {
|
|
return (
|
|
!this.draggingPath &&
|
|
((this.showMappingHint && this.mappingHintVisible) ||
|
|
window.localStorage.getItem(LOCAL_STORAGE_MAPPING_FLAG) !== 'true')
|
|
);
|
|
},
|
|
},
|
|
methods: {
|
|
getShortKey(el: HTMLElement): string {
|
|
if (!el) {
|
|
return '';
|
|
}
|
|
|
|
return shorten(el.dataset.name || '', 16, 2);
|
|
},
|
|
getJsonParameterPath(path: string): string {
|
|
const convertedPath = convertPath(path);
|
|
return `{{ ${ convertedPath.replace(/^(\["?\d"?])/, this.distanceFromActive === 1 ? '$json' : `$node["${ this.node!.name }"].json`) } }}`;
|
|
},
|
|
onDragStart(el: HTMLElement) {
|
|
if (el && el.dataset.path) {
|
|
this.draggingPath = el.dataset.path;
|
|
}
|
|
|
|
this.ndvStore.resetMappingTelemetry();
|
|
},
|
|
onDragEnd(el: HTMLElement) {
|
|
this.draggingPath = null;
|
|
|
|
setTimeout(() => {
|
|
const mappingTelemetry = this.ndvStore.mappingTelemetry;
|
|
const telemetryPayload = {
|
|
src_node_type: this.node.type,
|
|
src_field_name: el.dataset.name || '',
|
|
src_nodes_back: this.distanceFromActive,
|
|
src_run_index: this.runIndex,
|
|
src_runs_total: this.totalRuns,
|
|
src_field_nest_level: el.dataset.depth || 0,
|
|
src_view: 'json',
|
|
src_element: el,
|
|
success: false,
|
|
...mappingTelemetry,
|
|
};
|
|
|
|
this.$externalHooks().run('runDataJson.onDragEnd', telemetryPayload);
|
|
|
|
this.$telemetry.track('User dragged data for mapping', telemetryPayload);
|
|
}, 1000); // ensure dest data gets set if drop
|
|
},
|
|
getContent(value: unknown): string {
|
|
return isString(value) ? `"${ value }"` : JSON.stringify(value);
|
|
},
|
|
getListItemName(path: string): string {
|
|
return path.replace(/^(\["?\d"?]\.?)/g, '');
|
|
},
|
|
},
|
|
});
|
|
</script>
|
|
|
|
<style lang="scss" module>
|
|
.jsonDisplay {
|
|
position: absolute;
|
|
top: 0;
|
|
left: 0;
|
|
padding-left: var(--spacing-s);
|
|
right: 0;
|
|
overflow-y: auto;
|
|
line-height: 1.5;
|
|
word-break: normal;
|
|
height: 100%;
|
|
padding-bottom: var(--spacing-3xl);
|
|
background-color: var(--color-background-base);
|
|
|
|
&:hover {
|
|
/* Shows .actionsGroup element from <run-data-json-actions /> child component */
|
|
> div:first-child {
|
|
opacity: 1;
|
|
}
|
|
}
|
|
}
|
|
|
|
.mappable {
|
|
cursor: grab;
|
|
|
|
&:hover {
|
|
background-color: var(--color-json-highlight);
|
|
}
|
|
}
|
|
|
|
.dragged {
|
|
&,
|
|
&:hover {
|
|
background-color: var(--color-primary-tint-2);
|
|
}
|
|
}
|
|
|
|
.dragPill {
|
|
display: flex;
|
|
height: 24px;
|
|
align-items: center;
|
|
padding: 0 var(--spacing-4xs);
|
|
color: var(--color-text-xlight);
|
|
font-weight: var(--font-weight-bold);
|
|
font-size: var(--font-size-2xs);
|
|
border-radius: var(--border-radius-base);
|
|
white-space: nowrap;
|
|
}
|
|
|
|
.droppablePill {
|
|
background-color: var(--color-success);
|
|
}
|
|
|
|
.defaultPill {
|
|
background-color: var(--color-primary);
|
|
transform: translate(-50%, -100%);
|
|
box-shadow: 0 2px 6px rgba(68, 28, 23, 0.2);
|
|
}
|
|
|
|
</style>
|
|
|
|
<style lang="scss">
|
|
.vjs-tree {
|
|
color: var(--color-json-default);
|
|
}
|
|
|
|
.vjs-tree-node {
|
|
&:hover {
|
|
background-color: transparent;
|
|
}
|
|
|
|
&.is-highlight {
|
|
background-color: var(--color-json-highlight);
|
|
}
|
|
}
|
|
|
|
.vjs-key,
|
|
.vjs-value {
|
|
> span {
|
|
color: var(--color-text-dark);
|
|
line-height: 1.7;
|
|
border-radius: var(--border-radius-base);
|
|
}
|
|
}
|
|
|
|
.vjs-value {
|
|
> span {
|
|
padding: 0 var(--spacing-5xs) 0 var(--spacing-5xs);
|
|
margin-left: var(--spacing-5xs);
|
|
}
|
|
}
|
|
|
|
|
|
.vjs-tree .vjs-value-null {
|
|
&, span {
|
|
color: var(--color-json-null);
|
|
}
|
|
}
|
|
|
|
.vjs-tree .vjs-value-boolean {
|
|
&, span {
|
|
color: var(--color-json-boolean);
|
|
}
|
|
}
|
|
|
|
.vjs-tree .vjs-value-number {
|
|
&, span {
|
|
color: var(--color-json-number);
|
|
}
|
|
}
|
|
|
|
.vjs-tree .vjs-value-string {
|
|
&, span {
|
|
color: var(--color-json-string);
|
|
}
|
|
}
|
|
|
|
.vjs-tree .vjs-key {
|
|
color: var(--color-json-key);
|
|
}
|
|
|
|
.vjs-tree .vjs-tree__brackets {
|
|
color: var(--color-json-brackets);
|
|
}
|
|
|
|
.vjs-tree .vjs-tree__brackets:hover {
|
|
color: var(--color-json-brackets-hover);
|
|
}
|
|
|
|
.vjs-tree .vjs-tree__content.has-line {
|
|
border-left: 1px dotted var(--color-json-line);
|
|
}
|
|
</style>
|