Loading
Forsikring
InsCensusServiceStd:updateMembers

Du er her:

  1. Salesforce Hjelp
  2. Dokumenter
  3. Digital forsikring

InsCensusServiceStd:updateMembers

Bruk denne tjenesten til å oppdatere verdiene for eksisterende medlemmer i en folketelling.

Klasse: InsCensusServiceStd​​

Metode: updateMembers

Slik virker det

  1. Denne tjenesten tar medlemmene fra en inndata JSON og oppdaterer folketellingen (i henhold til gitt censusId) med de nye dataene.

  2. JSON består av to lister - headers og members.

    1. headers er en liste over feltets metadata som består av fieldId, type, label og name. Her er navnet feltets API-navn (med navneområdet for administrert pakke og tilpassede felt).

    2. members er listen over medlemmer som skal oppdateres i folketellingen.

  3. Tjenesten ser etter updateById-felt. Det er et boolsk felt som bestemmer handlingsplanen for tjenesten. Medlemmene kan oppdateres på disse to måtene:

    1. updateMembers av MemberKey

      Dette alternativet gjelder når updateById er usann. Medlemsdataene må ha en medlemsnøkkel.

    2. updateMembers by Id of GroupCensusMember

      Dette alternativet gjelder når updateById er sann. Medlemsdataene må ha ID for gruppebestemmelsesmedlem.

updateMembers by MemberKey

  1. Tjenesten analyserer medlemmenes data med feltene i headers. headers må inneholde alle feltets metadata som brukes i medlemslisten.

  2. Tjenesten skiller primære medlemmer og avhengige medlemmer basert på RelationshipToPrimaryMember.

    1. Hvis medlemslisten inneholder primære medlemmer og avhengige, må inndataene ha SourceSystemIdentifier for alle medlemmene. Alle medlemmer må ha en unik SourceSystemIdentifier. I tillegg må alle avhengige ha PrimaryMemberSource eller PrimaryGroupCensusMemberId (hvis det primære medlemmet allerede er til stede i folketellingen).

    2. Hvis listen er en kombinasjon av primære og avhengige medlemmer, må du forsikre deg om at alle avhengige medlemmer og primære medlemmer finnes i medlemslisten.

  3. Tjenesten behandler nye GroupClass. Hvis tjenesten har GroupClass.Name i stedet for GroupClassId, henter den GroupClass med navnet og oppretter en ny GroupClass med samme navn hvis den ikke blir funnet.

    1. Hvis tjenesten har GroupClass.Name, inkluderer du også AccountId i medlemmenes data.

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

    3. Hvis den gitte GroupClass.Name er ugyldig, returneres det en feil. Tjenesten bruker en ny parameter quoteEffectiveDate for å validere GroupClass. GroupClass anses som gyldig hvis

      • GroupClass er knyttet til medlemmets gruppekonto.

      • quoteEffectiveDate ligger mellom GroupClass StartDate og EndDate. Hvis quoteEffectiveDate ikke oppgis som en parameter til tjenesten, hoppes denne valideringen over.

  4. Tjenestene behandler PrimaryMemberSource for avhengige med PrimaryGroupCensusMemberId.

    1. Hvis tjenesten har både PrimaryMemberSource og PrimaryGroupCensusMemberId, vurderer tjenesten PrimaryGroupCensusMemberId som kilde og oppdaterer PrimaryMemberSource av avhengig til å inneholde SourceSystemIdentifier av primær.

  5. Tjenesten lagrer alle primære medlemmer først.

  6. Den analyserer avhengige for å identifisere foreldreløse avhengige (avhengige uten PrimaryMemberSource).

  7. Den lagrer alle gyldige avhengige.

  8. Tjenesten oppdaterer DependentCount for alle primære medlemmer i medlemslisten.

