| Docs Home | Help | Sign out

.

levelelement namenitf definitionNAR and NewsML-G2NAR definitionNotesATTRIBUTES

.

corenitf/@unoThe universally unique identifier for the document.newsItem/@guidThe persistent, universally unique identifier common for all versions of the Item.The NAR guid MUST be a URI

.

corenitf/@baselangBase language for document. Uses en-US (per ISO 639 and 3166).newsItem/contentMeta/language/@tag and newsItem/@xml:langA language used by the news content (language), and ... the language of this property and potentially all descendant properties.

.

powernitf/@classAn open placeholder for categorization.?

.

powernitf/head-NAR defines two headers: itemMeta and contentMeta.

.

powernitf/head/titleDocument titlenewsItem/itemMeta/titlea short natural language name for the Item.NAR title is repeatable.

.

powernitf/head/title/@typeA categorization for title. (Controlled vocabulary.) enumeration: 'main', 'subtitle', 'parttitle', 'alternate', 'abbrev', 'other'newsItem/itemMeta/title/@roleA refinement of the semantics of the label.The NAR role must be a qcode

.

powernitf/head/meta/@name and @contentRepeatable. A construct for sending generic metadata. Normally is undisplayed. Name used for this piece of metadata. Content associated with the specified name.-Extensibility is provided in the NAR via properties from a provider defined namespace.

.

powernitf/head/meta/@http-equivHTTP response header name.what the hell is it used for?

.

powernitf/head/tobjectSubject code. Used to identify the type of the news material, based on a Subject Code system.-

.

powernitf/head/tobject/@tobject.typeExpanded from News, Data, and Advisory. See NewsML topic set. Default is "news"newsItem/itemMeta/itemClassThe nature of the item, set in accordance with the structure of its content.The NAR value is a qcode. Warning: itemClass values are different from the NITF original values or NewsML NewsItemType values (News, Data, Advisory, Alert). An article will have an itemClass = "icls:text"

.

powernitf/head/tobject/tobject.property/@tobject.property.typeSubject code property. Assigns a property to the object type. Includes such items as analysis, feature, and obituary. Default is "current".newsItem/contentMeta/genreA nature, intellectual or journalistic form of the news contentNAR genre is repeatable. Value is a qcode or literal.

.

powernitf/head/tobject/tobject.subject/@tobject.subject.codeThree-letter code for the subject type. This attribute is deprecated.newsItem/contentMeta/subjectAn important topic of the news content; what the news content is aboutNAR subject is repeatable. Value is a qcode or literal. A legacy 3-letter code is permitted.

.

powernitf/head/tobject/tobject.subject/@tobject.subject.iprInformation provider reference. Default "IPTC"--In the NAR, the scheme is part of the subject qcode.

.

powernitf/head/tobject/tobject.subject/@tobject.subject.refnumEight-digit reference number for all three levels.newsItem/contentMeta/subject-NAR subject is repeatable. Value is a qcode or literal. qcode contains the ipr as a prefix. A mapping for this prefix must exist.

.

powernitf/head/tobject/tobject.subject/@tobject.subject.typeFirst-tier subject description.newsItem/contentMeta/subject/nameA natural language name for the conceptNAR name is repeatable.

.

powernitf/head/tobject/tobject.subject/@tobject.subject.matterSecond-tier subject descriptionnewsItem/contentMeta/subject/name-

.

powernitf/head/tobject/tobject.subject/@tobject.subject.detailThird-tier subject descriptionnewsItem/contentMeta/subject/name-

.

powernitf/head/iim/ds/@name and @valueIIM Record 2 Data Container. Location for IIM Record 2 DataSet information. IIM field number.*The IIM to NAR mapping is described in another document.

.

powernitf/head/docdata/@management-statusDefines whether this document is a cancellation of a previous doc, and other news management properties. Allowed values are usable,embargoed,withheld,canceled.ItemManagement/itemMeta/pubStatusThe publishing status of the Item, its value is "usable" by default.Same values in the NAR, but expressed as qcodes

.

