\documentclass[11pt,a4paper]{ivoa}
\input tthdefs

\usepackage[utf8]{inputenc}
\usepackage{booktabs, tabulary}    % for nicer tables
\usepackage[titletoc,toc,title]{appendix}

% make the text in pdf properly searchable
\usepackage{lmodern}

% use listings for including text files and code snippets
\usepackage{listings}
\usepackage{color}
\usepackage[nottoc]{tocbibind}

\definecolor{mygreen}{rgb}{0,0.6,0}
\definecolor{mygray}{rgb}{0.5,0.5,0.5}
\definecolor{mymauve}{rgb}{0.58,0,0.82}

\ivoagroup{DM}
\author{François Bonnarel}
\author{Kristin Riebe}
\author{Mathieu Servillat}
\author{Mireille Louys}
\author{Markus Nullmeier}
\author{Florian Rothmaier}
\author{Michèle Sanguillon}
\author{IVOA Data Model Working Group}

\editor{Kristin Riebe}
%\editor{Mathieu Servillat}

% smaller font in verbatim:
\usepackage{verbatimbox}

% for nicer tables:
\renewcommand{\arraystretch}{1.3}
\newcommand{\head}[1]{\textbf{#1}}

% define new command for classes and other stuff, in case we decide later on for a different style
\newcommand{\class}[1]{\emph{#1}}
\newcommand{\attribute}[1]{\texttt{#1}}
\newcommand{\attr}[1]{\texttt{#1}} % equivalent to \attribute

\newcommand{\urlparam}[1]{{\scriptsize{#1}}}
\newcommand{\urlvalue}[1]{{\scriptsize{#1}}}

% from https://tex.stackexchange.com/questions/121955/help-on-dealing-with-items-divided-with-slash
\renewcommand{\slash}{/\penalty\exhyphenpenalty\hspace{0pt}}

\begin{document}
\newcolumntype{Y}{>{\raggedright\arraybackslash}X}

\title{IVOA Provenance Simple Access Protocol (ProvSAP)}

\begin{abstract}
This document describes the ProvSAP protocol for accessing provenance information according to the IVOA ProvenanceDM standard.
It is a simple, light weight protocol. For extensive querying features, please see the ProvTAP protocol.
\end{abstract}

\section{Introduction}
We envision two access protocols:
\begin{itemize}
\item ProvSAP: retrieve provenance information based on given ID of a data entity or activity.
\item ProvTAP: allows detailed queries for provenance information, discovery of datasets based on e.g. code version. ProvTAP will be desribed in a separate standard document.
\end{itemize}

%ProvSAP is a data access layer service specialization for delivering IVOA Provenance metadata. A service implementing ProvSAP
%takes the ID of an entity, activity or agent as main parameter and returns its provenance metadata from a given service
%in the specified format, e.g. in W3C's PROV-N format.

There are two main reasons for ProvSAP:
\begin{itemize}
\item ProvSAP allows users to retrieve serializations for a given entity, activity or agent as W3C compatible serializations in one of the supported formats. This makes the provenance metadata that are provided via a ProvSAP interface very useful, since it can even be processed by tools that understand W3C provenance metadata.
\item Projects that have their own internal provenance data structure may not want to or cannot completely reorganize their database to comply with the ProvTAP specification. However, a ProvSAP layer on top of their individual data structure is less of an overhead and gives the opportunity to share the provenance data in a common serialization format with other tools.
\end{itemize}

Other reasons are:
\begin{itemize}
\item ProvSAP is a rather simple protocol and easy to implement
\item ProvSAP returns valid IVOA or W3C serializations, which can be processed or uploaded with other tools, or also placed into FITS-headers (e.g. in an extra block)
\item ProvSAP urls with ID parameter could be used as a point of reference, for refering to the provenance for a given entity.
\end{itemize}


\section{ProvSAP}
\input{provsap-section}



\section{VOSI availability and capabilities}
According to the DALI specification for VO services \citep{std:DALI}, a provenance service implementing ProvTAP must provide a VOSI availability interface as well as a capabilities interface with entries for ProvTAP. The \texttt{standardId}s for these provenance interfaces are:

\begin{verbatim}
ivo://ivoa.net/std/ProvenanceDM#ProvSAP-1.0
\end{verbatim}

The capability for a DAL service to support the ProvenanceDM is expressed by
the dataModel element as:
\begin{verbatim}
<dataModel ivoid="ivo://ivoa.net/std/ProvenanceDM-1.0">
  ProvenanceDM-1.0
</dataModel>
\end{verbatim}




\appendix
\section{Changes from Previous Versions}

\bibliography{ivoatex/ivoabib,prov-refs}


\end{document}
