Skip to content

Workspaces JOSM Settings Guide

This guide explains how use the Workspaces JOSM Settings Script from TDEI Tools to set up JOSM to enable editing of Workspaces.

For a list of all guides on the TCAT Wiki, refer to the Guides List.


Instructions

Note: You must have a TDEI Portal account.

1. Download and run the helper script

  1. Download the Workspaces JOSM Settings Script from TDEI Tools.
  2. Run the script by right clicking and selecting "Run with PowerShell"

Screenshot of the downloaded Workspaces JOSM Settings Script, after right clicking to pop up a menu containing the "Run with PowerShell" option.

Now, follow the script's instructions and enter the requested information:

2. Determine your environment

  1. Prod: portal.tdei.us + workspaces.sidewalks.washington.edu

  2. Stage: portal-stage.tdei.us + workspaces-stage.sidewalks.washington.edu

  3. Dev: portal-dev.tdei.us + workspaces-dev.sidewalks.washington.edu

3. Enter your TDEI credentials

  1. Enter the credentials for the account you use to sign into both the TDEI Portal and Workspaces.

4. Find your Workspace ID

  1. Extract the ID from the Workspace link, in this case 125:

https://workspaces.sidewalks.washington.edu/workspace/125/settings

5. Generate JOSM Settings

  1. After entering the Workspace ID, the script will authenticate you and output two strings:

Screenshot of the downloaded Workspaces JOSM Settings Script, after right clicking to pop up a menu containing the "Run with PowerShell" option.

6. Apply JOSM Settings

  1. Open JOSM's "Preferences" Menu

Screenshot of the JOSM Preferences menu icon.

  1. Navigate to the "OSM Server" menu

Screenshot of the "OSM Server" submenu in the JOSM Preferences menu.

  1. If present, click "Remove token"

Screenshot of the "Remove token" button in the JOSM Preferences menu.

  1. Uncheck "User the default OSM server URL"
  2. Paste in the generated URL from the script
  3. Select "Use Basic Authentication"
  4. Paste in the generated Access Token in the "OSM username" field
  5. Enter none in the "OSM password" field

Screenshot of the "OSM server" submenu in the JOSM Preferences menu.

  1. Save your settings changes.

You should now be able to use JOSM to edit the specified Workspace!