尋找零件

除了能夠按一下零件來檢視其中繼資料以外，您還可以將搜尋列新增至體驗。如果您有零件編號，但不知道要在模型上尋找的確切零件，您可以搜尋零件編號，且零件將會反白。這可以透過建立名為 findMeta 的函數來完成，此函數可讓您輸入零件編號，然後將它與 quadcopter 的模型資料進行比較。然後具有該零件編號的零件會反白。

6. 在「檢視」樹中按一下 Home.js。必須建立新的函數，才能使用搜尋列來尋找具有特定零件編號的零件。此功能會將採用輸入到 userInput 方塊中的文字，並將其設定為名為 searchNum 的變數。然後，此值的變數會與 quadcopter 模型中所有可用的零件編號進行比較。如果有零件編號與輸入文字相符的話，則該零件會使用先前 3D-導件服務指示 201 部份中的顯影程式來反白，如果有多個相同零件編號的例證，則這些零件都會反白。零件會反白3秒。將此函數放置在 userpick 函數的結尾，且在 playit 函數之前。

a. 建立名為 findMeta 的函數，用來尋找包含在 userInput 文字方塊中輸入之訊息的零件中繼資料。此函數中的第一個步驟是從播放按鈕中移除文字，並將模型與任何序列取消關聯。接下來，必須建立一個變數，使其值等於根據已建立的應用程式參數在 userInput 文字方塊中輸入的任何文字。

//function for using the userInput text box to search for parts
$scope.findMeta = function () {

//reset the text property of the play button to be blank
$scope.view.wdg.playButton.text='';
//
//set the toPlay object for the play button to be undefined
$scope.view.wdg.playButton.toPlay = undefined;
//
//set a variable for comparing the user input to the value of the partno application parameter
var searchNum = $scope.app.params.partno;

//
// instead of using metadata from just the picked part, use metadata from the whole model. If resolved, proceed
PTC.Metadata.fromId('quadcopter')
.then ( (metadata) => {

b. 函數的下一個部分會取得已輸入 userInput 的資料，並將其與模型的 Part Number 屬性進行比較。options變數會建立為 ID 路徑陣列，其中包含與所輸入文字對應的資料。這可透過使用 .find 和 .like 等方法一起來完成。當使用者在 userInput 方塊中輸文字時，文字會因為文字輸入與參數之間的繫結而被輸入至 partno 應用程式參數。因此，變數 searchNum 會設定為 partno 應用程式參數的值。然後，searchNum 變數會與使用 .find 方法找到的任何現有 partNumber 值進行比較。接著會使用 .like 方法來尋找與輸入方塊的文字部份或完全符合的所有零件編號。然後，這些結果會因為 getSelected 而儲存為 options 變數的值清單。

//
//set a variable for comparing the user input to the value of the partno application parameter
var searchNum = $scope.app.params.partno;

//
// instead of using metadata from just the picked part, use metadata from the whole model. If resolved, proceed
PTC.Metadata.fromId('quadcopter')
.then((metadata) => {
//
// set a variable named options. this variable will become an array of ID paths that fit the input text.
// 'like' will look for a partial text match to what is typed in. use 'same' to get an exact match
var options = metadata.find('partNumber').like(searchNum).getSelected();

//
// if the text input leads to a part number so that there is an entry in the options array
if (options != undefined && options.length > 0) {
//
// set an empty array called ID. This array will house the parts that contain the entered part number
var identifiers = []
//
// for each entry in the options array, push that value with 'quadcopter-' at the beginning into the ID array
options.forEach(function (i) {
identifiers.push('quadcopter-' + i)
}) //end forEach

//
// highlight each object in the identifiers array with the shader
$scope.hilite(identifiers, true)

//
// function for removing the highlight
var removeHilite = function (refitems) {
//
// return the hilite function with a value of false to the given part(s)
return function () {
$scope.hilite(refitems, false)
} // end of return function
} // end of turning off hilite

//
// remove the highlight of the selected part(s) after 3000 ms
$timeout(removeHilite(identifiers), 3000)

} //end if statement
}) // end .then

//catch statement if the promise of having a part with metadata is not met
.catch((err) => { console.log('metadata extraction failed with reason : ' + err) })
} // end findMeta function