Temos o prazer de anunciar a adição da função include() à API wix-data. A função include() é usada ao consultar uma coleção que contém campos de referência.
Anteriormente, quando você consultava essa coleção, você recebia apenas os IDs dos itens referenciados nos resultados da consulta. Agora, usando a função include(), você pode recuperar o item de referência inteiro nos resultados da consulta.
Como funciona
Precisa apenas adicionar a função include() à sua cadeia de construção de consulta antes de chamar a função find().
Exemplo
Suponha que você tenha uma coleção de livros que contém um campo de referência que se refere aos dados do autor do livro que são armazenados em outra coleção. Você pode escrever a seguinte consulta para encontrar todos os livros com mais de 250 páginas e receber as informações completas do autor nos resultados.
import wixData from 'wix-data';
// ...
wixData.query("books")
.ge("pages", 250)
.include("author")
.find()
.then( (results) => {
let books = results.items;
let firstBook = items[0];
let firstAuthor = firstBook.author.name;
} )
.catch( (error) => {
let errorMsg = error.message;
let code = error.code;
} );
Esse pode ser um dos itens resultantes.
{
"_id":"37d9a27a-6b13-4c8d-ac40-5ce8dac7a64f",
"_owner":"f6c0f9c2-a02d-4e9f-a58d-99729af244d9",
"_createdDate":"2018-02-07T13:40:40.765Z",
"_updatedDate":"2018-02-07T13:46:47.132Z",
"title":"Amazing Book",
"publisher":"A Publishing House",
"pages":"375",
"author": {
"_id":"c4cb45bc-bece-4ef7-bfee-e47c5b6f9d8e",
"_owner":"f6c0f9c2-a02d-4e9f-a58d-99729af244d9",
"_createdDate":"2018-02-07T13:40:05.542Z",
"_updatedDate":"2018-02-07T13:40:05.542Z",
"name":"John Doe",
"dob":"1963-04-08T00:00:00.000Z",
"bio":"John is a prolific author and lives in NYC with his six dogs."
}
}
Saiba mais
Para ler mais, consulte a função include() na Referência API.