Families Compare

Description

The FamCompare operation compares two family records by OGFN and determines if they match. If Automerge is true and the families match, they will be merged together.

Version

2011-02-02

URI

REST URI [GET]:
/v11.02/Family.svc/Compare/fam/{OGFN1}/fam/{OGFN2}?AutoMergeIfMatch={AutoMergeIfMatch}?SessionId={SessionId}

Example

Request GET

http://wsdev.onegreatfamily.com/v11.02/Family.svc/Compare/fam/123432/fam/3322113?AutoMergeIfMatch=true?SessionId=43523454553451534514545

Fault Response Payload

<RestFault xmlns="http://schemas.datacontract.org/2004/07/OGF.WS.Data">
	<ErrorCode>551</ErrorCode>
	<FaultMessage>An unhandled exception has occurred</FaultMessage>
</RestFault>

Query String Parameters

Name	Description	Required
indiOgfn1	The OneGreatFamily ID for the first family to compare Type: UInt64 Default: None Constraints: Must be a valid family ID.	Yes
indiOgfn2	The OneGreatFamily ID for the second family to compare Type: UInt64 Default: None Constraints: Must be a valid family ID.	Yes
AutoMergeIfMatch	Flag that if true will automatically merge OGFN1 and OGFN2 if the OGFNs match Type: bool Default: None Constraints:	Yes
SessionId	The current session Id Type: string Default: None	Yes

Response Elements

Name	Description
`UInt32`	zero on success or non-zero if an error occurs
`HTTP Status Code`	The Web Server returns a status code which indicates if the operation was successful. Anything other than 200 should be regarded as a failure.
`HTTP Status Code` of 417	The Web Server threw an exception and contains a `RestFault` aggregate. Retrieve the RestFault from the Webexception response property.