2021/11/22 - 読み終える時間: ~1 分

資料などを含めた一覧記事は準備中ですが、まずは動画を公開します。9月分の公開について失念していました。申し訳ございません。

• テクてく Lotus 技術者夜会 2021年11月度リプレイ
• テクてく Lotus 技術者夜会 2021年9月度リプレイ

2021/11/22 - 読み終える時間: ~1 分

非常に長いタイトルですが、今回は ITmedia ビジネスオンラインに掲載された記事の紹介です。

HCL Domino は DX を実現するプラットフォームとしてノーコード、ローコードから複雑なアプリケーションまでカバーしています。クライアントもPCデスクトップからモバイル、ブラウザーまで全方位をカバーしています。HCL Domino 単体でも業務の多くをカバーできますが、外部連携機能も豊富に備えておりオープンなプラットフォームであり、より柔軟な対応が可能です。

そのような、非常に高いコストパフォーマンスを誇る HCL Domino について、実例を交えて解説されています。是非、ご一読ください。

• 「文系ひとり情シス」でもDXを諦めない　今注目のローコードプラットフォームが見せる可能性：モバイル運用環境も「3分」で実現できるHCL Notes/Dominoとは (ITmedia ビジネスオンライン)

2021/11/22 - 読み終える時間: 8 分

新しい試みのトライアルとして、1週間分のサポート技術情報更新のインデックスを作成してみました。しばらく継続してみます。新規追加と内容更新したものが含まれています。システム上、軽微な修正であってもリストに含まれてしまいます。予めご了解ください。

