用語集
DUST プラットフォームの用語をアルファベット順に掲載しています。ドキュメント本文では、これらの用語を一貫して使用しています。API エンドポイントのパスやフィールド名には、以前の実装名が残っている場合があります(各用語で注記しています)。
アクティベート
Section titled “アクティベート”ラベルの DUST マーキングを識別可能にし、Identifyスキャンでそのラベル、またはバインド後はそのスレッドを検出できるようにすることです。登録ステーションで登録されたラベルは検証のみの状態で作成され、アクティベートされるまでその状態が続きます。どのチームメンバーでも、ラベルまたはリール全体をアクティベートできます。これは管理者のみが行える操作ではありません。ラベルとリールを参照してください。
上流の提供元が開示した変更を、自分が保有するスレッドのコピーに取り込むことです。取り込みは同期ではなく、明示的な判断です。開示されたデータは取り込まなくても引き続き表示され、すでに取り込んだコピーは、提供元が後からそのデータを非開示化しても保持されます。開示を参照してください。
同じ識別子の 2 回のスキャンを、比較できる程度に相互に位置合わせできるかどうかを示します。改ざん分析の前提条件であり、分析結果ではありません。位置合わせが不十分である場合、その比較を利用できないという意味であり、アイテムに問題があることを意味するものではありません。
API キー
Section titled “API キー”サービスアカウントに発行され、API を呼び出す前に短時間有効なベアラートークンと交換する認証情報です。個人用 API キーは存在しません。キーとトークンにはサービスアカウントのすべてのアクセス権が付与されるため、ブラウザーではなく必ずサーバーに保管してください。認証を参照してください。
アーカイブ(識別子)
Section titled “アーカイブ(識別子)”識別子をスレッドから切り離さず、デフォルト表示から非表示にすることです。識別子を表示したままマークする無効化とは、表示上の扱いが反対です。この 2 つは独立しており、識別子はアーカイブ済み、無効、またはその両方の状態になり得ます。識別子とスキャンを参照してください。
アセンブリー
Section titled “アセンブリー”ほかのスレッドを付属部品としてまとめながら、それ自体も独立した完全なスレッドとして扱われるものです。独自の名前、フィールド、識別子、証明書を持ちます。アセンブリーは別のアセンブリー内に入れ子にできます。アセンブリー内から到達できるすべてのスレッドは、同じ所有チームに属します。
識別子をスレッドに関連付ける操作で、識別子エンドポイントを通じて実行します。バインド後に識別子をスキャンすると、そのスレッドに解決されます。
一括バインド
Section titled “一括バインド”リール範囲を、順序付けられたスレッドの選択対象に一度の操作でバインドすることです。範囲内の最初のラベルを最初のスレッドに、2 番目のラベルを 2 番目のスレッドに、という順序で対応付けます。処理は全件成功または全件失敗となり、位置が飛ばされることはありません。位置を飛ばすと、それ以降のすべての対応関係が暗黙のうちにずれてしまうためです。バインドする前に、対応リストで組み合わせをプレビューしてください。ラベルとリールを参照してください。
カメラコントロール
Section titled “カメラコントロール”DUST Camera Controls デスクトップアプリケーションです。Web サイトから接続済みのDragonを操作し、ブラウザーだけでは利用できないフォーカスや撮影の設定を行えます。これは任意であり、Dragon はこのアプリケーションを使用しなくても通常のカメラとして動作します。対応デバイスを参照してください。
スレッドを横断的に分類するグループです。フォルダーとは異なり、1 つのスレッドを同時に複数のカテゴリーに所属させることができます。カテゴリーは親カテゴリーの下に入れ子にしてサブカテゴリーにできます。所属関係は直接的なもので、上位カテゴリーへ集約されません。
スレッドのデータから特定時点の状態を反映して生成され、プラットフォームから発行される変更不能な PDF です。スレッドに添付されたリソースとして保存され、信頼状態(発行済みまたは無効)と来歴を示す記録が付随します。リソースのチェックサムが証明書のハッシュです。
証明書フォーム
Section titled “証明書フォーム”証明書のレイアウトと、そこに入力するスレッドデータを定義する、チーム所有の再利用可能なデザインです。証明書フォームはテンプレートではなくフィールド名(任意のエイリアスを含む)によって値を特定するため、所有、共有、移管されたスレッドのいずれについても証明書を生成できます。
異なる組織に属する 2 つのチーム間に継続して存在し、チーム間のすべての交換に使用される関係です。共有と出荷は接続を介してのみ開始できます。また、そのライフサイクル(保留中、接続済み、一時停止、削除済み)と方向(送信、受信、または双方向)によって、両者の間で何をやり取りできるかが決まります。同じ組織内のチームは、接続なしで共同作業できます。
切り分け(リール)
Section titled “切り分け(リール)”連続する範囲のラベルを、あるリールから別のリールに移動することです。これはスプールを切り分ける操作を台帳上で表したものであり、顧客の注文分を在庫から取り出す方法でもあります。範囲は最初と最後のラベルをスキャンするか、位置を入力して指定します。範囲内に移動できない位置(アーカイブ済み、出荷済み、または未登録)がある場合、それらは欠番として元のリールに残ります。移動後の数量はプレビューされ、注文数量を指定した場合はその数量との一致も強制されます。ラベルとリールを参照してください。
プラットフォームが確認したものではなく、個人または業務システムが申告する来歴の記録です。たとえば、物品の受領、検査の承認、販売などがあります。各記録には申告者が記録され、永続的に保持されます。アイテムの履歴とともに引き継がれ、撤回はできますが削除はできません。プラットフォームは申告内容を記録しますが、検証はしません。過去のイベントの記録と ERP の来歴を参照してください。
デザインバージョン
Section titled “デザインバージョン”公開ページデザインの変更不能な番号付きバージョンです。v1、v2、v3 のように、デザインの公開時に固定されます。公開ページモジュールで「バージョン」が指すのはこれだけです(ページ自体の公開は日付で識別され、番号は付けられません)。バージョンを公開しても、現在公開中のページは変更されません。ページに適用するには展開が必要で、適用方向は新しいバージョンへの一方向のみです。デザインバージョンが復元されることはなく、問題のあるバージョンは、さらに新しいバージョンを公開して修正します。
スレッドの所有者が、選択したデータ(フィールド、リソース、識別子、証明書)を Fabric を通じて下流から見えるようにする明示的な操作です。移管されたコピーはスナップショットです。提供元での編集は、所有者が明示的に開示した場合にのみ反映されます。一度行われた開示は、その連鎖上のすべての下流利用者に表示されます。
Dragon
Section titled “Dragon”USB 接続の DUST スキャナーです。独自の光学系で DUST マーキングを読み取るため、Loupeのようにスマートフォンのカメラを補助するのではなく、Dragon 自体が撮影を行います。卓上ではコンピューターに接続し、カメラコントロールアプリでフォーカスを制御できます。Android ではスマートフォンに接続し、DUST Goから直接操作します。対応デバイスを参照してください。
DUST(識別子)
Section titled “DUST(識別子)”物体に付けられた物理的な DUST マークです。画像としてスキャンされ、登録済みの識別子に対する識別または検証によってサーバー側で解決されます。DUST 識別子は物理的な個体識別情報を表し、スレッド間でコピーされることはありません。識別子とスキャンを参照してください。
DUST Go
Section titled “DUST Go”DUST 対応 Web エクスペリエンスのモバイルエントリーポイントです。Web ページを実行し、デバイスのスキャン用ハードウェアへのアクセスを提供するホストアプリです。iPhone では Loupeを装着したスマートフォンのカメラ、Android では USB 接続の Dragonを使用します。Web アプリは dust-go-connect ブリッジを通じて DUST Go と通信します。DUST Goを参照してください。
登録ステーション
Section titled “登録ステーション”API を通じてラベルをリールに登録するステーションです。通常は、ラベルを印刷または貼付する機械のそばに設置されます。無人で稼働するステーションは、デフォルトで検証のみとしてラベルを登録するため、Identifyスキャンで検出できるようにするにはラベルをアクティベートする必要があります。
特定のリール上の各ラベルに、種類ごとの識別子がいくつ付いているかを、種類ごとの数値で示したものです。登録時に、予定される識別子ごとに 1 つの撮影枠を用意するための指針となりますが、ラベルに実際に付けられる識別子を制限するものではありません。ラベルとリールを参照してください。
Fabric
Section titled “Fabric”プラットフォームのチーム横断的な来歴グラフです。スレッドが移管または分割されると、Fabric は提供元と派生スレッドの間に生じたリンクを記録し、そのリンクに沿って開示を伝達します。これは、リアルタイム共有や接続の状態とは無関係です。
スレッド上の、名前と型を持つ値です。テキスト、数値、日付、画像など、スレッドが表すアイテムを記述する属性が含まれます。テンプレートは、再利用可能なフィールドのセットを定義します。
スレッドやほかのフォルダーを整理する、入れ子可能なコンテナーです。1 つのスレッドが所属できるフォルダーは最大 1 つです(単一所属であり、カテゴリーとは異なります)。フォルダーを共有すると、その内容にもアクセス権が継承されます。
DUST 識別子がインデックス化され、Identifyスキャンで検出できる状態です。検証のみの反対です。DICE で登録された DUST マーキングはデフォルトで識別可能です。登録ステーションから登録されたものは、アクティベートされると識別可能になります。
スレッドに関連付けられた、スキャン可能な物理コードまたはデジタルコードです。DUST、QR、バーコード、Data Matrix、NFC などがあります。API で tag と呼ばれているもののユーザー向け名称です。エンドポイントのパスとフィールド名には、従来の名称(/api/v1/tags、tagType)が残っています。識別子と識別子とスキャンを参照してください。
Identify
Section titled “Identify”識別子をスキャンまたは入力してスレッドを検索する操作です。検索対象のチームはリクエストごとに設定します(API の searchTeamIds)。デフォルトでは、リクエストの実行対象となるチームです。識別子を参照してください。
1 つ以上の識別子が付いた 1 枚の物理的なラベルです。印刷されたテキストコード、DUST マーキング、QR コード、NFC チップ、バーコード、Data Matrix シンボルを任意に組み合わせて付けることができます。ラベルはリール上で製造され、リール上での物理的な位置を保持します。スレッドにバインドされるまで、ラベルは在庫として扱われます。バインドすると、そのラベルのすべての識別子が一度にスレッドへ付加されます。ラベルとリールを参照してください。
ラベルコレクション
Section titled “ラベルコレクション”リールをまとめるフォルダーです。整理のためだけに使用され、出荷されることはありません。スレッドを整理するフォルダーとは異なります。どのコレクションにも属していないリールは、コレクション未所属です。
スマートフォンの背面カメラ上に取り付け、DUST マーキングを拡大してスマートフォン自体のカメラで撮影できるようにする光学アクセサリーです。Loupe 自体はカメラではなく、機種ごとに専用です。それぞれの Loupe は、対応する MagSafe ケースに装着した特定のスマートフォンに適合します。対応デバイスを参照してください。
出荷またはその他の Fabric 操作に含める内容の下書きです。選択したスレッド、その中から選択したアセット、および一緒に引き継ぐアセンブリー、フォルダー、カテゴリーの構造が含まれます。出荷を送信すると、明細書は固定されます。
新しいスキャンをバインド時に撮影した基準画像と比較する際に、改ざん分析が数える DUST 粒子の 1 つです。識別子とは異なります。マーカーは、個々の DUST マーキングを構成する要素です。改ざん分析を参照してください。
チームとそのメンバーを含む、最上位のアカウント境界です。API リクエストでは、Dust-Ctx-Org-Id ヘッダーでアクティブな組織を指定します。規約を参照してください。
部品 / 位置
Section titled “部品 / 位置”部品は、アセンブリーに付加されたスレッドです。各スレッドが所属できるアセンブリーは最大 1 つで、デフォルトではそのアセンブリーのアクセス権を継承します。位置は、アセンブリーに付加されたスレッドのいずれかが割り当てられる、アセンブリー上の名前付きスレッド値フィールドです(たとえば「前輪」)。これはリール上のラベルの位置とは異なります。ラベルの位置は物理在庫の並び順を示すキーであり、アセンブリー上の割り当て枠ではありません。
一括バインドでバインド前に表示され、バインド後も保持される、位置とスレッドの対応表です。CSV としてダウンロードできるため、作業台の担当者は正しいラベルを正しいアイテムに貼付できます。リール範囲と選択内容から生成され、独立した記録として保存されることはありません。
スレッドを一般公開し、認証なしで閲覧できる Web 表示です。消費者は識別子をスキャンするか、印刷されたリンクを開いて、このデジタル製品パスポートにアクセスします。URL は永続的で、何も公開されていない段階でも予約し、その QR コードを印刷できます。それまでは「登録済み」の通知が表示されます。公開ページ自体はコンテンツ設定を持ちません。公開ページデザインが取得する内容をそのまま表示し、1 つのデザインバージョンと、そのデータに対する 1 回の公開に固定されます。公開ページを参照してください。
公開ページデザイン
Section titled “公開ページデザイン”そのデザインを通じて公開されるすべての公開ページの内容と外観を決める、再利用可能なチーム所有のデザインです。証明書フォームと同様に、スレッドデータをフィールド名で取得するブロックを順番に積み重ねて構成します。1 つのデザインを製品ライン全体に使用できます。編集しても、デザインバージョンを公開して展開するまでは、公開中の内容は何も変わりません。
フォルダー、カテゴリー、テンプレート、または明示的な選択範囲に含まれるすべての公開ページを、1 つのデザインバージョンで公開または再公開する、範囲指定されたバックグラウンド実行です。スレッドごとに成功と失敗が集計されます。失敗した対象について一括公開を再試行することも、キャンセルすることもできます。キャンセルすると、残りのページの処理は停止しますが、すでに公開されたページが元に戻ることはありません。
チームのメンバーシップに対する、「このチームのデータを公開できる」という権限です。公開ページモジュールでのすべての変更を制御します。これには、公開ページデザインの作成と公開、ページの公開と公開停止、展開、一括公開が含まれます。チーム管理者は常にこの権限を持ちます。この権限を持たないメンバーは、モジュールを読み取り専用で利用できます。パイプラインから公開できるように、サービスアカウントにも付与できます。
クイック作成
Section titled “クイック作成”新規スレッドを作成する別のフローです。任意の写真撮影ステップを開き、その後に短い作成ステップを表示します。詳細を追加 / 完全なフォームを選択すると、完全なフォームへ移動できます。組織ごとに有効化されるため、多くのチームでは代わりに完全なフォームが直接表示されます。はじめにを参照してください。
以前に行った開示からアセットを取り下げることです。下流のチームはそれ以降の詳細を見られなくなりますが、すでに取り込んだ内容は保持されます。開示済みの内容を未閲覧の状態に戻すことはできず、それ以降の提供を停止することだけができます。開示を参照してください。
ラベルが製造される物理的なロールであり、DICE がラベルを追跡する単位です。リールには名前(通常はスプールに印刷された番号)、任意の説明、予定構成があります。各ラベルはリール上の位置を保持します。これは並び順を示すキーで、ラベル自体には印刷されず、欠番があっても正常です。リールはチームの在庫の最上位、またはラベルコレクション内に配置されます。ラベルとリールを参照してください。
1 つのリール上にある位置の、連続した両端を含む範囲です。リール上の順序で読み取られ、一括バインドで使用する選択範囲となります。切り分けとは異なり、ラベルは元の場所に残ります。
同じチームが所有する 2 つのスレッドを接続するために使用する、方向を持つ関係の種類です(たとえば「供給元」)。関係リンクは自由形式の注釈です。部品としての付加とは異なり、アクセス権を付与せず、入れ子にもなりません。
スレッドに添付されたファイルです。文書、画像、その他のアップロードファイルが含まれます。リソースは明細書、分割、開示の対象として選択できます。
申告取引など、記録済みの項目に対して行える唯一の訂正です。消去ではなく、訂正情報を追加します。記録は将来の所有者とも共有されるため、元の項目とその撤回はどちらも取引ログに残ります。
スキャン範囲
Section titled “スキャン範囲”Identifyによる検索対象となるチームの集合です。すべてのスキャナー画面でこの名称を使用します。API では searchTeamIds として表され、デフォルトではリクエストの実行対象となるチームです。識別子とスキャンを参照してください。
サービスアカウント
Section titled “サービスアカウント”組織が所有する機械用の ID です。API 連携は個人ではなくサービスアカウントとして動作し、サービスアカウントがAPI キーを保持します。サービスアカウントは、個人とまったく同様に、操作可能なチームのメンバーになります。認証を参照してください。
自分のチームが所有者のまま、別のチームにスレッドまたはフォルダーへのリアルタイムアクセスを許可することです。相手のチームには、付与した役割とともに、その対象が共有済みビューに表示されます。アクセス権は取り消せます。所有権を完全に引き渡す移管とは異なります。共有とアクセスを参照してください。
DICE における移管のユーザー向け名称です。接続済みのチーム間で交換される、スレッドの送付または受領パッケージです。下書き、送信済み、受入済み、処理中の各状態を遷移し、受取側は受け入れ、拒否、変更要求を行えます。
提供元スレッドから選択したフィールド、ファイル、識別子をコピーまたはリンクして新しいスレッドを派生させ、Fabricにその系譜を記録することです。DUST 識別子は物理的な個体識別情報を表すため、分割先へコピーされることはありません。
DUST 識別子の新しいスキャンを、バインド時に撮影した基準画像と比較し、マーカーのカバー率に関する測定結果と視覚的な証拠レイヤーを生成するものです。結論は生成しません。プラットフォームは測定した内容を報告し、証拠を表示しますが、識別子が改ざんされたかどうかを判定することはなく、要約数値、評価、しきい値も提供しません。改ざん分析を参照してください。
改ざん分析所見
Section titled “改ざん分析所見”1 件の改ざん分析から人が導き出した独自の結論であり、プラットフォームが保存する唯一の結論です。結果は、整合、想定内(識別子のユースケースと基材に照らして通常の摩耗や損耗)、不整合、判断不能のいずれかです。デフォルト値はなく、明示的に選択します。所見には作成者が記録され、変更不能で、置き換えられることもありません。分析には一連の所見がすべて保持されます。評価対象は識別子の表面であり、スレッドや、それが表す物品ではありません。
組織内におけるアクセスと共同作業の範囲です。チームはスレッドとフォルダーを所有し、共有、接続、リクエストコンテキストの単位となります。リクエストヘッダーは Dust-Ctx-Team-Id です。Dust-Ctx-Grp-Id は以前の表記であり、現在もヘッダーのエイリアスとして受け付けられます(両方が送信された場合は Dust-Ctx-Team-Id が優先されます)。このエイリアスは、通信上に残っている唯一の「group」という名称です。リクエスト本文のフィールドでは、identify の searchTeamIds など、現在の表記を使用します。一部のエラーコード(GROUP_ID_REQUIRED)も名称変更以前のものです。規約を参照してください。
テンプレート
Section titled “テンプレート”スレッドが持つフィールドの再利用可能な定義です。スレッドを個別に作成する場合や、CSV などから一括インポートする場合に使用します。
テキストコード
Section titled “テキストコード”ラベルに印刷された、人が読める識別子です。スキャンする代わりにキーボードで入力します。カメラでコードを読み取れない場合の最後の入力手段であり、検証のみのラベルでも利用できる入力方法です。
プラットフォームの中心となる記録です。物理的な物品またはアイテムのデジタル ID を表します。スレッドはフィールド、リソース、識別子、証明書を保持し、フォルダー内に配置され、分類、共有、出荷、分割、開示できます。
スレッドバージョン
Section titled “スレッドバージョン”Fabricの連鎖上における、ある時点のスレッドの状態です。リアルタイムアクセス権がある場合の現在のデータである現在の状態に加え、移管、分割、または開示が連鎖の下流へ伝達された各時点の固定バージョンが含まれます。Fabricを参照してください。
スレッドに起きたすべての事象について、実行者とともに永続的に記録するものです。プラットフォームが確認したイベントと申告取引の両方が含まれます。アイテムとともに将来の所有者へ引き継がれ、項目が削除されることはなく、撤回のみが可能です。アクティビティを参照してください。
接続を介してスレッドをあるチームから別のチームへ移すことです。受取側は自らが完全に所有する新しいスレッドを受け取り、提供元のスレッドは終了扱いになり、Fabricが両者をリンクします。DICE では出荷として表示されます。受入時点を過ぎると元に戻せません。
スキャンした識別子が、特定のスレッドにバインドされた予定識別子と一致することを確認する操作です。申告された ID に対する「はい」または「いいえ」の確認であり、Identifyのような検索対象を限定しない探索とは異なります。識別子を参照してください。
申告されたスレッドに対して検証を行えば一致を確認できるものの、インデックス化されていないため Identifyでは検出できない DUST 識別子です。識別可能の反対です。アクティベートされるまで検索対象外にしておくべき在庫に対して、意図的に使用します。
利用者が管理するリンク先へリダイレクトする、永続的な公開 URL です。QR コードとしてアイテムに印刷でき、再印刷せずに後からリンク先を変更できます。Vlinkを参照してください。
無効化(識別子)
Section titled “無効化(識別子)”識別子が、そのアイテムの現行のマーキングではなくなったことを示す操作です。たとえば、DUST が破壊された、再度付けられた、またはマーキングされた素材部分が切除された場合に使用します。無効はラベルとして扱われます。識別子は完全な履歴を維持したままスレッドにバインドされ続け、識別子リストにも表示されたままになります(赤色で無効と表示されます)。その識別子は引き続き識別、検証、バインド解除が可能です。この操作は元に戻すことができ、基礎となる DUST の記録は変更されません。識別子をデフォルト表示から隠すアーカイブや、恒久的な証明書の無効化とは異なります。識別子とスキャンを参照してください。