Hangfire.Tags

hangfire.tags

受搜索和分組缺乏的啟發，hangfire.tags提供了一種搜索和分組不同作業的方法。

貢獻者

• Yong Liu ：特別感謝您創建的所有拉動請求。太感謝了！
• 亞當·泰勒（Adam Taylor） ：MySQL支持

特徵

• 100％安全：從未更新由Hangfire管理的數據，因此沒有損壞數據的風險。
• 屬性：支持[tag（“ {0}”）]語法，用於創建作業時創建默認的標籤集。
• 擴展：在perfercontext上具有擴展方法，但也具有字符串上的擴展方法（例如，為jobid添加標籤）。
• 清理：使用懸掛式套裝，這些懸掛式套裝在刪除工作時會清理。
• 過濾：允許基於標籤和狀態過濾標籤，這使得具有特定標籤的失敗作業變得容易。
• 搜索：允許您搜索標籤
• 存放：有SQL Server，MySQL，PostgreSQL和初始REDIS支持的存儲空間
• 黑暗和光模式：支持hangfire的新的黑暗和光模式支持

設定

在.net Core的啟動.cs：

 public void ConfigureServices ( IServiceCollection services )
{
    services . AddHangfire ( config =>
    {
        config . UseSqlServerStorage ( " connectionSting " ) ;
        // config.UseTagsWithPostgreSql();
        // config.UseTagsWithMySql();
        // config.UseTagsWithRedis();
        config . UseTagsWithSql ( ) ;
    } ) ;
}

否則，

GlobalConfiguration . Configuration
    . UseSqlServerStorage ( " connectionSting " )
    //.UseTagsWithPostgreSql()
    //.UseTagsWithMySql()
    //.UseTagsWithRedis();
    . UseTagsWithSql ( ) ;

注意：如果您的儀表板和服務器單獨運行，則需要在兩者上調用UseTags() ， UseTagsWithSql() ， UseTagsWithPostgreSql() ， UseTagsWithMySql()或usetagswithmysql（）或UseTagsWithRedis() 。

SQL選項

如果您的數據庫中有自定義的掛斷模式，則需要將SQL選項傳遞給存儲方法。例如：

        var tagsOptions = new TagsOptions ( ) { TagsListStyle = TagsListStyle . Dropdown } ;
        var hangfireSqlOptions = new SqlServerStorageOptions
        {
            SchemaName = " MyCustomHangFireSchema " ,
        } ;
        services . AddHangfire ( hangfireConfig => hangfireConfig
            . SetDataCompatibilityLevel ( CompatibilityLevel . Version_180 )
            . UseColouredConsoleLogProvider ( )
            . UseSimpleAssemblyNameTypeSerializer ( )
            . UseRecommendedSerializerSettings ( )
            . UseSqlServerStorage ( " dbConnection " , hangfireSqlOptions )
            . UseTagsWithSql ( tagsOptions , hangfireSqlOptions )
        ) ;

其他選項

像往常一樣，您可以為UseTags()方法提供其他選項。

這是您可以配置的：

• tagcolor / darktagcolor-標籤的默認背景顏色
• TextColor / TextColor-標籤的默認文本顏色
• 標籤接口- 您可以指定自動完成標籤搜索（Yong Liu）
• 最大長度- 標籤的最大長度，自動設置為SQL Server的100

注意：最初添加hangfire.tag（或更改上面的選項）後，您可能需要清除瀏覽器緩存，因為瀏覽器可以緩存生成的CSS/JS。

提供者

為了正確清理過期的作業標籤，默認存儲提供商需要擴展名。目前，有三個提供商：對於SQL Server，用於PostgreSQL和MySQL。

標籤

hangfire.tags提供了PerformContext對象的擴展方法，因此您需要將其添加為作業參數。

注意：像IJobCancellationToken一樣， PerformContext是一種特殊的參數類型，hangfire將自動替代。在找到工作時，您應該通過null 。

現在您可以添加一個標籤：

 public void TaskMethod ( PerformContext context )
{
    context . AddTags ( " Hello, world! " ) ;
}

這導致標籤Hello-world。

您還可以使用屬性，在類上或方法（或兩者！）添加標籤。

 [ Tag ( " TaskMethod " ) ]
public void TaskMethod ( PerformContext context )
{
    ....
} 

搜索標籤

在儀表板中，單擊作業時，您會看到一個新的菜單項，稱為標籤。默認情況下，此頁面將顯示系統中所有定義的標籤。單擊標籤將顯示所有作業的列表，並附上該標籤。

顯示標籤的默認視圖是所謂的TagCloud。如果您喜歡自動完成的下拉列表，則可以使用選項指定：

 var options = new TagsOptions ( )
{
   TagsListStyle = TagsListStyle . Dropdown
} ;
config . UseTagsWithSql ( options ) ;

結果看起來像這樣：

執照

版權（c）2018 2face-it bv

特此免費獲得許可，免費授予任何獲得此軟件副本和相關文檔文件（“軟件”）的人，以無限制地處理軟件，包括無限制的使用權，複製，複製，修改，合併，發布，分發，分發，分發，分配，sublicense和/或允許軟件允許與以下條件相關的軟件，以下是以下條件。

上述版權通知和此許可通知應包含在軟件的所有副本或大量部分中。

該軟件是“原樣”提供的，沒有任何形式的明示或暗示保證，包括但不限於適銷性，特定目的的適用性和非侵權的保證。在任何情況下，作者或版權持有人都不應對任何索賠，損害賠償或其他責任責任，無論是在合同，侵權的訴訟中還是其他責任，是由軟件，使用或與軟件中的使用或其他交易有關的。