• KB0094692 (Unica Campaign) Unica Campaignのフローチャート実行時にout of memory エラーが発生する
• KB0094033 (Unica Campaign) HCL Unica Campaignにおけるメールリストディクショナリーのフォーマットは何か？
• KB0094540 (Unica Campaign) WAS上で新規にデプロイされたアプリケーション'Campaign'をクリックすると、'Error parsing XML'が発生する
• KB0094541 (Unica Campaign) タイトル:Unica CampaignがUnica Marketing Platformから異なったJVM上でデプロイされ、ログインできない
• KB0094623 (Unica Campaign) UNIX系のOSでError 10404への対処方法を知りたい
• KB0094669 (Unica Campaign) WASインストール時に自動的にWindowsサービスとして登録されてしまい、サービスを開始する時に次のようなエラーが発生する。 「Windowsは、'IBM WebSphere Application Server vX.X [マシン名] サービスをローカルコンピューターで開始できませんでした。エラー 1067: プロセスの予期しない終了」
• KB0094668 (Unica Platform) Windows Server2008でUnica製品実行中にログインページがブランクになる
• KB0094953 (Sametime) WebSocket 通信がブロックされると Sametime Meeting のロードに失敗する
• KB0089857 (Sametime) Sametime サーバーを Domino ディレクトリ認証で構築した場合に連絡先リストに日本語の別名を表示することは可能か
• KB0094952 (Sametime) STUN サーバーと Sametime Meetings サーバーに関する FAQ
• KB0085995 (Sametime) HCL Sametime の一部製品バージョンの販売終了とサポート終了の発表
• KB0090513 (Sametime) HCL Sametime 11.6 Premium インストールガイド
• KB0086101 (Domino Designer) 複数のIf/Else、While および For ステートメントを含む LotusScript コードのインデントが [Ctrl+I] キーで修正されないことがある
• KB0092615 (Domino Server) 「Unable to bind to XXX, bad ip address or unable to lookup ip address」エラー発生後HTTPタスクがシャットダウンしない
• KB0090616 (Domino Server) Domino Server で断続的なアクセス障害が発生する
• KB0089975 (Domino Server) DDM 調査文書 "アプリケーションコード" の "スケジュールより遅れたエージェント" が正しく動作しない
• KB0091378 (Domino Server) データベースのオンライン圧縮により Long Held Lock Dump メッセージが連続して表示され、サーバーがハングアップする
• KB0090610 (Domino Server) restart task update コマンドを実行する度に Update タスクが大量に起動する
• KB0094871 (Domino Server) サーバー接続文書の [複製するファイル/ディレクトリのパス] と [複製しないファイル/ディレクトリのパス] を同時に設定した動作について
• KB0092031 (Domino Server) Compact 実行中の複製により [設計要素] 等のチェックを外していても複製される
• KB0092829 (Domino Server) 日本語版 mail12.ntf と djxmail12.ntf のレプリカ ID が同じになっている
• KB0039905 (Domino Server) インターネットメール本文中にある URL リンクの折り返しについて
• KB0094897 (Domino Server) Domino for i: ランゲージパックをインストールすると Web ブラウザでの全文検索やプリファレンスの画面が文字化けする
• KB0090739 (Nomad) HCL Nomad Web (HCL Nomad for Web Browsers) 1.0.x リリース情報
• KB0090718 (Nomad) HCL Nomad for Web Browsers の制限事項
• KB0094970 (Nomad) HCL Nomad Web をアンインストール後にインストールができない場合の対処方法
• KB0094185 (Notes Client) 「JavaMaxHeapSize」の値を MB で指定すると mac 版 Notes が起動しない
• KB0094976 (Notes Client) メールデータベースの受信ボックスにおいて、送信者列でソートしたときの2次ソート列である日付列のソートが正しくない
• KB0089499 (Notes Client) ユーザー文書に転送アドレスが設定されているユーザーに会議招集を送信すると、不正なアドレスに変換されてしまう
• KB0089809 (Notes Client) 未読メールが「赤の標準テキスト」で表示されなくなった
• KB0089301 (Notes Client) 検索結果のビューから文書を選択してコピーを作成すると、選択した文書とは別の文書のコピーが作成される
• KB0094807 (Notes Client) Notes クライアントのワークスペース上のタブ名で「使い方」のタブ名が変わる場合がある
• KB0094186 (Notes Client) [macOS Big Sur]: 宛先、Cc、件名、会議の場所、メール本文などでのキーボード入力の問題
• KB0094188 (Notes Client) セクションの三角マークは印刷されますか
• KB0084060 (Traveler) HCL Traveler モバイルクライアントでの HTTP (非SSL) サポートの廃止
• KB0094822 (Volt MX) Play ストアにホストされる Android アプリケーションの必須 64 ビット要件
• KB0093959 (Volt MX) Iris/Visualizer からビルドされたモバイルアプリケーションが 1011 エラーコードをスローする
• KB0094765 (Volt MX) Chrome 開発者ツールで Android アプリケーションをデバッグできない
• KB0094785 (Volt MX) クラスのキャストの例外でオフラインオブジェクトの同期が失敗する
• KB0094705 (Volt MX) Microsoft Edge レガシー版および IE 11 のサポート終了について
• KB0094729 (Volt MX) ユニバーサルアプリケーションのビルド
• KB0094667 (Volt MX) Foundry App Key および App Secret の理解
• KB0094581 (Volt MX) Volt MX ワークフロー - 概要
• KB0094999 (BigFix Platform) コンソール使用中に Connection Error

2021/11/22 - 読み終える時間: 2 分

DX Transform Was … Truly Transformative の翻訳版です。

DX トランスフォームは ... 真に変革的だった

2021年11月17日

著者: Demetrios Nerris / Product Marketing Manager for HCL Digital Experience

コンステレーション・リサーチ社の主席アナリストであるリズ・ミラー氏がモデレーターを務め、HCL社のゲイリー・ショーチ氏とベッキー・クライトン氏のセッションを紹介しました。このセッションでは、成功するデジタルエクスペリエンスが持つべきすべての「スーパーパワー」の概要が紹介されました。DXPは、単なるウェブサイトとそのコンテンツではありません。強力なものは、「重要な瞬間」を提供し、信頼をもたらす体験を提供します。信頼は、パーソナライズされた、安全な、共感できる（文化的、地域的に調整された）、シームレスなデジタル体験によって生まれます。

お客さまのインタラクションやパーソナライズされたアクションは、必要なヘルプやサービスを受けるために不可欠な情報や専門知識につながるものでなければなりません。そのためには、バックエンドにあるすべてのデータと、デジタルタッチポイントや人々が関わる体験との間のギャップを埋める方法が必要です。

