Index of modules
Module news
Name: news
Title: Gestor de notícies
Namespace: http://news.matrix.org/
Service: NewsManagerService
Port: NewsManagerPort
Java package: org.matrix.news
Version: 1.0
Status: FINAL
Authors: Jordi López
WSDL: news.wsdl
Imports:
prefix namespace
xs http://www.w3.org/2001/XMLSchema
mime http://www.w3.org/2005/05/xmlmime
mx http://base.matrix.org/
doc http://doc.matrix.org/
security http://security.matrix.org/
Documentation:

Característiques generals

El mòdul news és l'encarregat de:
  • Gestionar la creació, edició, consulta i esborrat de notícies.
  • Gestionar les diferents publicacions d'una notícia.
  • Gestionar els documents associats a una notícia.

Notícia

Les notícies es representen en el mòdul news mitjançant objectes New. Una notícia consisteix en una unitat d'informació vigent durant un període de temps determinat creada amb la finalitat de ser llegida per diferents clients. La informació que conté s'estructura en tres parts:
  • Titular: Text descriptiu sobre la informació continguda a la notícia.
  • Resum: Resum del contingut de la notícia.
  • Text: Contingut de la notícia.

Publicació de notícies

La publicació d'una notícia es representa en el mòdul news mitjançant objectes NewSection. Una notícia es pot publicar a un o més punts anomenats seccions. Dintre de cada secció, tota notícia té una determinada prioritat, que determina la seva posició respecte a la resta de notícies de la secció. Com més alt sigui aquest valor, més rellevant serà la seva posició a la secció.

Documents associats a notícies

Un document associat a una notícia es representa en el mòdul news mitjançant objectes NewDocument. Una notícia pot tenir un o més documents associats, que serveixen per a completar la informació aportada per la notícia. Un document s'associa a una notícia per a complir una funció determinada, dependent de la implementació.

Casos d'ús

  • Creació d'una nova notícia:
                New n = new New();
                n.setHeadline("Titular de la notícia");
                n.setSummary("Resum de la notícia");
                n.setText("Text de la notícia");
                n.setStartDate("20120101");
                n.setStartTime("083000");
                n.setEndDate("20120401");
                n.setEndTime("220000");
                n.setUserId("user");
                n.setDraft(false);
                n.setSource("AJ");
                NewStoreOptions newStoreOptions = new NewStoreOptions();
                newStoreOptions.setCleanSummary(true);
                newStoreOptions.setCleanText(true);
                n = port.storeNew(n, newStoreOptions);
              
  • Publicació d'una notícia a una secció:
                NewSection ns = new NewSection();
                ns.setNewId("13");
                ns.setSectionId("1467");
                ns.setPriority(10);
                port.storeNewSection(ns);
              
  • Associació d'un document a una notícia:
                NewDocument nd = new NewDocument();
                nd.setNewId("13");
                nd.setDocumentId("6550");
                nd.setNewDocTypeId("NewDocumentExtendedInfo");
                port.storeNewDocument(nd);
              
  • Cerca de notícies:
                NewsFilter filter = new NewsFilter();
                filter.setStartDateTime("20120101000000");
                filter.setEndDateTime("20120401000000");
                filter.setContent("Contingut a cercar");
                filter.getSectionId().clear();
                filter.getSectionId().add("1467");
                filter.getSectionId().add("2");
                filter.getSectionId().add("150");
                filter.setExcludeDrafts(false);
                filter.setExcludeNotPublished(false);
                filter.setMinPubDateTime("20120201000000");
                list = port.findNews(filter);
              

[Types] [Operations]

Types

Entity New
Name: New
QName: news:New
Java class name: org.matrix.news.New
Description:
New representa una notícia.
Properties:
name xml type occurs nillable read only references
newId xs:string 0..1 false false
headline xs:string 0..1 false false
summary xs:string 0..1 false false
text xs:string 0..1 false false
registerDate mx:date 0..1 false true
registerTime mx:time 0..1 false true
startDate mx:date 0..1 false false
startTime mx:time 0..1 false false
endDate mx:date 0..1 false false
endTime mx:time 0..1 false false
userId xs:string 0..1 false true security:User
source xs:string 0..1 false false
draft xs:boolean 1 false false
totalReadingCount xs:int 1 false true
keywords xs:string 0..1 false false
customUrl xs:string 0..1 false false
customUrlTarget xs:string 0..1 false false
hash xs:string 0..1 false false
iconUrl xs:string 0..1 false false
  • newId: Identificador de la notícia.
  • headline: Titular de la notícia.
  • summary: Resum de la notícia.
  • text: Text complet de la notícia.
  • registerDate: Data de registre de la notícia al sistema, en format yyyyMMdd.
  • registerTime: Hora de registre de la notícia al sistema, en format HHmmss.
  • startDate: Data d'inici de visibilitat de la notícia al sistema, en format yyyyMMdd.
  • startTime: Hora d'inici de visibilitat de la notícia al sistema, en format HHmmss.
  • endDate: Data de fi de visibilitat de la notícia al sistema, en format yyyyMMdd.
  • endTime: Hora de fi de visibilitat de la notícia al sistema, en format HHmmss.
  • userId: Usuari creador o editor de la notícia.
  • source: Font de la notícia.
  • draft: Indica si la notícia és un esborrany o és definitiva.
  • totalReadingCount: Nombre total de lectures de la notícia.
  • keywords: Llista separada per comes de les paraules clau de la notícia, per als cercadors.
  • customUrl: Adreça URL a la qual es redirigirà a l'usuari en fer clic a la notícia.
  • customUrlTarget: Tipus d'enllaç a utilitzar a l'adreça URL externa.
  • hash: Hash del contingut de la notícia
  • iconUrl: Adreça URL de la icona per defecte de la notícia.
Related operations:
Entity NewSection
Name: NewSection
QName: news:NewSection
Java class name: org.matrix.news.NewSection
Description:
Publicació d'una notícia a una secció.
Properties:
name xml type occurs nillable read only references
newSectionId xs:string 0..1 false false
newId xs:string 0..1 false false news:New
sectionId xs:string 0..1 false false
priority xs:int 0..1 false false
readingCount xs:int 1 false true
sticky xs:boolean 1 false false
  • newSectionId: Identificador de la publicació.
  • newId: Identificador de la notícia.
  • sectionId: Identificador de la secció on es publica la notícia.
  • priority: Prioritat de visualització de la notícia dins de la secció. Com més gran sigui el valor, més rellevant serà la notícia.
  • readingCount: Nombre de lectures de la notícia a la secció.
  • sticky: Indica si la notícia té prioritat màxima a la secció.
