Class SubmitFormAction

PDF action to submit form fields in the current document.

It is an Immutable.Record and thus can be updated using set(key, value), for example: action.set("uri", "www.nutrient.io");.

A SubmitFormAction defines which form fields should be submitted, when clicked on it. The form field names and their values will get submitted to the provided URI defined by the uri field. By default all form fields will be submitted. The includeExclude field defines if the fields specified by fields, which are a NutrientViewer.Immutable.List of form field names, should submit all form fields excluding the defined fields or just the defined fields. When includeExclude is set to true, all form fields except the fields defined in fields will be submitted. If includeExclude is set to false, which is the default value for this field, only the form fields defined in fields will be submitted.

Example

Create a new SubmitFormAction

const action = new NutrientViewer.Actions.SubmitFormAction({
  uri: "www.nutrient.io"
});

Hierarchy

NutrientViewer.Actions.Action
- SubmitFormAction

Constructors

constructor

new SubmitFormAction(
    options?: {
        canonicalFormat?: boolean;
        embedForm?: boolean;
        excludeFKey?: boolean;
        excludeNonUserAnnotations?: boolean;
        exportFormat?: boolean;
        fields?: NutrientViewer.Immutable.List<string>;
        getMethod?: boolean;
        includeAnnotations?: boolean;
        includeAppendSaves?: boolean;
        includeExclude?: boolean;
        includeNoValueFields?: boolean;
        subActions?:
            | null
            | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
        submitCoordinated?: boolean;
        submitPDF?: boolean;
        uri?: string;
        xfdf?: boolean;
    },
): NutrientViewer.Actions.SubmitFormAction
Parameters
- Optionaloptions: {
      canonicalFormat?: boolean;
      embedForm?: boolean;
      excludeFKey?: boolean;
      excludeNonUserAnnotations?: boolean;
      exportFormat?: boolean;
      fields?: NutrientViewer.Immutable.List<string>;
      getMethod?: boolean;
      includeAnnotations?: boolean;
      includeAppendSaves?: boolean;
      includeExclude?: boolean;
      includeNoValueFields?: boolean;
      subActions?:
          | null
          | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
      submitCoordinated?: boolean;
      submitPDF?: boolean;
      uri?: string;
      xfdf?: boolean;
  }
Returns NutrientViewer.Actions.SubmitFormAction
Overrides Action.constructor

Properties

canonicalFormat

canonicalFormat: boolean

This option is not supported yet. If true, any submitted field values representing dates shall be converted to the standard format.

Default

false

embedForm

embedForm: boolean

This option is not supported yet. shall be used only when the form is being submitted in Forms Data Format (that is, when both the XFDF and ExportFormat flags are false). If true, the F entry of the submitted FDF shall be a file specification containing an embedded file stream representing the PDF file from which the FDF is being submitted.

Default

false

excludeFKey

excludeFKey: boolean

Default

false

excludeNonUserAnnotations

excludeNonUserAnnotations: boolean

This option is not supported yet. shall be used only when the form is being submitted in Forms Data Format (that is, when both the XFDF and ExportFormat flags are false) and the IncludeAnnotations flag is true. If true, it shall include only those markup annotations those T entry matches the name of the current user, as determined by the remote server to which the form is being submitted.

Default

false

exportFormat

exportFormat: boolean

Meaningful only if the submitPDF and xfdf flags are false. If set, field names and values shall be submitted in HTML Form format. If false, they shall be submitted in Forms Data Format (FDF)

Default

true

fields

fields: undefined | null | NutrientViewer.Immutable.List<string>

A List identifying which fields to submit or which to exclude from submitting, depending on the setting of the includeExclude flag. Each element of the array shall be a text string representing the fully qualified name of a field. If this entry is omitted, the includeExclude flag shall be ignored; all fields in the document’s interactive form are submitted.

Default

null

getMethod

getMethod: boolean

If true, field names and values shall be submitted using an HTTP GET request. If false, they shall be submitted using a POST request. This flag is meaningful only when the exportFormat flag is set. If exportFormat is false, this flag shall also be false.

Default

false

includeAnnotations

includeAnnotations: boolean

This option is not supported yet. shall be used only when the form is being submitted in Forms Data Format (that is, when both the XFDF and ExportFormat flags are false). If set, the submitted FDF file shall include all markup annotations in the underlying PDF document. If false, markup annotations shall not be included.

Default

false

includeAppendSaves

includeAppendSaves: boolean