このギャップを埋めることができれば、企業は効率を高め、イノベーションを促進し、最終的には成長を促すことができます

組織はどのようにしてこれを実現するのか、そして本当に重要な瞬間とは何か（そしてそれはなぜ重要なのか）？ このセグメントを見る。

クラウドネイティブに注目する理由

コンステレーションリサーチ社のリズ・ミラー氏は、今日の組織にとってのクラウドの価値について、アナリストや経営者との説得力のある活発な会話を導き出しました。この座談会では、デジタル・エクスペリエンスに関連したクラウドのビジネス価値とは何か、そして主要なステークホルダーは誰なのかを探りました。専門家たちは、今日の世界で私たちが直面している課題を明らかにし、新しい働き方にはクラウドが提供するアジリティとモビリティが必要であることを示しました。また、クラウド・インフラストラクチャとクラウドネイティブ・ソリューションが、企業をITに関する懸念やボトルネックから解放し、企業の俊敏性を高め、ビジネスを革新と差別化に集中させることができることを説明しました。

続いて、IDCのリサーチディレクターであるマーシ・マドックスは、驚くべきことを話してくれました。2020年には、世界の人口約80億人のうち60％がオンラインになっています。これは大変な数のトラフィックです。そして、世界の組織の40％で大規模なトラフィックの増加が見られ、一部のサイトではそれに対応できないことがわかりました。IDCが行った調査によると、デジタルエクスペリエンスを提供する組織の70％が、クラウドネイティブなソリューションを好んでいることがわかりました。その理由は？それは、耐障害性、拡張性、アップタイムの確保です。これらはすべて、ブランドに対する必要な信頼と信用の構築につながります。

Perficient社のDXおよびコマース部門のエグゼクティブであるDave Torres氏は、クラウドによってIT部門は「ノー」ではなく「イエス」と簡単に言える組織になると説明しています。組織はもはや、稼働できないシステムに悩まされることはなく、ビジネスプロセスはより自動化され、更新はより自発的に行われるようになります。グーグルのロドリゴ・ロシャは、クラウドによって企業はインフラの心配をすることなく、ビジネスや市場の重要なニーズに集中することができると付け加えました。

クラウドはどのようにしてデジタルエクスペリエンスと "重要な瞬間 "をサポートするのでしょうか？企業は、必要なシステムやプロセスをオンラインやモバイルなど、あらゆる場所に配置することができるようになるため、顧客や関係者、パートナーに対して大規模に行動し、対応し、コミュニケーションをとることができます。また、ハイブリッド・クラウドは、既存のアプリケーションやプロセスを書き換えたり、やり直したりすることなく、最新の状態にすることができ、ビジネスに大きなメリットをもたらします。

誰が、何を、なぜ、どのようにして仕事をするのかということに加えて、もう一つの重要なことはデータです。この5年間で、私たちは過去10年間の2.5倍、180ゼタバイトという驚異的な量のデータを手にすることになります。 組織が成功するためには、データがサイロになっていないことが必要です。すべてのバックエンドシステムとプロセス（外部のパートナーや周辺のエコシステムからのものも含む）を織り交ぜて、フロントエンドでのシームレスな体験を実現する必要があります。そして、モバイルデバイスによって、私たちは日常生活に必要なすべての重要なデータに手に取るようにアクセスすることができます。

「今後5年間で、過去10年間に比べて2.5倍、180ゼタバイトという驚異的な量のデータを手にすることになります」

しかし、デジタルトランスフォーメーションのKPIとは何でしょうか？成功の尺度として共有され、合意されたものは何でしょうか？これを見て、その答えを探してみてください。

数十億ドル規模の企業を変革する方法

猛暑のドバイでは、人々は冷房の効いたショッピングモールに涼しさを求めます。 Al-Futtaim社は、このような必要不可欠なサービスとテクノロジーを提供しており、HCL Digital Experienceを使用して事業全体をデジタル化して規模を拡大し、強力なデジタルフットプリントを確立しました。アル・フッタイム社は、デジタル・エクスペリエンスを利用して、ブランド認知度の向上、顧客の獲得、eコマース事業の強化、そしてビジネスの成果を強力に達成しています。エンジニアリング部門の責任者であるHeman Dhagai氏は、デジタルソリューションに必要なのは、手頃な価格で、堅牢で、柔軟性があり、クラウド・ネイティブであることだと述べています。HCL Digital Experienceは、Al-Futtaim社のデジタル変革の鍵となりました。

