InsCensusServiceStd:updateMembersWithPlans

Verwenden Sie diesen Service, um eine Gruppenzählung mit primären Mitgliedern, ihren Angehörigen und ihrem vorab registrierten Plan auszufüllen. Dieser Service aktualisiert vorhandene GroupCensusMember nach memberKey und erstellt GroupCensusMemberPlan für vorhandene GroupCensusMember. Sie verwendet die in der Eingabe-JSON angegebene ContractGroupPlans, um Pläne für jede GroupCensusMember zu aktualisieren.

Klasse: InsCensusServiceStd

Methode: updateMembersWithPlans

Funktionsweise

Der Service übergibt censusId und die JSON der Volkszählungseingabe, um Mitglieder mit Plänen zu aktualisieren.
Die JSON-Zählung besteht aus zwei Listen: headers und members.
1. headers ist die Liste der Metadaten von Feldern, die aus fieldId, type, label und name besteht. Der Name hier ist der API-Name des Felds (mit dem Namespace für verwaltete Pakete und benutzerdefinierte Felder). Der headers muss ContactGroupPlanId. enthalten
2. members ist die Liste der Mitglieder, die bei der Zählung aktualisiert werden sollen. Die members muss für mehrere Pläne durch Semikolon(;) getrennte ContactGroupPlanId enthalten.
Der Service ruft updateMembers by MemberKey auf, um Daten über die Mitglieder zu speichern, indem er die Mitglieder im JSON-Objekt analysiert.
Der Service fügt für alle neuen Mitglieder isNewMember als wahr hinzu. It also populates Id for each GroupCensusMember.
Anschließend ruft der Service InsCensusServiceStd: addPlanSelections auf, um GroupCensusMemberPlan für jedes Mitglied zu erstellen. Sie akzeptiert auch optionale Abdeckungen pro Mitglied, sodass primäre Mitglieder und Angehörige für unterschiedliche Abdeckungen unter demselben Plan registriert werden.

updateMembers by MemberKey

Der Service analysiert die Daten der Mitglieder mit den in headers angegebenen Feldern. headers muss alle Metadaten der Felder enthalten, die in der Liste der Mitglieder verwendet werden.
Der Service trennt primäre Mitglieder und abhängige Mitglieder anhand von RelationshipToPrimaryMember.
1. Wenn die Mitgliederliste primäre Mitglieder und abhängige Mitglieder enthält, muss die Eingabe SourceSystemIdentifier für alle Mitglieder aufweisen. Alle Mitglieder müssen über eine eindeutige SourceSystemIdentifier verfügen. Zusätzlich müssen alle abhängigen Personen über PrimaryMemberSource oder PrimaryGroupCensusMemberId verfügen (wenn das primäre Mitglied bereits in der Zählung vorhanden ist).
2. Wenn es sich bei der Liste um eine Kombination aus primären und abhängigen Mitgliedern handelt, stellen Sie sicher, dass alle abhängigen Mitglieder und primären Mitglieder in der Mitgliederliste vorhanden sind.
Der Service verarbeitet neue GroupClass. Wenn der Service GroupClass.Name anstelle von GroupClassId aufweist, wird GroupClass mit dem Namen abgerufen und ein neuer GroupClass mit demselben Namen erstellt, sofern er nicht gefunden wird.
1. Wenn der Service über GroupClass.Name verfügt, schließen Sie auch AccountId in die Daten der Mitglieder ein.
2. header fürGroupClass.Name: {"type":"STRING","label":"Group Class Name","fieldId":"","name":"GroupClass.Name"} hinzu.
3. Wenn die angegebene GroupClass ungültig ist, wird ein Fehler zurückgegeben. Die GroupClass gilt in folgenden Fällen als gültig:
  - GroupClass ist mit dem Gruppenaccount des Mitglieds verknüpft.
  - Die Vertragslaufzeit liegt zwischen dem StartDate und dem EndDate des GroupClass.
  - Die StartDate und EndDate des Vertrags werden mithilfe der als Eingabe für den Service bereitgestellten ContractId abgerufen.
Die Services verarbeiten PrimaryMemberSource für Angehörige mit PrimaryGroupCensusMemberId.
1. Wenn der Service sowohl über PrimaryMemberSource als auch über PrimaryGroupCensusMemberId verfügt, betrachtet der Service PrimaryGroupCensusMemberId als Quelle und aktualisiert die PrimaryMemberSource von dependent so, dass sie SourceSystemIdentifier von primary enthalten.
Der Service speichert zuerst alle primären Mitglieder.
Sie analysiert Angehörige, um verwaiste Angehörige zu identifizieren (Abhängige ohne PrimaryMemberSource).
Dadurch werden alle gültigen abhängigen Personen gespeichert.
Der Service aktualisiert die DependentCount aller primären Mitglieder in der Mitgliederliste.

Remote-Optionen