This option is not supported yet. Shall be used only when the form is being submitted in Forms Data Format (that is, when both the XFDF and ExportFormat flags are false). If true, the submitted FDF file shall include the contents of all incremental updates to the underlying PDF document, as contained in the Differences entry in the FDF dictionary. If false, the incremental updates shall not be included.

Default

false

includeExclude

includeExclude: boolean

If false, the fields list specifies which fields to submit. If true, the fields list indicates which fields to exclude from submitting. That is, all fields in the document’s interactive form shall be submitted except those listed in the fields list.

Default

false

includeNoValueFields

includeNoValueFields: boolean

This option is not supported yet. If true, all fields designated by the Fields array and the IncludeExclude flag shall be submitted, regardless of whether they have a value. For fields without a value, only the field name shall be transmitted. If false, fields without a value shall not be submitted.

Default

true

`Optional`subActions

subActions?: null | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action> = null

Actions can be chained by adding them to this immutable List.

submitCoordinated

submitCoordinated: boolean

This option is not supported yet. If true, the coordinates of the mouse click that caused the submit-form action shall be transmitted as part of the form data. The coordinate values are relative to the upper-left corner of the field’s widget annotation rectangle. They shall be represented in the data in the format name.x=xval&name.y=yval where name is the field’s name.

Default

false

submitPDF

submitPDF: boolean

If true, the document shall be submitted as PDF, using the MIME content type application/pdf.

Default

false

uri

uri: string

The uniform resource identifier (web link) defining where the form should be submitted to, when this action got triggered.

xfdf

xfdf: boolean

This option is not supported yet. Shall be used only if the SubmitPDF flags are false. If true, field names and values shall be submitted as XFDF.

Default

false

Methods

asImmutable

asImmutable(): this
Returns this
Inherited from Action.asImmutable

asMutable

asMutable(): this
Returns this
Inherited from Action.asMutable

clear

clear(): this
Returns this
Inherited from Action.clear

delete

delete<K extends "subActions">(key: K): this
Type Parameters
- K extends "subActions"
Parameters
- key: K
Returns this
Inherited from Action.delete

deleteIn

deleteIn(keyPath: Iterable<unknown>): this
Parameters
- keyPath: Iterable<unknown>
Returns this
Inherited from Action.deleteIn

equals

equals(other: unknown): boolean
Parameters
- other: unknown
Returns boolean
Inherited from Action.equals

get

get<K extends "subActions">(
    key: K,
): {
    subActions?:
        | null
        | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
}[K]
Type Parameters
- K extends "subActions"
Parameters
- key: K
Returns {
    subActions?:
        | null
        | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
}[K]
Inherited from Action.get

getIn

getIn(keyPath: Iterable<unknown>, notSetValue?: unknown): unknown
Parameters
- keyPath: Iterable<unknown>
- OptionalnotSetValue: unknown
Returns unknown
Inherited from Action.getIn

has

has(key: unknown): boolean
Parameters
- key: unknown
Returns boolean
Inherited from Action.has

merge

merge(
    ...collections: Partial<
        {
            subActions?: | null
            | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
        },
    >[],
): this
Parameters
- ...collections: Partial<
      {
          subActions?: | null
          | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
      },
  >[]
Returns this
Inherited from Action.merge

mergeDeep

mergeDeep(
    ...collections: (
        | Iterable<[string, unknown]>
        | Partial<
            {
                subActions?: | null
                | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
            },
        >
    )[],
): this
Parameters
- ...collections: (
      | Iterable<[string, unknown]>
      | Partial<
          {
              subActions?: | null
              | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
          },
      >
  )[]
Returns this
Inherited from Action.mergeDeep

mergeDeepIn

mergeDeepIn(
    keyPath: Iterable<unknown>,
    ...collections: (
        | Iterable<[string, unknown]>
        | Partial<
            {
                subActions?: | null
                | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
            },
        >
    )[],
): this
Parameters
- keyPath: Iterable<unknown>
- ...collections: (
      | Iterable<[string, unknown]>
      | Partial<
          {
              subActions?: | null
              | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
          },
      >
  )[]
Returns this
Inherited from Action.mergeDeepIn

mergeDeepWith

mergeDeepWith(
    merger: (previous?: unknown, next?: unknown, key?: string) => unknown,
    ...collections: (
        | Iterable<[string, unknown]>
        | Partial<
            {
                subActions?: | null
                | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
            },
        >
    )[],
): this
Parameters
- merger: (previous?: unknown, next?: unknown, key?: string) => unknown
- ...collections: (
      | Iterable<[string, unknown]>
      | Partial<
          {
              subActions?: | null
              | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
          },
      >
  )[]