Related operations:
Entity NewDocument
Name: NewDocument
QName: news:NewDocument
Java class name: org.matrix.news.NewDocument
Description:
Associació d'un document a una notícia.
Properties:
name xml type occurs nillable read only references
newDocumentId xs:string 0..1 false false
newId xs:string 0..1 false false news:New
documentId xs:string 0..1 false false doc:Document
title xs:string 0..1 false true
mimeType xs:string 0..1 false true
contentId xs:string 0..1 false true doc:Content
newDocTypeId xs:string 0..1 false false dic:Type
  • newDocumentId: Identificador de l'associació.
  • newId: Identificador de la notícia.
  • documentId: Identificador del document associat a la notícia.
  • title: Títol del document.
  • mimeType: Tipus MIME del document.
  • contentId: Identificador del contingut emmagatzemat del document al Gestor Documental.
  • newDocTypeId: Tipus d'associació entre el document i la notícia.
Related operations:
Struct NewStoreOptions
Name: NewStoreOptions
QName: news:NewStoreOptions
Java class name: org.matrix.news.NewStoreOptions
Description:
Opcions d'emmagatzemament d'una notícia.
Properties:
name xml type occurs nillable read only references
cleanSummary xs:boolean 1 false false
cleanText xs:boolean 1 false false
  • cleanSummary: Indica si s'ha de netejar el codi HTML del resum de la notícia, traient els tags menys comuns.
  • cleanText: Indica si s'ha de netejar el codi HTML del text de la notícia, traient els tags menys comuns.
Related operations:
Struct NewsManagerMetaData :: mx:ManagerMetaData
Name: NewsManagerMetaData
QName: news:NewsManagerMetaData
Java class name: org.matrix.news.NewsManagerMetaData
Super type: mx:ManagerMetaData
Description:
Conté les propietats que descriuen les característiques de la implementació d'aquest servei.
Properties:
name xml type occurs nillable read only references
Related operations:
Struct SectionFilter
Name: SectionFilter
QName: news:SectionFilter
Java class name: org.matrix.news.SectionFilter
Description:
Filtre per cercar notícies agrupades en seccions a través de les operacions countNewsBySection i findNewsBySection.
Properties:
name xml type occurs nillable read only references
newId xs:string 0..N true false
content xs:string 0..1 false false
startDateTime mx:dateTime 0..1 false false
endDateTime mx:dateTime 0..1 false false
sectionId xs:string 0..N true false
maxResults xs:int 1 false false
minPubDateTime mx:dateTime 0..1 false false
firstResult xs:int 1 false false
excludeDrafts xs:boolean 0..N true false
userId xs:string 0..1 false false
  • newId: Llista de codis de notícies a cercar.
  • content: Text que ha de contenir el titular o el resum de la notícia, sense distingir entre majúscules i minúscules.
  • startDateTime: Data i hora a partir de la qual la notícia ha de ser visible, en format yyyyMMddHHmmss.
  • endDateTime: Data i hora abans de la qual la notícia ha de ser visible, en format yyyyMMddHHmmss.
  • sectionId: Llista de seccions on cercar notícies.
  • maxResults: Nombre màxim de notícies a retornar dins del total de resultats de la operació findNewsBySection, per a cada secció.
  • minPubDateTime: Data mínima de publicació de la notícia, en format yyyyMMddHHmmss.
  • firstResult: Índex de la primera notícia a retornar dins del total de resultats de la operació findNewsBySection, per a cada secció.
  • excludeDrafts: Per cadascuna de les seccions especificades al paràmetre sectionId, indica, en el mateix ordre, si hem de retornar els esborranys o no.
  • userId: Identificador de l'usuari publicador de la notícia.
Related operations:
Struct SectionView
Name: SectionView
QName: news:SectionView
Java class name: org.matrix.news.SectionView
Description:
Informació sobre una secció de notícies, amb un conjunt de notícies publicades a la mateixa.
Properties:
name xml type occurs nillable read only references
sectionId xs:string 0..1 false false
desc xs:string 0..1 false false
newView news:NewView 0..N true false
  • sectionId: Identificador de la secció de notícies.
  • desc: Descripció de la secció de notícies.
  • newView: Llista de notícies trobades a la secció, en forma d'objectes NewView.
Related operations:
Struct NewView
Name: NewView
QName: news:NewView
Java class name: org.matrix.news.NewView
Description:
Conté informació sobre una notícia dins d'una secció.
Properties:
name xml type occurs nillable read only references
newId xs:string 0..1 false false new:New
headline xs:string 0..1 false false
summary xs:string 0..1 false false
registerDate mx:date 0..1 false false
registerTime mx:time 0..1 false false
startDate mx:date 0..1 false false
startTime mx:time 0..1 false false
endDate mx:date 0..1 false false
endTime mx:time 0..1 false false
priority xs:int 1 false false
readingCount xs:int 1 false false
sticky xs:boolean 1 false false
newDocument news:NewDocument 0..N true false
draft xs:boolean 1 false false
keywords xs:string 0..1 false false
customUrl xs:string 0..1 false false
customUrlTarget xs:string 0..1 false false
hash xs:string 0..1 false false
iconUrl xs:string 0..1 false false
newSource news:Source 0..1 false false
  • newId: Identificador de la notícia.
  • headline: Titular de la notícia.
  • summary: Resum de la notícia.
  • registerDate: Data de registre de la notícia, en format yyyyMMdd.
  • registerTime: Hora de registre de la notícia, en format HHmmss.
  • startDate: Data d'inici de visibilitat de la notícia al sistema, en format yyyyMMdd.
  • startTime: Hora d'inici de visibilitat de la notícia al sistema, en format HHmmss.
  • endDate: Data de fi de visibilitat de la notícia al sistema, en format yyyyMMdd.
  • endTime: Hora de fi de visibilitat de la notícia al sistema, en format HHmmss.
  • priority: Prioritat de la notícia dins de la secció a la que pertany l'objecte NewView.
  • readingCount: Nombre de lectures de la notícia a la secció a la que pertany l'objecte NewView.
  • sticky: Indica si la notícia té prioritat màxima dins de la secció a la que pertany l'objecte NewView.
  • newDocument: Llista de documents associats a la notícia.
  • draft: Indica si la notícia és un esborrany.
  • keywords: Llista separada per comes de les paraules clau de la notícia, per als cercadors.
  • customUrl: Adreça URL a la qual es redirigirà a l'usuari en fer clic a la notícia.
  • customUrlTarget: Tipus d'enllaç a utilitzar a l'adreça URL externa.
  • hash: Hash del contingut de la notícia
  • iconUrl: Adreça URL de la icona per defecte de la notícia.
  • newSource: Font de la notícia.
