Declaración
|
Parámetros
|
Descripción
|
||
get (idpath, propName, categoryName)
|
• {string|string[]} idpath: Ruta de ID como '/0/1', o matriz de rutas de ID ['/0/1', '/0/2'].
• {string|string[]} propName: (Opcional) Por ejemplo, 'Display Name' o ['Display Name', 'Part ID Path'].
• {string|string[]} categoryName: (Opcional) Por ejemplo, 'PROE Parameters'.
|
Obtiene un objeto de metadatos que representa la ruta de ID o los valores de propiedad de idpath y propName dados.
Esta función devuelve el objeto de metadatos que representa la idpath dada. Si se da propName, devuelve el valor de la propiedad del componente.
Ejemplo:
PTC.Metadata.fromId('model-1').then( (metadata) => {
var result = metadata.get('/0/6', 'Display Name') }); |
||
getProp (propName, categoryName)
|
• {string|string[]} propName: (Opcional) Por ejemplo, 'Display Name' o ['Display Name', 'Part ID Path'].
• {string|string[]} categoryName: (Opcional) Por ejemplo, 'PROE Parameters'.
|
Esta función devuelve todos los valores de las propiedades string de un solo componente, o bien sin definir si no hay datos o componentes disponibles. Si el valor de propName dado era una matriz, devuelve string[] de valores.
Ejemplo:
PTC.Metadata.fromId('model-1').then( (metadata) => {
var result = metadata.get('/0/1').getProp('Display Name'); }); |
||
getCategory (categoryName)
|
• {string} categoryName
|
Esta función devuelve el objeto con todos los nombres de propiedades y valores de la categoría dada.
Ejemplo:
PTC.Metadata.fromId('model-1').then( (metadata) => {
var result = metadata.get('/0/6'). getCategory ('__PV_SystemProperties'); }); |
||
getSelected (selectFunc)
|
• {function} selectFunc: (Opcional) Función que controla los valores indicados en la matriz que se devuelve. Se da idpath a la función y un argumento y metadatos actuales como:
`this` function(idpath) {
return [idpath, this.get(idpath, 'Display Name')]; }); |
Esta función devuelve una matriz del resultado devuelto por el valor de selectFunc dado. Si selectFunc está sin definir, devuelve string[] de rutas de ID.
Ejemplo:
PTC.Metadata.fromId('model-1').then( (metadata) => {
var selectFunc = function(idpath) { return metadata.get(idpath, 'Display Name'); } var result = metadata.getSelected(selectFunc); }); |
||
find (propName, category)
|
• {string} propName (obligatorio)
• {string} category (opcional)
|
Busca componentes basados en valores de propiedades. Consulte también findCustom a continuación.
Devuelve un buscador de componentes según la categoría y el valor dado de propName.
Ejemplo:
PTC.Metadata.fromId('model-1').then( (metadata) => { var displayName = metadata.find('Display Name').like('BOLT'); }); PTC.Metadata.fromId('model-1').then( (metadata) => { var result = metadata.find('Part Depth').lessThan(3).find('Display Name').like('PRT'); }); PTC.Metadata.fromId('model-1').then( (metadata) => { var selectFunc = function(idpath) { return metadata.get(idpath, 'Display Name') var result = metadata.find('Part Depth').greaterThan(4, selectFunc) }); La comparación puede ser como la que se indica a continuación:
- startsWith,like,sameAs,unlike : string comparison
- equal,notequal,greaterThanEq,lessThanEq,lessThan,greaterThan : numeric comparison - in,out : numeric range comparison - before,after : date/time comparison |
||
findCustom (whereFunc, selectFunc)
|
• {function} whereFunc (obligatorio)
• {function} selectFunc (opcional)
|
Consulte también find arriba.
Esta función devuelve un buscador de componentes según el valor personalizado de whereFunc. El ejemplo siguiente busca todos los componentes con depth<2 o con un nombre similar a 'ASM'.
Ejemplo:
PTC.Metadata.fromId('model-1').then( (metadata) => { var whereFunc = function(idpath) { const depth = metadata.get(idpath, 'Part Depth') const name = metadata.get(idpath, 'Display Name') return parseFloat(depth) >= 4 || (name && name.search('ASM') >= 0) } var result = metadata.findCustom(whereFunc); }); |