本文介紹如何通過輕量訊息佇列(原 MNS)擷取IMM非同步任務的執行狀態訊息。
建立輕量訊息佇列(原 MNS)相關資源
步驟一:建立輕量訊息佇列主題
-
在左側導覽列選擇主題列表,並單擊建立主題。
-
在建立主題面板設定主題的相關資訊,如下以建立名稱為tf-test-mns-topic的主題為例。
設定訊息最大長度為
65536,啟用日誌功能選擇否。 -
單擊確定。
步驟二:建立輕量訊息佇列(原 MNS)隊列
-
在左側導覽列選擇隊列列表,並單擊建立隊列。
-
在建立隊列面板設定隊列的相關資訊,如下以建立名稱為tf-test-mns-queue的列隊為例。
隊列配置參數:訊息最大長度設定為 64 KB,長輪詢時間設定為 0 秒(即關閉長輪詢),訊息可見度逾時時間設定為 30 秒,訊息儲存時間長度設定為 4 天,訊息定時時間設定為 0 秒,啟用日誌功能保持關閉狀態。
-
單擊確定。
步驟三:關聯輕量訊息佇列(原 MNS)主題與隊列
-
在左側導覽列選擇主題列表,並單擊步驟一:建立輕量訊息佇列(原 MNS)主題中建立的主題名稱,即tf-test-mns-topic。
-
選擇訂閱列表,並單擊建立訂閱。
-
在建立訂閱面板,建立名稱為tf-test-mns-subscription的訂閱,如下所示。
-
訂閱類型:選擇隊列。
-
接收端地址:選擇tf-test-mns-queue,即步驟二:建立輕量訊息佇列(原 MNS)隊列中建立的隊列名稱。
-
訊息格式:選擇JSON。
-
-
單擊確定。
可選:建立OSS資源
如果阿里雲OSS中已有相關資源,可以跳過此步驟,自行發起IMM調用。
步驟一:建立Bucket
-
登入OSS管理主控台。
-
在左側導覽列選擇Bucket 列表,並單擊建立 Bucket。
-
在建立 Bucket面板,建立名稱為tf-test-oss-bucket的Bucket。
步驟二:上傳檔案
-
登入OSS管理主控台。
-
在左側導覽列選擇Bucket 列表,並單擊tf-test-oss-bucket,即步驟一:建立Bucket中建立的Bucket名稱。
-
單擊上傳文件,根據頁面提示上傳檔案1.docx,檔案上傳完成後即可進行下一步操作。
發起IMM調用
步驟一:建立Project
步驟二:發起IMM調用
-
登入OpenAPI平台。
-
在左側API列表選擇文檔處理>CreateOfficeConversionTask介面。
-
填寫以下參數資訊。
-
ProjectName:填寫tf-test-imm-project,即步驟一:建立Project中建立的專案名稱。
-
SourceURI:填寫oss://tf-test-oss-bucket/1.docx,即步驟二:上傳檔案中上傳或已經存在的OSS源檔案的儲存地址。
-
TargetURIPrefix:填寫oss://tf-test-oss-bucket/output,即文檔轉換後輸出檔案的儲存地址首碼。
-
TargetType:填寫png,即轉換輸出的目標檔案類型。
-
TopicName:填寫tf-test-mns-topic,即步驟一:建立輕量訊息佇列(原 MNS)主題中建立的輕量訊息佇列(原 MNS)主題名稱。
-
-
單擊發起調用。
接收輕量訊息佇列(原 MNS)訊息
-
在左側導覽列選擇隊列列表,單擊tf-test-mns-queue,即步驟二:建立輕量訊息佇列(原 MNS)隊列中建立的隊列名稱。
-
在隊列詳情頁面右上方單擊收發訊息。
-
在收發訊息頁面,單擊接收訊息,頁面會新增一條訊息。
接收到的訊息記錄包含 訊息ID、被消費次數、首次消費時間、訊息建立時間 和 操作(詳情、刪除)列。
-
在訊息所在行的操作列,單擊詳情,查看訊息詳情。
訊息詳情彈窗中包含基礎資訊(訊息 ID、被消費次數、首次消費時間、訊息建立時間、下次可見時間、訊息控制代碼)和訊息原始內容地區,其中訊息類型為
imm:Task:OfficeConversion,來源為acs.imm,表明 IMM 文檔轉換任務已成功觸發。下方還展示Base64 解碼後的訊息內容和訊息 MD5 內容。
常見問題
為什麼收不到輕量訊息佇列(原 MNS)訊息?
無法收到輕量訊息佇列(原 MNS)訊息時,請確認以下資訊:
-
檢查輕量訊息佇列(原 MNS)主題和IMM專案是否在同一個地區。
-
檢查輕量訊息佇列(原 MNS)主題和隊列是否綁定成功且訊息推送格式為JSON。
-
檢查是否有多個消費者在同時消費隊列。
-
檢查IMM專案授權角色是否有發送輕量訊息佇列(原 MNS)許可權,關於授權角色,請參見為專案配置授權角色。