8.7.1 Release Notes

Possible Breaking Changes

What has changed	What to do
TRANS-1007. Apps, by default, are no longer embeddable in other sites. Permission to do this must now be enabled per App using the new Embeddable property. When you upgrade Transtream instance to 8.7.1, this defaults to off for all Apps, and access is lost.	If you have embedded Apps within sites, after upgrading to this release, in Product Admin, on the Apps tab, select each embedded App, and enable its Embeddable property. See TRANS-1007 for full details.
TRANS-756. Ship App. Updated. New version available.	If you are using a modified Ship App, you must replicate your changes in the new version. See App Changes below.

Headline Enhancements

ID	Salesforce	Description
TRANS-1006	-	Apps. Improved Anonymous access and revised Page types. Changes have been made to allow direct anonymous (no login required) access to Apps. A Compliance Engine user can also be associated with anonymous access so that access is as that user. To facilitate this, the following changes have been made: In Composer Designer, the Page object's Type property has been renamed Page Type and now has the settings: Start Page. Previously this setting was labelled Default. This is the App's landing page. Allow Anonymous determines whether login is required. Page. Previously General. Any other pages in the App. Branded Login Page. Previously Login. This is a page designed to provide an alternative to the default login. Branded User Management. Previously Forgot Password. This is a page designed to provide an alternative to the default forgotten password capability. Page Types of Start Page and Page can have Allow Anonymous enabled. The default is disabled. User Context is a new setting. When Allow Anonymous is enabled, User Context lets you specify a Compliance Engine user. The anonymous session will run as this user. It can be left empty. However, note that if your App makes calls to a Compliance Engine, these require a user. Anonymous access without user context restricts what you can offer. When a user navigates from an Allow Anonymous page to a page that does not allow anonymity, they are prompted for login credentials. When a logged in user navigates to an anonymous page, any User Context setting is ignored.
TRANS-1007	-	Apps. Embeddable authorization options. All Apps have new Product Admin settings to control if and how they can be embedded in other web sites. In Instance Admin, on the Apps tab, each App now has the following settings: Embeddable. When enabled, the App can be embedded. If not enabled, and the App is identified as embedded, access is denied. By default, Embeddable is disabled. Only Embeddable. When embedding is allowed, this setting restricts that embedding to iframe only, meaning the embedded App cannot appear as a top level window or tab. Only Allow These Hosts. When embedding is allowed, use this to restrict that embedding to named domains. This is a semi-colon separated list of permissible domains. Note that an empty list means allow all domains. If you have embedded Apps, this is a breaking change. On upgrade to an 8.7.1 or above Transtream instance, all Apps have their Embeddable setting disabled. For your embedded Apps, you must enable it. See Possible Breaking Changes above.
TRANS-952	-	Rating App demonstration. This App is not available through the normal download feed. Contact Product Management, if you have a business case for access to this App.

Salesforce

Description

TRANS-1006

Apps. Improved Anonymous access and revised Page types. Changes have been made to allow direct anonymous (no login required) access to Apps. A Compliance Engine user can also be associated with anonymous access so that access is as that user. To facilitate this, the following changes have been made:

In Composer Designer, the Page object's Type property has been renamed Page Type and now has the settings:
- Start Page. Previously this setting was labelled Default. This is the App's landing page. Allow Anonymous determines whether login is required.
- Page. Previously General. Any other pages in the App.
- Branded Login Page. Previously Login. This is a page designed to provide an alternative to the default login.
- Branded User Management. Previously Forgot Password. This is a page designed to provide an alternative to the default forgotten password capability.
Page Types of Start Page and Page can have Allow Anonymous enabled. The default is disabled.
User Context is a new setting. When Allow Anonymous is enabled, User Context lets you specify a Compliance Engine user. The anonymous session will run as this user. It can be left empty. However, note that if your App makes calls to a Compliance Engine, these require a user. Anonymous access without user context restricts what you can offer.

When a user navigates from an Allow Anonymous page to a page that does not allow anonymity, they are prompted for login credentials. When a logged in user navigates to an anonymous page, any User Context setting is ignored.

TRANS-1007

Apps. Embeddable authorization options.

All Apps have new Product Admin settings to control if and how they can be embedded in other web sites. In Instance Admin, on the Apps tab, each App now has the following settings:

Embeddable. When enabled, the App can be embedded. If not enabled, and the App is identified as embedded, access is denied. By default, Embeddable is disabled.
Only Embeddable. When embedding is allowed, this setting restricts that embedding to iframe only, meaning the embedded App cannot appear as a top level window or tab.
Only Allow These Hosts. When embedding is allowed, use this to restrict that embedding to named domains. This is a semi-colon separated list of permissible domains. Note that an empty list means allow all domains.

If you have embedded Apps, this is a breaking change. On upgrade to an 8.7.1 or above Transtream instance, all Apps have their Embeddable setting disabled. For your embedded Apps, you must enable it. See Possible Breaking Changes above.

TRANS-952

Rating App demonstration. This App is not available through the normal download feed. Contact Product Management, if you have a business case for access to this App.

Headline History lists headline items across releases.

Other Changes

ID	Salesforce	Description
TRANS-736	-	Print request. Resolved issue with PrintLater.
TRANS-746	-	Chrome on iPad. Resolved Address Book sizing issue.
TRANS-756	-	iPad. Ship App. Resolved scrolling issue on changing Address Book type. There is a new version of the Ship App.
TRANS-760	-	FedEx Web Services. Resolved hazardous shipping issue with the Express service. Resolved an issue that could generate an invalid package type error. New carrier component.
TRANS-871	-	Restored legacy Customer charge element handling. In a transaction request, TotalCharge is now returned in the Customer element, and overrides CustomerTotalCharge in the database.
TRANS-881	-	Search Custom Document Viewer by output identifier. You can now search by OutputID, CarrierName and OutputTypeDescription.
TRANS-959	-	Rate Viewer snippet. Resolved issue with midday (12:00 PM) and midnight (12:00 AM) time handling.
TRANS-973	SF16186	UPS API. Resolved issue with Return transaction. New carrier component.
TRANS-1000	-	Freight carriers. Resolved issue with weekend DeliveryDate calculation. Resolved an issue that could result in freight deliveries getting a weekend delivery date. For example, a TnT of 7 days for a Thursday ship date calculated a weekend delivery date. Now, the same calculation returns the Monday. No new carrier components were required for this fix.

App Changes

App changes in this release are listed below. See Upgrade Apps and Snippets for general advice.

Ship App App - Version 1.8 available

ID	Salesforce	Description
TRANS-756	-	iPad scrolling issue. Resolved scrolling issue on changing Address Book type.

Carrier Component Changes

Changes to carrier components in this release are collated here. See Update Carrier Components for updating an existing instance's components, Add Carrier Components to add new components, and Carrier Components for a list of available components.

ID	Salesforce	Version Available
TRANS-760	-	FedEx Web Services 1.4.0.0.
TRANS-973	SF16186	UPS API 1.5.0.0.

Latest Versions lists all installers, Apps and carrier components and gives their release version.

Article last edited 14 February 2017