Returns this
Inherited from Action.mergeDeepWith

mergeIn

mergeIn(
    keyPath: Iterable<unknown>,
    ...collections: (
        | Iterable<[string, unknown]>
        | Partial<
            {
                subActions?: | null
                | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
            },
        >
    )[],
): this
Parameters
- keyPath: Iterable<unknown>
- ...collections: (
      | Iterable<[string, unknown]>
      | Partial<
          {
              subActions?: | null
              | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
          },
      >
  )[]
Returns this
Inherited from Action.mergeIn

mergeWith

mergeWith(
    merger: (previous?: unknown, next?: unknown, key?: string) => unknown,
    ...collections: (
        | Iterable<[string, unknown]>
        | Partial<
            {
                subActions?: | null
                | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
            },
        >
    )[],
): this
Parameters
- merger: (previous?: unknown, next?: unknown, key?: string) => unknown
- ...collections: (
      | Iterable<[string, unknown]>
      | Partial<
          {
              subActions?: | null
              | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
          },
      >
  )[]
Returns this
Inherited from Action.mergeWith

removeIn

removeIn(keyPath: Iterable<unknown>): this
Parameters
- keyPath: Iterable<unknown>
Returns this
Inherited from Action.removeIn

set

set<K extends "subActions">(
    key: K,
    value: {
        subActions?:
            | null
            | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
    }[K],
): this
Type Parameters
- K extends "subActions"
Parameters
- key: K
- value: {
      subActions?:
          | null
          | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
  }[K]
Returns this
Inherited from Action.set

setIn

setIn(keyPath: Iterable<unknown>, value: unknown): this
Parameters
- keyPath: Iterable<unknown>
- value: unknown
Returns this
Inherited from Action.setIn

toJS

toJS(): {
    subActions?: | null
    | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
}
Returns {
    subActions?:
        | null
        | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
}
Inherited from Action.toJS

toJSON

toJSON(): {
    subActions?: | null
    | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
}
Returns {
    subActions?:
        | null
        | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
}
Inherited from Action.toJSON

toSeq

toSeq(): Keyed<string, unknown>
Returns Keyed<string, unknown>
Inherited from Action.toSeq

update

update<K extends "subActions">(
    key: K,
    updater: (
        value: {
            subActions?:
                | null
                | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
        }[K],
    ) => {
        subActions?: | null
        | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
    }[K],
): this
Type Parameters
- K extends "subActions"
Parameters
- key: K
- updater: (
      value: {
          subActions?:
              | null
              | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
      }[K],
  ) => {
      subActions?: | null
      | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
  }[K]
Returns this
Inherited from Action.update

updateIn

updateIn(
    keyPath: Iterable<unknown>,
    notSetValue: unknown,
    updater: (value: unknown) => unknown,
): this
Parameters
- keyPath: Iterable<unknown>
- notSetValue: unknown
- updater: (value: unknown) => unknown
Returns this
Inherited from Action.updateIn
updateIn(keyPath: Iterable<unknown>, updater: (value: unknown) => unknown): this
Parameters
- keyPath: Iterable<unknown>
- updater: (value: unknown) => unknown
Returns this
Inherited from Action.updateIn

withMutations

withMutations(mutator: (mutable: this) => unknown): this
Parameters
- mutator: (mutable: this) => unknown
Returns this
Inherited from Action.withMutations

Class SubmitFormAction

Example

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns NutrientViewer.Actions.SubmitFormAction

Properties

canonicalFormat

Default

embedForm

Default

excludeFKey

Default

excludeNonUserAnnotations

Default

exportFormat

Default

fields

Default

getMethod

Default

includeAnnotations

Default

includeAppendSaves

Default

includeExclude

Default

includeNoValueFields

Default

OptionalsubActions

submitCoordinated

Default

submitPDF

Default

uri

xfdf

Default

Methods

asImmutable

Returns this

asMutable

Returns this

clear

Returns this

delete

Type Parameters

Parameters

Returns this

deleteIn

Parameters

Returns this

equals

Parameters

Returns boolean

get

Type Parameters

Parameters

Returns { subActions?: | null | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;}[K]

getIn

Parameters

Returns unknown

has

Parameters

Returns boolean

merge

Parameters

Returns this

mergeDeep

Parameters

Returns this

mergeDeepIn

Parameters

Returns this

mergeDeepWith

Parameters

`Optional`subActions

Returns {
subActions?:
| null
| NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
}[K]

Returns {
subActions?:
| null
| NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
}

Returns {
subActions?:
| null
| NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>;
}