This specification describes a Linked Data vocabulary for asserting Verifiable Credentials related to Appointments.

Introduction

This specification describes a Linked Data vocabulary for asserting Verifiable Credentials related to appointmnet information, such as attributes used to determine .

Use Cases and Requirements

The following use cases outline a number of key scenarios that readers might find useful:

Examples

The following examples are provided as a simple example of when this vocabulary is useful:


        

        

        

        

        

      

Terminology

The Appointment Vocabulary

This vocabulary assumes all terms specified in the base Verifiable Credentials [[VC-DATA-MODEL]] context. In addition, the following classes are available for specifying information related to appointments.

Class Description
AppointmentDetails Specifies that the subject of the credential has an appointment.
USCISAppointmentDetails Specifies that the subject of the credential has an appointment.
Appointment Specifies that the credential is an appointment card.

This document also specifies the following terms for expressing appointments:

Term Description
title A short summary of the appointment.
description A description of the appointment.
organizer The person who organised the appointment.
attendee The person or organisation attending the appointment.
startTime The (inclusive) scheduled start time for an appontment.
duration The time span that represents the scheduled duration of the appointment.
location The location of where the appointment takes place.
identifier An alternate identifier used to refer to information associated with the credential.

Title

A short summary of the appointment.

Term title
IRI http://schema.org/Text
Expected Value string

Description

A description of the appointment.

Term description
IRI http://schema.org/description
Expected Value string

Organizer

The person who organised the appointment.

Term organizer
IRI http://schema.org/attendee
Expected Value string

Attendee

The person or organisation attending the appointment.

Term attendee
IRI http://schema.org/attendee
Expected Value string

Start Time

The person or organisation attending the appointment.

Term startTime
IRI https://schema.org/DateTime
Expected Value DateTime

Duration

The time span that represents the scheduled duration of the appointment.

Term duration
IRI https://schema.org/Duration
Expected Value Duration

Location

The time span that represents the scheduled duration of the appointment.

Term start
IRI https://schema.org/location
Expected Value Location

Identifier

An alternate identifier used to refer to information associated with the credential.

Term identifier
IRI https://schema.org/identifier
Expected Value string

The USCIS Appointment Details Vocabulary

Term Description
title A short summary of the appointment.
description A description of the appointment.
organizer The person who organised the appointment.
applicant The person or organisation attending the uscis appointment.
startTime The (inclusive) scheduled start time for an appontment.
duration The time span that represents the scheduled duration of the appointment.
location The location of where the appointment takes place.
accountNumber A unique identification number issued by the USCIS online filing system account. You should have one account number for all cases submitted.
alienNumber A unique seven-, eight- or nine-digit number assigned to a noncitizen by the Department of Homeland Security.
receiptNumber

The receipt number is a unique 13-character identifier that USCIS provides for each application or petition it receives. The agency uses it to identify and track its cases.

The receipt number consists of three letters-for example, EAC, WAC, LIN, SRC, NBC, MSC or IOE-and 10 numbers. You can find it on notices of action USCIS has sent you.

caseType The specific application process associated with the applicant and their appointment.
appointmentType The nature of the appointment.
noticeDate The date the applicant was notified of the Appointment.
applicantLocation The applicant's physical address.

Title

Same as Title.

Description

Same as Description.

Organizer

Same as Organizer.

Applicant

Same as Attendee.

Start Time

Same as Start Time.

Duration

Same as Duration.

Location

Same as Location.

Account Number

A unique identification number issued by the USCIS online filing system account. You should have one account number for all cases submitted.

Term accountNumber
IRI https://w3id.org/appointment#AccountNumber
Expected Value string

Alien Number

A unique seven-, eight- or nine-digit number assigned to a noncitizen by the Department of Homeland Security.

Term alienNumber
IRI https://w3id.org/appointment#AlienNumber
Expected Value string

Receipt Number

The receipt number is a unique 13-character identifier that USCIS provides for each application or petition it receives. The agency uses it to identify and track its cases.

The receipt number consists of three letters-for example, EAC, WAC, LIN, SRC, NBC, MSC or IOE-and 10 numbers. You can find it on notices of action USCIS has sent you.

Term receiptNumber
IRI https://w3id.org/appointment#AlienNumber
Expected Value string

Case Type

The specific application process associated with the applicant and their appointment.

Term caseType
IRI https://w3id.org/appointment#CaseType
Expected Value string

Appointment Type

The nature of the appointment.

Term appointmentType
IRI https://w3id.org/appointment#AppointmentType
Expected Value string

Notice Date

The date the applicant was notified of the Appointment.

Term noticeDate
IRI https://schema.org/DateTime
Expected Value DateTime

Applicant Location

The applicant's physical address.

Term applicantLocation
IRI https://schema.org/location
Expected Value location

The Appointment Vocabulary

Term Description
name The name of the appointment.
description A description of the appointment.

Appointment

Specifies that the credential is an appointment.

Term Appointment
URL https://w3id.org/appointment#Appointment
Expected Value Class

Name

The name of the appointment.

Term name
IRI https://schema.org/name
Expected Value String

Description

A description of the appointment.

Term description
IRI https://schema.org/description
Expected Value String

Privacy Considerations

This section details the general privacy considerations and specific privacy implications of deploying this specification into production environments.

Security Considerations

There are a number of security considerations that implementers should be aware of when processing data described by this specification. Ignoring or not understanding the implications of this section can result in security vulnerabilities.

While this section attempts to highlight a broad set of security considerations, it is not a complete list. Implementers are urged to seek the advice of security and cryptography professionals when implementing mission critical systems using the technology outlined in this specification.

Accessibility Considerations

There are a number of accessibility considerations implementers should be aware of when processing data described in this specification. As with any web standards or protocols implementation, ignoring accessibility issues makes this information unusable to a large subset of the population. It is important to follow accessibility guidelines and standards, such as [[WCAG21]], to ensure all people, regardless of ability, can make use of this data. This is especially important when establishing systems utilizing cryptography, which have historically created problems for assistive technologies.

This section details the general accessibility considerations to take into account when utilizing this data model.

Internationalization Considerations

There are a number of internationalization considerations implementers should be aware of when publishing data described in this specification. As with any web standards or protocols implementation, ignoring internationalization makes it difficult for data to be produced and consumed across a disparate set of languages and societies, which would limit the applicability of the specification and significantly diminish its value as a standard.

This section outlines general internationalization considerations to take into account when utilizing this data model.