入門(mén)使用
搜索聯(lián)系人
更新時(shí)間：2019-11-20
描述
用戶(hù)可以查詢(xún)所有部門(mén)里面聯(lián)系人的詳細(xì)信息。
已完成組件的初始化和登錄。
業(yè)務(wù)流程
圖1 搜索聯(lián)系人詳情流程
-
UI調(diào)用tsdk_search_contacts()搜索聯(lián)系人信息。
說(shuō)明：
傳入的參數(shù)TSDK_S_SEARCH_CONTACTS_PARAM即為搜索聯(lián)系人請(qǐng)求參數(shù)，包括：
-
必選參數(shù)：
搜索關(guān)鍵字、當(dāng)前需要查找的頁(yè)面索引(從1開(kāi)始)、是否精確查找，以及當(dāng)前查詢(xún)序號(hào)。建議應(yīng)用程序設(shè)置的查詢(xún)序號(hào)從0開(kāi)始遞增，最大值0xFFFFFFFD(0xFFFFFFFE為SDK內(nèi)部保留值)。
-
可選參數(shù)：
部門(mén)ID，若填寫(xiě)則在指定部門(mén)下查詢(xún)。
代碼示例：- (void)searchContactWithParam:(SearchParam *)searchParam { TSDK_S_SEARCH_CONTACTS_PARAM *tsdkSearchParam = (TSDK_S_SEARCH_CONTACTS_PARAM *)malloc(sizeof(TSDK_S_SEARCH_CONTACTS_PARAM)); memset(tsdkSearchParam, 0, sizeof(TSDK_S_SEARCH_CONTACTS_PARAM)); if (searchParam.acSearchItem.length > 0 && searchParam.acSearchItem != nil) { strcpy(tsdkSearchParam->search_keyword, [searchParam.acSearchItem UTF8String]); } tsdkSearchParam->page_index = searchParam.ulPageIndex; tsdkSearchParam->is_exact_search = searchParam.ulExactSearch; if (searchParam.acDepId.length > 0 && searchParam.acDepId != nil && ![searchParam.acDepId isEqualToString:@"-1"]) { strcpy(tsdkSearchParam->department_id, [searchParam.acDepId UTF8String]); } tsdkSearchParam->seq_no = searchParam.ulSeqNo; TSDK_RESULT result = tsdk_search_contacts(tsdkSearchParam); DDLogInfo(@"tsdk_search_contacts result: %d",result); free(tsdkSearchParam); } -
必選參數(shù)：
-
SDK收到服務(wù)器下發(fā)的查詢(xún)聯(lián)系人信息結(jié)果，上報(bào)TSDK_E_EADDR_EVT_SEARCH_CONTACTS_RESULT的事件，通知給UI所查詢(xún)的聯(lián)系人信息內(nèi)容。
說(shuō)明：
查詢(xún)到的聯(lián)系人信息包括：UC帳號(hào)、姓名、工號(hào)、IP號(hào)碼、部門(mén)名字、職務(wù)、郵箱、手機(jī)號(hào)碼、座機(jī)號(hào)碼、家庭電話(huà)、性別、郵編、地址、簽名和硬終端等內(nèi)容。
代碼示例：case TSDK_E_EADDR_EVT_SEARCH_CONTACTS_RESULT: { DDLogInfo(@"TSDK_E_EADDR_EVT_SEARCH_CONTACTS_RESULT"); BOOL result = notification.param1 == TSDK_SUCCESS; if (!result) { DDLogError(@"TSDK_E_EADDR_EVT_SEARCH_CONTACTS_RESULT,error:%@",[NSString stringWithUTF8String:(TSDK_CHAR *)notification.data]); return; } TSDK_S_SEARCH_CONTACTS_RESULT *searchContactorResult = (TSDK_S_SEARCH_CONTACTS_RESULT *)notification.data; if (searchContactorResult == NULL) { DDLogWarn(@"handleSearchContact result is empty."); return; } int pageIndex = searchContactorResult->page; int totalNum = searchContactorResult->total_num; TSDK_S_CONTACTS_INFO *pstContactorInfo = searchContactorResult->contact_info; //查詢(xún)配置自己軟終端號(hào) if (notification.param2 == 100) { if (pstContactorInfo != NULL) { ContactInfo *contactInfo = [ContactInfo contactInfoTransformFrom:pstContactorInfo[0]]; [[ManagerService callService] configBussinessAccount:contactInfo.terminal token:nil]; [eSpaceDBService sharedInstance].localDataManager = [[ESpaceLocalDataManager alloc] initWithUserAccount:contactInfo.staffAccount]; } return; } NSMutableArray *contactArray = [[NSMutableArray alloc] init]; // 搜索到的聯(lián)系人結(jié)果放入聯(lián)系人數(shù)組，傳遞給界面使用 for (int i = 0; i< totalNum; i++) { int lastTotal = totalNum - PAGE_ITEM_SIZE*(pageIndex-1); int endIndex = (lastTotal < PAGE_ITEM_SIZE) ? lastTotal : PAGE_ITEM_SIZE ; if (i == endIndex) { NSDictionary *resultInfo = @{ TUP_CONTACT_EVENT_RESULT_KEY : [NSNumber numberWithBool:result],TUP_CONTACT_KEY:contactArray }; [self respondsContactDelegateWithType:CONTACT_E_SEARCH_CONTACT_RESULT result:resultInfo]; return; } ContactInfo *contactInfo = [ContactInfo contactInfoTransformFrom:pstContactorInfo[i]]; DDLogInfo(@"contactInfo.personName: %@",contactInfo.personName); [contactArray addObject:contactInfo]; } NSDictionary *resultInfo = @{ TUP_CONTACT_EVENT_RESULT_KEY : [NSNumber numberWithBool:result],TUP_CONTACT_KEY:contactArray }; [self respondsContactDelegateWithType:CONTACT_E_SEARCH_CONTACT_RESULT result:resultInfo]; } break;
注意事項(xiàng)
無(wú)。
