Sie befinden sich hier:
InsCensusServiceStd:addMembers
Verwenden Sie diesen Service, um Gruppenzählungsmitglieder mithilfe einer Eingabe-JSON einer Gruppenzählung hinzuzufügen.
Klasse: InsCensusServiceStd
Methode: addMembers
Funktionsweise
Der Service verwendet die Mitglieder in der JSON-Zähleingabe und fügt sie den angegebenen censusId hinzu. Es gibt eine Liste der IDs der hinzugefügten Mitglieder zurück ( censusMemberIds ).
Der Service analysiert die Mitgliedsdaten.
Parst die Daten der Mitglieder mit den in Kopfzeilen bereitgestellten Feldern. Kopfzeilen müssen alle Metadaten der Felder enthalten, die in den Mitgliederlisten verwendet werden.
Trennt primäre Mitglieder und abhängige Mitglieder anhand von
RelationshipToPrimaryMember. Wenn die Mitgliederliste primäre Mitglieder und abhängige Mitglieder enthält, muss die EingabeSourceSystemIdentifierfür alle Mitglieder aufweisen. Alle Mitglieder müssen über eindeutigeSourceSystemIdentifierverfügen. Zusätzlich müssen alle Angehörigen überPrimaryMemberSourceoderPrimaryGroupCensusMemberIdverfügen (wenn das primäre Mitglied bereits in den Zählungen vorhanden ist).Generiert
MemberKey.Verarbeitet neue
GroupClass. Wenn Service anstelle vonGroupClassIdGroupClass.Namewird, ruft der ServiceGroupClassmit dem Namen ab und erstellt eine neueGroupClassmit demselben Namen, sofern sie nicht gefunden wird. Die Kopfzeile fürGroupClass.Name lautet {"type":"STRING","label":"Group Class Name","fieldId":"","name":"GroupClass.Name"}. Wenn die angegebeneGroupClass.Nameungültig ist, wird ein Fehler zurückgegeben. Der Service verwendet einen neuen ParameterquoteEffectiveDate, umGroupClasszu validieren. DieGroupClassgilt in folgenden Fällen als gültig:Hinweis WennGroupClass.Nameangegeben ist, sollten Sie auchAccountIdin die Daten der Mitglieder aufnehmen.GroupClassist mit dem Gruppenaccount des Mitglieds verknüpft.quoteEffectiveDateliegt zwischenGroupClassStartDateundEndDate. WennquoteEffectiveDatenicht als Parameter für den Service angegeben wird, wird diese Validierung übersprungen.
Verarbeitet
PrimaryMemberSourcefür Angehörige mitPrimaryGroupCensusMemberId. Wenn sowohlPrimaryMemberSourceals auchPrimaryGroupCensusMemberIdin den Mitgliedsdaten angegeben sind, verwendet der ServicePrimaryGroupCensusMemberIdals Quelle und aktualisiert diePrimaryMemberSourcevon dependent so, dass sieSourceSystemIdentifiervon primary enthalten.
Speichert alle primären Mitglieder. Der Service verwendet
MemberKeyzum Identifizieren von Duplikaten. Wenn ein doppeltes Mitglied vorhanden ist, aktualisiert der Service die Felder dieses bereits vorhandenen Mitglieds. DieMemberKeymuss eine eindeutige Kombination von Zeichenfolgen sein.Vergleicht Abhängigkeiten, um verwaiste Angehörige zu identifizieren (Abhängige ohne
PrimaryMemberSource).Speichert alle gültigen abhängigen Personen. Der Service verwendet
MemberKeyzum Identifizieren von Duplikaten. Wenn ein doppelter Mitgliedsdatensatz vorhanden ist, aktualisiert der Service die Felder dieses bereits vorhandenen Mitglieds, statt einen neuen Datensatz zu erstellen.Aktualisiert die
DependentCountaller primären Mitglieder in der Mitgliederliste.
Serviceverhalten
Erfahren Sie, wie sich unterschiedliche Eingaben auf die Serviceausgaben auswirken.
| 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. |
Remote-Optionen
Option |
Beschreibung |
|---|---|
|
Pflichtangabe. ID der Gruppenzählung, der Mitglieder hinzugefügt werden sollen. |
|
Pflichtangabe. Eingabe-JSON der hinzuzufügenden Mitglieder. Die JSON-Zählung besteht aus zwei Listen – Kopfzeilen und Mitgliedern. headers ist die Liste der Metadaten von Feldern, die fieldId, type, label und name umfassen. Der Name hier ist der API-Name des Felds (mit Namespace für verwaltete Pakete und benutzerdefinierte Felder). members ist die Liste der Mitglieder, die der Zählung hinzugefügt werden sollen. |
duplicateKey
|
Optional. Liste der Felder zum Generieren von |
Input JSON
Die Eingabe-JSON besteht aus zwei Listen – Kopfzeilen und Mitgliedern. headers ist die Liste der Metadaten von Feldern, die fieldId, type, label und name umfassen. Der Name hier ist der API-Name des Felds (mit Namespace für verwaltete Pakete und benutzerdefinierte Felder). members ist die Liste der Mitglieder, die der Zählung hinzugefügt werden sollen.
{
"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": [
{
"Lastname": "Koffins",
"FirstName": "Raj",
"FullTimeEquivalent": 1,
"Gender": "Male",
"Birthdate": "1985-10-13",
"SourceSystemIdentifier": "1.primary",
"PrimaryMemberSource": null,
"Email": "testraj@mail.com",
"AccountId":"001B000001QOqJHIA1",
"IsOptOutAllPlans":true,
"OptOutPlanTypes":"Medical;Dental"
},
{
"Lastname": "Koffins",
"FirstName": "Rita",
"Gender": "Female",
"Birthdate": "1987-07-13",
"RelationshipToPrimaryMember": "Spouse",
"SourceSystemIdentifier": "1.spouse",
"PrimaryMemberSource": null,
"Email": "testrita@mail.com",
"AccountId":"001B000001QOqJHIA1",
"IsOptOutAllPlans":true,
"OptOutPlanTypes":"Medical;Dental"
},
{
"Lastname": "Koffins",
"FirstName": "Kris",
"Gender": "Male",
"Birthdate": "2016-05-13",
"RelationshipToPrimaryMember": "Child",
"SourceSystemIdentifier": "1.child",
"PrimaryMemberSource": "1.primary",
"Email": "testkris@mail.com",
"AccountId":"001B000001QOqJHIA1",
"IsOptOutAllPlans":true,
"OptOutPlanTypes":"Medical;Dental"
},
{
"Lastname": "Warner",
"FirstName": "Christopher",
"FullTimeEquivalent": 0.5,
"Gender": "Male",
"Birthdate": "1985-10-13",
"SourceSystemIdentifier": "2.primary",
"PrimaryMemberSource": null,
"Email": "testchristopher@mail.com",
"AccountId":"001B000001QOqJHIA1",
"IsOptOutAllPlans":false,
"OptOutPlanTypes":"Medical"
},
{
"Lastname": "Warner",
"FirstName": "Steph",
"Gender": "Male",
"Birthdate": "1985-10-13",
"RelationshipToPrimaryMember": "Spouse",
"SourceSystemIdentifier": "2.spouse",
"PrimaryMemberSource": "2.primary",
"Email": "teststeph@mail.com",
"AccountId":"001B000001QOqJHIA1",
"IsOptOutAllPlans":false,
"OptOutPlanTypes":"Medical"
},
{
"Lastname": "Jose",
"FirstName": "Steve",
"Gender": "Male",
"Birthdate": "1989-10-13",
"FullTimeEquivalent":10,
"SourceSystemIdentifier": "3.primary",
"Email": "teststeve@mail.com",
"AccountId":"001B000001QOqJHIA1",
"IsOptOutAllPlans":false,
"OptOutPlanTypes":"Medical"
}
]
}
}
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 derGroupCensusMemberIdsder 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 dieDependentCountnach Service aktualisiert wird. -
relatedFieldsUpdateErrorCount: Anzahl der primären Mitglieder, für die dieDependentCountFehler zurückgibt. -
relatedFieldsUpdateErrors: Die Liste der Fehler, die beim Aktualisieren derDependentCountder primären Mitglieder zurückgegeben wurden.
{
"result": "success",
"relatedFieldsUpdateErrors": [],
"relatedFieldsUpdateErrorCount": 0,
"relatedFieldsUpdateSuccessCount": 2,
"errors": [
{
"error": "[FullTimeEquivalent]: NUMBER_OUTSIDE_VALID_RANGE - Full Time Equivalent: value outside of valid range on numeric field: 10",
"Birthdate": "1989-10-13",
"Gender": "Male",
"IsOptOutAllPlans": false,
"Lastname": "Jose",
"SourceSystemIdentifier": "3.primary",
"FullTimeEquivalent": 10,
"FirstName": "Steve",
"AccountId": "001B000001QOqJHIA1",
"Email": "teststeve@mail.com",
"OptOutPlanTypes": "Medical"
},
{
"RelationshipToPrimaryMember": "Spouse",
"SourceSystemIdentifier": "1.spouse",
"OptOutPlanTypes": "Medical;Dental",
"PrimaryMemberSource": null,
"error": "Dependent has no primary member.",
"Birthdate": "1987-07-13",
"Gender": "Female",
"IsOptOutAllPlans": true,
"Lastname": "Koffins",
"FirstName": "Rita",
"AccountId": "001B000001QOqJHIA1",
"Email": "testrita@mail.com"
}
],
"censusMemberIds": [
"0r6B00000000ANcIAM",
"0r6B00000000ANdIAM",
"0r6B00000000ANeIAM",
"0r6B00000000ANfIAM"
],
"errorCode": "INVOKE-200",
"error": "OK"
}
