Loading
Verzekering
InsCensusServiceStd:updateMembers

U bent hier:

  1. Help van Salesforce
  2. Documenten
  3. Digitale verzekering

InsCensusServiceStd:updateMembers

Gebruik deze service om de waarden van bestaande leden in een telling bij te werken.

Klasse: InsCensusServiceStd​​

Methode: updateMembers

De manier waarop het werkt...

  1. Deze service haalt de leden uit een ingevoerde JSON en werkt de telling (volgens de opgegeven censusId) bij met de nieuwe gegevens.

  2. census JSON bestaat uit twee lijsten - headers en members.

    1. headers is de lijst van metagegevens van velden die bestaat uit fieldId, type, label en name. Hier is de naam de API-naam van het veld (met de naamruimte voor beheerde pakketten en aangepaste velden).

    2. members is de lijst van leden die moeten worden bijgewerkt in de volkstelling.

  3. De service zoekt naar het veld updateById. Het is een booleaans veld dat de handelwijze voor de service bepaalt. De leden kunnen op deze twee manieren worden bijgewerkt:

    1. updateMembers op MemberKey

      Deze optie is van toepassing wanneer updateById false (onwaar) is. De ledengegevens moeten een lidsleutel hebben.

    2. updateMembers op ID van GroupCensusMember

      Deze optie is van toepassing wanneer updateById true (waar) is. De gegevens van de leden moeten een ID van een lid van een groepstelling hebben.

updateMembers by MemberKey

  1. De service parseert de gegevens van de leden met de velden die in headers zijn opgegeven. headers moet alle metagegevens van de velden bevatten die in de lijst van leden worden gebruikt.

  2. De service scheidt primaire leden en afhankelijke leden op basis van RelationshipToPrimaryMember.

    1. Als de ledenlijst primaire leden en afhankelijke personen bevat, moet de invoer SourceSystemIdentifier hebben voor alle leden. Alle leden moeten een unieke SourceSystemIdentifier hebben. Daarnaast moeten alle afhankelijke personen PrimaryMemberSource of PrimaryGroupCensusMemberId hebben (als het primaire lid al aanwezig is in de telling).

    2. Als de lijst een combinatie is van primaire en afhankelijke leden, zorgt u ervoor dat elk afhankelijk lid en elk primair lid voorkomt in de lijst van leden.

  3. De service verwerkt nieuwe GroupClass. Als de service GroupClass.Name in plaats van GroupClassId heeft, haalt deze GroupClass met de naam op en maakt een nieuwe GroupClass met dezelfde naam als deze niet wordt gevonden.

    1. Als de service GroupClass.Name heeft, neemt u ook AccountId op in de gegevens van de leden.

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

    3. Als de opgegeven GroupClass.Name ongeldig is, wordt er een fout geretourneerd. De service gebruikt een nieuwe parameter quoteEffectiveDate om GroupClass te valideren. De GroupClass wordt als geldig beschouwd als:

      • GroupClass is gekoppeld aan de groepsaccount van het lid.

      • quoteEffectiveDate ligt tussen GroupClass StartDate en EndDate. Als quoteEffectiveDate niet is opgegeven als parameter voor de service, wordt deze validatie overgeslagen.

  4. De services verwerken PrimaryMemberSource voor afhankelijken met PrimaryGroupCensusMemberId.

    1. Als de service zowel PrimaryMemberSource als PrimaryGroupCensusMemberId heeft, beschouwt de service PrimaryGroupCensusMemberId als bron en werkt PrimaryMemberSource van afhankelijk bij om SourceSystemIdentifier van primair te bevatten.

  5. De service slaat eerst alle primaire leden op.

  6. Het parseert afhankelijken om weesafhankelijken (afhankelijken zonder PrimaryMemberSource) te identificeren.

  7. Hiermee worden alle geldige afhankelijken opgeslagen.

  8. De service werkt de DependentCount bij van alle primaire leden in de ledenlijst.

