Plugin Mode

ZIP code → Address

Summary

When you change a field value, save the record, or click a button, automatically enter the address corresponding to a postal code into prefecture and address fields.

Smartphone support

This plugin supports smartphones.

How to use

Choose the postal-code field and the fields that will receive the address. Select whether to retrieve the address when the postal code changes, when the record is saved, or when the button is clicked. For button-based retrieval, click the address conversion button in the postal-code field on a record creation or edit page.

When it runs

Depending on the settings, this customization runs at the following times. Any configured conditions are also evaluated.

  • When you edit and change a target field value
  • Immediately before saving a record
  • When you open a record creation or edit page
  • When you click a button added by this plugin

Click the button added by this customization to run the operation.

The page-display and field-change triggers exclude inline editing from the pencil icon on the list page.

Parameters

Enter or select a value for each setting unless it is marked optional.

Timing of address acquisition

Please select whether to retrieve the address immediately upon entering the ZIP code, upon saving, or when you click the button in the ZIP code field. Please note that when this feature is active, it will overwrite the fields used to enter the address based on the ZIP code (prefecture field, city/town/village field, and address field).

Available options:

  • When Editing
  • When Saving
  • When press the button

Initial value: When Editing

Postal Code Field

Choose the field containing the postal code used to find the address.

The following field types can be selected.

  • Text
  • Drop-down

Prefecture Field

Choose the field for the retrieved prefecture.

The following field types can be selected.

  • Text
  • Text area
  • Rich text
  • Drop-down

Municipal Field

Please select the field for city, ward, town, or village. You can also specify the same field as the prefecture field. In that case, the concatenated value will be set in the specified field.

The following field types can be selected.

  • Text
  • Text area
  • Rich text

Address Field

Please select the field where you want to enter the address starting with the town/city name. You can also specify the same field as the prefecture field or the address field. In that case, the concatenated value will be set in the specified field.

The following field types can be selected.

  • Text
  • Text area
  • Rich text

Restrictions

When this plugin runs, it overwrites the Prefecture, City, and Address fields based on the postal code.

Specify different values for “Postal Code Field” and “Prefecture Field”.

Specify different values for “Postal Code Field” and “Municipal Field”.

Specify different values for “Postal Code Field” and “Address Field”.

Notes

When retrieving on edit, the plugin checks the format of a nonempty postal code. If any address destination already contains a value, it asks for confirmation before overwriting. Button-based retrieval also checks the format but does not ask for overwrite confirmation. These format checks accept seven digits or the format 123-4567.

The following actions and conditions are useful when building similar behavior in customization mode.

Actions

Conditions