Поделиться через

App Power Forms

  • Reference

Use this connector from App Power to easily include external stakeholders in your business processes. The connector makes it very easy to create a form within the designer. You can start with a free trial license and acquire a production license at https://apppower.net.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name App Power
URL https://apppower.net
Email [email protected]
Connector Metadata
Publisher App Power Solutions LLC
Website https://apppower.net
Privacy policy https://apppower.net/privacy
Categories Business Management;Productivity

Forms Connector from App Power Solutions LLC provides a suite of actions and triggers to easily include external stakeholders in your business processes. The connector makes it very easy and straight forward to create a form within the designer resulting in a URL that you can send to the external party. With App Power Easy Forms you can build your forms right within Power Automate cloud flow or Azure Logic Apps designer without need to use any external third-party form editor. The process is simple: 1) add an action to create a new form, 2) add fields to the form and 3) wait for form reseponse. You can also use Adaptive Cards JSON to create the forms.

Prerequisites

You need either a trial API key or a purchased production API key to use the connector.

The connector is intended for Power Automate and Logic Apps only and it will not work directly with Power Apps.

How to get credentials

If you want to start with a free trial license, you can go ahead and create a new App Power Forms connection by following the below steps. The trial key will be sent to your inbox during the process. You can also acquire a trial or paid license from App Power website.

  1. Browse to Connections section under Power Apps or Power Automate site (e.g. https://us.flow.microsoft.com/ or https://make.powerapps.com/)
  2. Click + New connection
  3. Search for App Power Forms connector an click on the plus icon next to it
  4. You are now presented with a dialog allowing you to enter an API key. However, you can also type in your e-mail address to have a trial key delivered right into you inbox
  5. Once you've typed in you e-mail address, go ahead and click Create
  6. You will now receive a notification Check your inbox for new trial key!
  7. Go ahead and check your inbox. You should have received an e-mail with a subject Your trial key for App Power Forms
  8. Copy the trial key in the e-mail and paste it in the new connection dialog (where you just typed in your e-mail address)
  9. Click Create and a new connection is successfully created!

The trial license is intended for testing only and can't be used in production. You can purchase a production license at https://apppower.net/pricing.

Get started with the connector

To get started with the connector and to create a new form the URL which you can send to the recipient, follow these steps:

  1. Create a new App Power Forms connection if not yet created
  2. Add Create new App Power Easy form action to create a new form (As a response to this action you get a URL you can send to the person you want to fill in the form.) Choose Create new App Power Easy form
  3. Add multiple Add new field to App Power Easy form actions to add fields to your form Add fields to the form
  4. Send the form URL to the recipient you want to fill the form
  5. Add Wait for form response action to wait for form response (TIP: Alternatively you can create another flow and use When form is submitted trigger to react to the form submission.) The form being filled by the recipient
  6. Once the form is submitted, you can process the field values and save them to you ERP system, for example Submitted form values utilized later in the flow

(Once your flow fetches submitted data from App Power service the data is removed from the database, the data entered on the forms is persisted in App Power database only as long as it is absolutely necessary.)

Known issues and limitations

  • If you add a field to a form and then remove it in the designer, the field is still visible in the dynamic content picker. However when the flow is run the value will always be empty.
  • Currently there is no way to remove forms that have been added during flow design.
  • If, during the same authoring session, you add Wait for form response action and after that you go back and add new fields to the form, the new fields are not visible in the dynamics content picker as outputs of the Wait for form response action. Workarounds:
    • Save the flow
    • Make a change to Wait for form response action (e.g. choose a different form and then change back to the original one)

Creating a connection

The connector supports the following authentication types:
Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Key (use e-mail to receive a trial key) securestring The API Key for this api. You can use your e-mail address to receive a trial key. True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Add new field to App Power Easy form

Use this action to add a new field to the form created in an earlier step. The fields will be visible on the form in the order they are added.
Create new App Power Easy form

Create a new App Power Easy form. After this action you can add any number of fields to the form by adding field specific actions.
Create new form from Adaptive Card

Use this action to create a form based on Adaptive Card JSON.
Get form as Adaptive Card JSON

Get Easy Form as Adaptive Card JSON. You can use the JSON to post the card in Teams as an Adaptive Card, for example.
Wait for form response

Use this action to wait until a specific form is submitted. You can use this action for both Easy Forms and forms based on Adaptive Card JSON.

Add new field to App Power Easy form

Operation ID:
AddFormField

Use this action to add a new field to the form created in an earlier step. The fields will be visible on the form in the order they are added.

Parameters

Name Key Required Type Description
body
 body True dynamic

Returns

The outputs of this operation are dynamic.

Create new App Power Easy form

Operation ID:
AddForm

Create a new App Power Easy form. After this action you can add any number of fields to the form by adding field specific actions.

Parameters

Name Key Required Type Description
Form name
 formTitle True string

Give unique form name. This is not visible to the end user.
Form description
 welcomeText string

Give form description. This text is displayed at the beginning of the form.
Thank you text
 thankYouText string

Give text displayed to the user after submission.

Returns

The outputs of this operation are dynamic.

Create new form from Adaptive Card

Operation ID:
AddAdaptiveCard

Use this action to create a form based on Adaptive Card JSON.

Parameters

Name Key Required Type Description
Card name
 name True string
Adaptive Card JSON
 card True string
Card displayed after submit
 cardAfterSubmit string

Returns

The outputs of this operation are dynamic.

Get form as Adaptive Card JSON

Operation ID:
GetFormAdaptiveCardJson

Get Easy Form as Adaptive Card JSON. You can use the JSON to post the card in Teams as an Adaptive Card, for example.

Parameters

Name Key Required Type Description
Card Id of the form
 instanceId True string

Give the Card Id of the form definition to get the JSON from.

Returns

JSON string
string

Wait for form response

Operation ID:
GetCardResponse

Use this action to wait until a specific form is submitted. You can use this action for both Easy Forms and forms based on Adaptive Card JSON.

Parameters

Name Key Required Type Description
Card ID
 instanceId True string

ID of the card to wait for
Card name
 name True string

Name of the card providing the schema.

Returns

The outputs of this operation are dynamic.

Triggers

When form is submitted

This trigger is fired whenever there are new submissions for the specified form.

When form is submitted

Operation ID:
TriggerGetCardResponse

This trigger is fired whenever there are new submissions for the specified form.

Parameters

Name Key Required Type Description
Form name
 name True string

Choose the form to get submissions from.

Returns

The outputs of this operation are dynamic.

Definitions

string

This is the basic data type 'string'.