Skip to main content

HelloID

Map target account fields
  1. For the relevant PowerShell v2 target system, Edit a target system.

  2. Go to the Fields tab.

    2023-11-16_13-14-26.jpg
  3. Choose one:

    1. To remap an existing field:

      1. Click the field's Edit button to open it.

        2023-11-16_13-20-40.jpg
      2. Configure its options:

        Table 1. Individual mappings

        Name

        Description

        Delete

        Delete this mapped field.

        Close

        Stop editing this mapped field and return to the grid. Any changes you made are automatically saved.

        Name

        The name of this mapped field.

        Type

        The type of this mapped field:

        • Text: A string.

        • Array: An array of strings.

        Description

        An optional description of this mapped field, for internal (admin) reference only.

        Add

        Add a new configuration to this mapped field. Configurations let you vary a field's mapping depending on the account lifecycle stage (using the Actions checkboxes).

        Actions

        Specify which account lifecycle stage(s) the current configuration should be active for. Each stage can only be used in a single configuration.

        Delete

        Delete this configuration.

        Use In Notifications

        Make this mapped field available to use as a condition in Notifications (including conditional notifications).

        Store In Account Data

        See Share account fields between target systems. (Replaces ExportData in PowerShell v1.)

        Mapping type

        • None: A target account field that has no mapping, because you plan to set the value in an account script. Sometimes needed in conditional notifications.

        • Fixed: A constant string value (specified by you). All accounts in this target system will receive the same fixed value for this field.

        • Field: A direct mapping of a field from the Person schema, without any further transformations applied.

        • Complex: A string built in JavaScript. See Complex mappings.

        Person field

        The field from the Person schema that will be used as the basis for this mapped field.



    2. To add and map a new field:

      1. Click Add Field.

        2023-11-16_13-53-18.jpg

        A new, unconfigured field is added:

        2023-11-16_13-54-05.jpg
      2. Map the new field using the instructions in step (3a).

        Note

        Custom fields added this way must already be defined and available in the target system's user schema.

  4. To preview mappings, Preview target mappings.

The new mappings will be written to target accounts during the next Enforcement (depending on the configuration details of your Account scripts).