Option	Beschreibung
`censusId`	Erforderlich ID der Volkszählung mit Mitgliedern, die aktualisiert werden sollen. Stellt sicher, dass die `contractId` zum Account/Zensus gehört.
`census`	Pflichtangabe. Eingabe-JSON mit Details zu aktualisierenden Mitgliedern.
`contractId`	Erforderlich ID des aktuellen Vertrags des Accounts. Überprüft, ob die Pläne der einzelnen Mitglieder Teil des Vertrags sind.
`onlySaveMembersWithValidProducts`	Boolean (Boolesch) Bei true werden neue Mitglieder ohne Einträge in `GroupCensusMemberPlan` gelöscht.
`duplicateKeys`	Optional Liste der Felder für die `MemberKey` zur Identifizierung vorhandener Mitglieder. Standardfelder in der Liste: `FirstName`, `Lastname`, `Email`, `GroupCensusId`.

Eingabe	Serviceausgabe
Nein `censusId`	Der Service gibt einen Fehler zurück: `Specify a censusId.`
Keine JSON für Zensuseingaben	Der Service gibt einen Fehler zurück: `The census input is missing.`
`PrimaryMemberSource` Wert, der dem primären Mitglied bereitgestellt wird	Der Service gibt einen Fehler zurück: `The PrimaryMemberSource must be null for primary members.`
`headers` fehlt bei Eingabezählung	Der Service gibt einen Fehler zurück: `The header node is missing in the census input.`
`members` fehlt bei Eingabezählung	Der Service gibt einen Fehler zurück: `The members node is missing in the census input.`
Für verwaiste Angehörige (die Angehörigen ohne `PrimaryMemberSource` oder `PrimaryGroupCensusMemberId`)	Der Service gibt einen Fehler zurück: `Dependent has no primary member.`
Keine contractId oder ungültige contractId	Der Service aktualisiert keinen Mitgliedsplan.
Ungültige `ContractGroupPlanId` für den angegebenen Vertrag	Der Service erstellt keinen Mitgliedsplan. Wenn `onlySaveMembersWithValidProducts` wahr ist und das Mitglied neu ist, führt der Service Folgendes aus: Löscht das Mitglied ohne gültige Pläne. Erstellt ein Mitglied, wenn es über mindestens einen gültigen Plan verfügt.
Ungültige `ContractGroupPlanId` für das Mitglied (wegen Abmeldung)	Mitgliedsplan wird nicht erstellt Wenn `onlySaveMembersWithValidProducts` wahr ist und das Mitglied neu ist, führt der Service Folgendes aus: Löscht das Mitglied ohne gültige Pläne. Erstellt ein Mitglied, wenn es über mindestens einen gültigen Plan verfügt.
Das primäre Mitglied meldet sich von einem Produkttyp ab	`IsOptOutAllPlans` hat Vorrang, gefolgt von `OptOutPlanTypes` Wenn `IsOptOutAllPlans` = true ist, erstellt der Service keinen Mitgliedsplan, selbst wenn Sie ein Produkt für die Registrierung angeben. Wenn `IsOptOutAllPlans` = false ist und ein Produkt für die Mitgliederregistrierung angegeben ist, sein Produkttyp jedoch mit dem Abmeldeeintrag übereinstimmt, erstellt der Service keinen Mitgliedsplan. Wenn sich das primäre Mitglied von einem Produkttyp abmeldet, werden die abhängigen Mitglieder auch von diesem Produkttyp abgemeldet.
Abhängiges Mitglied meldet sich von einem Produkttyp ab	`IsOptOutAllPlans` hat Vorrang, gefolgt von `OptOutPlanTypes` Wenn `IsOptOutAllPlans` = true ist, erstellt der Service keinen Mitgliedsplan, selbst wenn Sie ein Produkt für die Registrierung angeben. Wenn `IsOptOutAllPlans` = false ist und ein Produkt für die Mitgliederregistrierung angegeben ist, sein Produkttyp jedoch mit dem Abmeldeeintrag übereinstimmt, erstellt der Service keinen Mitgliedsplan. Wenn sich das primäre Mitglied von einem Produkttyp abmeldet, werden die abhängigen Mitglieder auch von diesem Produkttyp abgemeldet. Wenn `IsOptOutAllPlans` = true für ein primäres Mitglied ist, gilt dieselbe Ausgabe für die zugeordneten abhängigen Mitglieder.

Input JSON

So sieht das Format für die Eingabe-JSON aus:

