1. REST API for Oracle Digital Experience for Communications Industry Fabric
  2. Tasks
  3. TMF 632 Party Management
  4. Notification Listeners

Sample listener for Update Individual event

post

/party/v4/listener/individualAttributeValueChangeEvent

This method is a sample client listener for receiving notifications when an Update Person event (IndividualAttributeValueChangeEvent) is triggered.

Request

There are no request parameters for this operation.

Supported Media Types
Request Body - application/json;charset=utf-8 ()
Root Schema : schema
Type: object
The notification data structure
Show Source
Nested Schema : IndividualAttributeValueChangeEventPayload
Type: object
The event data structure
Show Source
  • Discriminator: @type
    Discriminator: { "propertyName":"@type", "mapping":{ "Individual":"#/components/schemas/Individual", "IndividualOracle":"#/components/schemas/IndividualOracle" } }
    Individual represents a single human being (a man, woman or child). The individual can be a customer, an employee or any other person that the organization needs to store information about.
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

Individual represents a single human being (a man, woman or child). The individual can be a customer, an employee or any other person that the organization needs to store information about.
Show Source
Nested Schema : contactMedium
Type: array
Show Source
  • Discriminator: @type
    Discriminator: { "propertyName":"@type", "mapping":{ "ContactMedium":"#/components/schemas/ContactMedium", "ContactMediumOracle":"#/components/schemas/ContactMediumOracle" } }
    Indicates the contact medium that could be used to contact the party.
Nested Schema : creditRating
Type: array
Show Source
Nested Schema : disability
Type: array
Show Source
Nested Schema : externalReference
Type: array
Show Source
Nested Schema : individualIdentification
Type: array
Show Source
  • IndividualIdentification
    Represents our registration of information used as proof of identity by an individual (passport, national identity card, drivers license, social security number, birth certificate)
Nested Schema : languageAbility
Type: array
Show Source
Nested Schema : otherName
Type: array
Show Source
Nested Schema : partyCharacteristic
Type: array
Show Source
Nested Schema : relatedParty
Type: array
Show Source
  • Discriminator: @type
    Discriminator: { "propertyName":"@type", "mapping":{ "RelatedParty":"#/components/schemas/RelatedParty", "RelatedPartyOracle":"#/components/schemas/RelatedPartyOracle" } }
    Related Entity reference. A related party defines party or party role linked to a specific entity.
Nested Schema : skill
Type: array
Show Source
  • Skill
    Skills evaluated for an individual with a level and possibly with a limited validity when an obsolescence is defined (Ex: the first-aid certificate first level is limited to one year and an update training is required each year to keep the level).
Nested Schema : taxExemptionCertificate
Type: array
Show Source
  • TaxExemptionCertificate
    A tax exemption certificate represents a tax exemption granted to a party (individual or organization) by a tax jurisdiction which may be a city, state, country,... An exemption has a certificate identifier (received from the jurisdiction that levied the tax) and a validity period. An exemption is per tax types and determines for each type of tax what portion of the tax is exempted (partial by percentage or complete) via the tax definition.
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

Indicates the contact medium that could be used to contact the party.
Show Source
  • When sub-classing, this defines the super-class
  • A URI to a JSON-Schema file that defines additional attributes and relationships
  • Default Value: ContactMediumOracle
    When sub-classing, this defines the sub-class entity name
  • Discriminator: @type
    Discriminator: { "propertyName":"@type", "mapping":{ "MediumCharacteristic":"#/components/schemas/MediumCharacteristic", "MediumCharacteristicOracle":"#/components/schemas/MediumCharacteristicOracle" } }
    Describes the contact medium characteristics that could be used to contact a party (an individual or an organization)
  • Allowed Values: [ "postalAddress", "emailAddress", "socialNetwork", "phoneNumber" ]
    Type of the contact medium, such as: email address, telephone number, postal address
  • If true, indicates that is the preferred contact medium
  • TimePeriod
    A period of time, either as a deadline (endDateTime only) a startDateTime only, or both
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