20カ国に33,000人の従業員を擁し、複数の事業を展開する企業が混沌とした状況に陥らないためにはどうすればいいのか。

Al-Futtaim社は、拡大するデジタル組織を成長させ、進化させながら、どのようにして従来の側面を満足させることができたのでしょうか。成功の鍵となったバーチャルポータルとは？振り出しに戻る必要があったシナリオの原因は何か？このソリューションは、組織内のすべての異なるビジネスにどのように貢献したのか、また、各ビジネスユニットがより良い仕事をするためにどのように役立ったのか。ソリューションアーキテクトのArjit Boseが、このグローバル企業が業務全体を変革するために使用した具体的な戦略と戦術を詳細に説明します。彼らが言ったことについてはこちらをご覧ください。

カスタマー・エクスペリエンス・スタジオの登場

デジタルトランスフォーメーションがいかに重要であるか、そしてデジタルエクスペリエンスがその中心であることは、これまで以上に誰もが認めるところです。私たちが開発したCustomer Experience Studioは、企業がこれまでとは違った方法で物事を進めることができるようにするためのものです。このコーナーでは、HCLのデジタル・エージェンシーとデジタル・コンサルティングの経験（275年分）を活かして、統合、デジタル化、真のトランスフォーメーションを実現するために、お客様をどのように支援できるかをご紹介します。

私たちのアイデアを、お客様のビジネスのために100％パーソナライズされた戦略を無料で作成することで、お客様のために役立てたいと思っています。 今すぐDXアクセラレータプログラムに登録して、将来の成功のためのプランを作りましょう

お問い合わせはこちらから。

2021/11/22 - 読み終える時間: 3 分

Launching Z and I Emulator for Transformation in Japanese Language の翻訳版です。

HCL Z and I Emulator for Transformation の日本語環境での起動

2021年11月19日

著者: Tejaswini R / Developer at HCL Software

バージョン2.0から、ZIETransは以下のいずれかの方法でインストールできます。

• パッケージ配布: パッケージ配布：ZIETransおよび依存するすべてのツールがインストールされたeclipseを含む。
• プラグインリポジトリ: Eclipse（バージョン名：Oxygen）が既にインストールされている場合、ZIETransのプラグイン・リポジトリを使用して、必要なZIETransツールキットをインストールすることができます。WDT、JBoss、EMF、Window Builderなどの依存するプラグインは、ZIETransと一緒にインストールする必要があります。

"パッケージ配布/プラグインリポジトリともに、日本語を有効にするには、 ?vmargsの下に ?Duser.language=jaを追加する必要があります。"

注：ただし、OSのデフォルト言語が日本語の場合は、.iniファイルに-vmargsパラメータを設定する必要はありません。

注：パッケージ配布の場合は、ZIETrans.iniで以下のように日本語を設定してください。

図1：ZIETrans.iniに日本語を追加する

ZIETrans.iniに日本語を追加する手順は以下の通りです

1. https://archive.eclipse.org/technology/babel/index.php にアクセスしてください。
2. Babel Language Pack Update Site for Oxygen」-R0.16.0をダウンロードします。
3. eclipseの「Help」→「Install new Software」をクリックします。
4. 「Add」をクリックして、リポジトリの「Name」を指定し、「OK」をクリックします。

図2：日本語リポジトリの追加

5. 検索ボックスで日本語のテキストをフィルタリングします。

グラフィカル・ユーザー・インターフェース、テキスト 説明が自動的に生成されます。

図3：日本語機能の選択

6. 完了をクリックして、Babel日本語サポートアップデートサイトを日食にインストールします。

7. インストール後、変更を適用するためにeclipseを再起動してください。

8. 製品が日本語で起動します。

図4：日本語での起動

注：Note: プラグイン・リポジトリでは、eclipse.iniファイルで日本語を有効にしてください。

図5: eclipse.iniに日本語サポートを追加する

2021/11/18 - 読み終える時間: 2 分

