## Aurigma Image Uploader Flash 7.0.1

# POST Field Reference

- Collapse All Sections
- Language Filter ( all languages )

This topic contains the information about POST fields (both standard and custom) which are sent by Image Uploader Flash. Use it when writing the server-side upload processing code. You should extract them in the same manner as if they were sent through the standard HTML form. See Saving Uploaded Files in ASP.NET and Saving Uploaded Files in PHP topics for more details on how to work with them.

## Standard Fields

Note

If you use Image Uploader Flash ASP.NET or Image Uploader Flash PHP you can refer standard fields via the PostFields constants.

The table below contains a list of POST fields that are generated and uploaded by Image Uploader Flash.

Name | Type | Description
--- | --- | ---
Upload Information
PackageIndex | Integer | Zero-based index of the package inside the current upload session. Using this field you can recognize the order of the uploaded files if they are sent in different packages.
PackageCount | Integer | Total number of packages (i.e. requests) in the current upload session.
PackageGuid | GUID | Unique identifier of the current upload session. When the upload is separated into several packages, all of them will have the same GUID. So you can use it to determine whether files are uploaded in the same session (useful for concurrent uploads from several users).
PackageFileCount | Integer | Number of files uploaded in the current package. Note Image Uploader Flash sends a one file per package. Therefore, this field is always 1.
RequestComplete | Integer | End of request marker. This field is always 1.
PackageComplete | Integer | End of package marker. This field is always 1 and is represented only in the last request of a package.
Name | Type | Description
Original File Information
SourceName_N * | String | Name of the original Nth file. It is useful to employ this field to get name of the original file when only resized copy of an image is uploaded.
SourceSize_N * | Integer | Size of the original Nth file in bytes.
SourceCreatedDateTime_N * | Time | Creation date of the original Nth file in EXIF-style format: YYYY:MM:DD hh:mm:ss For example, 28th of March, 2:40PM would be looking in the following way: 2005:03:28 14:40:00
SourceLastModifiedDateTime_N * | Time | The last modification date of the original Nth file in EXIF-style format: YYYY:MM:DD hh:mm:ss For example, 28th of March, 2:40PM would be looking in the following way: 2005:03:28 14:40:00
SourceCreatedDateTimeLocal_N * | Time | The local creation date of the original Nth file in EXIF-style format: YYYY:MM:DD hh:mm:ss For example, 28th of March, 2:40PM would be looking in the following way: 2005:03:28 14:40:00
SourceLastModifiedDateTimeLocal_N * | Time | The local last modification date of the original Nth file in EXIF-style format: YYYY:MM:DD hh:mm:ss For example, 28th of March, 2:40PM would be looking in the following way: 2005:03:28 14:40:00
SourceWidth_N * | Integer | Width of the original Nth file in pixels if it is an image. Otherwise, this field contains 0.
SourceHeight_N * | Integer | Height of the original Nth file in pixels if it is an image. Otherwise, this field contains 0.
HorizontalResolution_N * | Integer | Horizontal resolution of the original Nth file if it is an image (measured in DPI - dots per inches). Otherwise, this field contains 0.
VerticalResolution_N * | Integer | Vertical resolution of the original Nth file if it is an image (measured in DPI - dots per inches). Otherwise, this field contains 0.
Name | Type | Description
Converted File Information
FileX_N ** | File | The Xth converted file for the Nth user-selected file.
FileXMode_N ** | String | The mode of the Xth converted file created for the Nth user-selected file. Possible values are: sourceFile - the Xth converted file is a copy of the original file. thumbnail - the Xth converted file is a resized copy of the original file if it is an image. icon - the Xth converted file is a system icon associated with the original file type. zip - the Xth converted file is a ZIP archive of the original file. none - the Xth converted file was not created.
FileXName_N ** | String | The name of the Xth converted file created for the Nth user-selected file. Depending on the FileXMode_N field value this field contains one of the following names: name.ext for sourceFile mode. name.ext_ThumbnailX.jpg for thumbnail mode. name.ext_IconX.jpg for icon mode. name.ext_CompressedX.zip for zip mode.
FileXSize_N ** | Integer | Size of the Xth converted file created for the Nth user-selected file (in bytes).
FileXWidth_N ** | Integer | Actual width of the Xth converted file created for the Nth uploaded file if it is an image (in pixels). Otherwise, this field contains -1. Depending on the converter.thumbnailFitMode, this value may differ from the value specified through the converter.thumbnailWidth property. This happens because Image Uploader Flash preserves the aspect ratio of the image and not always can use the same dimensions as specified in the thumbnail parameters.
FileXHeight_N ** | Integer | Actual height of the Xth converted file created for the Nth uploaded file if it is an image (in pixels). Otherwise, this field contains -1. Depending on the converter.thumbnailFitMode, this value may differ from the value specified through the converter.thumbnailHeight property. This happens because Image Uploader Flash preserves the aspect ratio of the image and not always can use the same dimensions as specified in the thumbnail parameters.
Name | Type | Description
User Input
Angle_N * | Integer | Rotation angle of Nth user-specified file (measured in degrees clockwise). This field is changed if the user clicks an arrow icon to rotate an image. You can use it if you want to rotate images on the server side (e.g. if you upload only source file). Possible values are: 0; 90; 180; 270.
Description_N * | String | User-provided description of the Nth user-selected file.
Tag_N * | String | Tag attached to the Nth user-selected file.
* The N character appended to the field name is a placeholder for an index of this file in the uploaded package. This index is zero-based. For example, Image Uploader Flash sends one file per package, so to retrieve a name of this file use the SourceName_0 field (the same is true for others XXX_N fields). ** Image Uploader Flash can generate up to three converted files per each user-selected file and send them to the server. The X character is a placeholder for an index of the converted file created for the Nth user-selected file. Maximum X value is not bigger than the number of converter instances added to the converters array. For example, if you set two converters, the following fields will be available on the server: File0_0 and File1_0.

## Custom Fields

Image Uploader Flash is able to send not only fields described in the table above, but also custom fields. It can be done in two ways:

- Using the Metadata.AdditionalFormName property. You just add the <form> element somewhere to your code, add elements to it (<input>, <select>, <textarea> elements are supported), and set its name as a value of this property. Then Image Uploader Flash automatically appends data from this <form> to the request that is sent to the server.
- Using the metadata.addCustomField(String, String, Boolean) method. It takes the name of a field you want to receive on the server and its value. The most convenient place to use this method is the BeforeUpload event. Any custom fields added via this method can be removed by calling the metadata.removeCustomField(String) method.

- PostFields (ASP.NET)
- PostFields (PHP)

- ThumbnailFitMode (ASP.NET)
- ThumbnailFitMode (PHP)
- thumbnailFitMode (JavaScript)

- ThumbnailWidth (ASP.NET)
- ThumbnailWidth (PHP)
- thumbnailWidth (JavaScript)

- ThumbnailFitMode (ASP.NET)
- ThumbnailFitMode (PHP)
- thumbnailFitMode (JavaScript)

- ThumbnailHeight (ASP.NET)
- ThumbnailHeight (PHP)
- thumbnailHeight (JavaScript)

- Converter (ASP.NET)
- Converter (PHP)
- converter (JavaScript)

- Converters (ASP.NET)
- Converters (PHP)
- converters (JavaScript)

- AdditionalFormName (ASP.NET)
- AdditionalFormName (PHP)
- additionalFormName (JavaScript)