Skip to main content

IP Address Capture

The IP Address component is designed to automatically collect the client's publicly exposed IP address during form submission. This component operates invisibly to users and captures their IP address for tracking, security, or analytical purposes. From the author's perspective, this functions as a standard form field that can be configured to submit to the form endpoint and/or include in form submissions.

  • No user interaction or input is required for the component to function
  • The captured IP address is treated as standard form field data in all submission processes

Placement

The IP Address component can be placed anywhere within the form structure:

  • In the root panel of the form
  • Within any child panel
  • At any position within the form hierarchy

The component is invisible to end users, so placement does not affect the visual layout of your form.

Configuration

Select the component and click the wrench icon, on the component toolbar, to configure the properties for IP Address. Only two or three properties should be changed in the configuration, as all others are already set correctly by default.

Basic Properties

  • Name: By default an auto-generated unique identifier is set(e.g., ipCapture_354641354963). This can be changed as needed to match endpoint for submission
  • Title: Can be edited to any title author prefers as component is invisible to end-users
  • Bind Reference: Used when form will be submited using a data source or PDF file
  • Hide Component: This should remain checked as the component operates invisibly

Once properties are set, click the checkmark in the upper right-hand corner of the configuration pane to save the changes. 

Advanced Configuration

To ensure the IP Address Capture component functions properly, you must contact DoIT.WebServices@illinois.gov to obtain the required script that needs to be added to the component's rules.

Once you receive the script from DoIT Web Services:

  1. Select the IP Address Capture component
  2. Click the rules editor icon (gavel) in the component toolbar
  3. Click create in to top bar to make a rule for the component
  4. Switch from visual editor to code editor
  5. Click Edit Code in top left corner of window
  6. Click Edit in the pop-up window
  7. In top left corner change from Value Commit to Initialize
  8. Replace the existing script with the provided script in the edit window
  9. Click Done in top right corner of screen
  10. Click Close in top right corner of screen to exit the rule editor and get back to main form edit interface

Troubleshooting

  • Verify that the required script has been properly added to the component rules
  • Ensure the component's configuration properties are set correctly
  • Check that your form's submission configuration is properly set up
  • Contact DoIT.WebServices@illinois.gov for technical support