CloudKitRecord:set()

field _^(required)

String. The field name for which to set the value.

value _^(required)

Table, String, or Number. Value to store in the record. This value is typically passed as a table containing the required type key, along with the associated keys noted in Record Values below. However, strings and numbers can be passed directly as a convenience method.

Standard Values

local function fetchResults( event )

    if event.record then
        -- String and number values can be passed directly (convenience method)
        event.record:set( "company", "Corona Labs" )
        event.record:set( "amount", 1 )
        -- Other value types must be passed as a table
        event.record:set( "where", { type="location", latitude=37.453139, longitude=122.113451 } )
    else
        print( "Record not fetched!" )
    end
end

iCloud.recordFetch(
    {
        recordName = "Corona Labs 1",
        onComplete = fetchResults
    }
)

Related Records

local meetingParticipants = {
    { fullName="John Smith" },
    { fullName="Jennifer White" },
    { fullName="Robert Jones" }
}

local function meetingSaved( event )

    if event.record then
        -- Get meeting unique identifier (recordName) contained in record metadata
        local meetingID = event.record:metadata().recordName

        -- Create new participant records
        for i = 1,#participants do
            local participant = iCloud.recordCreate( { type="participant" } )
            participant:set( "participantName", meetingParticipants[i]["fullName"] )
            -- Relate this record (create reference) to the meeting
            -- This reference record name and the meeting's unique identifier should match
            participant:set( "meetingID", { type="reference", recordName=meetingID, action="deleteSelf" } )
            participant:save()
        end
    end
end

local function createMeeting( event )

    -- Create a new meeting record
    local meeting = iCloud.recordCreate( { type="meeting" } )

    -- Set the meeting's location
    meeting:set( "meetingLocation", "Office" )
    meeting:save( { onComplete=meetingSaved } )
end

createMeeting()