Repository Extra Fields
Extra fields attached to a |repo| allow you to configure additional actions for |RCX|. To install and read more about |RCX|, see the :ref:`install-rcx` section.
Enabling Extra Fields
To enable extra fields on |repos|, use the following steps:
- Go to the :menuselection:`Admin --> Settings --> Visual` page.
- Check the :guilabel:`Use repository extra fields` box.
- Save your changes.
Configuring Extra Fields
To configure extra fields per repository, use the following steps:
- Go to :menuselection:`Admin --> Repositories` and select :guilabel:`Edit` beside the |repo| to which you wish to add extra fields.
- On the |repo| settings page, select the :guilabel:`Extra fields` tab.
![../images/extra-repo-fields.png](/u/ewong/rhodecode-enterprise-ce-fork/raw/06061388b9ecdbd0b6629d4f929c7c71a2495fa4/docs/images/extra-repo-fields.png)
Example Usage
To use the extra fields in an extension, see the example below. For more information and examples, see the :ref:`extensions-hooks-ref` section.
call = load_extension('http_notify.py') if call: url = 'http://default.url' # <url for post data> # possibly extract the URL from extra fields call = load_extension('extra_fields.py') if call: repo_extra_fields = call(**kwargs) # now update if we have extra fields, they have precedence # this way users can store any configuration inside the database per # repo for key, data in repo_extra_fields.items(): kwargs[key] = data['field_value'] # an endpoint url data will be sent to, fetched from extra fields # if exists, or fallback to default kwargs['URL'] = kwargs.pop('webhook_url', None) or url # fetch pushed commits, from commit_ids list call = load_extension('extract_commits.py') extracted_commits = {} if call: extracted_commits = call(**kwargs) # store the commits for the next call chain kwargs['COMMITS'] = extracted_commits # set additional keys and values to be sent via POST to given URL kwargs['caller_type'] = 'rhodecode' kwargs['date'] = time.time() # import time before call(**kwargs)