.Service Order Imports v2021.1

.Service Order Imports v2021.1

Capability

This Import allows the User to INSERT or UPDATE existing Service Orders or INSERT new Service Order Actions.

Matches On

The Service Order Import attempts to match based on the SD Number. There are several valid values for SD Number and behaviors associated with each.

Blank value - (Null)

Passing in a blank value or Null causes the Import to create a new Order record.

PREVIOUS

The Keyword PREVIOUS assigns the current line of the Import File record to UPDATE the last successfully saved Order with a new Child Action.

PREVIOUS_ACTION

The Keyword PREVIOUS_ACTION assigns the line of the Import record to UPDATE the last successfully saved Action with new Child data such as the GLA.

SD Number

Passing in a valid SD Number like 'SO201700001' prompts the Service Order Import to match on that number for an UPDATE. The SD Number must exist or the Import causes an error.

Fields

SD Number

Required

Datatype is String.

See the Matches On section for information about allowable values.

Service Rep

Required

Datatype is String.

It can be specified by Customer Number or both the First Name and Last Name.

The Service Rep MUST be an existing Contact with a Type of Service Rep.

Service Rep Customer Number

Datatype is String.

Service Rep First Name

Datatype is String.

MUST be used with Service Rep Last Name.

Service Rep Last Name

Datatype is String.

MUST be used with Service Rep First Name.

Due Date

Datatype is Date-Time.

Set Date Format in the Column Mapping Format Mask field.

Description

Datatype is String.

Status

Datatype is String.

Default value: Pending

If the Import is attempting an INSERT, the only valid value is Pending

If the Import is attempting an UPDATE, either Pending or Hold can be used.

ALL other values will cause an error.

Owner

Either an Owner Contact or Owner Department Hierarchy should be provided.

If they are both provided, an error is generated.

The Owner set on the Order applies to all child Actions unless an Action has an Owner otherwise specified.

Owner Contact

Datatype is String.

This is specified by Customer Number only NOT First Name or Last Name.

All Owners Contact must be Customer Type Contacts.

Owner Department Hierarchy

Datatype is Hierarchical String.

The full Department Hierarchy Path and Code value should be provided.

The Import does not accept the Department Hierarchy Name.

Requestor

This enters a Requestor into the Service Order item.

This can be specified by Customer Number or both the First Name and Last Name.

Requestor Customer Number

Datatype is String.

Requestor First Name

Datatype is String.

MUST be used with Requestor Last Name.

Requestor Last Name

Datatype is String.

MUST be used with Requestor First Name.

Associated Project

Datatype is String

Default value: blank

The provided value for this field must be an existing Project Service Desk Number.

Impact

Datatype is String.

Default value: Off

Valid values are blank (Off), Low, Medium, and High.