Kafka プロデューサーステップ

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む2読むのに数分
  • Kafka 環境のトピックにイベントを公開するアクションを作成します。

    ロールと使用可用性

    Kafka プロデューサーステップはアクションデザイナーのアクションステップです。action_designer ロールを持つユーザーは、1 つ以上のアクションステップを使用してカスタムアクションを作成できます。

    このステップは Apache Kafka 向けストリームコネクト の一部で、Apache Kafka 向けストリームコネクト サブスクリプションが必要です。詳細については、「https://www.servicenow.com/products/automation-engine.html」を参照してください。

    このステップには、ServiceNow Integration Hub Action Step - Kafka Producer [com.glide.hub.action_step.kafka] プラグインが必要です。

    フィールド

    フィールド 説明
    トピック

    メッセージの公開先となるトピックの名前。1 つのトピックには同じタイプのメッセージが格納されます。たとえば、Payments という名前のトピックには最近の支払いに関するメッセージが格納されると考えられます。

    ドロップダウンリストからトピックを選択します。

    メッセージ メッセージのテキスト。
    キー 特定のパーティションのキーの名前。トピックはパーティションに分割できます。同じキーを持つメッセージは同じパーティションに格納されます。たとえば、6 月というキーを持つ支払に関するメッセージがすべて、Payments トピックの同じパーティションに保存されます。
    ヘッダー 名前と値のペアのメッセージのヘッダー。[名前] フィールドと [値] フィールドの両方で、値を入力するか、データピルを使用できます。
    完了待ち フローがステップの完了を待ってから続行するように要求するオプション。
    このステップが失敗した場合 エラー評価に進むか、次のステップの実行を続行するオプション。このオプションはステップステータスに影響しません。次のいずれかを選択します。
    • [アクションを停止し、エラー評価に進みます]:現在のステップでアクションの実行を停止し、エラーの評価に進みます。ステップステータスオブジェクトには、ステップによって返されたエラー情報が含まれています。
    • [アクションを停止せずに次のステップに進みます]:エラーを無視し、次のステップからアクションの実行を続行します。ステップステータスオブジェクトには、ステップによって返されたエラー情報が含まれています。アクションが引き続き実行されるかどうかに関係なく、アクションエラーの評価が実行されます。

    この例では、インシデントの作成を記録するメッセージを送信します。メッセージには、インシデント識別子、説明、およびメッセージヘッダーが含まれます。メッセージはインシデントトピックに送信され、インシデント識別子の名前がついたパーティションに格納されます。

    「Kafka プロデューサー」ステップの例。

    出力

    フィールド 説明 データタイプ
    ステップステータス ステップに関するランタイムの詳細を含むオブジェクトデータピル。アクションの各ステップはステップステータスを返します。 オブジェクト
    [ステップステータス] > [コード] ステップでエラーが発生したかどうかを示す整数データピルです。デフォルトでは、値 1 はステップでエラーが生成されたことを示します。値 0 は、ステップが正常に実行されたことを示します。これらのコードはカスタマイズできません。 整数
    [ステップステータス] > [メッセージ] ステップまたはシステム操作によって生成されたエラーメッセージを含む文字列データピル。このメッセージはカスタマイズできません。 文字列