updateMembers op ID

  1. De service parseert de gegevens van de leden met de velden die in headers zijn opgegeven. headers moet alle metagegevens van de velden bevatten die in de lijst van leden worden gebruikt.

  2. members moeten ID hebben. Als de ID niet wordt gevonden in lidgegevens, geeft de service een fout.

  3. De service verwerkt nieuwe GroupClass. Als de service GroupClass.Name in plaats van GroupClassId heeft, haalt deze GroupClass met de naam op en maakt een nieuwe GroupClass met dezelfde naam als deze niet wordt gevonden.

    1. Als de service GroupClass.Name heeft, neemt u ook AccountId op in de gegevens van de leden.

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

  4. De service verwerkt PrimaryGroupCensusMemberId voor afhankelijken met PrimaryMemberSource.

    1. Als u PrimaryMemberSource levert, werkt de service ook PrimaryGroupCensusMemberId bij.

  5. De services verwerken PrimaryMemberSource voor afhankelijken met PrimaryGroupCensusMemberId.

    1. Als de service zowel PrimaryMemberSource als PrimaryGroupCensusMemberId heeft, beschouwt de service PrimaryGroupCensusMemberId als bron en werkt PrimaryMemberSource van afhankelijk bij om SourceSystemIdentifier van primair te bevatten.

  6. De service slaat alle leden inclusief afhankelijke personen op.

  7. De service identificeert geen weesafhankelijken.

  8. De service werkt de DependentCount bij van alle primaire leden in de ledenlijst.

Externe opties

Optie

Beschrijving

censusId

Verplicht.

ID van de telling met bij te werken leden.

census

Verplicht.

Voer JSON in met details voor leden die moeten worden bijgewerkt.
updateById

Optioneel

Indien ingesteld op true (waar), volgt service de stroom updateMembers op ID.

De standaardwaarde is false (onwaar).

Servicewerking

Begrijp hoe verschillende invoer van invloed is op de service-uitvoer.

Invoer updateById Service-uitvoer
Nee censusId waar of onwaar

De service retourneert een fout: Specify a censusId.

Geen volkstellingsinvoer-JSON waar of onwaar De service retourneert een fout: The census input is missing.
De waarde van de PrimaryMemberSource die aan het primaire lid is verstrekt false (onwaar) De service retourneert een fout: The PrimaryMemberSource must be null for primary members.
headers ontbreekt in Invoertelling waar of onwaar De service retourneert een fout: The header node is missing in the census input.
members ontbreekt in Invoertelling waar of onwaar De service retourneert een fout: The members node is missing in the census input.
Voor weesafhankelijken (De afhankelijken zonder PrimaryMemberSource of PrimaryGroupCensusMemberId) false (onwaar) De service retourneert een fout: Dependent has no primary member.
ID ontbreekt in gegevens van leden true (waar) De service retourneert een fout: Specify Id of the census member.

Invoer-JSON

De invoer-JSON omvat headers, dat de bij te werken velden vermeldt, en members, dat leden vermeldt met hun overeenkomende veld-waardeparen, inclusief fieldId.

Voorbeeld van invoer-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"
      }
    ]
  }
}

Voorbeeld van invoer-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"
      }
    ]
  }
}

Uitvoer-JSON

De service retourneert het succesbericht als de stroom is voltooid, anders retourneert deze de fout in geval van uitzonderingen.

  • censusMemberIds: De lijst van GroupCensusMemberIds van opgeslagen leden.

  • fouten: De lijst van leden met fouten. Elk lijstitem bestaat uit invoerlidgegevens en fouten.

  • ​ ​ ​ relatedFieldsUpdateSuccessCount: Aantal primaire leden voor wie de DependentCount wordt bijgewerkt door service.

  • ​ ​ ​ relatedFieldsUpdateErrorCount: Aantal primaire leden waarvoor de DependentCount fouten retourneert.

  • relatedFieldsUpdateErrors: De lijst van fouten die worden geretourneerd tijdens het bijwerken van DependentCount van primaire leden.

Voorbeeld van uitvoer-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"
}

Voorbeeld van uitvoer-JSON - (updateMembers op 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"
}
 
Wordt geladen
Salesforce Help | Article