Referência de consulta de pesquisa

Updated: August 19, 2026

Este documento é um guia de referência para a sintaxe, os operadores e as convenções usados na linguagem de busca de projetos de hardware do Workspace. As consultas de busca são baseadas em uma sintaxe field:value familiar e podem ser usadas desde pesquisas rápidas e simples até a construção de consultas avançadas e precisas.

Consulte Web Viewer Search para informações de uso relacionadas.

Sintaxe e Guia de Busca

As informações de referência abaixo estão agrupadas por tipos de alvos de busca (componentes, conexões etc.), com cada seção incluindo subtipos de categoria de uso, exemplos de uso e consultas de exemplo correspondentes.

Busca de Componentes

Use Category	Application Example	Query
Basics	Encontre um componente conhecido pelo seu Designador.	`R14`
	Encontre um componente IC específico pelo Designador.	`designator:U7`
	Encontre componentes por seu Nome/Comentário (ex.: ERJ-2RKF1002X ou "Capacitor 100nF +/-20% 50V 0402"]).	`comment:ERJ-2RKF1002X`
	Encontre componentes pelo parâmetro Valor (ex.: 100nF ou 4.7k).	`value:100nF`
	Encontre componentes em um encapsulamento físico específico (ex.: QFN-48).	`package:0402`
	Encontre componentes que usam um nome específico de footprint de PCB.	`footprint:RESC0402`
Identifiers	Encontre componentes que sejam dispositivos de montagem em superfície (SMD).	`mounting:smd`
Identifiers	Encontre todos os componentes de tecnologia through-hole (THT).	`mounting:tht`
Types	Encontre todos os componentes passivos (resistores, capacitores, indutores).	`type:passive`
	Encontre todos os componentes ativos (ICs, transistores, diodos).	`type:active`
	Encontre todos os componentes classificados como conectores.	`type:connector`
Connections	Encontre componentes que contenham um nome ou número de pino específico.	`pin:SCLK`
Connections	Encontre componentes que contenham pinos com uma direção especificada (ex.: entrada, saída, IO etc.). Também encontra Ports com a direção especificada.	`direction:output`
Parametric	Encontre componentes com uma propriedade ou parâmetro específico (ex.: Tolerance) de qualquer valor.	`has:tolerance`
	Encontre componentes em que um parâmetro tenha um valor específico	`tolerance:1%`
	Encontre componentes em que um parâmetro numérico esteja dentro de um intervalo. Filtro. Observe que nomes de parâmetros com um caractere de espaço devem estar entre aspas.	`"Voltage Rating":[3V to 5.5V]`
	Encontre componentes na camada Top com um parâmetro específico de potência nominal. Filtro	`power:63mW layer:Top`

Busca de Nets

Use Category	Application Example	Query
Basics	Encontre uma net conhecida pelo nome.	`GND`
Basics	Encontre uma net de alimentação específica pelo nome (ex.: VCC, GND, VSENSE).	`net:VCC3`
Classes	Encontre todas as nets que pertencem a uma classe de net.	`netclass:analog`
	Encontre as nets de um par diferencial específico.	`diffpair:USB_SYS`
	Encontre todos os pares de nets na classe de par diferencial.	`diffpairclass:USB`

Conectividade

Use Category	Application Example	Query
Simple Search	Encontre o componente U3 e tudo o que está conectado a ele. Caminhos de conexão lógica também são mostrados, onde dispositivos passivos entre dispositivos ativos (ex.: resistores de terminação e capacitores de acoplamento) são ignorados.	`connectsTo:U3`
Simple Search	Encontre a net 'SYS_CLK' e tudo o que está conectado a ela.	`connectsTo:SYS_CLK`
Advanced Search	Encontre o componente U3 e tudo o que está diretamente conectado a ele. Apenas conexões físicas (mesma net) são mostradas – conexões lógicas entre dispositivos ativos não são incluídas.	`connectsTo.Direct:U3`
	Encontre o componente U3 e as conexões físicas e lógicas com ele, mas exclua conexões com trilhos de alimentação.	`connectsTo.noPower:U3`
	Encontre o componente U3 e as conexões físicas (mesma net) com ele, mas exclua conexões com trilhos de alimentação.	`ConnectsTo.Direct:U3 ConnectsTo.NoPower:U3`
	Encontre a net específica conectada ao pino 5 do componente U12.	`connectsTo:U12.5`
	Encontre a net específica conectada à entrada 'D_CLK' do componente U12.	`connectsTo:U12.D_CLK`
	Encontre nets do barramento CAN em camadas específicas da PCB (ex.: L3 e Bottom). Filtro	`net:can* layer:Bottom layer:L3`

