Loading
Försäkring
InsCensusServiceStd:updateMembers

Du är här:

  1. Salesforce-hjälp
  2. Dokument
  3. Digital försäkring

InsCensusServiceStd:updateMembers

Använd denna tjänst för att uppdatera värdena för befintliga medlemmar i en folkräkning.

Klass: InsCensusServiceStd​​

Metod: updateMembers

Så här fungerar det

  1. Denna tjänst tar medlemmarna från en indata-JSON och uppdaterar folkräkningen (enligt den givna censusId) med de nya data.

  2. census JSON består av två listor - headers och members.

    1. headers är listan över fältens metadata som består av fieldId, type, label och name. Här är namn fältets API-namn (med namnutrymmet för hanterade paket och egna fält).

    2. members är listan över medlemmar som ska uppdateras i folkräkningen.

  3. Tjänsten letar efter updateById. Det är ett booleskt fält som bestämmer tillvägagångssättet för tjänsten. Medlemmarna kan uppdateras på dessa två sätt:

    1. updateMembers med MemberKey:

      Detta alternativ gäller om updateById är falskt. Medlemsdata måste ha en medlemsnyckel.

    2. updateMembers efter ID för GroupCensusMember

      Detta alternativ gäller när updateById är sant. Medlemsdata måste ha ett ID för gruppräkningsmedlem.

updateMembers by MemberKey

  1. Tjänsten tolkar medlemmarnas data med fälten i headers. headers måste innehålla alla fältens metadata som används i medlemslistan.

  2. Tjänsten separerar primära medlemmar och beroende medlemmar baserat på RelationshipToPrimaryMember.

    1. Om medlemslistan innehåller primära medlemmar och beroenden måste indata ha SourceSystemIdentifier för alla medlemmar. Alla medlemmar måste ha en unik SourceSystemIdentifier. Dessutom måste alla underordnade ha PrimaryMemberSource eller PrimaryGroupCensusMemberId (om den primära medlemmen redan finns i folkräkningen).

    2. Om listan är en kombination av primära och beroende medlemmar, se till att varje beroende medlem och primär medlem finns i medlemslistan.

  3. Tjänsten bearbetar nya GroupClass. Om tjänsten har GroupClass.Name istället för GroupClassId hämtar den GroupClass med namnet och skapar en ny GroupClass med samma namn om den inte hittas.

    1. Om tjänsten har GroupClass.Name, inkludera även AccountId i medlemmarnas data.

    2. header för GroupClass.Name: {"type":"STRING","label":"Group Class Name","fieldId":"","name":"GroupClass.Name"}.

    3. Om den angivna GroupClass.Name är ogiltig returneras ett fel. Tjänsten tar en ny parameter quoteEffectiveDate för att validera GroupClass. GroupClass anses vara giltigt om:

      • GroupClass är länkat till medlemmens gruppkonto.

      • quoteEffectiveDate ligger mellan GroupClass StartDate och EndDate. Om quoteEffectiveDate inte anges som en parameter till tjänsten hoppas denna validering över.

  4. Tjänsterna bearbetar PrimaryMemberSource för beroenden med PrimaryGroupCensusMemberId.

    1. Om tjänsten har både PrimaryMemberSource och PrimaryGroupCensusMemberId överväger tjänsten PrimaryGroupCensusMemberId som källa och uppdaterar PrimaryMemberSource för beroende till att innehålla SourceSystemIdentifier för primär.

  5. Tjänsten sparar alla huvudmedlemmar först.

  6. Den tolkar beroenden för att identifiera föräldralösa beroenden (beroenden utan PrimaryMemberSource).

  7. Det sparar alla giltiga beroenden.

  8. Tjänsten uppdaterar DependentCount över alla primära medlemmar i medlemslistan.