powernitf/head/docdata/@management-doc-idrefUsed in conjunction with management-status. Details which document the current one is an update to, etc.newsItem/itemMeta/link/@hrefA link from the current Item to a target Item or Web resourceUsing a link supposes that the document is NOT considered as a news version of the referenced document.

.

powernitf/head/docdata/@management-idref-statusWhen a management-doc-idref is specified, this attribute contains the new status for that referenced document. Allowed values are usable,embargoed,withheld,canceled.-This feature is not present in the NAR. If the new instance is considered being a new version of a document, then the new version supercedes the previous version.

.

powernitf/head/docdata/correctionCorrection information. Indicates that the item is a correction to a previously published document.newsItem/itemMeta/signalAn instruction to the processor that the content requires special handling.The NAR signal takes a qcode as value, e.g. sig:correction, meaning that this is a correction of the previous version of a document.The NITF id-string and regsrc are not mapped.

.

powernitf/head/docdata/correction/@info and regsrcContains actual message or instructions regarding the correction. Identifies the source of the correction.newsItem/itemMeta/edNoteA note addressed to the editorial people receiving the Item.An editorial note may contain a correction message or instruction to the reader.

.

powernitf/head/docdata/evlocEvent location. Where an event took place (as opposed to where the story was written).newsItem/contentMeta/subject[@type="ctyp:event"]An important topic of the news content; what the news content is aboutNAR: the article "is about" the event location. The subject value is a qcode or literal, which identifies the location with the best available precision (from nitf @city, @state-prov, @county-dist or @iso-cc).

.

powernitf/head/docdata/evloc/@city or @state-prov or @county-dist or iso-ccCity or municipality name. State or province where the event occurred. County or district name. Country code as specified in ISO 3166.newsItem/contentMeta/subject[@type="ctyp:event"]/broaderAn identifier of a more generic concept.NAR: broader is repeatable; the value is a qcode of literal.

.

powernitf/head/docdata/doc-id/@id-string and @regsrcRegistered identification for document. Character string that provides a unique, persistent identification for a document.newsItem/@guidThe persistent, universally unique identifier common for all versions of the Item.NAR: the guid is a URI, and includes the notion of source of identification. There is already a nitf/@uno at the top.

.

powernitf/head/docdata/del-list/from-srcDelivery trail of delivery services. Holds an ordered list of the distribution services that have been involved in the delivery of the document. Delivery service identifier. Identifier used to track the transmission path of the document throughout the delivery process.-Not implemented in the NAR. Could make sense as a newsMessage property.

.

powernitf/head/docdata/urgency/@ed-urgNews importance. Can be used to set the priority for distribution but does not set the actual distribution priority.newsItem/contentMeta/urgencyThe editorial urgency of the content.Same values in nitf and NAR, but NAR accepts value 9.

.

powernitf/head/docdata/fixture/@fix-idSpecification for named document, such as Heard on the Street or On Language. Provides a consistent reference to a document whose content is refreshed periodically.newsItem/itemMeta/instanceOfA frequently updating information object that this Item is an instance of.

.

powernitf/head/docdata/date.issue/@normDate/time document was issued. If not provided, it is assumed to be on receipt. FRom the tutorial: date the item was published. Date/time value normalized to ISO 8601: YYYYMMDDTHHMMSS-HHMM (preferred) YYYYMMDDTHHMMSSZ (alternative). Use YYYYMMDD000000-HHMM when no time is available. Before the HHMM time, the - or + character may be used.newsItem/itemMeta/versionCreatedThe date and time on which the current version of the Item was created.the mapping is questionnable. To publish a document does not always happens at the time it is created. The NAR versionCreated is mandatory.

.

powernitf/head/docdata/date.release/@normDate/time document is available to be released. If not provided, it is assumed to be on receipt. From the nitf tutorial: Works in correspondence with docdata's management-status="embargoed" attribute. Earliest date at which the item may be published.newsItem/itemMeta/embargoedThe date and time before which all versions of the Item are embargoed. If absent, the Item is not embargoed.

