Loading the saved form...
JSON definition · shared/definitions/creator-load-save.json
View on GitHub
{
"title": "Support request",
"elements": [
{
"type": "dropdown",
"name": "product",
"title": "Product",
"choices": [
"Form Library",
"Survey Creator",
"Dashboard",
"PDF Generator"
]
},
{
"type": "comment",
"name": "issue",
"title": "Describe the issue",
"isRequired": true
},
{
"type": "radiogroup",
"name": "urgency",
"title": "How urgent is it?",
"choices": [
"Low",
"Normal",
"Blocking"
]
},
{
"type": "boolean",
"name": "callback",
"title": "Call me back"
}
]
}
Client · shared/client/creator-load-save.js · sjs:creator-load-save.client
View on GitHub
const creator = new SurveyCreator({ showTranslationTab: true });
// Queue writes so an older request cannot overwrite newer edits
const saver = createSchemaSaver(() => creator.JSON, async json => {
const response = await fetch(`/api/forms/${formId}`, {
method: "PUT",
headers: { "Content-Type": "application/json" },
body: json
});
if ([401, 403].includes(response.status)) saveDenied = true;
if (!response.ok) throw await responseError(response, "Couldn't save the form schema. Please try again.");
}, updateSaveState);
creator.saveSurveyFunc = (saveNo, callback) => {
saver.save().then(saved => {
callback(saveNo, saved);
// Creator says "not saved" in the callback; show the server's reason after it
if (!saved) creator.notify(saver.error, "error");
});
};
Client · shared/client/creator-load-save.js · sjs:creator-load-save.load
View on GitHub
// Render only after the backend returns a valid form schema
async function loadDefinition() {
setBusy(true);
retryLoad.hidden = true;
show("schema-status", "Loading the saved form...");
try {
const response = await fetch(`/api/forms/${formId}`);
if (!response.ok) throw await responseError(response, "Couldn't load the form schema. Please try again.");
const { definition } = await response.json();
if (!definition || typeof definition !== "object" || Array.isArray(definition)) throw new Error("The server returned an invalid form schema.");
creator.JSON = definition;
loaded = true;
saver.markSaved();
if (preview) mountSurvey(new Model(definition), "creator");
else { renderSurveyCreator(creator, element); creator.autoSaveEnabled = true; }
element.hidden = false;
if (preview) show("schema-status", "This form uses the saved schema.");
} catch (error) { show("schema-status", error.message); retryLoad.hidden = false; }
finally { setBusy(false); }
}
Server · routes/creator-load-save.js · sjs:creator-load-save.server
View on GitHub
// PUT /api/forms/:id — store the definition as-is: it's one JSON document
app.put("/api/forms/:id", (req, res) => {
const denied = can(req.user, "edit-forms"); // editing is an admin action: 403 otherwise
if (denied) throw httpError(403, denied);
if (req.body === undefined) throw httpError(400, "Expected a form definition"); // not a JSON body
// req.body is the parsed raw body: {} stays {}; store it with JSON.stringify, never a copy
db(req).prepare("INSERT INTO forms (key, json) VALUES (?, ?) ON CONFLICT (key) DO UPDATE SET json = excluded.json")
.run(req.params.id, JSON.stringify(req.body));
res.sendStatus(204); // the next page load renders the new version
});