Working with VersionVault Express outside the browser の翻訳版です。

ブラウザー以外での HCL VersionVault Express の操作

2021年11月17日

著者: John Kohl / Software Engineer

VersionVault Expressの主要なUIは、ブラウザベースのアプリケーションです。 単一のファイルの編集や保存、ファイルの比較や変更セットの確認、リベースやストリーム間の配信などの簡単なケースをサポートしています。 しかし、一度に複数のファイルを作業する必要がある場合はどうでしょうか？ あるいは、コードをテストするためにコンパイルする必要がありますか？ あるいは、自分の変更が他の開発者の同じ要素への変更と衝突してしまったら？ このような場合には、デスクトップ・クライアント・ツールを使用し、それらをVersionVault Expressサーバに接続することになります。

クライアント・ツールをセットアップしたら（詳しくは後述します）、コードのコピーをストリームから自分のコンピュータに取り込むには、スナップショットのダウンロードとビューの読み込みという2つの方法があります。

スナップショットのダウンロード

ストリームのスナップショットをダウンロードする方法は簡単です。ブラウザのインターフェースでストリームを表示しているときに、ダウンロード・スナップショット・アイコン（）をクリックするだけです。 これにより、ストリームの現在のバージョンを含むzipファイルが生成され、ダウンロードされます。

ストリームの読み取り専用コピーが必要な場合（変更内容をストリームに同期させる必要がなく、新しいスナップショットをダウンロードするたびにローカルコピー全体を置き換えても構わない場合）、これは現在の状態のコピーを取得するためのシンプルで迅速な方法です。 これは、ビルドやテストスイートを実行するのに適しているかもしれません。 しかし、もしあなたが変更を追跡し、プロジェクトのVOBにそれらをチェックバックする必要があるならば、VersionVault Expressクライアントによって管理されるビューが必要でしょう。

クライアントビューとサーバービュー

ビューは、VersionVault Expressプロジェクト内のストリームのコンテンツを表示するために使用されます。 各ビューは、ストリームのチェックインされたコンテンツと、バージョンコントロール下にないあなたが作成したファイルへのOSファイルシステムのアクセスを提供します。 ブラウザー・インターフェースやREST APIを介してストリームにアクセスすると、VersionVault Expressサーバー内で管理されるビューがあります。 しかし、そのビューはお客様のクライアントからは直接アクセスできません。

お客様のクライアントでのビューの作成

クライアント上で使用するビューを作成するには、VersionVault Expressクライアントをインストールする必要があります。 ブラウザのインターフェイスの右上にあるリンク（）をたどると、手順とインストール・パッケージが表示されます。 IDEとしてEclipseを使用している場合は、クライアントと一緒にインストールされるEclipseのアップデート・サイトからVersionVault Explorerプラグインを使用して拡張することができます（下記リンク先のドキュメントを参照）。

クライアントをインストールしたら、ブラウザのストリーム詳細ページ（）にある「open in VersionVault Explorer」のリンクをクリックして、クライアントのGUIを開き、同じストリームに新しいビューを作成（または既存のビューを再オープン）することができます。

VersionVault Explorerのクライアントを使用して、ストリーム上に自動ビューまたはWebビューを作成すると、サーバーで管理されているビューとは独立したビューが得られます。 クライアントのビューを作成した後は、VersionVault Explorerの "Refresh->Update from repository... "アクションや、'rcleartool update'コマンドライン・アクションによって、明示的にビューを更新した場合にのみ、他のビュー/ユーザからの変更が表示されます。 ビューを更新すると、ストリーム内の他のビューによって行われたチェックインされた変更に加えて、完了した配信やリベース操作によってストリームに追加された変更もピックアップされます。

クライアントでは、VersionVault Explorerやrcleartoolを使ってバージョンをチェックアウトし、お気に入りの編集ツールを使ってファイルに変更を加えることができます。 変更内容に満足したら、チェックインして、他のビューやストリームにアクセスする他のユーザーに見えるようにします。 ストリームビューのページで更新アイコンをクリックすると、ブラウザUIの基礎となるビューにチェックインされた変更が表示されます。 ストリーム上の他の自動ビューやウェブビューは、新しくチェックされた変更を表示するために更新が必要です。