{
  "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"
      },
      {
        "type": "ENTITYID",
        "label": "Contract Group Plan",
        "fieldId": "",
        "name": "ContractGroupPlanId"
      }    
    ],
    "members": [
      {
        "MemberKey": "cd64a62573825ee11b87ce91110aa576",
        "Lastname": "KoffinsUpdated",
        "FirstName": "RajUpdated",
        "FullTimeEquivalent": 1,
        "Gender": "Male",
        "Birthdate": "1965-10-13",
        "SourceSystemIdentifier": "1.primary",
        "PrimaryMemberSource": null,
        "Email": "testrajUpdated@mail.com",
        "ContractGroupPlanId":"a4D4P000000hbjSUAQ;a4D4P000000hbjSUAQ"      
      },
      {
        "MemberKey": "f2f8735bbb66b3f7d7b2bae794c00650",
        "Lastname": "Koffins",
        "FirstName": "KrisUpdated",
        "Gender": "Male",
        "Birthdate": "2010-05-13",
        "RelationshipToPrimaryMember": "Child",
        "SourceSystemIdentifier": "1.child",
        "PrimaryMemberSource": "1.primary",
        "Email": "testkrisUpdated@mail.com",
        "ContractGroupPlanId":"a4D4P000000hbjSUAQ;a4D4P000000hbjSUAQ"      
      },
      {
        "Lastname": "WarnerUpdated",
        "MemberKey": "5a5bc4e3c05cf461a65a2d7fdc0ab8e0",
        "FirstName": "Christopher",
        "FullTimeEquivalent": 0.75,
        "Gender": "Male",
        "Birthdate": "1985-10-13",
        "SourceSystemIdentifier": "2.primary",
        "PrimaryMemberSource": null,
        "Email": "testchristopherUpdated@mail.com",
        "ContractGroupPlanId":"a4D4P000000hbjSUAQ;a4D4P000000hbjSUAQ"
      },
      {
        "Lastname": "WarnerUpdated",
        "MemberKey": "157b2052fc732d8261984c2922a3261b",
        "FirstName": "Steph",
        "Gender": "Male",
        "Birthdate": "1985-10-13",
        "RelationshipToPrimaryMember": "Spouse",
        "SourceSystemIdentifier": "2.spouse",
        "PrimaryMemberSource": "2.primary",
        "Email": "teststephUpdated.com",
        "ContractGroupPlanId":"a4D4P000000hbjSUAQ;a4D4P000000hbjSUAQ"
      }
    ]
  }
}

Ausgabe-JSON

Der Service gibt eine Erfolgsmeldung zurück, wenn der Flow abgeschlossen ist. Andernfalls wird der Fehler im Falle von Ausnahmen zurückgegeben.

censusMemberIds: Die Liste der GroupCensusMemberIds der gespeicherten Mitglieder.
Fehler: Die Liste der Mitglieder mit Fehlern. Jedes Listenelement besteht aus Eingabemitgliedsdaten und Fehlern.
relatedFieldsUpdateSuccessCount: Anzahl der primären Mitglieder, für die die DependentCount nach Service aktualisiert wird.
relatedFieldsUpdateErrorCount: Anzahl der primären Mitglieder, für die die DependentCount Fehler zurückgibt.
relatedFieldsUpdateErrors: Die Liste der Fehler, die beim Aktualisieren der DependentCount der primären Mitglieder zurückgegeben wurden.
memberPlanIds: Die Liste der erfolgreich eingefügten GroupCensusMemberPlanIds.

{
  "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",
      "ContractGroupPlanId":"a4D4P000000hbjSUAQ;a4D4P000000hbjSUAQ"
    }
  ],
  "censusMemberIds": [
    "0r6RO00000005pZYAQ",
    "0r6RO00000005paYAA",
    "0r6RO00000005pbYAA"
  ],
  "memberPlanIds":[
    "a4B4P000006jKsMUAU",
    "a4B4P000006jKsNUAU",
    "a4B4P000006jKsOUAU",
    "a4B4P000006jKsPUAU",
    "a4B4P000006jKsQUAU",
    "a4B4P000006jKsRUAU"
  ],
  "errorCode": "INVOKE-200",
  "error": "OK"
}

Konnten Sie Ihr Problem mithilfe dieses Artikels lösen?

Geben Sie uns Feedback, damit wir uns verbessern können.

Dieser Text wurde mit dem maschinellen Übersetzungssystem von Salesforce übersetzt. Weitere Details finden Sie hier.

InsCensusServiceStd:updateMembersWithPlans

Funktionsweise

updateMembers by MemberKey

Remote-Optionen

Input JSON

Ausgabe-JSON

General Information

Required Cookies

Functional Cookies

Advertising Cookies

General Information

Required Cookies

Functional Cookies

Advertising Cookies

Cookie List

Dieser Text wurde mit dem maschinellen Übersetzungssystem von Salesforce übersetzt. Weitere Details finden Sie hier.Zu Englisch wechselnNicht jetzt

Produktbereich

Auswirkungen auf Funktionen

Edition

Erfahrung

InsCensusServiceStd:updateMembersWithPlans

Funktionsweise

updateMembers by MemberKey

Remote-Optionen

Input JSON

Ausgabe-JSON

Dieser Text wurde mit dem maschinellen Übersetzungssystem von Salesforce übersetzt. Weitere Details finden Sie hier.