repo_zf1/documentation/manual/es/module_specs/Zend_Pdf-Properties.xml

<?xml version="1.0" encoding="UTF-8"?>
    <!-- EN-Revision: 17227 -->
    <!-- Reviewed: no -->
<sect1 id="zend.pdf.info">
    <!-- @todo review and revise upon completion of refactoring -->
    <title>Información del Documento y Metadatos</title>
    <para>
        Un documento
        <acronym>PDF</acronym>
        puede incluir información general como el título del documento, autor,
        la creación y
        modificación de fechas.
    </para>
    <para>
        Históricamente, esta información se almacena usando una estructura especial de
        Información.
        Esta estructura está disponible para lectura y la escritura como una array
        asociativo
        utilizando propiedades públicas
        <methodname>properties</methodname>
        de objetos
        <classname>Zend_Pdf</classname>
        :
        <programlisting language="php"><![CDATA[
$pdf = Zend_Pdf::load($pdfPath);

echo $pdf->properties['Title'] . "\n";
echo $pdf->properties['Author'] . "\n";

$pdf->properties['Title'] = 'New Title.';
$pdf->save($pdfPath);
]]></programlisting>
    </para>
    <para>
        Las siguientes claves están definidas por v1.4
        <acronym>PDF</acronym>
        (Acrobat 5) estándar:
        <itemizedlist>
            <listitem>
                <para>
                    <emphasis>Title</emphasis>
                    - string, opcional, el título del documento.
                </para>
            </listitem>
            <listitem>
                <para>
                    <emphasis>Author</emphasis>
                    - string, opcional, el nombre de la persona que creó
                    el documento.
                </para>
            </listitem>
            <listitem>
                <para>
                    <emphasis>Subject</emphasis>
                    - string, opcional, el tema del documento.
                </para>
            </listitem>
            <listitem>
                <para>
                    <emphasis>Keywords</emphasis>
                    - string, opcional, las palabras clave asociadas
                    con el documento.
                </para>
            </listitem>
            <listitem>
                <para>
                    <emphasis>Creator</emphasis>
                    - string, opcional, si el documento se convirtió
                    desde otro formato a
                    <acronym>PDF</acronym>
                    , el nombre de la aplicación (por ejemplo, Adobe
                    FrameMaker ®) que creó el
                    documento original a partir del cual se convirtió.
                </para>
            </listitem>
            <listitem>
                <para>
                    <emphasis>Producer</emphasis>
                    - string, opcional, si el documento se convirtió
                    desde otro formato a
                    <acronym>PDF</acronym>
                    , el nombre de la aplicación (por ejemplo, Acrobat
                    Distiller), que lo convirtió a
                    <acronym>PDF</acronym>
                    .
                </para>
            </listitem>
            <listitem>
                <para>
                    <emphasis>CreationDate</emphasis>
                    - string, opcional, la fecha y la hora en que
                    el documento fue creado, en la
                    forma siguiente: "D:YYYYMMDDHHmmSSOHH'mm'", en la
                    que:
                    <itemizedlist>
                        <listitem>
                            <para>
                                <emphasis>YYYY</emphasis>
                                es el año.
                            </para>
                        </listitem>
                        <listitem>
                            <para>
                                <emphasis>MM</emphasis>
                                es el mes.
                            </para>
                        </listitem>
                        <listitem>
                            <para>
                                <emphasis>DD</emphasis>
                                es el día (01–31).
                            </para>
                        </listitem>
                        <listitem>
                            <para>
                                <emphasis>HH</emphasis>
                                es la hora (00–23).
                            </para>
                        </listitem>
                        <listitem>
                            <para>
                                <emphasis>mm</emphasis>
                                es el minuto (00–59).
                            </para>
                        </listitem>
                        <listitem>
                            <para>
                                <emphasis>SS</emphasis>
                                es el segundo (00–59).
                            </para>
                        </listitem>
                        <listitem>
                            <para>
                                <emphasis>O</emphasis>
                                es la relación de la hora local a la hora
                                universal (UT),
                                identificado por uno de los caracteres +, -, o Z
                                (véase más
                                adelante).
                            </para>
                        </listitem>
                        <listitem>
                            <para>
                                <emphasis>HH</emphasis>
                                seguido de ' es el valor absoluto de la
                                posición de la UT en horas
                                (00-23).
                            </para>
                        </listitem>
                        <listitem>
                            <para>
                                <emphasis>mm</emphasis>
                                seguido de ' es el valor absoluto de la
                                posición de la UT en minutos
                                (00-59).
                            </para>
                        </listitem>
                    </itemizedlist>
                    El carácter apóstrofe (') después de HH mm es parte de la
                    sintaxis. Todos los
                    campos después del año son opcionales. (El prefijo D:,
                    aunque también opcional,
                    se recomienda fuertemente.) Los valores por defecto
                    para MM y DD son 01, y todos
                    los demás valores numéricos de los campos son cero
                    por defecto. Un signo más (+)
                    como el valor del campo O significa que la hora
                    local es más tarde que la UT, un
                    signo menos (-) que la hora local es anterior a
                    la UT, y la letra Z que la hora
                    local es igual a la UT. Si no se especifica la
                    información UT, la relación del
                    tiempo especificado para UT se considera
                    desconocida. Ya sea que la zona horaria
                    se conozca o no, el resto de la fecha
                    debe estar especificada en la hora local.
                </para>
                <para>Por ejemplo, el 23 de diciembre de 1998, a las 7:52 PM, hora estándar del
                    Pacífico de EE.UU., está representado por el string "D:199812231952-08'00'".
               </para>
            </listitem>
            <listitem>
                <para>
                    <emphasis>ModDate</emphasis>
                    - string, opcional, la fecha y la hora en que el
                    documento fue modificado mas
                    recientemente, de la misma forma que
                    <emphasis>CreationDate</emphasis>
                    .
                </para>
            </listitem>
            <listitem>
                <para>
                    <emphasis>Trapped</emphasis>
                    - booleano, opcional, indica si el documento ha
                    sido modificado para incluir la
                    captura de información.
                    <itemizedlist>
                        <listitem>
                            <para>
                                <emphasis>true</emphasis>
                                - El documento ha sido capturado; no se
                                necesitan más capturas.
                            </para>
                        </listitem>
                        <listitem>
                            <para>
                                <emphasis>false</emphasis>
                                - El documento aún no ha sido capturado;
                                cualquier captura todavía
                                debe ser hecha.
                            </para>
                        </listitem>
                        <listitem>
                            <para>
                                <emphasis>null</emphasis>
                                - O bien se desconoce si el documento ha
                                sido capturado o que lo ha
                                sido en parte pero no completamente
                                capturado, y alguna captura
                                adicional puede ser necesaria.
                            </para>
                        </listitem>
                    </itemizedlist>
                </para>
            </listitem>
        </itemizedlist>
    </para>

    <para>
        Desde
        <acronym>PDF</acronym>
        v 1.6 los metadatos se pueden almacenar en el documento
        <acronym>XML</acronym>
        especial adjunto al
        <acronym>PDF</acronym>
        (XMP -
        <ulink url="http://www.adobe.com/products/xmp/">Extensible
            Metadata Platform</ulink>
        ).
    </para>

    <para>
        Este documento
        <acronym>XML</acronym>
        se pueden recuperar y adjuntar al
        <acronym>PDF</acronym>
        con los
        métodos
        <methodname>Zend_Pdf::getMetadata()</methodname>
        y
        <methodname>Zend_Pdf::setMetadata($metadata)</methodname>
        :
        <programlisting language="php"><![CDATA[
$pdf = Zend_Pdf::load($pdfPath);
$metadata = $pdf->getMetadata();
$metadataDOM = new DOMDocument();
$metadataDOM->loadXML($metadata);

$xpath = new DOMXPath($metadataDOM);
$pdfPreffixNamespaceURI = $xpath->query('/rdf:RDF/rdf:Description')
                                ->item(0)
                                ->lookupNamespaceURI('pdf');
$xpath->registerNamespace('pdf', $pdfPreffixNamespaceURI);

$titleNode = $xpath->query('/rdf:RDF/rdf:Description/pdf:Title')->item(0);
$title = $titleNode->nodeValue;
...

$titleNode->nodeValue = 'New title';
$pdf->setMetadata($metadataDOM->saveXML());
$pdf->save($pdfPath);
]]></programlisting>
    </para>

    <para>Las propiedades comunes del documento se duplican en la estructura de Info y el documento
        Metadata (si se presentan). Ahora es responsabilidad del usuario la aplicación para
        mantenerlos sincronizados.</para>
</sect1>