Related operations:
Struct NewsFilter
Name: NewsFilter
QName: news:NewsFilter
Java class name: org.matrix.news.NewsFilter
Description:
Filtre per cercar notícies a través de les operacions countNews, findNews i findNewViews.
Properties:
name xml type occurs nillable read only references
newId xs:string 0..N true false
content xs:string 0..1 false false
startDateTime mx:dateTime 0..1 false false
endDateTime mx:dateTime 0..1 false false
sectionId xs:string 0..N true false
excludeDrafts xs:boolean 1 false false
excludeNotPublished xs:boolean 1 false false
maxResults xs:int 1 false false
firstResult xs:int 1 false false
minPubDateTime mx:dateTime 0..1 false false
userId xs:string 0..1 false false
  • newId: Llista de codis de notícies a cercar.
  • content: Text que han de contenir les notícies al titular o al resum, sense distingir entre majúscules i minúscules.
  • startDateTime: Data i hora a partir de la qual la notícia ha de ser visible, en format yyyyMMddHHmmss.
  • endDateTime: Data i hora abans de la qual la notícia ha de ser visible, en format yyyyMMddHHmmss.
  • sectionId: Llista de seccions on cercar notícies.
  • excludeDrafts: Indica si s'han d'excloure les notícies esborrany dels resultats.
  • excludeNotPublished: Indica si s'han d'excloure les notícies no publicades dels resultats.
  • maxResults: Nombre màxim de notícies a retornar dins del total de resultats de les operacions findNews i findNewViews.
  • firstResult: Índex de la primera notícia a retornar dins del total de resultats de les operacions findNews i findNewViews.
  • minPubDateTime: Data mínima de publicació de la notícia, en format yyyyMMddHHmmss.
  • userId: Identificador de l'usuari publicador de la notícia.
Related operations:
Struct Source
Name: Source
QName: news:Source
Java class name: org.matrix.news.Source
Description:
Font d'una notícia.
Properties:
name xml type occurs nillable read only references
id xs:string 0..1 false true
name xs:string 0..1 false true
url xs:string 0..1 false false
  • id: Identificador de la font.
  • name: Nom de la font.
  • url: Adreça URL de la font.
Related operations:
Struct SourceFilter
Name: SourceFilter
QName: news:SourceFilter
Java class name: org.matrix.news.SourceFilter
Description:
Filtre per cercar fonts a través de les operacions countSources i findSources.
Properties:
name xml type occurs nillable read only references
sourceId xs:string 0..N true false
name xs:string 0..1 false false
url xs:string 0..1 false false
firstResult xs:int 1 false false
maxResults xs:int 1 false false
  • sourceId: Llista de codis de fonts a cercar.
  • name: Text que ha de contenir el nom de la font, sense distingir entre majúscules i minúscules.
  • url: Text que ha de contenir l'adreça URL de la font.
  • firstResult: Índex de la primera font a retornar dins del total de resultats de l'operació findSources.
  • maxResults: Nombre màxim de fonts a retornar dins del total de resultats de l'operació findSources.
Related operations:

Operations

Operation storeNew
Name: storeNew
Signature: storeNew (new {news:New}, storeOptions {news:NewStoreOptions}) => storedNew {news:New}
Java signature: org.matrix.news.New storeNew(org.matrix.news.New new, org.matrix.news.NewStoreOptions storeOptions)
Description:
Crea o modifica una notícia.
Parameters:
name xml type occurs nillable read only references
new news:New 1 false false
storeOptions news:NewStoreOptions 1 false false
  • new: Objecte New que es vol desar. Si el camp newId té valor nul es crearà una nova notícia. En canvi, si té un valor definit, es modificarà la notícia indicada.
  • storeOptions: Opcions d'emmagatzemament de la notícia.
Response:
name xml type occurs nillable read only references
storedNew news:New 1 false false
  • storedNew: Objecte New que ha estat desat.
Errors:
name message
VALUE_IS_MANDATORY Valor de camp obligatori
VALUE_TOO_LARGE Valor de camp massa gran
  • VALUE_IS_MANDATORY: El titular de la notícia no té valor o és buit.
  • VALUE_TOO_LARGE: Valor massa llarg al titular o al resum de la notícia.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:storeNew xmlns:ns2="http://news.matrix.org/">
      <new>
        <newId>{xs:string}</newId>
        <headline>{xs:string}</headline>
        <summary>{xs:string}</summary>
        <text>{xs:string}</text>
        <registerDate>{mx:date}</registerDate>
        <registerTime>{mx:time}</registerTime>
        <startDate>{mx:date}</startDate>
        <startTime>{mx:time}</startTime>
        <endDate>{mx:date}</endDate>
        <endTime>{mx:time}</endTime>
        <userId>{xs:string}</userId>
        <source>{xs:string}</source>
        <draft>{xs:boolean}</draft>
        <totalReadingCount>{xs:int}</totalReadingCount>
        <keywords>{xs:string}</keywords>
        <customUrl>{xs:string}</customUrl>
        <customUrlTarget>{xs:string}</customUrlTarget>
        <hash>{xs:string}</hash>
        <iconUrl>{xs:string}</iconUrl>
      </new>
      <storeOptions>
        <cleanSummary>{xs:boolean}</cleanSummary>
        <cleanText>{xs:boolean}</cleanText>
      </storeOptions>
    </ns2:storeNew>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:storeNewResponse xmlns:ns2="http://news.matrix.org/">
      <storedNew>
        <newId>{xs:string}</newId>
        <headline>{xs:string}</headline>
        <summary>{xs:string}</summary>
        <text>{xs:string}</text>
        <registerDate>{mx:date}</registerDate>
        <registerTime>{mx:time}</registerTime>
        <startDate>{mx:date}</startDate>
        <startTime>{mx:time}</startTime>
        <endDate>{mx:date}</endDate>
        <endTime>{mx:time}</endTime>
        <userId>{xs:string}</userId>
        <source>{xs:string}</source>
        <draft>{xs:boolean}</draft>
        <totalReadingCount>{xs:int}</totalReadingCount>
        <keywords>{xs:string}</keywords>
        <customUrl>{xs:string}</customUrl>
        <customUrlTarget>{xs:string}</customUrlTarget>
        <hash>{xs:string}</hash>
        <iconUrl>{xs:string}</iconUrl>
      </storedNew>
    </ns2:storeNewResponse>
  </S:Body>
