Get Field Activity

get

/rest/apis/meter/service/fieldActivities/{activityId}

This operation retrieves a field activity.

Request

Path Parameters

There's no request body for this operation.

Back to Top

Response

Supported Media Types

200 Response

Success response
Body ()
Root Schema : D1-GetFA
Type: object
Show Source
  • _self
  • Maximum Length: 14
    System-generated unique identifier for the field activity.
  • activityType
    Activity Type
  • appointmentInformation
  • appointmentWindow
  • Maximum Length: 30
    The business object (BO) of the Service Order Management Activity.
  • Maximum Length: 12
    The current status code of the service order field activity.
  • Maximum Length: 254
    The current status description of the service order field activity.
  • Allowed Values: [ "M2-INCOMPLETE", "CUT", "SEVER", "D1-Undetermined", "NEARMR", "UNDETER", "CR", "INCMPLTE", "C1SR", "WFA", "D1-AutoDiscarded", "STRSTP", "DEVTST", "CXS" ]
    The reason for cancelling the original activity (for canceled activities only). * `M2-INCOMPLETE` - INCOMPLETE, * `CUT` - Cut Canceled, * `SEVER` - Severance Canceled, * `D1-Undetermined` - Undetermined, * `NEARMR` - Near MR Completion Canceled, * `UNDETER` - Undetermined, * `CR` - Customer requested, * `INCMPLTE` - Incomplete, * `C1SR` - Activity Failed, * `WFA` - Wrong type of field act. type, * `D1-AutoDiscarded` - Auto Discarded, * `STRSTP` - Start Stop Canceled, * `DEVTST` - Device Test Canceled, * `CXS` - Canceled by external system
  • Create Date/Time
  • device
  • Allowed Values: [ "N ", "Y " ]
    A flag that indicates if the activity is an emergency or not. * `N ` - No, * `Y ` - Yes
  • externalActivityDetails
  • Maximum Length: 36
    Represents a unique system-generated id for the activity in the requesting system.
  • Maximum Length: 30
    External Service Point Type
  • Maximum Length: 30
    External Field Activity Type
  • Allowed Values: [ "D1-DisconnectItemSPAtSource", "ZZ-InstallMeter", "D1-ConnectSPAtSourceAndTurnOn", "D1-DisconnectSPAtSource", "D1-DisconnectWarning", "D1-MaintainEquipment", "D1-ExchangeMeter", "D1-DisConnSPAtDvcAndRmveDvc", "D1-TurnOffItem", "D1-ConnSPAtSrceAndInstMtr", "D1-TurnOnMeter", "D1-CutForNonPayment", "D1-DisConnSPAtSrceAndRmveMtr", "D1-ReconnectItemforPayment", "D1-TurnOffMeter", "D1-ConnectSPAtMeterAndTurnOn", "D1-DisconnectSPAtDevice", "D1-ConnectSPAtDevice", "D1-InstallDevice", "D1-ConnSPAtDvcAndInstDvc", "D1-ConnSPAtSrceAndTurnOnDvc", "D1-TurnOnPilotLight", "D1-ConnectSPAtSource", "D1-DisconnectSPAtMeter", "D1-ConnSPAtSrceAndInstDvc", "D1-ConnectSPAtMeter", "D1-ServiceInvestigation", "D1-DisConnSPAtMtrAndRmveMtr", "D1-InstallMeter", "D1-ReconnectForPayment", "D1-ConnectSPAtDvcAndTurnOn", "D1-TrimTree", "D1-ConnSPAtMtrAndInstMtr", "D1-CutItemForNonPayment", "X1-InvestigateControllableDevice", "D1-RemoveMeter", "D1-ConnectSPAtSourceAndInstallMeter", "D1-TurnOnItem", "D1-ReadMeter", "D1-RemoveDevice", "D1-ExchangeDevice", "X1-InstallControllableDevice" ]
    A service order field activity's field task type defines details about the type of task to be performed and how the system will process the activity. * `D1-DisconnectItemSPAtSource` - Disconnect SP at Source Item, * `ZZ-InstallMeter` - ZZ Install Meter, * `D1-ConnectSPAtSourceAndTurnOn` - Connect SP at Source and Turn On, * `D1-DisconnectSPAtSource` - Disconnect SP at Source, * `D1-DisconnectWarning` - Disconnect Warning, * `D1-MaintainEquipment` - Maintain SP and Meter Equipment, * `D1-ExchangeMeter` - Exchange Meter, * `D1-DisConnSPAtDvcAndRmveDvc` - Disconnect SP from Item and Remove Item, * `D1-TurnOffItem` - Turn Off Item, * `D1-ConnSPAtSrceAndInstMtr` - Connect SP at Source and Install Meter, * `D1-TurnOnMeter` - Turn On Meter, * `D1-CutForNonPayment` - Cut for Non Payment, * `D1-DisConnSPAtSrceAndRmveMtr` - Disconnect SP at Source and Remove Meter, * `D1-ReconnectItemforPayment` - Reconnect Item for Payment, * `D1-TurnOffMeter` - Turn Off Meter, * `D1-ConnectSPAtMeterAndTurnOn` - Connect SP at Meter and Turn On, * `D1-DisconnectSPAtDevice` - Disconnect SP from Item, * `D1-ConnectSPAtDevice` - Connect SP to Item, * `D1-InstallDevice` - Install Item, * `D1-ConnSPAtDvcAndInstDvc` - Connect SP to Item and Install Item, * `D1-ConnSPAtSrceAndTurnOnDvc` - Connect SP at Source and Turn On Item, * `D1-TurnOnPilotLight` - Turn On Pilot Light, * `D1-ConnectSPAtSource` - Connect SP at Source, * `D1-DisconnectSPAtMeter` - Disconnect SP at Meter, * `D1-ConnSPAtSrceAndInstDvc` - Connect SP at Source and Install Item, * `D1-ConnectSPAtMeter` - Connect SP at Meter, * `D1-ServiceInvestigation` - Service Investigation, * `D1-DisConnSPAtMtrAndRmveMtr` - Disconnect SP at Meter and Remove Meter, * `D1-InstallMeter` - Install Meter, * `D1-ReconnectForPayment` - Reconnect for Payment, * `D1-ConnectSPAtDvcAndTurnOn` - Connect SP to Item and Turn On, * `D1-TrimTree` - Trim Tree, * `D1-ConnSPAtMtrAndInstMtr` - Connect SP at Meter and Install Meter, * `D1-CutItemForNonPayment` - Cut Item for Non Payment, * `X1-InvestigateControllableDevice` - Investigate Controllable Device, * `D1-RemoveMeter` - Remove Meter, * `D1-ConnectSPAtSourceAndInstallMeter` - Connect SP at Source and Install Meter, * `D1-TurnOnItem` - Turn On Item, * `D1-ReadMeter` - Read Meter, * `D1-RemoveDevice` - Remove Item, * `D1-ExchangeDevice` - Exchange Item, * `X1-InstallControllableDevice` - Install Controllable Device
  • Maximum Length: 14
    Meter Number
  • parentActivity
  • Pending Changes
  • Maximum Length: 30
    The field work system service provider to which the service order field activity is sent for scheduling and assignment.
  • recommendedDeviceConfigurationType
  • Maximum Length: 30
    The requesting system service provider from which the request was received.
  • Maximum Length: 120
    Identifier Value
  • requesterUser
  • Allowed Values: [ "D1-Undetermined" ]
    Reschedule Reasons for rescheduling field activities as defined in the (D1-RescheduleReasonLookup) extendable lookup. * `D1-Undetermined` - Undetermined
  • Maximum Length: 60
    The Service Point Identifier in the Customer Care and Billing application data model.
  • sp
  • Status Date/Time
