---
sourceDocument: Yokohama Finance and Supply Chain
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/source-to-pay-operations

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Finance and Supply Chain

ft:clusterId :

    - stpop

bundleId :

    - stpop

workflow :

    - Employee


---

# Configure self-registration for external users

# Configure self-registration for external users {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read

Configure self-registration for external users.

## Before you begin

Note:  
You must do this task after installing the Supplier Collaboration Portal.

Role required: admin

## About this task

Ensure that you have activated the com.snc.external_user_self_registration plugin. For more information, see [Activate External User Self-Registration](https://www.servicenow.com/docs/access?context=external-user-registration-plugin&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US).

## Procedure

1. Navigate to External User Self-RegistrationUser Registration Configurations and select New.
2. On the User Registration Configuration form, fill in the fields.  
   For more information about the form fields and descriptions, see [Create a user registration configuration for external users](https://www.servicenow.com/docs/access?context=external-user-configuration&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US).
3. From the form context menu, select Save.
4. Select the Registration tab, and do the following:  
   1. In the Mandatory column for the First name and Last name fields, double-click and select true to make these fields mandatory.
   2. Select the green check mark icon (![Green check mark icon.]()) to save your changes.
   {#config-reg-for-external-users-slm__ol_gx3_pxq_bvb}
5. Configure the Verification tab to verify the identity of the registered users.  
   When the user verification flow triggers, an activation link is sent to the user's registered email address.
6. Select the Transformation tab, select and open the u_reg_xmap_\[number\] transformation map that maps the registered users from the User Acti Req \[number\] source table to the User \[sys_user\] target table.
7. In the Target table field, search and select Vendor Contact \[vm_vdr_contact\].
8. From the form header, right-click the header bar and select Save.
9. Scroll down and select the Field Maps tab, and then select New.
10. Select the Use source script check box.  
    The Source script box is displayed.
11. In the return string, enter supplier_registration in lowercase letters exactly as shown.  

        answer = (function transformEntry(source) {

        	// Add your code here
        	return "supplier_registration"; // return the value to be put into the target field

        })(source);

12. From the Target field list, select Source.
13. Select Submit.
14. Select the Onboarding tab and in the User onboarding flow field, search for and select Supplier Contact Onboarding.
15. Select the Advanced tab.
16. In Registration form field configuration section, in the Account signup form, add the form fields Supplier name (u_supplier_name) and Relationship contact email (u_relationship_contact_email).  
    Then select the preview this record icon to open the record.  
    Note:  
    * The Supplier name field has been added in the Xanadu December 2024 upgrade. To enable and register this field, customize the registration form by adding the new supplier field with field label: Supplier name and column name: u_supplier_name. For more information, see [Configuring a user registration configuration for external users](https://www.servicenow.com/docs/access?context=external-user-configuration&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US).
    * If you need to add a supplier contact whose email domain differs from the supplier's domain, you must also [Enable M2M mapping between supplier contact and suppliers](https://servicenow-prod.fluidtopics.net/VHOg_FRSNSwLRZ_HnDBcCg "Many-to-many (M2M) mapping between supplier contact and suppliers enables one supplier contact to be the contact for multiple suppliers, provided the suppliers share a parent-subsidiary relationship.").
    {#config-reg-for-external-users-slm__ul_fnc_sxc_mfc}
17. In the Variables related list, select and open the First name, Last name, Email, and Supplier name (if configured in the previous step) records individually.
18. In the First name variable record, select the Mandatory check box and select Save.  
    Repeat this step for the Last name, Email, and Supplier name variable records.  
    Note:  
    The Supplier name field has been added in the Xanadu December 2024 upgrade. This field is available only after M2M mapping between supplier contact and suppliers is enabled.
19. Select Save.
20. For sending personalized emails to contacts who want to self-register, select the Catalog Client Scripts tab.
21. Select New.
22. In the Name field, enter a name.
23. From the Type list, select onLoad.
24. In the Script box, copy and paste the code.  

        function onLoad() {
            function getParameterValue(name) {
                var url = top.location.href;
                var value = new URLSearchParams(url).get(name);
                if (value) {
                    return value;
                }
                return false;
            }

            if (this && this.location && this.location.pathname) {
                if (getParameterValue("email")) {
                    g_form.setValue("email", getParameterValue("email"));
                    g_form.setReadOnly("email", true);
                }
                if (getParameterValue("supplier_name") && (getParameterValue("supplier_name") != "null")) {
                    g_form.setValue("u_supplier_name", getParameterValue("supplier_name"));
                    g_form.setReadOnly("u_supplier_name", true);
                    g_form.setValue("supplier_name", getParameterValue("supplier_name"));
                    g_form.setReadOnly("supplier_name", true);

                }
                if (getParameterValue("relationship_contact_email") && (getParameterValue("relationship_contact_email") != "null")) {
                    g_form.setValue("u_relationship_contact_email", getParameterValue("relationship_contact_email"));
                    g_form.setReadOnly("u_relationship_contact_email", true);
                    g_form.setValue("relationship_contact_email", getParameterValue("relationship_contact_email"));
                    g_form.setReadOnly("relationship_contact_email", true);

                }
            }


        }

25. Select Save.

## What to do next

Do the following:

* Configure the sn_supplier.external_registration_profile_id system property to ensure that registration emails are sent to external users. For more information, see [Configure system property to send registration emails to external users](https://servicenow-prod.fluidtopics.net/K4X8Jmrxd~vaqy2V3gYAHA "Configure the sn_supplier.external_registration_profile_id system property to ensure that registration emails are sent to external users for accessing the Supplier Collaboration Portal.").
* Configure the Vendor Contact table to send emails to contacts during self-registration. For more information, see [Configure the Vendor Contact table to send invitation emails during self-registration](https://servicenow-prod.fluidtopics.net/PgB~ttLDctEWMZT7WQNj_Q "Configure the Vendor Contact [vm_vdr_contact] table to send invitation emails to supplier contacts during the self-registration process.").
* If you do this task after installing the Supplier Collaboration Portal, map the external user registration configuration that you just created to the Supplier Collaboration Portal. For more information, see [Map the self-registration configuration to Supplier Collaboration Portal](https://servicenow-prod.fluidtopics.net/isV8sUxmU1F3DFj_kPjqVQ "Map the external user self-registration configuration to the Supplier Collaboration Portal.").
{#config-reg-for-external-users-slm__ul_frk_z34_ytb}
* **[Configure the flow to create approval records for all supplier contact invite requests](https://servicenow-prod.fluidtopics.net/nu_PdYSo1dYNBTIHLFR_HA)**   
  Typically, an approval record is created only when a supplier contact self-registers to get access to the Supplier Collaboration Portal. However, a supplier admin can configure the Supplier Contact Onboarding flow to create approval records even when a supplier manager adds or invites a new supplier contact.
* **[Map the self-registration configuration to Supplier Collaboration Portal](https://servicenow-prod.fluidtopics.net/isV8sUxmU1F3DFj_kPjqVQ)**   
  Map the external user self-registration configuration to the Supplier Collaboration Portal.
* **[Configure system property to send registration emails to external users](https://servicenow-prod.fluidtopics.net/K4X8Jmrxd~vaqy2V3gYAHA)**   
  Configure the sn_supplier.external_registration_profile_id system property to ensure that registration emails are sent to external users for accessing the Supplier Collaboration Portal.
* **[Configure the Vendor Contact table to send invitation emails during self-registration](https://servicenow-prod.fluidtopics.net/PgB~ttLDctEWMZT7WQNj_Q)**   
  Configure the Vendor Contact \[vm_vdr_contact\] table to send invitation emails to supplier contacts during the self-registration process.
* **[Enable notifications about self-registration errors](https://servicenow-prod.fluidtopics.net/hBWrOSOFgoKocDERfogjnw)**   
  Add the sn_slm.admin role to the groups to enable supplier admins to receive an email if a supplier contact encounters an error during self-registration.

*[\>]: and then