Skip to main content

Return to TX Community

Liaison

Base Upgrade

Step 1 - Record the Current Package Version 

​Before upgrading,  find and record your currently installed version:

  1. Navigate to Setup > Installed Packages
  2. Search for TargetX_Base
  3. Record your current version number

Note: ​If your current version is 2405.18, you are on the most recent package and should proceed to the Payment Connector Upgrade

Step 2 - Check for Custom Object Tab 

  1. Navigate to Setup and search for Tabs.
  2. Check to see if you have a Custom Object tab for TargetX Logs.
    1. If you do NOT have the tab, proceed to the next step.
    2. If you DO have the tab, Delete the tab and then proceed to the next step.
    3. If you DO have the tab but do NOT have the option to Delete, proceed to the next step.

Step 3 - Install the Upgraded Package 

This is your "ending version" (i.e., the version you want to upgrade to). You can select any version that's higher than your current package version. Packages are cumulative, meaning the upgraded package you select includes all features from previous packages. For example, if you're upgrading from Package A to Package D, that package includes all features from Packages B and C. 

  1. Navigate toTargetX Recruitment Suite: Admin Group to select and obtain the upgraded package. 
  2. Choose "Install for Admins Only.
    • Remember to update the appropriate Profiles and Permission Sets if additional security is required.

Step 4 - Complete Additional Configurations

After installing the upgraded package (i.e., the ending version), you must complete additional configuration steps to ensure all functionality is available. Use the following chart to complete the additional configurations. Identify your starting package and your ending package, then complete all configurations steps in between. For example, if your starting version is xxxx.1 and you're upgrading to xxxx.4, you'll need to complete all configuration steps for xxxx.2, xxxx.3, and xxxx.4.

Starting Version

This is the version you currently have installed, as Identified in Step 1.

Ending Version

This is the upgrade you are installing, as selected in Step 2.  

Configuration Steps by Release

These are the steps you need to complete, from the starting version to the ending version. For example, if your starting version is 2205.0 (May '22) and you're upgrading to 2208.6 (August '22), you'll need to complete the configuration steps for 2206.3 (June '22), 2207.0 (July '22), and 2208.6 (August '22). 

2206.11, 2207.3, 2208.18, 2209.5, 2210.2 2211.3 (November '22) No configuration steps.
2211.3 2212.4 (December '22) No configuration steps.
2212.4 2302.17 (February '23) No configuration steps.
2302.17 2304.1 (March '23)

Item 1: Verify TX Forms with Conditional content on Inquiry records

The defect correction for CL-1905 updates the way the system handles Inquiry records and results in the removal of conditional fields based on Inquiry records. As a result, you should re-check any TX Forms with conditional content built on Inquiry records, as the conditional content may need to be recreated:

  1. Navigate to TargetX Builder.
  2. Select the TX Forms icon.
  3. Click the General or Events icon for the forms with conditional content on Inquiry records.
  4. Click Edit.
  5. Verify or recreate, if needed, any conditional content needed.
  6. Click Save and repeat for any forms with conditional content on Inquiry records.

Item 2: Your upgrade is complete

  1. No further configuration is required.
2304.1 2304.6 (April '23) No configuration steps.
2304.6

2305.9 (May '23)

No configuration steps. 

2305.9 2306.3 (June '23) Item 1: Update Page Layouts
  1. Navigate to Setup and click Object Manager.
  2. Click the Prediction object.
  3. Click Page Layouts.
  4. Click the Prediction Layout.
  5. In the Page Layout Palette, drag the External Prediction Id field onto the Layout.
  6. Click the Prescription object.
  7. Click Page Layouts.
  8. Click the Prescription Layout.
  9. In the Page Layout Palette, drag the External Prescription Id field onto the Layout.

Item 2: Update Permissions

Read/Edit Permissions need to be granted to the new Prediction field on the appropriate Profile/Permission Set:

  1. Navigate to Setup and search for Profiles.
  2. Click the Profile that needs access to the new Prediction field.
  3. Click Object Settings.
  4. Click the Prediction object.
  5. Click Edit.
  6. In the Field Permissions section, click Read Access and Edit Access for the following fields:
  • External Prediction Id 
  1. Click the Prescription object.
  2. Click Edit.
  3. In the Field Permissions section, click Read Access and Edit Access for the following fields:
  • External Prescription Id 
  1. Repeat for any other Profiles that need access to the new fields.
  2. Repeat for any Permission Sets you may use.

 

2306.3 2307.0 (July '23) No configuration steps. 
2307.0 2309.3 (September '23) Item 1: Update TX Forms Autocomplete fields

To utilize the new Autocomplete functionality using an Answer list, you must update any TX Forms with Autocomplete fields:

  1. Navigate to TargetX Builder.
  2. Select TX Forms.
  3. Click Edit on the form you plan to update.
  4. Click the field for School Name in the canvas.
  5. Select a field to use for the Answer List, such as School Name.
  6. Select a Filter Field.
  7. Enter a Filter Value.
  8. Repeat for all TX Forms with autocomplete fields.

Item 2: Upgrade Complete

  1. No further configuration is required.
2309.3 2310.0 (October '23) No configuration steps.
2310.0 2311.0 (November '23) No configuration steps.
2311.0 2312.1 (December '23) No configuration steps. 
2312.1 2402.4 (February '24)

Item 1: Updates for School Picker

The September '23 Base upgrade included a new feature that allowed for changing School Picker into an Autocomplete that works with all lookup Objects. The ‘older’ School Picker will no longer work with the security changes in the February ‘24 upgrade.

  1. For any forms with school picker that were created in a version earlier than September '23 (and not edited after), you must update anything on the School Picker field (such as reselecting the Answer List value) and resave the form for the upgraded school picker to take effect.
     

Item 2: Upgrade Complete

  1. No further configuration is required. 
2402.4 2403.20 (March '24)

Item 1: Update TX Forms embed code

Defect CL-2119 requires the URL for the Embed Code to be updated. As a result, you’ll need to update any webpages embedded with a TX Form with the new URL. To locate the updated embed code:

  1. Navigate to TargetX Builder.
  2. Select the TX Forms icon.
  3. Edit the form that is embedded on a webpage.
  4. Select a Site and click Copy Code in the Embed Code Snippet section.
  5. Apply the Embed Code Snippet to your webpages as needed

Item 2: Upgrade Complete

  1. No further configuration is required. 
2403.20 2405.18 (May '24)

Item 1: Update Address Widget (optional)

This step is necessary only if you observe address fields on your TX Forms are not arranged as expected. Prior versions of TX Forms, like the initial December '20 package, necessitate a manual update to rectify the sequence of address fields:

  1. Navigate to TX Builder, then TX Forms.
  2. Choose the form that uses the Address Widget.
  3. Choose the address widget you've previously mapped and rearrange it according to your preferences. 
  4. Save the form. 

Item 2: Update Site Guest User Permissions (optional)

When using a new site for Application Form Type, you must add permissions for the Application object for the Site Guest User. You will need the list of all the application fields added to the form.

  1. Navigate to Setup and search for Sites.
  2. Click your site, such as Inquiry.
  3. Click the Public Access Settings button.
  4. Click Object Settings.
  5. Select the Application object and click Edit.
  6. Assign READ and CREATE access to the Object.
  7. Assign READ access to any Application fields configured for your TX form.

For additional information on Permissions and TX Forms, see Implementing TX Forms.

Item 3: Upgrade Complete

  1. No further configuration is required. You may proceed to the Payment Connector Upgrade

 

 

  • Was this article helpful?