</S:Envelope>
Operation getManagerMetaData
Name: getManagerMetaData
Signature: getManagerMetaData () => managerMetaData {news:NewsManagerMetaData}
Java signature: org.matrix.news.NewsManagerMetaData getManagerMetaData()
Description:
Recupera les característiques de la implementació del servei.
Parameters:
name xml type occurs nillable read only references
Response:
name xml type occurs nillable read only references
managerMetaData news:NewsManagerMetaData 1 false false
  • managerMetaData: Objecte NewsManagerMetaData que conté les caracterítiques de la implementació del servei.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:getManagerMetaData xmlns:ns2="http://news.matrix.org/">
    </ns2:getManagerMetaData>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:getManagerMetaDataResponse xmlns:ns2="http://news.matrix.org/">
      <managerMetaData>
        {mx:ManagerMetaData}
      </managerMetaData>
    </ns2:getManagerMetaDataResponse>
  </S:Body>
</S:Envelope>
Operation loadNew
Name: loadNew
Signature: loadNew (newId {xs:string}) => new {news:New}
Java signature: org.matrix.news.New loadNew(String newId)
Description:
Recupera una notícia a partir del seu identificador.
Parameters:
name xml type occurs nillable read only references
newId xs:string 1 false false
  • newId: Identificador de la notícia a recuperar.
Response:
name xml type occurs nillable read only references
new news:New 1 false false
  • new: L'objecte New que correspon a l'identificador newId.
Errors:
name message
NEW_NOT_FOUND Notícia no trobada
  • NEW_NOT_FOUND: La notícia no existeix.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:loadNew xmlns:ns2="http://news.matrix.org/">
      <newId>{xs:string}</newId>
    </ns2:loadNew>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:loadNewResponse xmlns:ns2="http://news.matrix.org/">
      <new>
        <newId>{xs:string}</newId>
        <headline>{xs:string}</headline>
        <summary>{xs:string}</summary>
        <text>{xs:string}</text>
        <registerDate>{mx:date}</registerDate>
        <registerTime>{mx:time}</registerTime>
        <startDate>{mx:date}</startDate>
        <startTime>{mx:time}</startTime>
        <endDate>{mx:date}</endDate>
        <endTime>{mx:time}</endTime>
        <userId>{xs:string}</userId>
        <source>{xs:string}</source>
        <draft>{xs:boolean}</draft>
        <totalReadingCount>{xs:int}</totalReadingCount>
        <keywords>{xs:string}</keywords>
        <customUrl>{xs:string}</customUrl>
        <customUrlTarget>{xs:string}</customUrlTarget>
        <hash>{xs:string}</hash>
        <iconUrl>{xs:string}</iconUrl>
      </new>
    </ns2:loadNewResponse>
  </S:Body>
</S:Envelope>
Operation incrementNewCounter
Name: incrementNewCounter
Signature: incrementNewCounter (newId {xs:string}, sectionId {xs:string}) => counter {xs:int}
Java signature: int incrementNewCounter(String newId, String sectionId)
Description:
Incrementa el comptador total de visites d'una notícia, i el comptador parcial per a una secció determinada.
Parameters:
name xml type occurs nillable read only references
newId xs:string 1 false false
sectionId xs:string 1 false false
  • newId: Identificador de la notícia.
  • sectionId: Identificador de la secció. Si no s'indica, només s'incrementarà el comptador global de la notícia.
Response:
name xml type occurs nillable read only references
counter xs:int 1 false false
  • counter: Nou valor del comptador total de visites de la notícia.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:incrementNewCounter xmlns:ns2="http://news.matrix.org/">
      <newId>{xs:string}</newId>
      <sectionId>{xs:string}</sectionId>
    </ns2:incrementNewCounter>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:incrementNewCounterResponse xmlns:ns2="http://news.matrix.org/">
      <counter>{xs:int}</counter>
    </ns2:incrementNewCounterResponse>
  </S:Body>
</S:Envelope>
Operation getTotalNewCounter
Name: getTotalNewCounter
Signature: getTotalNewCounter (newId {xs:string}) => counter {xs:int}
Java signature: int getTotalNewCounter(String newId)
Description:
Recupera el valor del comptador total de visites a una notícia.
Parameters:
name xml type occurs nillable read only references
newId xs:string 1 false false
  • newId: Identificador de la notícia.
Response:
name xml type occurs nillable read only references
counter xs:int 1 false false
  • counter: El valor del comptador total de visites a la notícia que correspon a l'identificador newId.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:getTotalNewCounter xmlns:ns2="http://news.matrix.org/">
      <newId>{xs:string}</newId>
    </ns2:getTotalNewCounter>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:getTotalNewCounterResponse xmlns:ns2="http://news.matrix.org/">
      <counter>{xs:int}</counter>
    </ns2:getTotalNewCounterResponse>
  </S:Body>
</S:Envelope>
Operation removeNew
Name: removeNew
Signature: removeNew (newId {xs:string}) => removed {xs:boolean}
Java signature: boolean removeNew(String newId)
Description:
Elimina una notícia.
Parameters:
name xml type occurs nillable read only references
newId xs:string 1 false false
  • newId: Identificador de la notícia a eliminar.
Response:
name xml type occurs nillable read only references
removed xs:boolean 1 false false
  • removed: Indica si la notícia ha estat esborrada.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:removeNew xmlns:ns2="http://news.matrix.org/">
      <newId>{xs:string}</newId>
    </ns2:removeNew>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:removeNewResponse xmlns:ns2="http://news.matrix.org/">
      <removed>{xs:boolean}</removed>
    </ns2:removeNewResponse>
  </S:Body>
</S:Envelope>
Operation countNewsBySection
Name: countNewsBySection
Signature: countNewsBySection (filter {news:SectionFilter}) => newCount {xs:int}
Java signature: int countNewsBySection(org.matrix.news.SectionFilter filter)
Description:
Recupera el nombre de notícies que satisfan unes determinades condicions expressades per mitjà d'un filtre SectionFilter.
Parameters:
name xml type occurs nillable read only references
filter news:SectionFilter 1 false false
  • filter: Filtre que es vol aplicar a la cerca.
Response:
name xml type occurs nillable read only references
newCount xs:int 1 false false
  • newCount: Nombre de notícies que satisfan les condicions del filtre.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:countNewsBySection xmlns:ns2="http://news.matrix.org/">
      <filter>
        <newId>{xs:string}</newId>
        <content>{xs:string}</content>
        <startDateTime>{mx:dateTime}</startDateTime>
        <endDateTime>{mx:dateTime}</endDateTime>
        <sectionId>{xs:string}</sectionId>
        <maxResults>{xs:int}</maxResults>
        <minPubDateTime>{mx:dateTime}</minPubDateTime>
        <firstResult>{xs:int}</firstResult>
        <excludeDrafts>{xs:boolean}</excludeDrafts>
        <userId>{xs:string}</userId>
      </filter>
    </ns2:countNewsBySection>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:countNewsBySectionResponse xmlns:ns2="http://news.matrix.org/">
      <newCount>{xs:int}</newCount>
    </ns2:countNewsBySectionResponse>
  </S:Body>
