Olet tässä:
InsCensusServiceStd:getMembersWithPlans
Käytä tätä palvelua noutaaksesi tietyn censusId määrityksen jäsenten luettelon. Palvelu noutaa ContractGroupPlanIds-arvon vastaavasti näiltä väestönlaskentajäseniltä GroupCensusMemberPlan:sta. Palvelu noutaa myös ylätunnisteet niiden fieldsetName ja planFieldsetName perusteella.
Luokka: InsCensusServiceStd
Metodi: getMembersWithPlans
Miten se toimii?
Tällä palvelulla on kaksi avaintoimintoa:
- Hakee
GroupCensusMember- jaGroupCensusMemberPlan-kenttien luettelon.Palvelu noutaa
GroupCensusMember-kenttien luettelon parametrinfieldsetNameavulla. Jos arvoa ei ole, kentät noudetaan oletusarvoisesta kenttäjoukosta. Jos syötetty arvo ei löydä vastaavuutta, kenttiä ei noudeta.Palvelu noutaa
GroupCensusMemberPlan-kenttien luettelon parametrinplanFieldsetNameavulla. Jos arvoa ei ole, kaikki kentät noudetaan. Jos syötetty arvo ei löydä vastaavuutta, kenttiä ei noudeta.Hakee suhdekenttiä, jotka on yhdistetty JSON-otsikot-noodiin, vaikka näitä kenttiä ei sisällytettäisiin
fieldsetName. Nämä kentät ovat:PrimaryGroupCensusMemberId,RelationshipToPrimaryMember,SourceSystemIdentifierjaPrimaryMemberSource.Jos
-parametrillä on arvo, se täyttää sopimuksen rivitietueiden luettelon sopimuksen seuraavilla tiedoilla:contractGroupPlanIdSopimusryhmän suunnitelman nimi
Tuotetyyppi
Sopimusryhmän suunnitelmien tunnus
-
Palvelu käyttää
censusId-funktiota noutaakseen määrityksen jäsenten luettelon kunkin jäsenenGroupCensusMember-tietueista ja sopimusryhmien suunnitelmistaGroupCensusMemberPlan-tietueesta.-
Jos offset-arvolla on arvo, se noutaa ensisijaiset
GroupCensusMember-rivit (tunnuksen mukaan järjestettynä) offset-arvon jälkeen ja sitten kaikki näiden ensisijaisten jäsenten sidonnaiset. -
Jos rajoitusarvo on olemassa, palvelu noutaa Ensisijainen
GroupCensusMember-rivit (järjestettynä Id-arvolla) enintään määritetyn rajoituksen perusteella. Sen jälkeen se noutaa kaikki näiden ensisijaisten jäsenten sidonnaiset. Rajoitus voi olla enintään 500. -
Jos
searchKey-arvolla on arvo, palvelu noutaaGroupCensusMember-rivit (tunnuksen mukaan järjestettynä) sekä vastaavan perheen, jonka alamerkkijonona onsearchKey, joka on läsnä niidenFirstName- taiLastName-kentissä. JosGroupCensusMembersisältää sidonnaisia, palvelu noutaa niihin vastaavat ensisijaiset jäsenet. -
Jos
memberIdssisältää arvon, se noutaaGroupCensusMember-rivit (tunnuksen mukaan järjestettynä), joiden tunnus on osamemberIds-taulukkoa. Input-arvona täytyy olla jokomemberIdstaisearchKey. -
Jokaiselle jäsenelle haetut tiedot perustuvat
GroupCensusMember:sta jaGroupCensusMemberPlan:sta haettuihin kenttiin. -
Jäsenten luettelo asetetaan
members-noodiin.
-
Palvelun toimintatapa
Katso miten eri syötteet vaikuttavat palvelutuloksiin.
| Input | Palvelun output |
|---|---|
Ei |
Palvelu ei nouda mitään väestönlaskun jäsentä. |
Ei fieldsetName ja käypä censusId |
Palvelu noutaa:
|
Kelvolliset fieldsetName ja kelvolliset censusId |
Palvelu luetteloi GroupCensusMember-kentät määritetyn fieldsetName mukaan ja noutaa luettelon GroupCensusMember ja ContractGroupPlanIds. |
Ei planFieldsetName käypää fieldsetName ja käypä censusId |
Palvelu luetteloi GroupCensusMember-kentät GroupCensusMemberPlan määritetyn fieldsetName-, ContractGroupPlanId- ja Name-kentän perusteella. Se noutaa luettelon , joilla on ContractGroupPlanIds. |
planFieldsetName Kelvollinen fieldsetName ja käypä censusId |
Palvelu noutaa:
|
Kelvollinen contractId |
Palvelu noutaa sopimusryhmän suunnitelman nimen, tuotetyypin, alitason tuotteiden ja sopimusryhmän suunnitelman tunnuksen vaihtoehtoina ContractGroupPlanId-otsakekentässä. |
Kelvollinen limit |
Palvelu noutaa:
|
Kelvollinen offset |
Palvelu noutaa:
|
Kelvollinen offset ja käypä limit |
Palvelu noutaa:
|
Kelvollinen searchKey |
Palvelu noutaa:
|
Kelvolliset searchKey ja kelvolliset limit |
Palvelu noutaa:
|
Kelvolliset searchKey ja kelvolliset offset |
Palvelu noutaa:
|
Kelvolliset searchKey, kelvolliset limit ja kelvolliset offset |
Palvelu noutaa:
|
Etäasetukset
| Vaihtoehdot | Kuvaus |
|---|---|
|
Pakollinen. Sen väestönlaskun tunnus, jonka jäseniä täytyy hakea. |
|
Pakollinen . Tilin tämänhetkisen sopimuksen tunnus. Hakee sopimusryhmän suunnitelman nimen, tuotetyypin ja sopimusryhmän |
|
Valinnainen. GroupCensusMember-kenttien noutamiseen käytetyn kenttäjoukon nimi. Jos arvo on virheellinen, palvelu ei palauta kenttiä. Jos arvoa ei ole, palvelu käyttää oletusarvoista kenttäjoukkoa noutaakseen GroupCensusMember-kenttiä. |
|
Valinnainen. Hakee GroupCensusMemberPlan- ja GroupCensusMember-kentät, kun suunnitelman kenttäjoukon arvo on käypä. Kenttiä ei palauteta, jos arvo ei ole käypä. Kaikki GroupCensusMemberPlan-kentät palautetaan, kun arvoa ei ole. |
|
Valinnainen. Noudettavien väestönlaskentajäsenien määrä. |
|
Valinnainen . Rekisteröinnin jäsenen tunnus, jonka jälkeen rekisteröinnin jäsenet täytyy hakea. |
|
Merkkijono, joka hakee vastaavia väestönlaskentajäsenen tietueita. |
Syötetty JSON
Tämä palvelu ei ota syötettyä JSON-tiedostoa.
Tulos-JSON
Palvelu palauttaa tuloksen JSON-tiedoston, joka on muotoiltu alla olevan esimerkin mukaisesti. Tuloksessa on lisätietoja väestönlaskennan jäsenille, joiden otsikot ovat luettelo GroupCensusMember- ja GroupCensusMemberPlan-kenttien API-nimistä. members-noodi palauttaa jäsenelle valittujen suunnitelmien luettelon sekä ContractGroupPlanId-arvon ;. lastOffset-kentässä näytetään viimeksi noudetun väestönlaskentajäsenen tunnus. Tätä arvoa voidaan käyttää offset-parametrinä seuraavien rivien noutamiseen.
Alla on esimerkki tuloksen JSON-muodosta:
{
"census":{
"members":[
{
"ContractGroupPlanId":"ID1;ID2",
"Id":"ID",
"fieldAPI1":"value"
}
],
"headers":[
{
"type":"field type",
"label":"field label",
"fieldId":"",
"name":"fieldAPI1"
},
{
"options":[
{
"value":"ID",
"type":"Product Type",
"name":"Contract Group Plan Name"
}
],
"type":"REFERENCE",
"label":"Plan",
"fieldId":"",
"name":"ContractGroupPlanId"
}
]
},
"lastOffset" : "census member Id"
}Alla on esimerkki tuloksen JSON-tiedostosta:
{
"census":{
"members":[
{
"ContractGroupPlanId":"",
"Id":"a4C4P000000dNdbUAE",
"LastName":member1,
"FirstName":primary,
"Birthdate":"1999-08-08"
},
{
"ContractGroupPlanId":"a2N4P000006ygEjUAI",
"Id":"a4C4P000000dNdcUAE",
"LastName":member1,
"FirstName":dependent,
"Birthdate":"1994-08-08"
},
{
"ContractGroupPlanId":"a2N4P000006ygEjUAI;a2N4P000006ygEiUAI",
"Id":"a4C4P000000dNdeUAE",
"LastName":member2,
"FirstName":primary,
"Birthdate":"1985-08-08"
}
],
"headers":[
{
"type":"STRING",
"label":"First Name",
"fieldId":"",
"name":"FirstName"
},
{
"type":"DATE",
"label":"Birthday",
"fieldId":"",
"name":"Birthdate"
},
{
"type":"STRING",
"label":"Last Name",
"fieldId":"",
"name":"LastName"
},
{
"type":"REFERENCE",
"label":"Plan",
"fieldId":"",
"name":"ContractGroupPlanId",
"options":[
{
"value":"a2N4P000006ygEiUAI",
"type":"Medical",
"name":"rootProd",
"childProducts": [
{
"value": "0rgDC000000000RYAQ",
"IsOptional": false,
"name": "MandatoryCoverage"
},
{
"value": "0rgDC000000000RYBQ",
"IsOptional": true,
"name": "OptionalCoverage"
}
]
},
{
"value":"a2N4P000006ygEjUAI",
"type":"Dental",
"name":"rootProd2",
"childProducts": [
{
"value": "0rgDC000000000RYCQ",
"IsOptional": false,
"name": "MandatoryCoverage"
},
{
"value": "0rgDC000000000RYDQ",
"IsOptional": true,
"name": "OptionalCoverage"
}
]
}
]
}
]
},
"lastOffset" : "a4C4P000000dNdeUAE"
}