updateMembers by Id (oppdateringsmedlemmer etter ID)

  1. Tjenesten analyserer medlemmenes data med feltene i headers. headers må inneholde alle feltets metadata som brukes i medlemslisten.

  2. members må ha Id. Hvis ID-en ikke blir funnet i medlemsdata, utløser tjenesten en feil.

  3. Tjenesten behandler nye GroupClass. Hvis tjenesten har GroupClass.Name i stedet for GroupClassId, henter den GroupClass med navnet og oppretter en ny GroupClass med samme navn hvis den ikke blir funnet.

    1. Hvis tjenesten har GroupClass.Name, inkluderer du også AccountId i medlemmenes data.

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

  4. Tjenesten behandler PrimaryGroupCensusMemberId for avhengige med PrimaryMemberSource.

    1. Hvis du oppgir PrimaryMemberSource, oppdaterer tjenesten også PrimaryGroupCensusMemberId.

  5. Tjenestene behandler PrimaryMemberSource for avhengige med PrimaryGroupCensusMemberId.

    1. Hvis tjenesten har både PrimaryMemberSource og PrimaryGroupCensusMemberId, vurderer tjenesten PrimaryGroupCensusMemberId som kilde og oppdaterer PrimaryMemberSource av avhengig til å inneholde SourceSystemIdentifier av primær.

  6. Tjenesten lagrer alle medlemmer, inkludert avhengige.

  7. Tjenesten identifiserer ikke foreldreløse avhengige.

  8. Tjenesten oppdaterer DependentCount for alle primære medlemmer i medlemslisten.

Eksterne alternativer

Alternativ

Beskrivelse

censusId

Obligatorisk.

ID-en til folketellingen med medlemmer som skal oppdateres.

census

Obligatorisk.

Inndata-JSON-kode med detaljer om at medlemmer skal oppdateres.
updateById

Valgfritt

Hvis angitt til true, følger service updateMembers etter Id-flyt.

Standardverdien er false.

Virkemåte for service

Forstå hvordan forskjellige inndata påvirker tjenesteutdataene.

Inndata updateById Tjenesteutdata
Nei censusId true eller false

Tjenesten returnerer en feil: Specify a censusId.

Ingen JSON-kode for folketelling true eller false Tjenesten returnerer en feil: The census input is missing.
Verdien av PrimaryMemberSource som gis til primære medlemmer false Tjenesten returnerer en feil: The PrimaryMemberSource must be null for primary members.
headers mangler i inndatacensus true eller false Tjenesten returnerer en feil: The header node is missing in the census input.
members mangler i inndatacensus true eller false Tjenesten returnerer en feil: The members node is missing in the census input.
For foreldreløse avhengige (Avhengige uten PrimaryMemberSource eller PrimaryGroupCensusMemberId) false Tjenesten returnerer en feil: Dependent has no primary member.
Id mangler i medlemmets data true Tjenesten returnerer en feil: Specify Id of the census member.

Inndata-JSON

JSON-koden inkluderer headers, som viser feltene som skal oppdateres, og members, som viser medlemmer med sine tilsvarende felt-verdi-par, inkludert fieldId.

Eksempel på inndata-JSON (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"
      }
    ]
  }
}

Eksempel på inndata-JSON (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"
      }
    ]
  }
}

Utdata-JSON

Tjenesten returnerer meldingen om vellykket utførelse hvis flyten er fullført, ellers returnerer den feilen i tilfelle det oppstår unntak.

  • censusMemberIds: Listen over GroupCensusMemberIds av lagrede medlemmer.

  • feil: Listen over medlemmer med feil. Hvert listeelement består av inndata og feil.

  • ​ ​ ​ relatedFieldsUpdateSuccessCount: Antall primære medlemmer som DependentCount oppdateres for etter tjeneste.

  • ​ ​ ​ relatedFieldsUpdateErrorCount: Antall primære medlemmer som DependentCount-oppdateringen returnerer feil for.

  • relatedFieldsUpdateErrors: Listen over feil som returneres ved oppdatering av DependentCount av primære medlemmer.

Eksempel på utdata-JSON (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"
}

Eksempel på utdata-JSON - (updateMembers etter 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"
}
 
Laster
Salesforce Help | Article