</S:Envelope>
Operation findNewsBySection
Name: findNewsBySection
Signature: findNewsBySection (filter {news:SectionFilter}) => sectionView {news:SectionView}*
Java signature: List<org.matrix.news.SectionView> findNewsBySection(org.matrix.news.SectionFilter filter)
Description:
Cerca objectes SectionView que satisfan unes determinades condicions expressades per mitjà d'un filtre SectionFilter.
Parameters:
name xml type occurs nillable read only references
filter news:SectionFilter 1 false false
  • filter: Filtre que es vol aplicar a la cerca.
Response:
name xml type occurs nillable read only references
sectionView news:SectionView 0..N true false
  • sectionView: Llista d'objectes SectionView que satisfan les condicions del filtre.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:findNewsBySection xmlns:ns2="http://news.matrix.org/">
      <filter>
        <newId>{xs:string}</newId>
        <content>{xs:string}</content>
        <startDateTime>{mx:dateTime}</startDateTime>
        <endDateTime>{mx:dateTime}</endDateTime>
        <sectionId>{xs:string}</sectionId>
        <maxResults>{xs:int}</maxResults>
        <minPubDateTime>{mx:dateTime}</minPubDateTime>
        <firstResult>{xs:int}</firstResult>
        <excludeDrafts>{xs:boolean}</excludeDrafts>
        <userId>{xs:string}</userId>
      </filter>
    </ns2:findNewsBySection>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:findNewsBySectionResponse xmlns:ns2="http://news.matrix.org/">
      <sectionView>
        <sectionId>{xs:string}</sectionId>
        <desc>{xs:string}</desc>
        <newView>
          <newId>{xs:string}</newId>
          <headline>{xs:string}</headline>
          <summary>{xs:string}</summary>
          <registerDate>{mx:date}</registerDate>
          <registerTime>{mx:time}</registerTime>
          <startDate>{mx:date}</startDate>
          <startTime>{mx:time}</startTime>
          <endDate>{mx:date}</endDate>
          <endTime>{mx:time}</endTime>
          <priority>{xs:int}</priority>
          <readingCount>{xs:int}</readingCount>
          <sticky>{xs:boolean}</sticky>
          <newDocument>
            <newDocumentId>{xs:string}</newDocumentId>
            <newId>{xs:string}</newId>
            <documentId>{xs:string}</documentId>
            <title>{xs:string}</title>
            <mimeType>{xs:string}</mimeType>
            <contentId>{xs:string}</contentId>
            <newDocTypeId>{xs:string}</newDocTypeId>
          </newDocument>
          <draft>{xs:boolean}</draft>
          <keywords>{xs:string}</keywords>
          <customUrl>{xs:string}</customUrl>
          <customUrlTarget>{xs:string}</customUrlTarget>
          <hash>{xs:string}</hash>
          <iconUrl>{xs:string}</iconUrl>
          <newSource>
            <id>{xs:string}</id>
            <name>{xs:string}</name>
            <url>{xs:string}</url>
          </newSource>
        </newView>
      </sectionView>
    </ns2:findNewsBySectionResponse>
  </S:Body>
</S:Envelope>
Operation countNews
Name: countNews
Signature: countNews (filter {news:NewsFilter}) => newCount {xs:int}
Java signature: int countNews(org.matrix.news.NewsFilter filter)
Description:
Recupera el nombre de notícies que satisfan unes determinades condicions expressades per mitjà d'un filtre NewsFilter.
Parameters:
name xml type occurs nillable read only references
filter news:NewsFilter 1 false false
  • filter: Filtre que es vol aplicar a la cerca.
Response:
name xml type occurs nillable read only references
newCount xs:int 1 false false
  • newCount: Nombre de notícies que satisfan les condicions del filtre.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:countNews xmlns:ns2="http://news.matrix.org/">
      <filter>
        <newId>{xs:string}</newId>
        <content>{xs:string}</content>
        <startDateTime>{mx:dateTime}</startDateTime>
        <endDateTime>{mx:dateTime}</endDateTime>
        <sectionId>{xs:string}</sectionId>
        <excludeDrafts>{xs:boolean}</excludeDrafts>
        <excludeNotPublished>{xs:boolean}</excludeNotPublished>
        <maxResults>{xs:int}</maxResults>
        <firstResult>{xs:int}</firstResult>
        <minPubDateTime>{mx:dateTime}</minPubDateTime>
        <userId>{xs:string}</userId>
      </filter>
    </ns2:countNews>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:countNewsResponse xmlns:ns2="http://news.matrix.org/">
      <newCount>{xs:int}</newCount>
    </ns2:countNewsResponse>
  </S:Body>
</S:Envelope>
Operation findNews
Name: findNews
Signature: findNews (filter {news:NewsFilter}) => new {news:New}*
Java signature: List<org.matrix.news.New> findNews(org.matrix.news.NewsFilter filter)
Description:
Cerca notícies que satisfacin unes determinades condicions expressades mitjançant un filtre NewsFilter.
Parameters:
name xml type occurs nillable read only references
filter news:NewsFilter 1 false false
  • filter: Filtre que es vol aplicar a la cerca.
Response:
name xml type occurs nillable read only references
new news:New 0..N true false
  • new: Llista de notícies que satisfan les condicions del filtre.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:findNews xmlns:ns2="http://news.matrix.org/">
      <filter>
        <newId>{xs:string}</newId>
        <content>{xs:string}</content>
        <startDateTime>{mx:dateTime}</startDateTime>
        <endDateTime>{mx:dateTime}</endDateTime>
        <sectionId>{xs:string}</sectionId>
        <excludeDrafts>{xs:boolean}</excludeDrafts>
        <excludeNotPublished>{xs:boolean}</excludeNotPublished>
        <maxResults>{xs:int}</maxResults>
        <firstResult>{xs:int}</firstResult>
        <minPubDateTime>{mx:dateTime}</minPubDateTime>
        <userId>{xs:string}</userId>
      </filter>
    </ns2:findNews>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:findNewsResponse xmlns:ns2="http://news.matrix.org/">
      <new>
        <newId>{xs:string}</newId>
        <headline>{xs:string}</headline>
        <summary>{xs:string}</summary>
        <text>{xs:string}</text>
        <registerDate>{mx:date}</registerDate>
        <registerTime>{mx:time}</registerTime>
        <startDate>{mx:date}</startDate>
        <startTime>{mx:time}</startTime>
        <endDate>{mx:date}</endDate>
        <endTime>{mx:time}</endTime>
        <userId>{xs:string}</userId>
        <source>{xs:string}</source>
        <draft>{xs:boolean}</draft>
        <totalReadingCount>{xs:int}</totalReadingCount>
        <keywords>{xs:string}</keywords>
        <customUrl>{xs:string}</customUrl>
        <customUrlTarget>{xs:string}</customUrlTarget>
        <hash>{xs:string}</hash>
        <iconUrl>{xs:string}</iconUrl>
      </new>
    </ns2:findNewsResponse>
  </S:Body>