.

powernitf/head/docdata/date.expire/@normDate/time at which the document has no validity. If not provided, it is assumed to be infinity.no existing mapping. The notion of expiration is not part of the NAR1.0

.

powernitf/head/docdata/doc-scope/@scopeIndicates an area where the document may be of interest. Where a non-category interest may be specified. These are often geographic in origin, such as Pacific Northwest.newsItem/contentMeta/audienceAn intended audience for the content.

.

powernitf/head/docdata/series/@series.nameSeries information. Identification of an article within a series of related articles.newsItem/itemMeta/memberOfA set of Items around the same theme that this Item is part of.the nitf name will be mapped to a literal value

.

powernitf/head/docdata/series/@series.partNumeric order of this article within the series.no such data in NAR1.0

.

powernitf/head/docdata/series/@series.totalpartTotal or expected number of articles in the series; use 0 if unknown or indefinite.no such data in NAR1.0

.

powernitf/head/docdata/ed-msg/@infoNon-publishable editorial message from provider or editor of item. Place where an information provider can send a note to the editor about the contents of the story. Contains the actual message for the editorial message.newsItem/itemMeta/edNoteA note addressed to the editorial people receiving the Item.In case of a correction, another string is mapped as a edNote, which is repeatable.

.

powernitf/head/docdata/ed-msg/@msg-typeThe type of message. Providers are urged to use consistent values.newsItem/itemMeta/edNote/@rolerole is a qcode.

.

powernitf/head/docdata/du-key/@key @part @version @generationDynamic Use Key, created daily. Has tree structure indicated by defined form. Provides a mechanism for grouping and updating versions of stories. The du-key is unique to a story during a period fixed by the provider. After the time has elapsed, the reference is available for reuse.?No real NAR equivalent. Could be mapped to instanceOf or altId, with a transform of the composite structure.

.

powernitf/head/docdata/doc.copyright/@holderCopyright information for document header. A metadata location for the information about the holder of the document copyright. This information should be consistant with information in the copyrite tag.newsItem/rightsInfo/copyrightHolderThe person or organisation claiming the intellectual property for the content.A literal value will be used.

.

powernitf/head/docdata/doc.copyright/@yearCopyright information for document header. A metadata location for the information about the year of the document copyright. This information should be consistant with information in the copyrite tag.No such notion in the NAR: the copyright holder is associated with the item at the date the item is created.

.

powernitf/head/docdata/doc.rights/@*Rights information for use of the document. Used when the rights holder is not the same as the copyright holder. This information should be consistant with that in the series of rights tags.newsItem/rightsInfo/usageTermsA natural-language statement about the usage terms pertaining to the content.As the NAR property is a label, a free-text expression must be processed on the fly from the NITF attribute values... until a REL is chosen by the IPTC.

.

powernitf/head/docdata/keylist/keyword/@keyList of keywords. Holds a list of keywords about the document. Keyword. Can also be a phrase. Holds the keyword or phrase itself.newsItem/contentMeta/subjectAn important topic of the news content; what the news content is aboutThis was a question raise in the NAR WP: should we have a <keyword> property different from the <subject> property, for things that are not what the news is about? Ultimately the agreement was not to create it.

.