updateMembers by Id

  1. Tjänsten tolkar medlemmarnas data med fälten i headers. headers måste innehålla alla fältens metadata som används i medlemslistan.

  2. members måste ha ID. Om ID inte hittas i medlemsdata ger tjänsten ett fel.

  3. Tjänsten bearbetar nya GroupClass. Om tjänsten har GroupClass.Name istället för GroupClassId hämtar den GroupClass med namnet och skapar en ny GroupClass med samma namn om den inte hittas.

    1. Om tjänsten har GroupClass.Name, inkludera även AccountId i medlemmarnas data.

    2. header för GroupClass.Name: {"type":"STRING","label":"Group Class Name","fieldId":"","name":"GroupClass.Name"}.

  4. Servicen bearbetar PrimaryGroupCensusMemberId för beroenden med PrimaryMemberSource.

    1. Om du tillhandahåller PrimaryMemberSource uppdaterar tjänsten även PrimaryGroupCensusMemberId.

  5. Tjänsterna bearbetar PrimaryMemberSource för beroenden med PrimaryGroupCensusMemberId.

    1. Om tjänsten har både PrimaryMemberSource och PrimaryGroupCensusMemberId överväger tjänsten PrimaryGroupCensusMemberId som källa och uppdaterar PrimaryMemberSource för beroende till att innehålla SourceSystemIdentifier för primär.

  6. Tjänsten sparar alla medlemmar inklusive beroenden.

  7. Tjänsten identifierar inte föräldralösa anhöriga.

  8. Tjänsten uppdaterar DependentCount över alla primära medlemmar i medlemslistan.

Fjärralternativ

Alternativ

Beskrivning

censusId

Obligatoriskt.

ID för folkräkningen med medlemmar att uppdatera.

census

Obligatoriskt.

Ange JSON med detaljer för medlemmar som ska uppdateras.
updateById

Valfri

Om satt till sant följer tjänsten updateMembers efter Id-flöde.

Standardvärdet är falskt.

Servicebeteende

Förstå hur olika inmatningar påverkar serviceresultaten.

Indata updateById Serviceresultat
Nej censusId sant eller falskt

Tjänsten returnerar ett fel: Specify a censusId.

Ingen JSON för folkräkningsinmatning sant eller falskt Tjänsten returnerar ett fel: The census input is missing.
Värdet på PrimaryMemberSource som ges till huvudmedlemmen falskt Tjänsten returnerar ett fel: The PrimaryMemberSource must be null for primary members.
headers saknas i indataräkningen sant eller falskt Tjänsten returnerar ett fel: The header node is missing in the census input.
members saknas i indataräkningen sant eller falskt Tjänsten returnerar ett fel: The members node is missing in the census input.
För överordnade beroende (De beroende utan PrimaryMemberSource eller PrimaryGroupCensusMemberId) falskt Tjänsten returnerar ett fel: Dependent has no primary member.
ID saknas i medlemmars data true Tjänsten returnerar ett fel: Specify Id of the census member.

Indata-JSON

JSON för indata inkluderar headers, som listar de fält som ska uppdateras, och members, som listar medlemmar med motsvarande fältvärdepar, inklusive fieldId.

JSON för provinmatning (updateMembers By MemberKey) 