</S:Envelope>
Operation findNewViews
Name: findNewViews
Signature: findNewViews (filter {news:NewsFilter}) => newView {news:NewView}*
Java signature: List<org.matrix.news.NewView> findNewViews(org.matrix.news.NewsFilter filter)
Description:
Cerca notícies que satisfacin unes determinades condicions expressades per mitjà d'un filtre NewsFilter.
Parameters:
name xml type occurs nillable read only references
filter news:NewsFilter 1 false false
  • filter: Filtre que es vol aplicar a la cerca.
Response:
name xml type occurs nillable read only references
newView news:NewView 0..N true false
  • newView: Llista d'objectes NewView que satisfan les condicions del filtre.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:findNewViews xmlns:ns2="http://news.matrix.org/">
      <filter>
        <newId>{xs:string}</newId>
        <content>{xs:string}</content>
        <startDateTime>{mx:dateTime}</startDateTime>
        <endDateTime>{mx:dateTime}</endDateTime>
        <sectionId>{xs:string}</sectionId>
        <excludeDrafts>{xs:boolean}</excludeDrafts>
        <excludeNotPublished>{xs:boolean}</excludeNotPublished>
        <maxResults>{xs:int}</maxResults>
        <firstResult>{xs:int}</firstResult>
        <minPubDateTime>{mx:dateTime}</minPubDateTime>
        <userId>{xs:string}</userId>
      </filter>
    </ns2:findNewViews>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:findNewViewsResponse xmlns:ns2="http://news.matrix.org/">
      <newView>
        <newId>{xs:string}</newId>
        <headline>{xs:string}</headline>
        <summary>{xs:string}</summary>
        <registerDate>{mx:date}</registerDate>
        <registerTime>{mx:time}</registerTime>
        <startDate>{mx:date}</startDate>
        <startTime>{mx:time}</startTime>
        <endDate>{mx:date}</endDate>
        <endTime>{mx:time}</endTime>
        <priority>{xs:int}</priority>
        <readingCount>{xs:int}</readingCount>
        <sticky>{xs:boolean}</sticky>
        <newDocument>
          <newDocumentId>{xs:string}</newDocumentId>
          <newId>{xs:string}</newId>
          <documentId>{xs:string}</documentId>
          <title>{xs:string}</title>
          <mimeType>{xs:string}</mimeType>
          <contentId>{xs:string}</contentId>
          <newDocTypeId>{xs:string}</newDocTypeId>
        </newDocument>
        <draft>{xs:boolean}</draft>
        <keywords>{xs:string}</keywords>
        <customUrl>{xs:string}</customUrl>
        <customUrlTarget>{xs:string}</customUrlTarget>
        <hash>{xs:string}</hash>
        <iconUrl>{xs:string}</iconUrl>
        <newSource>
          <id>{xs:string}</id>
          <name>{xs:string}</name>
          <url>{xs:string}</url>
        </newSource>
      </newView>
    </ns2:findNewViewsResponse>
  </S:Body>
</S:Envelope>
Operation loadNewSection
Name: loadNewSection
Signature: loadNewSection (newSectionId {xs:string}) => newSection {news:NewSection}
Java signature: org.matrix.news.NewSection loadNewSection(String newSectionId)
Description:
Recupera una publicació d'una notícia a una secció.
Parameters:
name xml type occurs nillable read only references
newSectionId xs:string 1 false false
  • newSectionId: Identificador de l'objecte NewSection a recuperar.
Response:
name xml type occurs nillable read only references
newSection news:NewSection 1 false false
  • newSection: L'objecte NewSection que correspon a l'identificador newSectionId.
Errors:
name message
SECTION_NOT_FOUND Secció no trobada
  • SECTION_NOT_FOUND: No existeix la publicació de la notícia a la secció indicada.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:loadNewSection xmlns:ns2="http://news.matrix.org/">
      <newSectionId>{xs:string}</newSectionId>
    </ns2:loadNewSection>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:loadNewSectionResponse xmlns:ns2="http://news.matrix.org/">
      <newSection>
        <newSectionId>{xs:string}</newSectionId>
        <newId>{xs:string}</newId>
        <sectionId>{xs:string}</sectionId>
        <priority>{xs:int}</priority>
        <readingCount>{xs:int}</readingCount>
        <sticky>{xs:boolean}</sticky>
      </newSection>
    </ns2:loadNewSectionResponse>
  </S:Body>
</S:Envelope>
Operation storeNewSection
Name: storeNewSection
Signature: storeNewSection (newSection {news:NewSection}) => storedNewSection {news:NewSection}
Java signature: org.matrix.news.NewSection storeNewSection(org.matrix.news.NewSection newSection)
Description:
Crea o modifica una publicació d'una notícia a una secció.
Parameters:
name xml type occurs nillable read only references
newSection news:NewSection 1 false false
  • newSection: Objecte NewSection que es vol desar. Si el camp newSectionId té valor nul es crearà un nou objecte, amb la màxima prioritat. En canvi, si té un valor definit, es modificarà l'objecte indicat.
Response:
name xml type occurs nillable read only references
storedNewSection news:NewSection 1 false false
  • storedNewSection: Objecte NewSection que ha estat desat.
Errors:
name message
VALUE_TOO_LARGE Valor de camp massa gran
  • VALUE_TOO_LARGE: Valor massa llarg en el camp de prioritat.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:storeNewSection xmlns:ns2="http://news.matrix.org/">
      <newSection>
        <newSectionId>{xs:string}</newSectionId>
        <newId>{xs:string}</newId>
        <sectionId>{xs:string}</sectionId>
        <priority>{xs:int}</priority>
        <readingCount>{xs:int}</readingCount>
        <sticky>{xs:boolean}</sticky>
      </newSection>
    </ns2:storeNewSection>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:storeNewSectionResponse xmlns:ns2="http://news.matrix.org/">
      <storedNewSection>
        <newSectionId>{xs:string}</newSectionId>
        <newId>{xs:string}</newId>
        <sectionId>{xs:string}</sectionId>
        <priority>{xs:int}</priority>
        <readingCount>{xs:int}</readingCount>
        <sticky>{xs:boolean}</sticky>
      </storedNewSection>
    </ns2:storeNewSectionResponse>
  </S:Body>
