Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
133 changes: 133 additions & 0 deletions programming/android/api-reference/parsed-result-item-v2.4.2000.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,133 @@
---
layout: default-layout
title: ParsedResultItem Class - Dynamsoft Code Parser SDK Android Edition API Reference
description: This page shows ParsedResultItem Class of Dynamsoft Code Parser SDK Android Edition.
keywords: ParsedResultItem, api reference, Android
needAutoGenerateSidebar: true
---

# ParsedResultItem Class

`ParsedResultItem` is the basic unit of a parsed result. It stores the field name, value and additional information.

## Definition

*Namespace:* com.dynamsoft.dcp

*Assembly:* DynamsoftCodeParser.aar

```java
class ParsedResultItem extends CapturedResultItem
```

| Method | Description |
|----------------------|-------------|
| [`getCodeType`](#getcodetype) | Gets the code type of the parsed result. |
| [`getFieldMappingStatus`](#getfieldmappingstatus) | Gets the mapping status of a specified field from the parsed result. |
| [`getFieldValidationStatus`](#getfieldvalidationstatus) | Gets the validation status of a specified field from the parsed result. |
| [`getFieldValue`](#getfieldvalue) | Gets the value of a specified field from the parsed result. |
| [`getJsonString`](#getjsonstring) | Gets the parsed result as a JSON formatted string. |

## getCodeType

Gets the code type of the parsed result.

```java
String getCodeType();
```

**Return Value**

Returns a string value representing the code type. It can be one of the following:

- "AADHAAR"
- "AAMVA_DL_ID"
- "AAMVA_DL_ID_WITH_MAG_STRIPE"
- "MRTD_TD1_ID"
- "MRTD_TD2_ID"
- "MRTD_TD2_VISA"
- "MRTD_TD3_PASSPORT"
- "MRTD_TD3_VISA"
- "MRTD_TD2_FRENCH_ID"
- "SOUTH_AFRICA_DL"
- "VIN"

## getJsonString

Gets the parsed result as a JSON formatted string.

```java
String getJsonString();
```

**Return Value**

Returns a JSON formatted string representing the parsed result.

## getFieldValue

Gets the value of a specified field from the parsed result.

```java
String getFieldValue(String fieldName);
```

**Parameters**

`[in] fieldName`: The name of the field.

**Return Value**

Returns a string representing the specified field value.

## getFieldMappingStatus

Gets the mapping status of a specified field from the parsed result. Certain fields in the parsed result, such as the residing province or state, are abbreviated (e.g. BC standing for British Columbia). The library takes such fields and maps them to their full form. If the mapping is successful, the `MappingStatus` will be `MS_SUCCEEDED`. To learn of the other options of `MappingStatus`, please refer to the link below.

```java
EnumMappingStatus getFieldMappingStatus(String fieldName);
```

**Parameters**

`[in] fieldName`: The name of the field.

**Return Value**

Returns a [MappingStatus]({{ site.dcv_enumerations }}code-parser/mapping-status.html?lang=android) enumeration value representing the mapping status of a specified field.

**See Also**

[MappingStatus]({{ site.dcv_enumerations }}code-parser/mapping-status.html?lang=android)

## getFieldValidationStatus

Gets the validation status of a specified field from the parsed result. Certain fields can be validated with one of four possible validation methods: certification, checksum, length, and regex. Whether a field is validated or not, as well as the validation method, is determined by the code specification e.g. AAMVA specification.

```java
EnumValidationStatus getFieldValidationStatus(String fieldName);
```

**Parameters**

`[in] fieldName`: The name of the field.

**Return Value**

Returns a [ValidationStatus]({{ site.dcv_enumerations }}code-parser/validation-status.html?lang=android) enumeration value saying whether the validation of a specified field was successful, failed, or if it did not require validation.

**See Also**

[ValidationStatus]({{ site.dcv_enumerations }}code-parser/validation-status.html?lang=android)

## getParsedFields

Get the field names and values of the parsed fields as a `HashMap`. The field names are stored as the key of the HashMap while the field values are stored as the value.

```java
HashMap<String, String> getParsedFields();
```

**Return Value**

A HashMap that contains the names and values of the parsed fields.
17 changes: 17 additions & 0 deletions programming/android/api-reference/parsed-result-item.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@ class ParsedResultItem extends CapturedResultItem
| [`getCodeType`](#getcodetype) | Gets the code type of the parsed result. |
| [`getFieldMappingStatus`](#getfieldmappingstatus) | Gets the mapping status of a specified field from the parsed result. |
| [`getFieldValidationStatus`](#getfieldvalidationstatus) | Gets the validation status of a specified field from the parsed result. |
| [`getFieldRawValue`](#getfieldrawvalue) | Gets the raw value of the specified field. |
| [`getFieldValue`](#getfieldvalue) | Gets the value of a specified field from the parsed result. |
| [`getJsonString`](#getjsonstring) | Gets the parsed result as a JSON formatted string. |

Expand Down Expand Up @@ -64,6 +65,22 @@ String getJsonString();

Returns a JSON formatted string representing the parsed result.

## getFieldRawValue

Gets the raw value of the specified field.

```java
String getFieldRawValue(String fieldName);
```

**Parameters**

`[in] fieldName`: The name of the field.

**Return Value**

Returns a string representing the specified field raw value.

## getFieldValue

Gets the value of a specified field from the parsed result.
Expand Down
187 changes: 187 additions & 0 deletions programming/ios/api-reference/parsed-result-item-v2.4.2000.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,187 @@
---
layout: default-layout
title: DSParsedResultItem Class - Dynamsoft Code Parser SDK iOS Edition API Reference
description: This page shows DSParsedResultItem Class of Dynamsoft Code Parser SDK iOS Edition.
keywords: DSParsedResultItem, api reference, iOS
needAutoGenerateSidebar: true
---


# DSParsedResultItem Class

`ParsedResultItem` it the basic unit of a parsed result. It stores the field name, value and additional information.

## Definition

*Assembly:* DynamsoftCodeParser.xcframework

<div class="sample-code-prefix"></div>
>- Objective-C
>- Swift
>
>1.
```objc
@interface DSParsedResultItem: DSCapturedResultItem
```
2.
```swift
class ParsedResultItem : CapturedResultItem
```

## Method Summary

| Method | Description |
| ------ | ----------- |
| [`getFieldMappingStatus`](#getfieldmappingstatus) | Gets the mapping status of a specified field from the parsed result. |
| [`getFieldValidationStatus`](#getfieldvalidationstatus) | Gets the validation status of a specified field from the parsed result. |
| [`getFieldValue`](#getfieldvalue) | Gets the value of a specified field from the parsed result. |

## Property Summary

| Property | Type | Description |
| -------- | ---- | ----------- |
| [`codeType`](#codetype) | *NSString* | Gets the code type of the parsed result. |
| [`jsonString`](#jsonstring) | *NSString* | Gets the parsed result as a JSON formatted string. |
| [`parsedFields`](#parsedfields) | *NSDictionary* | A `NSDictionary` object stores the field names and values of the parsed fields. |

## Method Detail

### getFieldMappingStatus

Gets the mapping status of a specified field from the parsed result. Certain fields in the parsed result, such as the residing province or state, are abbreviated (e.g. BC standing for British Columbia). The library takes such fields and maps them to their full form. If the mapping is successful, the `MappingStatus` will be `DSMappingStatusSucceeded`. To learn of the other options of `MappingStatus`, please refer to the link below.

<div class="sample-code-prefix"></div>
>- Objective-C
>- Swift
>
>1.
```objc
- (DSMappingStatus *)getFieldMappingStatus(NSString *)fieldName;
```
2.
```swift
func getFieldMappingStatus(_ fieldName:String) -> MappingStatus
```

**Parameters**

`fieldName`: The name of the field.

**Return Value**

Returns a [MappingStatus]({{ site.dcv_enumerations }}code-parser/mapping-status.html?lang=objc,swift) enumeration value representing the mapping status of a specified field.

### getFieldValidationStatus

Gets the validation status of a specified field from the parsed result. Certain fields can be validated with one of four possible validation methods: certification, checksum, length, and regex. Whether a field is validated or not, as well as the validation method, is determined by the code specification e.g. AAMVA specification.

<div class="sample-code-prefix"></div>
>- Objective-C
>- Swift
>
>1.
```objc
- (DSValidationStatus *)getFieldValidationStatus(NSString *)fieldName;
```
2.
```swift
func getFieldValidationStatus(_ fieldName:String) -> ValidationStatus
```

**Parameters**

`fieldName`: The name of the field.

**Return Value**

Returns a [ValidationStatus]({{ site.dcv_enumerations }}code-parser/validation-status.html?lang=objc,swift) enumeration value saying whether the validation of a specified field was successful, failed, or if it did not require validation..

### getFieldValue

Gets the value of a specified field from the parsed result.

<div class="sample-code-prefix"></div>
>- Objective-C
>- Swift
>
>1.
```objc
- (NSString *)getFieldValue(NSString *)fieldName;
```
2.
```swift
func getFieldValue(_ fieldName:String) -> String
```

**Parameters**

`fieldName`: The name of the field.

**Return Value**

Returns a string representing the specified field value.

## Property Detail

### codeType

Returns the code type of the parsed result. It can be one of the following:

- "AADHAAR"
- "AAMVA_DL_ID"
- "AAMVA_DL_ID_WITH_MAG_STRIPE"
- "MRTD_TD1_ID"
- "MRTD_TD2_ID"
- "MRTD_TD2_VISA"
- "MRTD_TD3_PASSPORT"
- "MRTD_TD3_VISA"
- "MRTD_TD2_FRENCH_ID"
- "SOUTH_AFRICA_DL"
- "VIN"

<div class="sample-code-prefix"></div>
>- Objective-C
>- Swift
>
>1.
```objc
@property (nonatomic, readonly) NSString * codeType;
```
2.
```swift
var codeType: String? { get }
```

### jsonString

The parsed result as a JSON formatted string.

<div class="sample-code-prefix"></div>
>- Objective-C
>- Swift
>
>1.
```objc
@property (nonatomic, readonly) NSString * jsonString;
```
2.
```swift
var jsonString: String? { get }
```

### parsedFields

A `NSDictionary` object stores the field names and values of the parsed fields. The field names are stored as the key of the HashMap while the field values are stored as the value.

<div class="sample-code-prefix"></div>
>- Objective-C
>- Swift
>
>1.
```objc
@property (nonatomic, readonly) NSDictionary<NSString *, NSString *> * parsedFields;
```
2.
```swift
var parsedFields: NSDictionary { get }
```
26 changes: 26 additions & 0 deletions programming/ios/api-reference/parsed-result-item.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,7 @@ class ParsedResultItem : CapturedResultItem
| ------ | ----------- |
| [`getFieldMappingStatus`](#getfieldmappingstatus) | Gets the mapping status of a specified field from the parsed result. |
| [`getFieldValidationStatus`](#getfieldvalidationstatus) | Gets the validation status of a specified field from the parsed result. |
| [`getFieldRawValue`](#getfieldrawvalue) | Gets the raw value of the specified field. |
| [`getFieldValue`](#getfieldvalue) | Gets the value of a specified field from the parsed result. |

## Property Summary
Expand Down Expand Up @@ -96,6 +97,31 @@ func getFieldValidationStatus(_ fieldName:String) -> ValidationStatus

Returns a [ValidationStatus]({{ site.dcv_enumerations }}code-parser/validation-status.html?lang=objc,swift) enumeration value saying whether the validation of a specified field was successful, failed, or if it did not require validation..

### getFieldRawValue

Gets the raw value of the specified field.

<div class="sample-code-prefix"></div>
>- Objective-C
>- Swift
>
>1.
```objc
- (NSString *)getFieldRawValue(NSString *)fieldName;
```
2.
```swift
func getFieldRawValue(_ fieldName:String) -> String
```

**Parameters**

`fieldName`: The name of the field.

**Return Value**

Returns a string representing the specified field raw value.

### getFieldValue

Gets the value of a specified field from the parsed result.
Expand Down