Describes the contact medium characteristics that could be used to contact a party (an individual or an organization)
Show Source
Nested Schema : TimePeriod
Type: object
A period of time, either as a deadline (endDateTime only) a startDateTime only, or both
Show Source
Nested Schema : PartyCreditProfile
Type: object
An individual might be evaluated for its worthiness and this evaluation might be based on a credit rating given by a credit agency.
Show Source
Nested Schema : Disability
Type: object
Lack or inadequate strength or ability.
Show Source
Nested Schema : ExternalReference
Type: object
External reference of the individual or reference in other system
Show Source
Nested Schema : IndividualIdentification
Type: object
Represents our registration of information used as proof of identity by an individual (passport, national identity card, drivers license, social security number, birth certificate)
Show Source
Nested Schema : AttachmentRefOrValue
Type: object
An attachment by value or by reference. An attachment complements the description of an element, for example through a document, a video, a picture.
Show Source
Nested Schema : Quantity
Type: object
An amount in a given unit
Show Source
Nested Schema : LanguageAbility
Type: object
Ability of an individual to understand or converse in a language.
Show Source
Nested Schema : OtherNameIndividual
Type: object
Keeps track of other names, for example the old name of a woman before marriage or an artist name.
Show Source
Nested Schema : Characteristic
Type: object
Describes a given characteristic of an object or entity through a name/value pair.
Show Source
Nested Schema : Any
Type: object
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

Related Entity reference. A related party defines party or party role linked to a specific entity.
Show Source
Nested Schema : Skill
Type: object
Skills evaluated for an individual with a level and possibly with a limited validity when an obsolescence is defined (Ex: the first-aid certificate first level is limited to one year and an update training is required each year to keep the level).
Show Source
Nested Schema : TaxExemptionCertificate
Type: object
A tax exemption certificate represents a tax exemption granted to a party (individual or organization) by a tax jurisdiction which may be a city, state, country,... An exemption has a certificate identifier (received from the jurisdiction that levied the tax) and a validity period. An exemption is per tax types and determines for each type of tax what portion of the tax is exempted (partial by percentage or complete) via the tax definition.
Show Source
Nested Schema : taxDefinition
Type: array
Show Source
  • TaxDefinition
    Reference of a tax definition. A tax is levied by an authorized tax jurisdiction. There are many different types of tax (Federal Tax levied by the US Government, State Tax levied by the State of California,???).
Nested Schema : TaxDefinition
Type: object
Reference of a tax definition. A tax is levied by an authorized tax jurisdiction. There are many different types of tax (Federal Tax levied by the US Government, State Tax levied by the State of California,???).
Show Source
Back to Top

Response

Supported Media Types

201 Response

Notified
Body ()
Root Schema : EventSubscription
Type: object
Sets the communication endpoint address the service instance must use to deliver notification information
Show Source

400 Response

Bad Request
Body ()
Root Schema : Error
Type: object
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Show Source

401 Response

Unauthorized
Body ()
Root Schema : Error
Type: object
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Show Source

403 Response

Forbidden
Body ()
Root Schema : Error
Type: object
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Show Source

404 Response

Not Found
Body ()
Root Schema : Error
Type: object
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Show Source

405 Response

Method Not allowed
Body ()
Root Schema : Error
Type: object
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Show Source

409 Response

Conflict
Body ()
Root Schema : Error
Type: object
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Show Source

500 Response

Internal Server Error
Body ()
Root Schema : Error
Type: object
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Show Source
Back to Top

Examples

The following example shows how to create sample listener for individual update event by submitting a POST request on the REST resource using cURL. You need to create an individual first for this action.

cURL Command

curl -H 'Authorization: Bearer <Token>' -X POST https://{FABRIC_HOST}/party/v4/listener/individualAttributeValueChangeEvent -H "Content-Type: application/json" -D @create_individualattrbvalchangeevent.json | json_pp

Example of Request Body