変更内容をチームで共有する準備ができたら、配信操作を使って別のストリームにマージします。

配信とリベース

VersionVault Expressでは、ストリーム間での変更の移動にdeliverおよびrebaseオペレーションを使用します。 単純な変更であれば、ブラウザのUIで操作を行うことができます。 しかし、ブラウザUIはソース・ストリームとターゲット・ストリームに相反する変更を含むdeliverおよびrebaseのケースを扱うことができません。 2人の開発者がテキストファイルの同じセクションを変更した場合など、相反する変更がある場合は、クライアント上でビューを使用して、VersionVault Explorerやrcleartoolで配信やリベースの処理を行う必要があります。 (まだ両方のストリームにビューを持っていない場合は、操作を開始する前に作成することができます)。

VersionVault Explorerでは、Deliver->Defaultメニュー項目、またはツールバーのボタン( )から「Default Deliver」を使用してDeliverを行います。 リベースには、Rebase->Defaultメニュー項目、またはツールバーのボタン（ ）から「Default Rebase」を使用します。 VersionVault Explorerは、マージ・コンフリクトを解決するためのプロンプトを表示し、その後、操作を完了する前にビューで結果をテストすることができます（ターゲット・ストリームへの変更をチェックします）。

リベースや配信の後、ターゲット・ストリーム上の他のビューを更新することを忘れないでください。

まとめ

ここでは、VersionVaultクライアントを使用してVersionVault Expressサーバーを操作し、クライアント上で自動ビューまたはWebビューを作成し、維持する方法を学習しました。 また、VersionVault Expressプロジェクトの同じストリームにアクセスしている複数のビューで変更を可視化する方法や、クライアント上で複雑なリベースや配信操作を処理する方法についても学びました。

詳細はブログ・サイト をご覧ください。

2021/11/18 - 読み終える時間: ~1 分

HCL Nomad Mobile 1.0.17 for iOS が 2021年11月にリリースされます。今回の新機能は以下のとおりです。

• フローティングカーソルのサポート スペースキーを長押しして離すと、その場でカーソルを制御できる機能です (詳しくは下の Move your cursor with the keyboard — Apple Support - YouTube を参照)。

  
  

• ハードウェアキーボード使用時の QuickFind 機能 ビュー上で入力すると先頭一致で検索される QuickFnd 機能が利用できます。ソートされた列で検索されますが、ソートされていない場合は先頭列が自動的にソートされて検索を実行します。
  

• ユーザー文書の管理タブ上の使用マシンへの記録 これまで Nomad Mobile のデバイスは、ユーザー文書の使用マシン欄に反映されていませんでしたが、今回から記録されるようになりました。

  

参考: サポート技術情報: HCL Nomad Mobile のリリース履歴と製品ドキュメント

2021/11/18 - 読み終える時間: 7 分

Webhook basics の翻訳版です。

Webhook の基礎知識

2021年11月17日

著者: Mark Zukowsky / Senior Software Architect

はじめに

VersionVault Expressは、プロジェクト内で興味深いイベントが発生した際に、通知を送信するように設定することができます。これらの通知はWebhookと呼ばれます。Webhookは単純に、HTTPでPOSTリクエストとしてエンドポイントに送られるJSONペイロードです。HTTPのPOSTリクエストに応答できるシステムであれば、Webhookのエンドポイントとなり、任意のアクションを実行できます。この記事では、webhookに関連する基本的な情報を見ていきます。webhook定義の作成と更新には、プロジェクト内でビルダーの役割を持つユーザーが必要です。ロールについては、VersionVault Expressブログの「プロジェクト・チーム・メンバーのロール」を参照してください。

プロジェクトとストリームのWebhookの比較

VersionVault Expressでは、ユーザーはプロジェクトまたはプロジェクト内の個々のストリームのいずれかのコンテキストでWebhookを作成することができます。Webhookのトリガーの実装はすべてのWebhookで同じであり、プロジェクトとストリームのWebhookの違いは、どの基本的なイベントがWebhookのトリガーを引き起こすかということです。プロジェクトWebhookの作成は、プロジェクト設定ページのWebhookページで行い、ストリームWebhookの作成は、プライマリ・ストリーム・ページのWebhookページ（ストリームごとに移動）で行います。プロジェクトとストリームのどちらのWebhookを作成する場合でも、最初のWebhookを作成することができます。

