Move, rename and remove fields

This is the official documentation of the forestadmin-agent-django and forestadmin-agent-flask Python agents.

When building your admin panel, you will probably want to hide as much complexity from your users as you can.

This includes:

  • Hiding technical and confidential fields

  • Using naming conventions that the final user understands.

Moving fields

You can import fields from single record relationships into your collections.

The imported fields will behave as if they were on that collection.

# Assuming the following structure:
# User    { id, firstName, lastName, addressId }
# Address { id, streetName, streetNumber, city, countryId }
# Country { id, name }
agent.customize_collection("User").import_field(
    "city", {"path": "address:city", "readonly": True}
).import_field("country", {"path": "address:country:name", "readonly": True})

Note that when using readonly: false, the referenced record fields can be edited.

Renaming and removing fields and relations

Renaming and removing fields or relations can be done simply by calling the rename_field and remove_field methods.

# Assuming the following structure:
# User    { id, firstName, lastName, addressId }
# Address { id, streetName, streetNumber, city, countryId }
# Country { id, name }
user_collection.rename_field('account_v3_uuid_new', 'account').remove_field(
    'password'
)

Renamed and removed fields are renamed and removed ONLY in the admin panel.

In your code:

  • Removed fields are still accessible (for instance, as dependencies to compute new fields)

  • Renamed fields must still be referred to by using their original name.

Last updated