Fetching entries refers to the process of retrieving specific information or records. Here's an example of how you can configure and use these functions:

async function script(C) {
    const currentEntry = await C.getCurrentEntry();

    const currentEntryAsIV = await C.getCurrentEntry({ responseType: "iov" });
    
    const currentEntryWithSubrecordsAndAssociations = await C.getCurrentEntry({
        responseType: "fov",

        loadSubrecords: true,
        subrecords: [
            {
                internalId: "kalysys-dependencies",
                responseType: "fov",
            },
        ],

        loadAssociations: true,
        associations: [
            { 
                internalId: "bug-report",
                linkedFieldInternalId: "related-backlog-items", 
                responseType: "fov",
            },
            {
                internalId: "kalysys-customer-feedback",
                responseType: "fov",
            },
        ],
    });

    const getEntryResponse = await C.getEntry({
        entryId: 737466,
        recordInternalId: "bug-report", 
    });

    const getSpecificEntries = await C.getEntry({
        entryIds: [737466],
        recordInternalId: "bug-report", 
    });

    const filteredEntries = await C.filterEntries({
        filter: [
            {
                subject: "owner",
                requestType: "i",
                type: "array",
                operator: "any_of",
                value: [23643],
            },
        ],
        recordInternalId: "backlog-items",
    });

    return {
        filteredEntries,
        getSpecificEntries,
        getEntryResponse,
        currentEntry,
        currentEntryAsIV,
        currentEntryWithSubrecordsAndAssociations,
    };
}

Let's break down each component:

Fetch the Current Entry

Here, entryId and recordInternalId is taken from the event.

const currentEntry = await C.getCurrentEntry();

Fetch the Current Entry as an Internal View

In any of the functions relating to fetching entries, you can pass values responseType.

const currentEntryAsIV = await C.getCurrentEntry({ responseType: "iv" });

Fetch the Current Entry with Sub Records and Associations

Similarly, in any functions relating to fetching entries, you can have options to load sub records or associations.

const currentEntryWithSubrecordsAndAssociations = await C.getCurrentEntry({
        responseType: "fov",
        loadSubrecords: true,
        subrecords: [
            {
                internalId: "kalysys-dependencies",
                responseType: "fov",
            },
        ],
        loadAssociations: true,
        associations: [
            { 
                internalId: "bug-report",
                linkedFieldInternalId: "related-backlog-items", 
                responseType: "fov",
            },
            {
                internalId: "kalysys-customer-feedback",
                responseType: "fov",
            },
        ],
    });

📘
Info:
only pass linkedFieldInternalId if there are multiple linked fields.

Fetch a Specific Entry by ID

If not passed, the current record's internal will be taken.

const getEntryResponse = await C.getEntry({
        entryId: 737466,
        recordInternalId: "bug-report", 
    });

Fetch Specific Entries by IDs

If not passed, the current record's internal will be taken.

const getSpecificEntries = await C.getEntry({
        entryIds: [737466],
        recordInternalId: "bug-report", 
    });

Fetch Entries Based on Filter Criteria

const filteredEntries = await C.filterEntries({
        filter: [
            {
                subject: "owner",
                requestType: "i",
                type: "array",
                operator: "any_of",
                value: [23643],
            },
        ],
        recordInternalId: "backlog-items",
    });

    return {
        filteredEntries,
        getSpecificEntries,
        getEntryResponse,
        currentEntry,
        currentEntryAsIV,
        currentEntryWithSubrecordsAndAssociations,
    };
}

Output

The output of fetching entries consists of the data that matches your query or criteria. Depending on how you configured your fetch, you can expect to receive:

The current entry or record.
The current entry as an internal view.
The current entry with subrecords and associations.
Specific entries based on their IDs.
Entries that match a specified filter criteria.

📌 Need Help?

If you require assistance or encounter any issues, please don't hesitate to contact us for further support.