Twitter OAuth

The Twitter OAuth field allows a software developer to implment a Sign in with Twitter button. To utilize this field the application developer or their client will need to create a Twitter Application.

This field does not store data it only provides actions that will run when the field processes an OAuth request.

1. Click the to add a field in your form.
2. Choose “New Field”
3. Select the table you wish to add the field to. Most of the time this will be the current table you are on, called the current context.
4. Enter a field name and click “Choose Type”.
5. Choose “OAuth - Twitter” from the list of field types.
6. You will be prompted to provide expressions that will define the critical values required to communicate with Twitter.
7. You can continue adding fields or click the “Select” button to finish adding.

• Field Label
• Field Setting - Display Alternate Label (affects this form only)

• Column Span
• Row Span

• Tooltip
• Descriptive Text
• Display Alternate Descriptive Text (affects this form only)

• Consumer Key
• Consumer Secret

• Signin Appearance

• Temporary Block Association
• Global Block Association

1. Configure the field with a Consumer Key and Consumer Secret
2. Configure the OAuth Successful Actions. If the user is able to login to Twitter and accepts the permissions requested by the application the OAuth Successful Actions will run. Durring the execution of these actions several values are provided by Twitter about the Twitter User. Here the application developer should search the existing users and see if one already has the same Twitter User Id and if they do change to that user and redirect the user to the appropriate next page via an Open Page action. Otherwise a new WorkXpress user should be created and the Twitter data should be stored against that user. Of note it is important when creating a user to generate and save a value into the Username field. Without that field value the change user action will fail.

Notes

• If no Open Page actions are defined for the hook that ran then the User will be redirected back to the page the Twitter OAuth Field originated from.
• When defining an Open Page action as part of the login flow do NOT use the dialog or popup UI treatment.