Objetos de Projeto

Use Category	Application Example	Query
General Types	Encontre objetos de um tipo específico [ex.: pad, via, track].	`object:pad`
General Types	Encontre objetos específicos em uma determinada net (ex.: vias na net de terra). Filtro	`object:via net:GND`
Advanced	Encontre tracks (trilhas) nas camadas internas da PCB. (isto é, não nas camadas Top ou Bottom). Filtro	`object:track -layer:Top -layer:Bottom`
	Encontre todos os pinos designados como saídas. Filtro	`direction:output object:pin`
	Encontre todos os pads com tipo de forma retangular. Filtro	`object:pad shape:rectangle`

Filtros Lógicos e de Intervalo

Use Category	Application Example	Query
Wildcards	Encontre todas as nets cujo nome inclua vários caracteres após 'VCC' (ex.: VCC1, VCC_Digital, VCC_Analog).	`net:VCC*`
Wildcards	Encontre todos os componentes cujos designadores incluam um único caractere após 'C1' (isto é: capacitores C11 a C19)	`C1?`
Logic Combinations	Encontre capacitores na camada Top. Observe que um espaço entre expressões de busca é um AND implícito.	`type:Capacitor AND layer:Top`
	Encontre componentes usando encapsulamento 0402 ou 0603. Observe que uma expressão lógica OR deve estar entre parênteses quando usada com lógica AND.	`package:0402 OR package:0603`
	Mostre todas as conexões com U1, mas não inclua as da camada GND. Observe que o caractere '-' é equivalente ao qualificador lógico 'NOT' (-term:value).	`connectsto:U1 NOT Layer:GND`
Parentheses Logic	Encontre componentes usando encapsulamento 0402 ou 0603.	`package:(0402 OR 0603)`
Parentheses Logic	Encontre tracks (trilhas) nas camadas internas da PCB. (isto é, não nas camadas Top ou Bottom).	`object:track -layer:(Top or Bottom)`
Ranges	Encontre tracks de PCB mais longos que um comprimento especificado. Observe que o caractere '>' substitui os dois-pontos do termo.	`object:Track tracklength>100mm`
	Encontre pads de PCB com tamanhos de furo maiores ou iguais a um diâmetro especificado.	`object:Pad holesize>=0.6mm`
	Encontre resistores que tenham um valor dentro de um intervalo especificado. Observe o uso de colchetes.	`R* Value:[100k to 200k]`
	Encontre nets de PCB com comprimentos de 1 mm a 1,5 mm. Incluirá conexões (pads, vias, pinos etc.).	`NetLength:[1mm to 1.5mm]`

Busca Hierárquica e de Agrupamento

Use Category	Application Example	Query
Logical Groups	Encontre todos os componentes na classe de componentes 'DecouplingCaps'.	`componentClass:DecouplingCaps`
Logical Groups	Encontre todas as nets pertencentes à classe de net 'DDR_DATA'.	`netClass:DDR_DATA`
Physical Groups	Encontre todas as entidades em uma camada de PCB especificada (ex.: Mid 3).	`layer:"Mid 3"`
Physical Groups	Encontre todos os componentes dentro da room 'RF_Shield' na PCB.	`room:RF_Shield`

Projeto Físico

Use Category	Application Example	Query
Physical Properties	Encontre nets de alta velocidade com trilhas maiores que 50 mm. Filtro	`netClass:HighSpeed netlength>50mm`
	Mostre trilhas da placa (tracks) mais largas que 10 mil. Filtro	`object:track trackwidth>10mil`
	Encontre vias com tamanho de furo de perfuração menor que 8 mil. Filtro	`object:via holesize<8mil`

Buscas em Documentos

Use Category	Application Example	Query
Document Objects	Encontre todos os objetos em um documento PCB do projeto (ex.: 'Module1').	`document:module1.pcbdoc`
	Encontre todos os objetos no documento esquemático 'Power'.	`sheet:power.schdoc`
	Encontre resistores em um esquemático especificado. Filtro	`sheet:power.schdoc type:resistor`

Gerenciamento de Bibliotecas

Use Category	Application Example	Query
Status	Encontre todos os componentes que possuem footprint de PCB, mas não têm modelo 3D. Filtro	`has:footprint -has:model3d`
Status	Encontre qualquer componente que não possua modelo de simulação.	`-has:simulation_model`
Parts Source	Encontre componentes usados de uma fonte de biblioteca específica (ex.: Workspace, estoque interno de peças, project.IntLib).	`Library_Path:"Company Stock"`

Versão para impressão

Localizado por IA

Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.