關於索引的遠程控制

每當您的網站變更時,您都可以執行指令碼或程式,要求搜尋自動機使用遠端控制來執行索引。

使用遠程控制項為編製索引

遙控索引請求通常來自伺服器上的指令碼或程式。

自動機執行的索引步驟與從Index菜單手動啟動的步驟相同。 要提交遠程控制請求,請配置必要的密碼和響應字串。

如何發出遠程控制請求

要發出遠程控制請求,請根據資料中心的位置使用以下格式示例:

資料中心位置

範例

倫敦

https://center.lon5.atomz.com/search/cgiindex.tk? sp_a=sp99999999&sp_password=xxxxxx&sp_operation=op

北美

https://center.atomz.com/search/cgiindex.tk? sp_a=sp99999999&sp_password=xxxxxx&sp_operation=op

新加坡

https://center.sin2.atomz.com/search/cgiindex.tk? sp_a=sp99999999&sp_password=xxxxxx&sp_operation=op

字串與值

說明

sp_a= sp99999999

您的帳號。

您可以在Settings > Account Options > Account Settings 下找到您的帳戶號碼。

sp_lines= N

可讓您檢查正在運行的索引編目的狀態。

N 是正整數或全 。如果這是數值,則對應的索引記錄檔的最後一行 N 會包含在JSON回應中。

如果值為所有,則返回整個檔案。

如果值為 0 ,則不返回日誌資訊。 此值是運行索引狀態查詢的預設值。

sp_operation= op

可讓您指定下列其中一個要執行的索引作業:

  • full_index

    搜尋機器人會執行您網站的完整索引。

  • 增量索引

    搜索自動機使用在Index > Incremental Index > Configuration下設定的配置來運行增量索引。

  • 垂直索引

    搜索自動機使用在Index > > Configuration下設定的配置運行垂直更新。

    請參閱關於垂直更新

  • script_index

    搜索自動機使用在索引 > 指令碼化索引 > 配置下指定的文本檔案運行增量索引。

  • full_staged_index

    搜尋自動機會執行您網站的完整分段索引。

  • incremental_staged_index

    搜索自動機使用在Index > Incremental Index > Configuration下設定的配置來運行增量分段索引。

  • 垂直_staged_index

    搜索自動機使用在Index > Configuration下設定的配置運行垂直分段更新。

注意: 若要使用「垂直更新」,您可能需要由Adobe帳戶代表或Adobe支援在您的帳戶中啟用它。

請參閱關於垂直更新

您可以將 _saved 附加到上述任何 sp_operation 值,使搜索自動機嘗試使用保存的內容。 例如,您可以指定下列項目:

sp_operation=full_index_saved

sp_operation=full_staged_index_saved

或者,您可將 _status 附加至上述任何 sp_operation 值,以請求目前或最近的操作的狀態報告。 例如,您可以指定下列項目:

sp_operation=full_index_status

sp_operation=full_staged_index_status

結果會以JSON物件傳回。 包括 sp_lines=N 以包括關聯日誌檔案的N行。 如果N為負數,則會包含最後N行。

sp_operation= pushlive

可讓您遠端推送即時分段索引。

任何將 _saved 附加至推送即時作業的嘗試都會被忽略。

當您執行 pushlive 操作時,會將OK、Priority或Error響應文本字串返回到伺服器。 您可以在 Remote Control 頁面上指定這些響應字串。

請參閱配置遠程控制以編製索引

如果您在沒有分段索引時推送為即時,則不會發生任何動作,並傳回「確定」回應字串。

sp_password= xxxxxx

遙控密碼。

搜尋會以適當HTTP回應的形式傳回資料。 完整回應由HTTP狀態、HTTP回應標題、空白行和回應字串組成。

例如,假設您執行以下遠程控制請求:

https://center.atomz.com/search/cgiindex.tk?sp_a=sp99999999&sp_password=my-password&sp_operation=full_index

以下是來自伺服器的響應:

Status: 200 OK 
Content-type: text/plain 
OK

或者,假設您執行下列遠程控制狀態請求:

https://center.atomz.com/search/cgiindex.tk?sp_a=sp99999999&sp_password=my-password&sp_operation=full_index_status

來自伺服器的回應可能如下所示:

Status: 200 OK 
Content-type: application/json; charset=utf-8 
{ 
    "current_time": "2017-08-27T10:58:58-0700", 
    "start_time": "2017-07-25T16:40:07-0800", 
    "end_time": "2017-07-25T16:40:20-0800", 
    "elapsed_seconds": 13, 
    "elapsed_seconds_fmt": "13s", 
    "state": "finished", 
    "docs_indexed": 3, 
    "depth": 0, 
    "errors": 0, 
    "status": 1, 
    "message": "ok" 
}

要獲取與此索引操作關聯的日誌清單的前10行及其狀態,請使用以下查詢:

https://center.atomz.com/search/cgiindex.tk?sp_a=sp99999999&sp_password=my-password&sp_operation=full_index_status&sp_lines=10

