

Record Cursor

Provide functions to work with kintone Cursor

Currently there's only cursor for records.

Constructor

Parameter

Name	Type	Required	Description
params	Object	yes	Constructor params.
params.connection	Connection	yes	The connection module of this SDK.

Sample code

Init Record Cursor module

    const kintone = require('@kintone/kintone-wechat-miniprogram-sdk');

    const passwordAuthParam = {
        username: 'YOUR_USERNAME',
        password: 'YOUR_PASSWORD'
    }
    const kintoneAuth = (new kintone.Auth()).setPasswordAuth(passwordAuthParam);

    const connParam = {
        domain: 'YOUR_DOMAIN',
        auth: kintoneAuth
    }
    const kintoneConn = new kintone.Connection(connParam);

    const kintoneRC = new kintone.RecordCursor({connection: kintoneConn});

Methods

createCursor(params)

Create a cursor.

Parameter

Name	Type	Required	Description
params	Object	yes	Create cursor params
params.app	Integer	yes	The kintone app ID
params.fields	Array<String>	(optional)	List of field codes you want in the response.
params.query	String	(optional)	The query string that will specify what records will be responded.
params.size	Integer	(optional)	Number of records to retrieve per request. Default: 100. Maximum: 500.

Return

Promise<CreateCursorResponse> Cursor Object from kintone.

Name	Type	Description
id	String	The cursor ID
totalCount	Integer	The total count of records that match the query conditions

Sample code

Init Record Cursor module

    const rcOption = {
        app: appID,
        fields: [],
        query: '',
        size: 2
    }

    kintoneRC.createCursor(rcOption)
        .then(function(creatCursorResponse){
            const myCursor = creatCursorResponse;
            console.log('Cursor ID: ' + myCursor.id );
            console.log('Total Count: ' + myCursor.totalCount );
        })

getRecords(params)

Get one block of records.

Parameter

Name	Type	Required	Description
params	Object	yes	Get records create
params.id	String	yes	Cursor ID

Return

Promise<GetRecordCursorResponse>

Name	Type	Description
records	Array	The array of records data
next	Boolean	Show states whether there are more records to get from kintone of cursor.

Sample code

Get Records Once

    kintoneRC.getRecords({id: myCursor.id})
        .then((getRecordsResponse) => {
            console.log('RecordCursor result: ');
            console.log(getRecordsResponse);
        })

getAllRecords(params)

Get all records

Parameter

Name	Type	Required	Description
params	Object	yes	Get all records param
params.id	String	yes	Cursor ID

Return

Promise<GetRecordsResponse>

Name	Type	Description
records	Array	The array of records data
totalCount	Integer	The number of records response.

Sample code

Get All Records

    kintoneRC.getAllRecords({id: myCursor.id})
        .then((getAllRecordsResponse) => {
            console.log('RecordCursor result: ');
            console.log(getAllRecordsResponse);
        })

deleteCursor(params)

Delete a cursor

Parameter

Name	Type	Required	Description
params	Object	yes	Delete cursor param
params.id	String	yes	Cursor ID

Return

None

Sample code

Delete Cursor

    kintoneRC.deleteCursor({id: myCursor.id})
        .then(function(){
            console.log('Cursor Deleted');
        })
        .catch(function(error){
            console.log('Delete cursor fail');
            console.log(error);
        })