Skip to main content

Override Microsoft 365 user interface labels

You can override the Microsoft 365™ user interface labels based on the type of user checking out the document to Microsoft 365™. To support the overrides, a Connected App Plugin assigns a userType to a user, and the CA_IOffice365CheckoutUserOverrides interface provides overrides for each userType.

Considerations

Keep these considerations in mind when implementing user overrides:

  • As Salesforce users can change user types while logged in to Microsoft 365, Microsoft 365 user data may be stale. To prevent this, revoke users' Microsoft 365 Connected App session. This forces users to log in to Microsoft 365, which refreshes the data.

  • All URLs are displayed in anchor tags. Application engineers should follow best practices to ensure GETs are safe.

Implement overrides

To override the Microsoft 365™ user interface labels:

  1. Create a ConnectedAppPlugin class that adds mvn__userType to the user's attributes. This ensures that the Salesforce identity provider (IDP) passes the mvn__CA_O365_UserType in the user's custom_attributes.

    Example 13. userType is set to the user's profile's name
    public with sharing class Office365ConnectedAppPlugin extends Auth.ConnectedAppPlugin {
    public override Map<String, String> customAttributes(
        Id userId,
        Id connectedAppId,
        Map<String, String> formulaDefinedAttributes,
        Auth.InvocationContext context
    ) {
        User user = [SELECT Profile.Name FROM User WHERE Id = :userId];

        formulaDefinedAttributes.put('mvn__CA_O365_UserType', user.Profile.Name);

        return formulaDefinedAttributes;
    }
}


  2. Implement CA_IOffice365CheckoutUserOverrides.

    MIC_O365Overrides.png
    Example 14. Implement interface
    global with sharing class CM_Office365CheckoutUserOverrides implements CA_IOffice365CheckoutUserOverrides {
    global Map<String, Map<String, String>> getOverridesByUserType(Id documentVersionId) {
        return new Map<String, Map<String, String>>{
            'System Administrator' => new Map<string, String>{
                'breadcrumbBrandName' => 'Admin action url',
                'breadcrumbBrandUrl' => 'Admin action name',
                'breadcrumbFolderName' => 'Admin return url',
                'breadcrumbFolderUrl' => 'Admin return name',
                'closeUrl' => 'Admin close url'
            }
        };
    }
}


  3. Add the user override Apex class name and namespace to the Microsoft 365 Setting (CA_Office_365_Setting__mdt) custom metadata.

    1. In the Quick Find box in Setup, search for and select Custom Metadata Types.

    2. Click Manage Records in the Microsoft 365 Setting row, and then click Default.

    3. Click Edit, and enter values for these fields:

      • User Overrides Apex Class Name - the name of the Apex class that implements the CA_IOffice365CheckoutUserOverrides interface.

      • User Overrides Apex Class Namespace - namespace of the Apex class defined in the User Overrides Apex Class Name field.

    4. Click Save.

  4. Add the Auth.ConnectedAppPlugin class to the Microsoft 365 connected app as a plugin.

    1. In the Quick Find box in Setup, search for and select Manage Connected Apps.

    2. Click MCM Office 365 or MCM Office 365 - Test.

    3. Click Edit Policies.

    4. Enter Auth.ConnectedAppPlugin in the Apex Plugin Class field. This field is located in the Custom Connected App Handler section.

    5. Click Save.