</S:Envelope>
Operation removeNewSection
Name: removeNewSection
Signature: removeNewSection (newSectionId {xs:string}) => removed {xs:boolean}
Java signature: boolean removeNewSection(String newSectionId)
Description:
Elimina la publicació d'una notícia a una secció.
Parameters:
name xml type occurs nillable read only references
newSectionId xs:string 1 false false
  • newSectionId: Identificador de l'objecte NewSection a eliminar.
Response:
name xml type occurs nillable read only references
removed xs:boolean 1 false false
  • removed: Indica si l'objecte NewSection ha estat esborrat.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:removeNewSection xmlns:ns2="http://news.matrix.org/">
      <newSectionId>{xs:string}</newSectionId>
    </ns2:removeNewSection>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:removeNewSectionResponse xmlns:ns2="http://news.matrix.org/">
      <removed>{xs:boolean}</removed>
    </ns2:removeNewSectionResponse>
  </S:Body>
</S:Envelope>
Operation findNewSections
Name: findNewSections
Signature: findNewSections (newId {xs:string}) => newSection {news:NewSection}*
Java signature: List<org.matrix.news.NewSection> findNewSections(String newId)
Description:
Retorna la llista de seccions en les quals està publicada la notícia indicada mitjançant el parámetre newId.
Parameters:
name xml type occurs nillable read only references
newId xs:string 1 false false
  • newId: Identificador de la notícia a la qual han de pertànyer els objectes NewSection cercats.
Response:
name xml type occurs nillable read only references
newSection news:NewSection 0..N true false
  • newSection: Llista d'objectes NewSection que satisfan les condicions de la cerca.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:findNewSections xmlns:ns2="http://news.matrix.org/">
      <newId>{xs:string}</newId>
    </ns2:findNewSections>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:findNewSectionsResponse xmlns:ns2="http://news.matrix.org/">
      <newSection>
        <newSectionId>{xs:string}</newSectionId>
        <newId>{xs:string}</newId>
        <sectionId>{xs:string}</sectionId>
        <priority>{xs:int}</priority>
        <readingCount>{xs:int}</readingCount>
        <sticky>{xs:boolean}</sticky>
      </newSection>
    </ns2:findNewSectionsResponse>
  </S:Body>
</S:Envelope>
Operation storeNewDocument
Name: storeNewDocument
Signature: storeNewDocument (newDocument {news:NewDocument}) => storedNewDocument {news:NewDocument}
Java signature: org.matrix.news.NewDocument storeNewDocument(org.matrix.news.NewDocument newDocument)
Description:
Crea o modifica una associació entre un document i una notícia.
Parameters:
name xml type occurs nillable read only references
newDocument news:NewDocument 1 false false
  • newDocument: Objecte NewDocument que es vol desar. Si el camp newDocumentId té valor nul es crearà un nou objecte. En canvi, si té un valor definit, es modificarà l'objecte indicat.
Response:
name xml type occurs nillable read only references
storedNewDocument news:NewDocument 1 false false
  • storedNewDocument: Objecte NewDocument que ha estat desat.
Errors:
name message
VALUE_IS_MANDATORY Valor de camp obligatori
  • VALUE_IS_MANDATORY: El tipus de l'associació no té valor o és buit.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:storeNewDocument xmlns:ns2="http://news.matrix.org/">
      <newDocument>
        <newDocumentId>{xs:string}</newDocumentId>
        <newId>{xs:string}</newId>
        <documentId>{xs:string}</documentId>
        <title>{xs:string}</title>
        <mimeType>{xs:string}</mimeType>
        <contentId>{xs:string}</contentId>
        <newDocTypeId>{xs:string}</newDocTypeId>
      </newDocument>
    </ns2:storeNewDocument>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:storeNewDocumentResponse xmlns:ns2="http://news.matrix.org/">
      <storedNewDocument>
        <newDocumentId>{xs:string}</newDocumentId>
        <newId>{xs:string}</newId>
        <documentId>{xs:string}</documentId>
        <title>{xs:string}</title>
        <mimeType>{xs:string}</mimeType>
        <contentId>{xs:string}</contentId>
        <newDocTypeId>{xs:string}</newDocTypeId>
      </storedNewDocument>
    </ns2:storeNewDocumentResponse>
  </S:Body>
</S:Envelope>
Operation removeNewDocument
Name: removeNewDocument
Signature: removeNewDocument (newDocumentId {xs:string}) => removed {xs:boolean}
Java signature: boolean removeNewDocument(String newDocumentId)
Description:
Elimina una associació entre un document i una notícia.
Parameters:
name xml type occurs nillable read only references
newDocumentId xs:string 1 false false
  • newDocumentId: Identificador de l'objecte NewDocument a eliminar.
Response:
name xml type occurs nillable read only references
removed xs:boolean 1 false false
  • removed: Indica si l'objecte NewDocument ha estat esborrat.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:removeNewDocument xmlns:ns2="http://news.matrix.org/">
      <newDocumentId>{xs:string}</newDocumentId>
    </ns2:removeNewDocument>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:removeNewDocumentResponse xmlns:ns2="http://news.matrix.org/">
      <removed>{xs:boolean}</removed>
    </ns2:removeNewDocumentResponse>
  </S:Body>
</S:Envelope>
Operation findNewDocuments
Name: findNewDocuments
Signature: findNewDocuments (newId {xs:string}, docType {xs:string}) => newDocument {news:NewDocument}*
Java signature: List<org.matrix.news.NewDocument> findNewDocuments(String newId, String docType)
Description:
Retorna els documents associats a la notícia indicada pel paràmetre newId.
Parameters:
name xml type occurs nillable read only references
newId xs:string 1 false false
docType xs:string 1 false false
  • newId: Identificador de la notícia a la qual han de pertànyer els objectes NewDocument cercats.
  • docType: Tipus d'objecte NewDocument a retornar. Si no s'especifica, es retornaran tots els documents associats a la notícia.
