JavaScript API Differences Between Sintel Forms and Sintel Apps

Returns an array even for single-select Person fields.

Returns a single object for single-select fields:

{ emailAddress: "a@a.com", displayName: "Joe Bloggs" }

Generic methods used for most field types.

• getTextFieldValue / setTextFieldValue
• getNumberFieldValue / setNumberFieldValue
• getBooleanFieldValue / setBooleanFieldValue
• setLookupFieldValue
• setUserFieldValue
• getRelatedListFieldValue / setRelatedListFieldValue

The API has been simplified to a single method.

const requesterEmail = getValue("Requester")?.emailAddress;

if (requesterEmail) {
    getUserProperties(requesterEmail).then(data => {
        setValue("Email", data.Mail);
        setValue("Manager", data.Manager);
    });
}

A single API method replaces the previous filtered list retrieval methods.

getListItems({
  listInternalName: "Projects",
  search: {
    value: "Yes",
    fieldInternalName: "Program",
    operator: "equals"
  },
  itemsLimit: 0,
  returnedFieldInternalNames: ["ID","Title"]
})
.then(result => {
  const mappedResult = result.map(item => ({
    id: +item.ID,
    value: item.Title
  }));
});

A single API method replaces the previous filtered list retrieval methods.

/**
 * Adds a custom button to the form's top bar.
 * @param label - The label of the button.
 * @param icon - The icon of the button (name of the [Font Awesome icon](https://fontawesome.com/icons)). Can be `undefined` for no icon.
 * @param action - The action to perform when the button is clicked. Can be:
 *                 - A string representing a URL to navigate to.
 *                 - An object with `url` and optional `target` properties for navigation.
 *                 - A callback function to execute custom logic.
 */
addTopBarButton: (
    label: string,
    icon: string | undefined,
    action: string | { url: string; target?: string } | (() => void),
) => void;

A single API method replaces the previous filtered list retrieval methods.

updateLookupOptions: (
    fieldInternalName: string,
    values: LookupValue[] | undefined,
    listInternalNameOrId?: string,
) => void;

IMPORTANT: values require capital ID, e.g.. {ID: 1, value: ‘Option 1’};