powernitf/head/docdata/identified-content/*Holds content identifiers that can apply to document as a whole. The elements this holds also appear in paragraphs. Note that its children should be EMPTY . content mode (person | org | location | event | function | object.title | virtloc | classifier)*newsItem/contentMeta/subject"Each extracted concept is considered a subject of the news content.

.

powernitf/head/pubdataRepeatable. Information about specific instance of an item's publication. Contains metadata about how the particular news object was used in a specific instance.Correspond to publication metadata, not yet included in the NAR.

.

powernitf/head/revision-historyRepeatable. Information about the creative history of the document; also used as an audit trail. Includes who made changes, when the changes were made, and why.In the NAR, each property may be marked up with individual qualifiers expressing who and when the property was created or modified.

.

corenitf/bodyThe content portion of the NITF document. All items within body are meant for display to the user.

.

corenitf/body/body.headMetadata intended to be displayed to the reader. Holds content such as headline, byline, etc.

.

corenitf/body/body.head/hedlineContainer for main headline and subheadlines. Provides a generally-dependable component for display in search results.

.

corenitf/body/body.head/hedline/hl1Headline 1 (main-headline). The primary headline of the story.newsItem/descriptiveMetadata/headlineA brief and snappy introduction to the news content, designed to catch the reader's attention.

.

corenitf/body/body.head/hedline/hl2Headline 2 (sub-headline) A subordinate headline for the article.

.

powernoteDocument cautionary note. Potentially publishable.newsItem/itemManagement/edNoteA note addressed to the editorial people receiving the Item.

.

powernitf/body/body.head/rightsInformation on rights holder. Rights to news material other than the copyrights, such as archival, syndication, or distribution.newsItem/rightsInfoIf this is publishable information, one could advocate that labels would be easier to process for recipients. If this is pure metadata, it should be mapped to a future recommended NewsML-G2 REL.

.

powernitf/body/body.head/rights.ownerRights owner Owner of the rights to the material.newsItem/rightsInfo/copyrightHolderThe person or organisation claiming the intellectual property for the content.

.

powernitf/body/body.head/rights.startdateRights start date. Initial reference date for material rights.???

.

powernitf/body/body.head/rights.enddateRights end date. Terminal reference date for material rights.???

.

powernitf/body/body.head/rights.agentRights agent. Name of the agent that holds the rights to the material.newsItem/rightsInfo/accountableAn individual accountable for the content in legal terms.

.

powernitf/body/body.head/rights.geographyArea to which rights apply. A geographic area.???

.

powernitf/body/body.head/rights.typeType of rights claimed. Type of material rights claimed (such as distribution).newsItem/rightsInfo/usageTermsA natural-language statement about the usage terms pertaining to the content.

.

powernitf/body/body.head/rights.limitationsLimitations (exclusive / nonexclusive) of rights. Limitation on use of material rights.newsItem/rightsInfo/usageTermsA natural-language statement about the usage terms pertaining to the content.

.

corenitf/body/body.head/bylineContainer for byline information. Can either be structured with direct specification of the responsible person / entity and their title or unstructured text can be provided.newsItem/descriptiveMetadata/byA natural-language statement of the authot/creator information.

.

corenitf/body/body.head/byline/byttlByline title. Often contains an organization. Title of the person, or entity associated with the byline and a specified person.newsItem/descriptiveMetadata/byA natural-language statement of the authot/creator information.

.

powernitf/body/body.head/distributorInformation distributor. May or may not be the owner or creator.???

.

corenitf/body/body.head/datelineContainer for dateline information. The date and location where the story was created.newsItem/descriptiveMetadata/datelineA natural-language statement of the date and/or place of creation of the content.

.

corenitf/body/body.head/dateline/story.dateDate of story. Printable date.???

.

corenitf/body/body.head/abstractStory abstract summary or synopsis of the contents of the document.newsItem/contentMeta/description[type='drol:abstract']

.

powercopyriteContainer for copyright information. A displayable statement about who owns the copyright to the article.newsItem/rightsInfo/copyrightNoticeAny necessary copyright notice for claiming the intellectual property for the content.

.

powercopyrite/copyrite.yearCopyright year The year the copyright ownership was established.???

.

powercopyrite/copyrite.holderCopyright holder. The name of the holder of the copyright.newsItem/rightsInfo/copyrightHolderThe person or organisation claiming the intellectual property for the content.

.

corebody.contentActual body content. Holds paragraphs, lists, tables, media, and other containers.-

.

coreblockA group of related containers. This container can be used to organize a set of related containers, such as a sidebar.-

.

corepParagraph. An organized set of sentences.-

.

coretableTable of data. Form is like the form of HTML tables.-

.

coremediaGeneralized media object. Used to package up a reference to an image, audio, video, etc. with its caption and credit.-

.

coremedia/media-referenceReference to an external media object, OR to its following media-object. Points to any object, such as photo, audio, video and text; or to executable files.*

.

coremedia/media-metadataGeneric metadata placeholder. Used when the attributes of media-reference do not suffice.*

.

coremedia/media-objectInline media data. Holds binary information, or some other encoded format.*

.

coremedia/media-captionText describing media. Often rendered beneath a photo or video.*

.

coremedia/media-producerByline of media producer. Also used as a credit for the media.*

.

coreolOrdered list. Holds list items.-

.

coreulUnordered list. Holds list items.-

.

coreliList item. Holds content that is presented within a list.-

.

coredlDefinition list. Holds terms and their definitions.-

.

coredl/dtDefinition term. Holds the content that is to be defined.-

.

coredl/ddDefinition data. Holds the definition of the term.-

.

corebqBlock quote. An extended quotation.-

.

corebq/creditNames the source of the block quote. Provides attribution for a block quote.-

.

corefnFootnote. Notes that are often rendered at the end of a document.-

.

coreprePreformatted information. Carriage returns and fixed-width spacing should be maintained.-

.

corehrHorizontal rule. A rendered divider between sections of text.-

.

powerblock/datasourceSource of the information grouped in a block element. Cites the source of block content. Allowed only at end of block.?Seems to be for explaining where a block of content is from (e.g. "These quotes originate from NASDAQ"

.

coretable/captionText for the caption of a table. Appears only within the table element.-

.

corecolColumn. Used to specify formatting for a table column.-

.

coretable/colgroupColumn group. Used to specify formatting for a table column.-

.

coretable/theadTable heading. Used to group rows that can consistently be displayed atop a table.-

.

coretable/tbodyTable body. Holds the bulk of the data rows of a table.-

.

coretable/tfootTable footer. Used to group rows that can consistently be displayed below a table.-

.

coretrTable row. Holds cells of a table.-

.

coretr/thTable header cell. Holds content intended to be a label.-

.

coretr/tdTable data cell. Holds content intended to be data.-

.

powerchronDate and time. Used to normalize inline date and time references.?Could use id of chron as anchor for information about the date (e.g. with more information via qcode or concept item, etc.)

.

powereventAn event. An activity that is considered newsworthy.?Gateway for EventsML-G2

.

powerfunctionRole played by a person. Can be either a description, such as interior decorator, or a formal title, such as president, chairman, owner, captain, manager.?Use id of function to provide person metadata

.

powerlocationSignificant place mentioned in an article. Used to normalize locations.?Use id of location as hook for POIDetails information.

.

powerlocation/sublocationNamed region within city or state. Generic holder for more detailed location information.?Use id of location as hook for POIDetails information.

.

powerlocation/cityCity, town, village, etc. Used to normalize city, town names.?Use id of location as hook for POIDetails information.

.

powerlocation/stateState or province or region. Used to normalize these locations.?Use id of location as hook for POIDetails information.

.

powerlocation/regionGeographic area. Used to normalize regions.?Use id of location as hook for POIDetails information.

.

powerlocation/countryGeographic area with a government. Used to normalize countries.?Use id of location as hook for POIDetails information.

.

powermoneyMonetary item. Used to identify units of money.?No exact equivalent in NAR

.

powernumNumeric data. Used to normalize numbers.?No exact equivalent in NAR

.

powernum/fracFraction. Separates the numerator from the denominator.?No exact equivalent in NAR

.

powernum/frac/numerFraction numerator. The top part of a fraction.?No exact equivalent in NAR

.

powernum/frac/frac-sepFraction separator. Holds the preferred character, normally a slash.?No exact equivalent in NAR

.

powernum/frac/denomFraction denominator. The bottom part of a fraction.?No exact equivalent in NAR

.

powernum/subSubscript. Generally rendered in small type and vertically aligned lower than the main text.?No exact equivalent in NAR

.

powernum/supSuperscript. Generally rendered in small type and vertically aligned higher than the main text.?No exact equivalent in NAR

.

coreobject.titleTitle of inline object such as book, song, artwork, etc. Used to normalize these values.-Can use id as a hook for inlineRef

.

coreorgOrganization. Used for companies (both private and public) and non-profits.-Can use id as a hook for inlineRef

.

corealt-codeAn alternate symbol for the phrase. Used when an item has more than one symbol behind it.-Can use id as a hook for inlineRef

.

corepersonHuman individual. Used to normalize people. If person has one name, like Cher or Madonna, use name.given.-Can use id as a hook for inlineRef

.

coreperson/name.givenGiven name. In the U.S., the first name of an individual. Also used if person has only one name.-Can use id as a hook for inlineRef

.

coreperson/name.familyFamily name. In the U.S., the last name of an individual.-Can use id as a hook for inlineRef

.

powerpostaddrMailing address. Used to deliver mail.?Can use id as a hook for address element

.

powervirtlocVirtual Location. A location in cyberspace.?Can use id as a hook for an element of type ElectronicAddress (e.g. web, im, email, etc)

.

coreaAnchor for hypertext links. Allows users to traverse to other documents.aAn anchorPower NAR has inline markup for certain types of textual metadata

.

corebrForced line break. Often used within headlines.brA line break.Power NAR has inline markup for certain types of textual metadata

.

coreemEmphasis. Can be rendered as bold, italics, or another style.-

.

powerlangLanguage identifier. Used to separate inline changes of language.DescriptiveMetadata/languageA language used by the news contentCan this be used to point into the text to indicate where the language changes?

.

powerpronouncePronunciation Information. Used to elaborate on how a term is spoken.?No exact equivalent in NAR

.

powerqQuotation. Words directly attributed to an individual.?No exact equivalent in NAR

.

powerpostaddress/addresseePerson or organization to whom the postal item is being sent. Used in a postal address.?Can use id as a hook for personDetails

.

powerpostaddress/addressee/care.ofPoste restante. An alternative receiver of the postal item.?Can use id as a hook for personDetails

.

powerpostaddr/delivery.pointStreet, PO Box No. Precise point of delivery.?Can use id as a hook for address element

.

powerpostaddr/postcodePostal code. Used by postal agency to improve delivery efficiency.?Can use id as a hook for address element

.

powerpostaddr/delivery.officePostal city or town. Where the post office is located.?Can use id as a hook for address element

.

corebody/body.endInformation at the end of an article body Holds a tagline and/or a bibliography.-

.

corebody/body.end/taglineA byline at the end of a story. Example: Stuart Myles contributed to this article.-

.

corebody/body.end/bibliographyFree-form bibliographic data. Used to elaborate on the source of information.-

.

coreclassifierGeneric holder for metadata. Could be used by researchers and archivists to qualify documents. May be used inline (as localized phrase, atop a block (as localized section), or in docdata (for document as a whole).?Can use id as a hook for inlineRef

.

powernitf-tableA holder for a table, and content-filled metadata. May contain the classic NITF table, or a custom table.?Can use id as a hook for inlineRef

.

powernitf-table/custom-tableA holder for a namespaced XML fragment for custom-tagged data, or for an alternative set of non-parser-breaking content. Used when publisher wants to surround the fragment with NITF metadata.?

.

powernitf-table/table-referenceA pointer to a table that is elsewhere in the document. Can be used when the table is buried deep inside the included namespaced fragment.?

.

powernitf-table/nitf-table-referenceA holder for a namespaced XML fragment for custom-tagged data. Used when publisher wants to surround the fragment with NITF metadata.?status

.

powernitf-table/nitf-table-metadata/nitf-table-summaryTextual description of the table. May describe intent of table and how it may be represented. Should be managed like a non-publishable editors note.?

.

powernitf-table/nitf-table-metadata/nitf-colgroupA collection of nitf-col elements. Used when table repeats columns of a particular type.?

.

powernitf-table/nitf-table-metadata/nitf-colgroup/nitf-colA holder for a namespaced XML fragment for custom-tagged data. Used when publisher wants to surround the fragment with NITF metadata.?