Nested Schema : activityType
Type: object
Activity Type
Show Source
Nested Schema : appointmentInformation
Type: object
Show Source
Nested Schema : appointmentWindow
Type: object
Show Source
Nested Schema : device
Type: object
Show Source
Nested Schema : externalActivityDetails
Type: object
Show Source
Nested Schema : parentActivity
Type: object
Show Source
Nested Schema : recommendedDeviceConfigurationType
Type: object
Show Source
Nested Schema : requesterUser
Type: object
Show Source
Nested Schema : sp
Type: object
Show Source

400 Response

Bad Request
Body ()
Root Schema : problemDetailDocument
Type: object
Show Source
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 9999
    The HTTP Status code for the error.
  • Maximum Length: 60
    Fully qualified URL consisting of the Base URI Timestamp of error in ISO format, the User used for the transaction, the Message Category within Oracle Utilities Application Framework, the Message Number within Oracle Utilities Application Framework, the Request URL and the HTTP method used for the transaction.
  • Maximum Length: 60
    URL of the format "A/message/X/Y" where A is the base URI, X is the Message Category and Y is the Message Number within Oracle Utilities Application Framework.
  • serverMessage
  • Maximum Length: 60
    The stack trace shows where the error occurs during the execution of a program.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type: object
Show Source
  • Maximum Length: 60
    Delimited sequence of programs called.
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 0
    Message Category within Oracle Utilities Application Framework.
  • Minimum Value: -99999
    Maximum Value: 99999
    Message Number within Oracle Utilities Application Framework.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
  • Maximum Length: 60
    Name of the program that encountered the error.

500 Response

Internal Server Error
Body ()
Root Schema : problemDetailDocument
Type: object
Show Source
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 9999
    The HTTP Status code for the error.
  • Maximum Length: 60
    Fully qualified URL consisting of the Base URI Timestamp of error in ISO format, the User used for the transaction, the Message Category within Oracle Utilities Application Framework, the Message Number within Oracle Utilities Application Framework, the Request URL and the HTTP method used for the transaction.
  • Maximum Length: 60
    URL of the format "A/message/X/Y" where A is the base URI, X is the Message Category and Y is the Message Number within Oracle Utilities Application Framework.
  • serverMessage
  • Maximum Length: 60
    The stack trace shows where the error occurs during the execution of a program.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type: object
Show Source
  • Maximum Length: 60
    Delimited sequence of programs called.
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 0
    Message Category within Oracle Utilities Application Framework.
  • Minimum Value: -99999
    Maximum Value: 99999
    Message Number within Oracle Utilities Application Framework.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
  • Maximum Length: 60
    Name of the program that encountered the error.
Back to Top