來自伺服器的響應:

Status: 200 OK 
Content-type: application/json; charset=utf-8 
{ 
    "current_time": "2017-08-27T10:59:30-0700", 
    "start_time": "2017-07-25T16:40:07-0800", 
    "end_time": "2017-07-25T16:40:20-0800", 
    "elapsed_seconds": 13, 
    "elapsed_seconds_fmt": "13s", 
    "state": "finished", 
    "docs_indexed": 3, 
    "depth": 0, 
    "errors": 0, 
    "offset": 672, 
    "lines": [ 
        "07/25 16:40:07 PST   ======== Starting manual crawl of account sp99999999. ========", 
        "07/25 16:40:08 PST   Loading existing data", 
        "07/25 16:40:08 PST   Downloading entrypoint https://www.atomz.com/", 
        "07/25 16:40:08 PST   Robots.txt exclude mask: https://www.atomz.com/snap", 
        "07/25 16:40:08 PST   Exclude mask: regexp ^https://www.atomz.com/$", 
        "07/25 16:40:08 PST   Include mask: https://www.atomz.com/", 
        "07/25 16:40:08 PST   Downloading https://www.atomz.com/style.css", 
        "07/25 16:40:09 PST   Ignoring https://www.atomz.com/style.css, document type 'text/css'.", 
        "07/25 16:40:09 PST   Downloading https://www.atomz.com/privacy.html", 
        "07/25 16:40:09 PST   Downloading https://www.atomz.com/terms.html" 
    ], 
    "status": 1, 
    "message": "ok" 
}

請注意offset值。 此值標識日誌檔案中的檔案偏移位置,其中讀取為左。 若要讀取檔案中的​next​十行,請在此範例中,在傳送至伺服器的請求中加入&sp_offset=672

使用sp_offset,您可以有效地通過日誌檔案進行頁面設定。

若要取得記錄檔的​last​十行以及狀態,請將計數指定為負數。 例如,指定sp_lines=,其值為-10,如下所示:

https://center.atomz.com/search/cgiindex.tk?sp_a=sp99999999&sp_password=my-password&sp_operation=full_index_status&sp_lines=-10

來自伺服器的響應:

Status: 200 OK 
Content-type: application/json; charset=utf-8 
{ 
    "current_time": "2017-08-27T11:01:14-0700", 
    "start_time": "2017-07-25T16:40:07-0800", 
    "end_time": "2017-07-25T16:40:20-0800", 
    "elapsed_seconds": 13, 
    "elapsed_seconds_fmt": "13s", 
    "state": "finished", 
    "docs_indexed": 3, 
    "depth": 0, 
    "errors": 0, 
    "lines": [ 
        "07/25 16:40:20 PST   End Time: 07/25/2017 16:40:20 PST", 
        "07/25 16:40:20 PST   Elapsed Time: 13 seconds", 
        "07/25 16:40:20 PST   Pages Crawled: 3 pages", 
        "07/25 16:40:20 PST   Pages Indexed: 3 pages", 
        "07/25 16:40:20 PST   Words/Bytes Indexed: 2373 words/ 20618 bytes", 
        "07/25 16:40:20 PST   Errors: 0", 
        "07/25 16:40:20 PST   *** Index Summary ***", 
        "07/25 16:40:20 PST   Total Pages: 3", 
        "07/25 16:40:20 PST   --------------------------------------------------------------------", 
        "07/25 16:40:20 PST   ======== Finish manual crawl of account sp99999999: Done. ========" 
    ], 
    "status": 1, 
    "message": "ok" 
}

請注意,此處沒有返回offset值,因為此操作在檔案末尾完成,並且沒有其他行可供讀取。

配置遠程控制以編製索引

每當您的網站變更時,您都可以使用「遠端控制」從伺服器執行指令碼或程式,要求搜尋自動機執行索引。

配置遠程控制以編製索引

  1. 在產品功能表上,按一下「Index > Remote Control」。

  2. 在Remote Control頁面上,將每個配置欄位選項設定為能夠自動從伺服器提交索引請求以索引您的網站。

    選項

    說明

    遠程控制密碼

    指定遠程控制密碼。

    密碼區分大小寫,至少有6個字元長,且必須至少包含一個字母。 建議您也至少包含一個數字。

    請勿使用您的網站搜尋/銷售登入密碼。

    每個遠程控制請求都會使用您的密碼。

    確定響應字串

    可讓您在請求的索引操作成功開始時指定「確定」響應文本字串。 在這種情況下,搜索自動機將您的「確定」(OK)響應字串返回到伺服器。

    優先順序回應字串

    如果在執行遠程請求時正在執行另一個索引操作,則搜索自動機無法執行請求的索引。 在這種情況下,您的優先順序回應文字字串會傳回至伺服器。

    錯誤回應字串

    可讓您指定「錯誤」回應文字字串。如果您的密碼不正確,或是發生其他錯誤。 在這種情況下,搜索自動機會將錯誤響應字串返回伺服器。

  3. 按一下 Save Changes.

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free