{
  "census": {
    "headers": [
      {
        "type": "STRING",
        "label": "Last Name",
        "fieldId": "",
        "name": "Lastname"
      },
      {
        "type": "STRING",
        "label": "First Name",
        "fieldId": "",
        "name": "FirstName"
      },
      {
        "type": "DOUBLE",
        "label": "FTE",
        "fieldId": "",
        "name": "FullTimeEquivalent"
      },
      {
        "type": "PICKLIST",
        "label": "Gender",
        "fieldId": "",
        "name": "Gender"
      },
      {
        "type": "DATE",
        "label": "Birthday",
        "fieldId": "",
        "name": "Birthdate"
      },
      {
        "type": "PICKLIST",
        "label": "Relationship To Primary",
        "fieldId": "",
        "name": "RelationshipToPrimaryMember"
      },
      {
        "type": "BOOLEAN",
        "label": "Is Opt-out All Plans",
        "fieldId": "",
        "name": "IsOptOutAllPlans"
      },
      {
        "type": "MULTIPICKLIST",
        "label": "Opt-Out Plan Types",
        "fieldId": "",
        "name": "OptOutPlanTypes"
      },
      {
        "type": "ENTITYID",
        "label": "Account",
        "fieldId": "",
        "name": "AccountId"
      },
      {
        "type": "EMAIL",
        "label": "Email",
        "fieldId": "",
        "name": "Email"
      },
      {
        "type": "STRING",
        "label": "Primary Member Identifier",
        "fieldId": "",
        "name": "PrimaryMemberSource"
      },
      {
        "type": "STRING",
        "label": "Member Identifier",
        "fieldId": "",
        "name": "SourceSystemIdentifier"
      }
    ],
    "members": [
      {
        "MemberKey": "cd64a62573825ee11b87ce91110aa576",
        "Lastname": "KoffinsUpdated",
        "FirstName": "RajUpdated",
        "FullTimeEquivalent": 1,
        "Gender": "Male",
        "Birthdate": "1965-10-13",
        "SourceSystemIdentifier": "1.primary",
        "PrimaryMemberSource": null,
        "Email": "testrajUpdated@mail.com"
      },
      {
        "MemberKey": "f2f8735bbb66b3f7d7b2bae794c00650",
        "Lastname": "Koffins",
        "FirstName": "KrisUpdated",
        "Gender": "Male",
        "Birthdate": "2010-05-13",
        "RelationshipToPrimaryMember": "Child",
        "SourceSystemIdentifier": "1.child",
        "PrimaryMemberSource": "1.primary",
        "Email": "testkrisUpdated@mail.com"
      },
      {
        "Lastname": "WarnerUpdated",
        "MemberKey": "5a5bc4e3c05cf461a65a2d7fdc0ab8e0",
        "FirstName": "Christopher",
        "FullTimeEquivalent": 0.75,
        "Gender": "Male",
        "Birthdate": "1985-10-13",
        "SourceSystemIdentifier": "2.primary",
        "PrimaryMemberSource": null,
        "Email": "testchristopherUpdated@mail.com"
      },
      {
        "Lastname": "WarnerUpdated",
        "MemberKey": "157b2052fc732d8261984c2922a3261b",
        "FirstName": "Steph",
        "Gender": "Male",
        "Birthdate": "1985-10-13",
        "RelationshipToPrimaryMember": "Spouse",
        "SourceSystemIdentifier": "2.spouse",
        "PrimaryMemberSource": "2.primary",
        "Email": "teststephUpdated.com"
      }
    ]
  }
}

JSON för provinmatning (updateMembers By Id) 

{
  "census": {
    "headers": [
      {
        "type": "STRING",
        "label": "Last Name",
        "fieldId": "",
        "name": "Lastname"
      },
      {
        "type": "STRING",
        "label": "First Name",
        "fieldId": "",
        "name": "FirstName"
      },
      {
        "type": "DOUBLE",
        "label": "FTE",
        "fieldId": "",
        "name": "FullTimeEquivalent"
      },
      {
        "type": "PICKLIST",
        "label": "Gender",
        "fieldId": "",
        "name": "Gender"
      },
      {
        "type": "DATE",
        "label": "Birthday",
        "fieldId": "",
        "name": "Birthdate"
      },
      {
        "type": "PICKLIST",
        "label": "Relationship To Primary",
        "fieldId": "",
        "name": "RelationshipToPrimaryMember"
      },
      {
        "type": "BOOLEAN",
        "label": "Is Opt-out All Plans",
        "fieldId": "",
        "name": "IsOptOutAllPlans"
      },
      {
        "type": "MULTIPICKLIST",
        "label": "Opt-Out Plan Types",
        "fieldId": "",
        "name": "OptOutPlanTypes"
      },
      {
        "type": "ENTITYID",
        "label": "Account",
        "fieldId": "",
        "name": "AccountId"
      },
      {
        "type": "EMAIL",
        "label": "Email",
        "fieldId": "",
        "name": "Email"
      },
      {
        "type": "STRING",
        "label": "Primary Member Identifier",
        "fieldId": "",
        "name": "PrimaryMemberSource"
      },
      {
        "type": "STRING",
        "label": "Member Identifier",
        "fieldId": "",
        "name": "SourceSystemIdentifier"
      }
    ],
    "members": [
      {
        "Id":"0r6RO00000005pZYAQ",
        "Lastname": "KoffinsUpdatedById",
        "FirstName": "RajUpdatedById",
        "Birthdate": "1965-10-13",
        "Email": "testrajUpdated@mail.com"
      },
      {
        "Id":"0r6RO00000005pbYAA",
        "Lastname": "Koffins",
        "FirstName": "KrisUpdatedById",
        "Gender": "Male",
        "Birthdate": "2010-05-13",
        "RelationshipToPrimaryMember": "Child",
        "Email": "testkrisUpdatedById@mail.com"
      },
      {
        "Id":"0r6RO00000005paYAA",
        "Lastname": "WarnerUpdatedById",
        "FirstName": "Christopher",
        "FullTimeEquivalent": 0.75,
        "Gender": "Male",
        "Birthdate": "1985-10-13",
        "Email": "testchristopherUpdatedById@mail.com"
      },
      {
        "Lastname": "WarnerUpdatedById",
        "FirstName": "Steph",
        "Birthdate": "1985-10-13",
        "Email": "teststephUpdated.com"
      }
    ]
  }
}

