Setup Manager v1.1

[scriptingosx]

The latest version of Setup Manager has many fixes and improvements, many of them from requests and feedback from the community! Thank you!

There are also new features, most prominently a new action that waits for the user entry to complete, which allows for two-phase workflows, where the actions in the second phase, after the user entry, can use data or scoping based on the user entry. Data from user entry and the workflow as a whole is now written to a file, which can be used for statistics or extension attributes later.

Version 1.1 also adds Hebrew localization. This is the first non-latin-script localization and a right-to-left script at that. It's quite the ride to see Setup Manager actions scrolling the other way! If you would like to help localize Setup Manager to more languages, please reach out. It isn't a large amount of work, but we need the expertise of fluent speakers to make sure everything it just right.

However, the other major new feature we introduced in the 1.1beta, which allows Setup Manager to run at Login Window, retains the beta label. In our testing, we found that this workflow to be not as reliable in all situations as we would like it to be. There are a combination of challenges, that have to do with Xcode 16, macOS Sequoia and various timings of the enrollment workflow. We believe that we have addressed or found workarounds for most of them, but still would like to see more "field" testing before we are comfortable with releasing this feature fully. (Please share your feedback, both for successful deployments and failures.)

On the other hand, v1.1 brings with it a lot of fixes and improvements which should make the Setup Manager workflow more stable and useful. We didn't want to hold back the release any longer.

You can find the details in the release notes and changelog.

As always, test, test, test, and let us know how it works! (good and bad)

New Features

• new action waitForUserEntry which allows for two-phase installation workflows in Jamf Pro. When Setup Manager reaches this action it will wait for the user entry to save the data entry, then it will run a recon/Update Inventory. Policy actions that follow this, can then be scoped to data from the user entry. (Feature Request: wait on user to enter in building / department information #11)
• data from user entry is now written to a file when Setup Manager submits data. See details in User Entry (Feature request: Store finish timestamp of successful completion of JSM #9)
• use token substitution in the title, message, and action label values (as well as computerNameTemplate)
• token substitution can extract center characters with :=n
• localization of custom text in the configuration profile has been simplified. The previous method still works, but is considered deprecated. Details in the documentation. The plist and profile example files have been updated.

Fixes and improvements

1.1beta:

• icons using symbol: that end in .app now work properly
• Elapsed time is shown in "About this Mac…" Start time is shown with option key.
• svg and pdf images used for icons should now work
• general fixes in user entry setup
• improved rendering in Help View (Help window rendering issues #12)
• fixes to json schema
• improved and updated documentation
• included Installomator script updated to v10.6
• added Setup Manager version and macOS version and build to tracking ping
• fixed UI glitch in macOS Sequoia

1.1 release:

• documentation updates and fixes (Update ConfigurationProfile.md #35, simulateMDM key missing from Jamf Pro manifest  #44, “runAt” description is a bit unclear #48, Jamf Pro Configuration Profile Json #51)
• custom accentColor now works correctly with SF Symbol icons (Regression: accentColor not used in SF Symbols in 1.1beta #41)
• setting a placeholder no longer overrides a default in userEntry (default key in assetTag user entry not populating #43)
• more UI updates
• Hebrew localization

Beta features

Even though we are confident that the 1.1 release is overall stable and ready to be used in production, we believe this feature may require more testing. When, after thorough testing in your environment, you conclude this works for your workflow, please let us know about success or any issues you might encounter.

• Setup Manager can now run over Login Window, instead of immediately after installation. This also allows Setup Manager to work with AutoAdvance. Use the new runAt key in the profile to determine when Setup Manager runs (Feature Request: Any chance this could be configured to run over the login window? #18)

Deprecations

These features are marked for removal in a future release:

• localized labels and text by adding the two-letter language code to key. Switch to localization with dictionaries.
• showBothButtons key and functionality

---

This discussion was created from the release v1.1.