Family Create or Update

Description

The FamCreateUpdate operation updates or creates a family record. If the family OGFN is 0, the family will be created. Otherwise if it has a lock it will be updated.

Version

2011-02-02

URI

REST URI [POST]:
/v11.02/Family.svc/CreateUpdate?SessionId={SessionId}

Content-Type: Application/xml

Example

Request POST
http://wsdev.onegreatfamily.com/v11.02/Family.svc/CreateUpdate?SessionId=113434515134543151134
Request Headers
Content-Type: Application/xml
Request Payload 
<Fam xmlns="http://schemas.datacontract.org/2004/07/OGF.WS.Data">
  <ChildrenOgfns xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <a:unsignedLong>1341234</a:unsignedLong>
  </ChildrenOgfns>
  <DivorceDate>1 Jan 2000</DivorceDate>
  <DivorcePlace>New york, New york, usa</DivorcePlace>
  <GroupOgfn>2345</GroupOgfn>
  <HusbandOgfn>24345</HusbandOgfn>
  <MarriageDate>1 Jan 1960</MarriageDate>
  <MarriagePlace>New york, New york, usa</MarriagePlace>
  <Ogfn>0</Ogfn>
  <WifeOgfn>3242435</WifeOgfn>
  <lockIdlockIdcolor: #a31515">lockId>
</Fam>
Success Response Payload 
<Fam xmlns="http://schemas.datacontract.org/2004/07/OGF.WS.Data">
  <ChildrenOgfns xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <a:unsignedLong>1341234</a:unsignedLong>
  </ChildrenOgfns>
  <DivorceDate>1 Jan 2000</DivorceDate>
  <DivorcePlace>New york, New york, usa</DivorcePlace>
  <GroupOgfn>2345</GroupOgfn>
  <HusbandOgfn>24345</HusbandOgfn>
  <MarriageDate>1 Jan 1960</MarriageDate>
  <MarriagePlace>New york, New york, usa</MarriagePlace>
  <Ogfn>0</Ogfn>
  <WifeOgfn>3242435</WifeOgfn>
  <lockIdlockIdt;/lockId>
</Fam>
 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

SessionId

The current session Id

Type: string

Default: None

Yes

POST Payload

Name Description Required

Fam

This operation takes as input a Fam aggregate.

Type: Fam

Default: None

Constraints: Must be a valid Fam aggregate.

Yes

Response Elements

Name Description

Fam

This operation returns a Fam aggregate upon success. Otherwise an error is returned.

Type: Fam

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.