Webhook定義画面

Webhookの作成画面は、選択できるイベントを除き、プロジェクトとストリームのWebhookで同じです。

webhookの作成画面は上記の通りです。右上のアクティブ・スライダーは、Webhookがトリガーするかどうかを示しています。webhookの定義を削除せずに、webhookのトリガーを止めたい場合があります。デフォルトでは、Webhookはトリガーします。

Webhook name (Webhook名)

Webhook nameは、Webhookの識別子です。

ペイロードURL

ペイロードURLは、リクエストに応答するエンドポイントの定義です。ペイロードURLは、JSONボディを持つHTTPリクエストを受け取り、ペイロードに基づいて必要なアクションを実行します。

シークレット

シークレットは、ペイロードの内容に基づいたハッシュをWebhookのHTTPヘッダに追加します。

ストリーム Webhook 用のイベントタイプ

Webhookのペイロード

各Webhookには、Webhookのトリガーとなったイベントに役立つさまざまな情報が含まれています。ペイロードの完全な情報については、ブログページ を参照してください。

SSL検証の無効化

デフォルトでは、サーバー証明書は利用可能な認証局に対してチェックされます。このオプションを選択すると、必要に応じて検証がバイパスされます。

Webhookの起動

Webhookが起動すると、HTTPリクエストがエンドポイントに送信されます。 ヘッダーのContent-Typeはapplication/jsonを示します。リクエストのボディはペイロードのJSON表現で、ペイロードの内容が含まれています。ペイロードのサンプルを以下に示します。すべてのWebhookのペイロードに共通するフィールドが含まれています。

Webhookの作成時にシークレットが指定されていた場合は、ペイロードとシークレットのハッシュ値を含む以下のような追加ヘッダーがHTTPリクエストに追加されます。

X-VV-Signature : sha256=866c3800b398bd8c97a575268b2dea7b6adc329a3052ffec140572ed86e61b1f

この署名は、秘密を知っているエンドポイントが再現することで、ペイロードが変更されていないことを確認できます。エンドポイントの設定方法については、VersionVault のブログサイトをご参照ください。

HTTPリクエストを送信すると、sendは指定されたエンドポイントとの接続が確立するまで最大60秒、接続が確立するとエンドポイントからの応答を受信するまで最大20秒待機します。エンドポイントがリクエストに対して意味のある形で応答することが重要です。サーバーは、エンドポイントからの応答に基づいて、以下のように行動します。

• エンドポイントが有効なレスポンスを返信した場合、ヘッダー、ボディ、レスポンスコード、レスポンステキストが取得され、Webhookの配信レコードとして保存されます。この配信記録を取得することで、Webhook配信のステータスを確認できます。

• エンドポイントから返信がない場合や、400シリーズのHTTPコードで返信された場合は、Webhookが再試行されます。この場合、配信記録は失敗の状態で更新され、60秒後に新しいリクエストが再送されます。この再試行サイクルは3回（合計3分）繰り返されます。すべての再試行でWebhookの送信に失敗し、受理されたステータスを受信した場合、このインスタンスのWebhookのトリガーについては、それ以上の再試行は行われません。失敗した試行のステータス情報は、webhookの情報画面から取得できます。

• 決して受信しないエンドポイントが設定されている場合：Webhookのペイロードは4回送信されます。

Webhookの配信記録

各Webhookは、配信試行のステータスの記録を保持します。VersionVault ExpressのUIでこれらの記録を確認すると、エンドポイントへの到達に問題がある場合や、エンドポイントに問題がある場合、あるいはまれに成功した場合などがあります。

まとめ

Webhookは、VersionVault ExpressまたはVersionVault Explorerデスクトップ・クライアントによって開始されたかどうかに関わらず、VersionVaultで発生したさまざまなイベントに基づいてアクションを起こすための強力な方法です。ペイロードを受信して処理するエンドポイントを適切に開発すれば、統合の可能性は無限に広がります。