/
Active Forms > Listing

Active Forms > Listing

Platform URL

https://[enterprise].cvtr.io/v2/forms

API Endpoints

Retrieves the collection of Active Forms:

GET https://{enterprise}.cvtr.io/api/v4/forms&enabled=true

Retrieving a Form:

GET https://{enterprise}.cvtr.io/api/v4/form/{id}

Replaces/Creates a Form:

PUT/POST https://{enterprise}.cvtr.io/api/v4/forms

Creates a Form preview:

Removes the campaign from the Form:

Epic

https://convertr.atlassian.net/browse/GFR-50

Document status

REVIEWED

Document owner

@Danny Hannah @Adam Carter

Technical writers

@Arunima Kurup Prasad

Related Content

Forms Add and Edit Form Archived Forms > Listing

Feature Overview

With the Global Forms section, instead of creating individual forms for each campaign, users can create master templates and associate them to multiple campaigns. Users can view and manage forms across all campaigns using the Global Forms sections available on the left menu.

Active Forms

All active forms created on the platform are listed under the Active Forms tab in Global Forms page. The Active Forms listing page is as shown below.

The table shows:

  • ID: unique ID of the form. Users can search for forms using the ID.

  • Form: name of the form. Users can search for forms using the name.

  • Type: identifies if the form is a ‘Master’ form or ‘Translated’ form

  • Associated campaigns: provides a link to all campaigns using the form. Any changes made in a form will be reflected on all associated campaigns.

  • Actions column shows the various actions possible on forms.

  • Checkbox: A checkbox column is provided for selecting the forms that need to be archived.

  • The forms listing page provides pagination option so users can select how many forms they want to view on a page.

Apart from these, the following options are also available on the Active Forms listing page:

  • ‘Add’ button to add new forms

  • ‘Add via CSV’ to add import forms via CSV file

  • ‘Archive’ button to archive forms

  • ‘Edit’ form

  • ‘Preview’ form

  • ‘Save As New’ form

These are described in the page: 'Add and Edit Form‘, available in 'Related Content’ section.

Associated Campaigns

  • Clicking on the hyperlink opens the below modal showing all associated campaigns and option to associate new campaigns with the form.

Users can search by campaign name or campaign ID in the ‘Campaigns’ search box to select and add a campaign to associate to the form using the ‘Add’ button. User is not permitted to associate a campaign that is already associated with the same form.

A blue banner displays the number of campaigns associated with the form but users will only be able to see the campaigns that they have permission to access.

Clicking on the ‘Campaign Name’ hyperlink takes the user to the campaign overview page.

Clicking on the ‘Advertiser Name’ hyperlink takes the user to the advertiser’s campaign listing page.

Once campaigns are added for association, clicking on ‘Save’ will associate the form with the selected campaigns. If the form has any translations, they will also be automatically associated with the campaign.

Removing Associations

A campaign association can be removed using the ‘Remove’ button if the form does not have any associations to:

  • Landing pages

  • Email assets

  • ConnectedApps

If the form is associated with any the above, the following error message will be shown which displays the ID of the landing page/email asset/connected app association.

Below image shows the landing page associations the above form has.

Once the changes to form associations are made in the modal, the changes can be persisted by clicking on the Save button.

Summary

Summarise the functionalities in a table

Functionality

User Story

Functionality

User Story

1

Add form

Allows the user to add forms via the interface

2

Add via CSV

Allows the user to add forms via CSV file

3

Archive (see Related Content section - ‘Archived Forms > Listing’ for details)

Allows the user to archive multiple forms

4

Active forms listing

Lists all active forms, their type and associations

5

Associated campaigns

Allows user to view all campaign association, add and remove campaign associations

6

Edit Forms (see Related Content section - ‘Add and Edit Form’ for details)

Allows the user to edit forms

7

Preview (see Related Content section - ‘Add and Edit Form’ for details)

Allows the user to preview form fields page and thanks page

8

Save As New (see Related Content section - ‘Add and Edit Form’ for details)

Allows the user to save a form as new form

9

Table Filtering

Allows the user to filer the table values Form Id and Form Name

 User Permissions

Admin, agency users and creative managers have access to global forms.

Agency users can perform edit actions only if access is enabled at enterprise level.

https://docs.google.com/spreadsheets/d/1i4qTTKkC3rF3EyEOh2585ktDDGge0L0IMVDNCwriFR0/edit#gid=687611748

 

Related content

Archived Forms > Listing
Archived Forms > Listing
More like this
Thanks Page
Thanks Page
Read with this
Add and Edit Form
Add and Edit Form
More like this
Associate Form and 'Save As New'
Associate Form and 'Save As New'
More like this
Forms
More like this
Campaign Listing
Campaign Listing
More like this