統合
KontentZapier統合により自動化が容易になりました
By Eric Dugre
それで、Kentico Kontentプロジェクトを他の何百ものアプリケーションと統合したいのですが、自分でコードを書きたくないのですか?私たちの新しいネイティブZapier統合は、一日を節約するためにここにあります!
Zapierとは何ですか?
Zapierは、使いやすいインターフェースでトリガーとアクションを使用してタスクを自動化するのに役立ちます。これにより、チームは、コードを記述しなくても、Webサイトの自動展開などの複雑なタスクを実行できます。 Zapierの用語と使用法の詳細については、ガイドをご覧ください。開始するには、https://zapier.comで無料のアカウントを作成します。
短いデモを見て、実際の動作を確認してください。
ザップの作成
Zapierで自動化されたタスクが呼び出されザップ。 Zapの最初のステップは常にトリガーであり、Zapがいつ実行されるかを定義します。 ここで新しいZapを作成し、「Kontent」を検索して、Kontentトリガーを表示します。
Kontentのトリガーとアクションを使用するには、プロジェクトをZapierに登録する必要があります。ポップアップ表示されるウィンドウで、 [プロジェクト設定]> [APIキー]にあるキーを入力します。
セキュアアクセスが有効になっている場合、「Taxonomy Group Changed」トリガーを使用するには、このキーも指定する必要があります。
トリガーの最後の[データの検索]ペインで、[テストとレビュー]をクリックして、トリガーの出力のサンプルを表示できます。これは、後続の手順で使用できます。 2番目のステップでは、任意のアクションを選択できます。これは、Kontentアクションである必要はありません。たとえば、Gmail> [メールを送信]アクションを使用して、Kontentの言語バリアントで削除、作成、または復元操作が実行されるたびにメールを受信できます。アクションでは、ドロップダウンを使用して、トリガーからの値を電子メールに入力できます。
Zapのテスト
トリガーとアクションが完了したら、Zapをオンにする必要があります。これを行うと、統合によってKontentにWebhookが自動的に作成されます。何もする必要はありません。 Kontentで、Zapをトリガーするアクションを実行します。たとえば、この構成で「バリアントの作成、削除、または復元」トリガーを選択した場合、任意の言語で新しいバリアントを作成すると、Zapが実行されます。
しばらくすると、Zapが実行されます。 Kontent Webhookをデバッグし、 [プロジェクト設定]> [Webhook]でZapierにデータをPOSTする最新の試行を確認できます。 Zapierの[タスク履歴]ボタンをクリックして、各ステップで出力された実行とデータを表示することもできます。
Kontent統合
ZapierのネイティブKontent統合を使用すると、 トリガー、アクション、および検索を作成できます。
トリガー
トリガーは常にZapの最初のステップであり、Zapをいつ実行するかを定義します。 Kentico Kontent統合を使用すると、ZapierでZapを構成するだけで済みます。 KontentでのWebhookの作成は、統合によって自動的に処理されます。 ZapをオンにするとWebhookが作成され、オフにすると削除されます。
Kontent統合の各トリガーには、Zapをトリガーする1つ以上のアクションを指定できる[監視するイベント]フィールドがあります。ほとんどのトリガーでは、これを空のままにすると、アクションのいずれかが実行されたときにZapが実行されます。
現在、統合には4つのトリガーがあります。
- 変更されたバリアントワークフローステップ:プロジェクトから1つ以上のワークフローステップを選択します。バリアントがそのワークフローステップに移動するたびに、Zapがトリガーされます。
- バリアント公開ステータスが変更されました:公開または非公開を選択します。バリアントの公開ステータスがその状態に変わるたびに、Zapがトリガーされます。
- バリアントの作成、削除、または復元: [作成]、[削除]、または[復元]を選択します。これらのアクションがバリアントに対して実行されると、Zapがトリガーされます。
- タクソノミーグループの変更: [削除] 、 [復元] 、または[作成/更新]を選択します。これらのアクションが分類グループで実行されると、Zapがトリガーされます。
Zapierでのトリガの出力は正確に何であるKontentのウェブフックのZapierにポストします。次のようになります。
ほとんどのトリガーには、オプションの[サンプルのコンテンツタイプ]フィールドが含まれています。コンテンツタイプを選択した場合、トリガーの出力には、そのタイプのコンテンツアイテムのIDが含まれている必要があります。これにより、特定のコンテンツタイプからのデータの読み込みに依存している場合、Zapのテストが容易になります。
行動
アクションは、Kontentでデータを変更できるようにする手順です。現在、4つのアクションがあります。
- コンテンツアイテムの作成
- バリアントワークフローステップの変更
- 言語バリアントの更新
- 言語バリアントを削除する
これらのステップの多くにとって、あなたはKontentは、リンクされたアイテムの要素に例えば、理解することを特定の形式でデータを入力する必要があります。 Zapierが期待するフォーマットの説明は、ここのフィールドにあります。 Kontent統合に関して、アクションステップを提供するデータの例を次に示します。
- リンクされたアイテム:許容値は、コンテンツアイテムIDと外部IDです。これらは任意の組み合わせで使用できます。複数のリンクされたアイテムの場合、一部はアイテムIDにすることができ、一部は外部IDにすることができます。このフィールドのアイテムを検索する必要がある場合は、[コンテンツアイテムの検索]アクションを使用できます。各行に単一の値を追加することも、コンマで区切って複数の値を追加することもできます。たとえば、前のステップの出力は、「external_item_1、external_item_2」のような配列である可能性があります。この出力は、1行のリンクされたアイテムフィールドで参照できます。
- タクソノミー:このフィールドは、タクソノミーIDまたはコードネームを受け入れます。リンクされたアイテムと同様に、1行に1つの値、または1行にコンマ区切りの値を指定できます。
- アセット:分類フィールドと同様に、アセットのアセットIDまたはコードネームを指定でき、値はコンマで区切られた1行または複数行に追加できます。 [アセットの検索]アクションを使用して、プロジェクト内のアセットを検索できます。
- 日付と時刻:これは、 Zapierで指定された形式に従います。上記のスクリーンショットのように、前の手順で取得した値を渡すこともできます。許容可能な日時の例は次のとおりです。
- 2011年11月11日
- 2011年11月11日午後4時CST
- 次の金曜日の午後7時
- 2019-03-27T13:10:01.791Z
検索
KontentからのWebhook通知には、コンテンツアイテムIDや言語IDなどの基本情報しか含まれていないため、プロジェクトで詳細を検索する必要がある場合があります。たとえば、コンテンツアイテムに関するすべてのデータを読み込むには、[コンテンツアイテムの検索]アクションを使用できます。 id、codename、external_id、またはコンテンツタイプの要素のいずれかに基づいてアイテムを検索できます。
現在、4つの検索が利用可能です。
- コンテンツアイテムを探す
- ワークフローステップを見つける
- 言語を探す
- アセットを探す
もう1つの便利な例は、言語またはワークフローのステップIDをコードネームに変換することです。 Webhook通知には通常IDが含まれていますが、後でZapで言語コードネーム(「en-US」)を比較する必要がある場合、またはGoogleスプレッドシートに値を書き込んでいてユーザーフレンドリーな名前を追加する場合は、言語の検索ステップを追加できます。 IDを使用して言語を検索すると、出力に言語のすべての詳細が表示されます。
概要
これらのツールを使用すると、Kontentプロジェクトを他の何百ものアプリケーションと統合するために必要なすべてが揃っています。 Zapの例を見るには、 GitHubリポジトリをチェックしてください。統合を改善したり、問題が発生したりするアイデアがある場合は、 GitHubの問題を送信してください。