JSON för utdata

Tjänsten returnerar ett resultatmeddelande om flödet slutförs, annars returneras felet vid eventuella undantag.

  • censusMemberIds: Listan över GroupCensusMemberIds över sparade medlemmar.

  • fel: Listan över medlemmar med fel. Varje listobjekt består av indata för medlemmar och fel.

  • ​ ​ ​ relatedFieldsUpdateSuccessCount: Antal primära medlemmar som DependentCount uppdateras för efter tjänst.

  • ​ ​ ​ relatedFieldsUpdateErrorCount: Antal primära medlemmar som DependentCount returnerar fel för.

  • relatedFieldsUpdateErrors: Listan över fel som returnerades vid uppdatering av DependentCount över primära medlemmar.

Exempel på JSON för utdata (updateMembers By MemberKey)

{
  "result": "success",
  "relatedFieldsUpdateErrors": [],
  "relatedFieldsUpdateErrorCount": 0,
  "relatedFieldsUpdateSuccessCount": 2,
  "errors": [
    {
      "error": "[Email]: INVALID_EMAIL_ADDRESS - Email: invalid email address: teststephUpdated.com",
      "Birthdate": "1985-10-13",
      "Gender": "Male",
      "Lastname": "WarnerUpdated",
      "RelationshipToPrimaryMember": "Spouse",
      "MemberKey": "157b2052fc732d8261984c2922a3261b",
      "SourceSystemIdentifier": "2.spouse",
      "FirstName": "Steph",
      "Email": "teststephUpdated.com",
      "PrimaryMemberSource": "2.primary"
    }
  ],
  "censusMemberIds": [
    "0r6RO00000005pZYAQ",
    "0r6RO00000005paYAA",
    "0r6RO00000005pbYAA"
  ],
  "deletedCensusMemberIds": [],
  "errorCode": "INVOKE-200",
  "error": "OK"
}

Exempel på JSON för utdata - (updateMembers By Id)

{
  "result": "success",
  "relatedFieldsUpdateErrors": [],
  "relatedFieldsUpdateErrorCount": 0,
  "relatedFieldsUpdateSuccessCount": 2,
  "errors": [
    {
      "error": "Specify Id of the census member.",
      "Birthdate": "1985-10-13",
      "Lastname": "WarnerUpdatedById",
      "FirstName": "Steph",
      "Email": "teststephUpdated.com"
    }
  ],
  "censusMemberIds": [
    "0r6RO00000005pZYAQ",
    "0r6RO00000005pbYAA",
    "0r6RO00000005paYAA"
  ],
  "errorCode": "INVOKE-200",
  "error": "OK"
}
 
Laddar
Salesforce Help | Article