{
  "correlationId": "FAB-7b0c6bde-4c33-4195-96a0-b57cd4e07067",
  "eventId": "IndividualAttributeValueChangeEvent_2022-07-25T07:30:17.316767500Z",
  "eventTime": "2022-07-25T07:30:17.316767500Z",
  "eventType": "IndividualAttributeValueChangeEvent",
  "event": {
    "individual": {
      "partyId": "300100550342688",
      "doNotCallFlag": false,
      "doNotEmailFlag": false,
      "lastUpdateDate": "2022-07-25T06:03:43.558Z",
      "creationDate": "2022-07-25T05:29:32.002Z",
      "createdBy": "comms_care",
      "lastUpdatedBy": "comms_care",
      "partyNumber": "CDRM_953427",
      "userName": "comms_care",
      "id": "CDRM_953427",
      "href": "/party/v4/individual/CDRM_953427",
      "familyName": "Pickford1",
      "fullName": "Lia1 Test1 Pickford1",
      "givenName": "Lia1",
      "middleName": "Test1",
      "title": "MS.",
      "contactMedium": [
        {
          "id": "CDRM_854505",
          "lastUpdateDate": "2022-07-25T05:29:33.795Z",
          "addressId": "300100550342692",
          "mediumType": "postalAddress",
          "preferred": true,
          "characteristic": {
            "address1": "5174 Richmond56",
            "address2": "Avenue Md 206098",
            "formattedAddress": "5174 Richmond56,Avenue Md 206098,AVENUE, MD 20609",
            "state": "MD",
            "doNotMailFlag": false,
            "city": "Avenue",
            "contactType": "billingAddress",
            "country": "US",
            "postCode": "20609",
            "@type": "MediumCharacteristicOracle"
          },
          "@type": "ContactMediumOracle"
        },
        {
          "id": "300100550342696",
          "lastUpdateDate": "2022-07-25T05:29:35.770Z",
          "mediumType": "emailAddress",
          "preferred": true,
          "characteristic": {
            "doNotMailFlag": false,
            "emailAddress": "etm@etmail.com",
            "@type": "MediumCharacteristicOracle"
          },
          "@type": "ContactMediumOracle"
        },
        {
          "id": "300100550342697",
          "lastUpdateDate": "2022-07-25T05:29:36.253Z",
          "mediumType": "phoneNumber",
          "preferred": false,
          "characteristic": {
            "formattedPhoneNumber": "+54 112233",
            "phoneCountryCode": "54",
            "doNotCallFlag": false,
            "contactType": "faxNumber",
            "faxNumber": "112233",
            "@type": "MediumCharacteristicOracle"
          },
          "@type": "ContactMediumOracle"
        },
        {
          "id": "300100550342698",
          "lastUpdateDate": "2022-07-25T05:29:36.291Z",
          "mediumType": "phoneNumber",
          "preferred": true,
          "characteristic": {
            "formattedPhoneNumber": "+93 (1111)34444",
            "phoneCountryCode": "93",
            "phoneAreaCode": "1111",
            "doNotCallFlag": false,
            "contactType": "homePhoneNumber",
            "phoneNumber": "34444",
            "@type": "MediumCharacteristicOracle"
          },
          "@type": "ContactMediumOracle"
        },
        {
          "id": "300100550342699",
          "lastUpdateDate": "2022-07-25T05:29:36.305Z",
          "mediumType": "phoneNumber",
          "preferred": false,
          "characteristic": {
            "formattedPhoneNumber": "+358 ",
            "phoneCountryCode": "358",
            "doNotCallFlag": false,
            "contactType": "mobilePhoneNumber",
            "@type": "MediumCharacteristicOracle"
          },
          "@type": "ContactMediumOracle"
        }
      ],
      "individualIdentification": [
        {
          "id": "300100550342691",
          "identificationId": "KA-DL-24344",
          "identificationType": "DRIVERS_LICENSE",
          "issuingAuthority": "RTO Bangalore",
          "issuingDate": "2022-06-28T12:00:00Z",
          "attachment": {
            "id": "00020000000EACED00057708000110F09AB338270000000EACED00057708000110F09AB33826",
            "href": "/documentManagement/v4/attachment/00020000000EACED00057708000110F09AB338270000000EACED00057708000110F09AB33826",
            "content": "VGhpcyBpcyB0aGUgZHJpdmVycyBsaWNlbnNlIGNvbnRlbnQu",
            "description": "Drivers license file content",
            "mimeType": "application/pdf",
            "name": "Drivers_license.pdf",
            "size": {
              "amount": 48,
              "units": "bytes"
            },
            "validFor": {
              "endDateTime": "2027-06-28T03:40:14.003Z"
            }
          },
          "validFor": {
            "endDateTime": "2032-06-28T12:00:00Z"
          },
          "@baseType": "IndividualIdentification",
          "@type": "IndividualIdentificationOracle"
        }
      ],
      "relatedParty": [
        {
          "relationshipId": "300100550342700",
          "relationshipCode": "PARENT_OF",
          "relationshipType": "PARENT/CHILD",
          "lastUpdateDate": "2022-07-25T05:29:36.346Z",
          "id": "CDRM_953424",
          "href": "/party/v4/individual/CDRM_953424",
          "name": "Chandra Reddy",
          "role": "PARENT",
          "@type": "RelatedPartyOracle",
          "@referredType": "Individual"
        }
      ],
      "status": "initialized",
      "@type": "IndividualOracle"
    }
  }
}

Example of Response Body

You will get a 201 Created status if your payload is successful. If there are no records, then you will get a message as follows: 

No ListenerRegistration Found for  http: //127.0.0.1:8086/01/party/v4/listener/individualAttributeValueChangeEvent
Back to Top