InsCensusServiceStd:updateMembers

Sie befinden sich hier:

InsCensusServiceStd:updateMembers

Verwenden Sie diesen Service, um die Werte vorhandener Mitglieder in einer Zählung zu aktualisieren.

Klasse: InsCensusServiceStd

Methode: updateMembers

Funktionsweise

Dieser Service verwendet die Mitglieder aus einer Eingabe-JSON und aktualisiert die Zählung (gemäß den angegebenen censusId) mit den neuen Daten.
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).
2. members ist die Liste der Mitglieder, die bei der Zählung aktualisiert werden sollen.
Der Service sucht nach dem updateById. Hierbei handelt es sich um ein boolesches Feld, das die Vorgehensweise für den Service bestimmt. Die Mitglieder können auf folgende zwei Arten aktualisiert werden:
1. updateMembers von MemberKey
  
  Diese Option gilt, wenn updateById false ist. Die Mitgliederdaten müssen über einen Mitgliedsschlüssel verfügen.
2. updateMembers nach ID des GroupCensusMember
  
  Diese Option gilt, wenn updateById wahr ist. Die Mitgliederdaten müssen über eine ID des Gruppenzählungsmitglieds verfügen.

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.Name ungültig ist, wird ein Fehler zurückgegeben. Der Service verwendet einen neuen Parameter quoteEffectiveDate, um GroupClass zu validieren. Die GroupClass gilt in folgenden Fällen als gültig:
  - GroupClass ist mit dem Gruppenaccount des Mitglieds verknüpft.
  - quoteEffectiveDate liegt zwischen GroupClass StartDate und EndDate. Wenn quoteEffectiveDate nicht als Parameter für den Service bereitgestellt wird, wird diese Validierung übersprungen.
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.

updateMembers by Id (Mitglieder nach ID aktualisieren)

Der Service analysiert die Daten der Mitglieder mit den in headers angegebenen Feldern. headers muss alle Metadaten der Felder enthalten, die in der Mitgliederliste verwendet werden.
members müssen über eine ID verfügen. Wenn die ID in den Mitgliedsdaten nicht gefunden wird, gibt der Service einen Fehler aus.
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.
Der Service verarbeitet PrimaryGroupCensusMemberId für Angehörige mit PrimaryMemberSource.
1. Wenn Sie PrimaryMemberSource bereitstellen, aktualisiert der Service auch die PrimaryGroupCensusMemberId.
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 alle Mitglieder, einschließlich der Angehörigen.
Der Service identifiziert keine verwaisten Angehörigen.
Der Service aktualisiert die DependentCount aller primären Mitglieder in der Mitgliederliste.

Remote-Optionen

Option	Beschreibung
`censusId`	Pflichtangabe. ID der Volkszählung mit Mitgliedern, die aktualisiert werden sollen.
`census`	Pflichtangabe. Eingabe-JSON mit Details zu aktualisierenden Mitgliedern.
`updateById`	Optional Wenn "true" festgelegt ist, folgt der Service dem Flow "`updateMembers` by Id". Der Standardwert lautet "false".

Option

Beschreibung

censusId

Pflichtangabe.

ID der Volkszählung mit Mitgliedern, die aktualisiert werden sollen.

census

Pflichtangabe.

Eingabe-JSON mit Details zu aktualisierenden Mitgliedern.

updateById

Optional

Wenn "true" festgelegt ist, folgt der Service dem Flow "updateMembers by Id".

Der Standardwert lautet "false".

Serviceverhalten

Erfahren Sie, wie sich unterschiedliche Eingaben auf die Serviceausgaben auswirken.

Eingabe	updateById	Serviceausgabe
Nein `censusId`	true oder false	Der Service gibt einen Fehler zurück: `Specify a censusId.`
Keine JSON für Zensuseingaben	true oder false	Der Service gibt einen Fehler zurück: `The census input is missing.`
Der Wert der dem primären Mitglied bereitgestellten `PrimaryMemberSource`	false	Der Service gibt einen Fehler zurück: `The PrimaryMemberSource must be null for primary members.`
`headers` fehlt bei Eingabezählung	true oder false	Der Service gibt einen Fehler zurück: `The header node is missing in the census input.`
`members` fehlt bei Eingabezählung	true oder false	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)	false	Der Service gibt einen Fehler zurück: `Dependent has no primary member.`
ID fehlt in den Daten der Mitglieder	true	Der Service gibt einen Fehler zurück: `Specify Id of the census member.`

Input JSON

Die Eingabe-JSON enthält headers, in dem die zu aktualisierenden Felder aufgeführt sind, und members, in dem Mitglieder mit ihren entsprechenden Feldwertpaaren, einschließlich fieldId, aufgeführt sind.

Beispiel-Eingabe-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"
      }
    ]
  }
}

Beispiel-Eingabe-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"
      }
    ]
  }
}

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.

Beispielausgabe-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"
}

Beispielausgabe-JSON – (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"
}

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:updateMembers

Funktionsweise

updateMembers by MemberKey

updateMembers by Id (Mitglieder nach ID aktualisieren)

Remote-Optionen

Serviceverhalten

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:updateMembers

Funktionsweise

updateMembers by MemberKey

updateMembers by Id (Mitglieder nach ID aktualisieren)

Remote-Optionen

Serviceverhalten

Input JSON

Ausgabe-JSON

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