Response:
name xml type occurs nillable read only references
newDocument news:NewDocument 0..N true false
  • newDocument: Llista d'objectes NewDocument que satisfan les condicions de la cerca.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:findNewDocuments xmlns:ns2="http://news.matrix.org/">
      <newId>{xs:string}</newId>
      <docType>{xs:string}</docType>
    </ns2:findNewDocuments>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:findNewDocumentsResponse xmlns:ns2="http://news.matrix.org/">
      <newDocument>
        <newDocumentId>{xs:string}</newDocumentId>
        <newId>{xs:string}</newId>
        <documentId>{xs:string}</documentId>
        <title>{xs:string}</title>
        <mimeType>{xs:string}</mimeType>
        <contentId>{xs:string}</contentId>
        <newDocTypeId>{xs:string}</newDocTypeId>
      </newDocument>
    </ns2:findNewDocumentsResponse>
  </S:Body>
</S:Envelope>
Operation loadSource
Name: loadSource
Signature: loadSource (sourceId {xs:string}) => source {news:Source}
Java signature: org.matrix.news.Source loadSource(String sourceId)
Description:
Recupera una font a partir del seu identificador.
Parameters:
name xml type occurs nillable read only references
sourceId xs:string 1 false false
  • sourceId: Identificador de la font a recuperar.
Response:
name xml type occurs nillable read only references
source news:Source 1 false false
  • source: L'objecte Source que correspon a l'identificador sourceId.
Errors:
name message
SOURCE_NOT_FOUND Font no trobada
  • SOURCE_NOT_FOUND: La font no existeix.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:loadSource xmlns:ns2="http://news.matrix.org/">
      <sourceId>{xs:string}</sourceId>
    </ns2:loadSource>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:loadSourceResponse xmlns:ns2="http://news.matrix.org/">
      <source>
        <id>{xs:string}</id>
        <name>{xs:string}</name>
        <url>{xs:string}</url>
      </source>
    </ns2:loadSourceResponse>
  </S:Body>
</S:Envelope>
Operation storeSource
Name: storeSource
Signature: storeSource (source {news:Source}) => storedSource {news:Source}
Java signature: org.matrix.news.Source storeSource(org.matrix.news.Source source)
Description:
Crea o modifica una font.
Parameters:
name xml type occurs nillable read only references
source news:Source 1 false false
  • source: Objecte Source que es vol desar. Si el camp sourceId té valor nul es crearà una nova font. En canvi, si té un valor definit, es modificarà la font indicada.
Response:
name xml type occurs nillable read only references
storedSource news:Source 1 false false
  • storedSource: Objecte Source que ha estat desat.
Errors:
name message
VALUE_IS_MANDATORY Valor de camp obligatori
VALUE_TOO_LARGE Valor de camp massa gran
  • VALUE_IS_MANDATORY: El nom de la font no té valor o és buit.
  • VALUE_TOO_LARGE: Valor massa llarg al nom o a l'adreça URL de la font.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:storeSource xmlns:ns2="http://news.matrix.org/">
      <source>
        <id>{xs:string}</id>
        <name>{xs:string}</name>
        <url>{xs:string}</url>
      </source>
    </ns2:storeSource>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:storeSourceResponse xmlns:ns2="http://news.matrix.org/">
      <storedSource>
        <id>{xs:string}</id>
        <name>{xs:string}</name>
        <url>{xs:string}</url>
      </storedSource>
    </ns2:storeSourceResponse>
  </S:Body>
</S:Envelope>
Operation removeSource
Name: removeSource
Signature: removeSource (sourceId {xs:string}) => removed {xs:boolean}
Java signature: boolean removeSource(String sourceId)
Description:
Elimina una font.
Parameters:
name xml type occurs nillable read only references
sourceId xs:string 1 false false
  • sourceId: Identificador de la font a eliminar.
Response:
name xml type occurs nillable read only references
removed xs:boolean 1 false false
  • removed: Indica si la font ha estat esborrada.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:removeSource xmlns:ns2="http://news.matrix.org/">
      <sourceId>{xs:string}</sourceId>
    </ns2:removeSource>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:removeSourceResponse xmlns:ns2="http://news.matrix.org/">
      <removed>{xs:boolean}</removed>
    </ns2:removeSourceResponse>
  </S:Body>
</S:Envelope>
Operation countSources
Name: countSources
Signature: countSources (filter {news:SourceFilter}) => sourceCount {xs:int}
Java signature: int countSources(org.matrix.news.SourceFilter filter)
Description:
Recupera el nombre de fonts que satisfan unes determinades condicions expressades mitjançant un filtre SourceFilter.
Parameters:
name xml type occurs nillable read only references
filter news:SourceFilter 1 false false
  • filter: Filtre que es vol aplicar a la cerca.
Response:
name xml type occurs nillable read only references
sourceCount xs:int 1 false false
  • sourceCount: Nombre de fonts que satisfan les condicions del filtre.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:countSources xmlns:ns2="http://news.matrix.org/">
      <filter>
        <sourceId>{xs:string}</sourceId>
        <name>{xs:string}</name>
        <url>{xs:string}</url>
        <firstResult>{xs:int}</firstResult>
        <maxResults>{xs:int}</maxResults>
      </filter>
    </ns2:countSources>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:countSourcesResponse xmlns:ns2="http://news.matrix.org/">
      <sourceCount>{xs:int}</sourceCount>
    </ns2:countSourcesResponse>
  </S:Body>
</S:Envelope>
Operation findSources
Name: findSources
Signature: findSources (filter {news:SourceFilter}) => source {news:Source}*
Java signature: List<org.matrix.news.Source> findSources(org.matrix.news.SourceFilter filter)
Description:
Cerca fonts que satisfacin unes determinades condicions expressades mitjançant un filtre SourceFilter.
Parameters:
name xml type occurs nillable read only references
filter news:SourceFilter 1 false false
  • filter: Filtre que es vol aplicar a la cerca.
Response:
name xml type occurs nillable read only references
source news:Source 0..N true false
  • source: Llista d'objectes Source retornats.
Sample input message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:findSources xmlns:ns2="http://news.matrix.org/">
      <filter>
        <sourceId>{xs:string}</sourceId>
        <name>{xs:string}</name>
        <url>{xs:string}</url>
        <firstResult>{xs:int}</firstResult>
        <maxResults>{xs:int}</maxResults>
      </filter>
    </ns2:findSources>
  </S:Body>
</S:Envelope>
Sample output message:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:findSourcesResponse xmlns:ns2="http://news.matrix.org/">
      <source>
        <id>{xs:string}</id>
        <name>{xs:string}</name>
        <url>{xs:string}</url>
      </source>
    </ns2:findSourcesResponse>
  </S:Body>
</S:Envelope>


Ajuntament de Sant Feliu de Llobregat (C) 2025