#ctx.initResource()

Inicializa o recurso (resource) para o contexto atual. Se ctx.resource ainda não existir, ele cria um do tipo especificado e o vincula ao contexto; se já existir, ele é usado diretamente. Depois disso, ele pode ser acessado via ctx.resource.

#Cenários de uso

Geralmente usado em cenários de JSBlock (bloco independente). A maioria dos blocos, popups e outros componentes já possuem o ctx.resource pré-vinculado e não exigem chamadas manuais. O JSBlock não possui recurso por padrão, portanto, você deve chamar ctx.initResource(type) antes de carregar dados via ctx.resource.

#Definição de Tipo

initResource(
  type: 'APIResource' | 'SingleRecordResource' | 'MultiRecordResource' | 'SQLResource'
): FlowResource;

Retorno: A instância do recurso no contexto atual (ou seja, ctx.resource).

#Diferença de ctx.makeResource()

#Exemplos

#Dados de Lista (MultiRecordResource)

ctx.initResource('MultiRecordResource');
ctx.resource.setResourceName('users');
await ctx.resource.refresh();
const rows = ctx.resource.getData();
ctx.render(<pre>{JSON.stringify(rows, null, 2)}</pre>);

#Registro Único (SingleRecordResource)

ctx.initResource('SingleRecordResource');
ctx.resource.setResourceName('users');
ctx.resource.setFilterByTk(1); // Especifica a chave primária
await ctx.resource.refresh();
const record = ctx.resource.getData();

#Especificar Fonte de Dados

ctx.initResource('MultiRecordResource');
ctx.resource.setDataSourceKey('main');
ctx.resource.setResourceName('orders');
await ctx.resource.refresh();

#Observações

• Na maioria dos cenários de blocos (Formulários, Tabelas, Detalhes, etc.) e popups, o ctx.resource já é pré-vinculado pelo ambiente de execução, portanto, chamar ctx.initResource é desnecessário.
• A inicialização manual é necessária apenas em contextos como o JSBlock, onde não há recurso padrão.
• Após a inicialização, você deve chamar setResourceName(name) para especificar a coleção e, em seguida, chamar refresh() para carregar os dados.

#Relacionado

• ctx.resource — A instância do recurso no contexto atual
• ctx.makeResource() — Cria uma nova instância de recurso sem vinculá-la ao ctx.resource
• MultiRecordResource — Múltiplos registros/Lista
• SingleRecordResource — Registro único
• APIResource — Recurso de API geral
• SQLResource — Recurso de consulta SQL