Usted está aquí:
InsCensusServiceStd:getMembersWithPlans
Utilice este servicio para recuperar la lista de miembros del censo para un censusId concreto. Correspondiente a estos miembros del censo, el servicio recupera el ContractGroupPlanIds de GroupCensusMemberPlan. El servicio también recupera encabezados basándose en la fieldsetName y la planFieldsetName.
Clase: InsCensusServiceStd
Método: getMembersWithPlans
Funcionamiento
Este servicio tiene dos funciones clave:
- Recupera la lista de campos en
GroupCensusMemberyGroupCensusMemberPlan.El servicio utiliza el parámetro
fieldsetNamepara recuperar la lista de campos deGroupCensusMember. Si no hay ningún valor, los campos se recuperan del conjunto de campos predeterminado. Si el valor ingresado no encuentra una coincidencia, no se recupera ningún campo.El servicio utiliza el parámetro
planFieldsetNamepara recuperar la lista de campos deGroupCensusMemberPlan. Si no hay ningún valor, se recuperan todos los campos. Si el valor ingresado no encuentra una coincidencia, no se recupera ningún campo.Recupera campos de relaciones que se combinan para formar el nodo de encabezados JSON incluso si estos campos no están incluidos en el
fieldsetName. Estos campos son:PrimaryGroupCensusMemberId,RelationshipToPrimaryMember,SourceSystemIdentifieryPrimaryMemberSource.Si el parámetro
tiene valor, rellena la lista de registros de partidas de contrato con los siguientes detalles del contrato:contractGroupPlanIdNombre de plan de grupo de contratos
Tipo de producto
Id. de los planes de grupo de contratos
-
El servicio utiliza
censusIdpara recuperar la lista de miembros del censo desde registros deGroupCensusMembery planes de grupos de contratos desdeGroupCensusMemberPlanpara cada miembro.-
Si la compensación tiene valor, recupera filas de
GroupCensusMemberprincipal (ordenadas por Id.) después de la compensación y luego recupera todos los dependientes para estos Miembros principales. -
Si hay un valor límite, el servicio recupera las filas de
GroupCensusMemberprincipal (ordenadas por Id.) no superiores al límite especificado. A continuación recupera todos los dependientes para estos Miembros principales. El límite no puede ser superior a 500. -
Si
searchKeytiene valor, el servicio recupera filas deGroupCensusMember(ordenadas por Id.) junto con la familia correspondiente, que tienesearchKeycomo una subcadena presente en susFirstNameoLastName. SiGroupCensusMembercontiene dependientes, el servicio recupera miembros principales correspondientes a esos dependientes. -
Si
memberIdstiene un valor, recupera filas deGroupCensusMember(ordenadas por Id.) cuyo Id. forma parte de la matrizmemberIds. Debe proporcionarsememberIdsosearchKeyen la entrada. -
La información recuperada para cada miembro se basa en los campos recuperados de
GroupCensusMemberyGroupCensusMemberPlan. -
La lista de miembros se coloca en el nodo
members.
-
Comportamiento de servicio
Comprenda cómo afectan las diferentes entradas a los resultados del servicio.
| Entrada | Salida de servicio |
|---|---|
Sin |
El servicio no recupera ningún miembro del censo. |
censusId no fieldsetName y válido |
El servicio recupera:
|
fieldsetName válidos y censusId válidos |
El servicio enumera campos de GroupCensusMember según la fieldsetName especificada y recupera la lista de GroupCensusMember con ContractGroupPlanIds. |
Sin fieldsetName planFieldsetName válido y censusId válido |
El servicio enumera campos de GroupCensusMember según el campo fieldsetName, ContractGroupPlanId y Nombre especificado de GroupCensusMemberPlan. Recupera la lista de con ContractGroupPlanIds. |
planFieldsetName fieldsetName válidos y censusId válidos |
El servicio recupera:
|
contractId válido |
El servicio recupera el nombre del plan del grupo de contratos, el tipo de producto, los productos secundarios y el Id. del plan del grupo de contratos como opciones en el campo de encabezado de ContractGroupPlanId. |
limit válido |
El servicio recupera:
|
offset válido |
El servicio recupera:
|
limit válido offset y válido |
El servicio recupera:
|
searchKey válido |
El servicio recupera:
|
searchKey válidos y limit válidos |
El servicio recupera:
|
searchKey válidos y offset válidos |
El servicio recupera:
|
searchKey válidos, limit válidos y offset válidos |
El servicio recupera:
|
Opciones remotas
| Opciones | Descripción |
|---|---|
|
Requerido. Id. del censo cuyos miembros deben recuperarse. |
|
Obligatorio. Id. del contrato actual de la cuenta. Recupera el nombre del plan del grupo de contratos, el tipo de producto y el grupo de contratos |
|
Opcional. Nombre del conjunto de campos para recuperar los campos GroupCensusMember. Si el valor no es válido, el servicio no devuelve campos. Si no hay ningún valor, el servicio utiliza el campo predeterminado establecido para recuperar campos GroupCensusMember. |
|
Opcional. Recupera los campos GroupCensusMemberPlan y GroupCensusMember cuando hay un valor de conjunto de campos de plan válido. No se devuelven campos si el valor no es válido. Todos los campos GroupCensusMemberPlan se devuelven cuando no hay valor. |
|
Opcional. El número de miembros del censo a recuperar. |
|
Opcional . El Id. del miembro del censo después del cual se deben recuperar los miembros del censo. |
|
Cadena para buscar registros de miembros del censo coincidentes. |
JSON de entrada
Este servicio no toma un JSON de entrada.
JSON de salida
El servicio devuelve un JSON de salida con formato según el siguiente ejemplo. El resultado tiene detalles para los miembros en el censo, donde encabezados es una lista de nombres de API de campo de GroupCensusMember y GroupCensusMemberPlan. El nodo members devuelve la lista de planes seleccionados para el miembro junto con ContractGroupPlanId delimitado por ;. El campo lastOffset muestra el Id. del último miembro del censo que se recupera. Este valor se puede utilizar como el parámetro offset para obtener las siguientes filas.
Este es el formato JSON de salida de muestra:
{
"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"
}Este es el JSON de salida de muestra:
{
"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"
}