Werken met acties op afstand
Acties op afstand worden gebruikt om acties vanuit de IBM® Web Content Manager-toepassing te starten.
[plugin:RemoteAction action=" " docid=" " dialog=" " dialogSize=" " dialogTitle=" " useCurrentContext=" " showInfoMsg=" " ]
- action
- Dit is de uit te voeren actie op afstand.
- docid
- Dit is het document-ID van het item dat uitgevoerd moet worden voor de actie op afstand.
- useCurrentContext
- Als dit is ingesteld op true, wordt het document-ID verkregen uit de weergavecontext in plaats van het kenmerk docid.
- dialog
- Als de waarde true is ingesteld en de actie op afstand wordt weergegeven in een webcontentviewerportlet, wordt deze afgebeeld in de vorm van een URL waarmee de gebruiker wordt doorgestuurd naar een verborgen portalpagina die door de webcontentviewer wordt gebruikt voor inline bewerkingen.
- dialogSize
- Dit is een optionele instelling waarmee de grootte kan worden opgegeven van het venster dat de actie op afstand uitvoert. De waarde heeft de notatie "breedte,hoogte". Bijvoorbeeld dialogSize="200,300" voor een venster van 200 pixels breed en 300 pixels hoog. Als u deze instelling weglaat, wordt de venstergrootte berekend op basis van de content die in het venster wordt afgebeeld. Deze instelling wordt alleen gebruikt als dialog="true".
- dialogTitle
- Dit is een optionele instelling waarmee de titel kan worden opgegeven van het venster dat de actie op afstand uitvoert. Als u deze instelling weglaat, wordt de naam van de actie gebruikt. Deze instelling wordt alleen gebruikt als dialog="true".
- showInfoMsg
- Stel dit in op true als u wilt dat de successtatus en andere statusberichten worden afgebeeld nadat de actie op afstand voltooid is. Geeft u deze parameter niet op, dan wordt de standaardwaarde false gebruikt en worden er alleen waarschuwings- en foutberichten afgebeeld. Deze instelling kan alleen worden gebruikt als dialog="true".
http://[host]/wps/myportal/wcmAuthoring?wcmAuthoringAction=actionU kunt acties op afstand ook toevoegen aan de URL van een lokale webcontentviewerportlet. Dit kan nuttig zijn voor sites waar contentitems inline bewerkt kunnen worden.
Typen van acties op afstand
- new
- Dit wordt gebruikt om een nieuw-itemformulier te openen. U moet ook de parameter "type" opgeven.Bijvoorbeeld:
- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" ]
U kunt de volgende parameters gebruiken:- com.ibm.workplace.wcm.api.WCM_AuthoringTemplate
- com.ibm.workplace.wcm.api.WCM_Category
- com.ibm.workplace.wcm.api.WCM_Content
- com.ibm.workplace.wcm.api.WCM_DateComponent
- com.ibm.workplace.wcm.api.WCM_FileComponent
- com.ibm.workplace.wcm.api.WCM_HTMLComponent
- com.ibm.workplace.wcm.api.WCM_ImageComponent
- com.ibm.workplace.wcm.api.WCM_NumericComponent
- com.ibm.workplace.wcm.api.WCM_PresentationTemplate
- com.ibm.workplace.wcm.api.WCM_RichTextComponent
- com.ibm.workplace.wcm.api.WCM_ShortTextComponent
- com.ibm.workplace.wcm.api.WCM_SiteArea
- com.ibm.workplace.wcm.api.WCM_Taxonomy
- com.ibm.workplace.wcm.api.WCM_TextComponent
- com.ibm.workplace.wcm.api.WCM_Workflow
- com.ibm.workplace.wcm.api.WCM_WorkflowStage
Als u een nieuw contentitem maakt, kunt u een standaardauthoringsjabloon opgeven door het document-ID van de authoringsjabloon op te geven in de parameter atid:- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" atid="com.ibm.workplace.wcm.api.WCM_AuthoringTemplate/ID1"]
Als u sitegebieden , contentitems en categorieën maakt, kunt u het document-ID van het bovenliggende item opgeven om het nieuwe item hieronder op te slaan. Geef dit ID op in de parameter pid:- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" pid="com.ibm.workplace.wcm.api.WCM_SiteArea/ID"]
- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_SiteArea" pid="com.ibm.workplace.wcm.api.WCM_SiteArea/ID"]
- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Category" pid="com.ibm.workplace.wcm.api.WCM_Taxonomy/ID"]
Als u sitegebieden maakt, kunt u de positie van het nieuwe sitegebied opgeven met de parameter position. U kunt aangeven of u het nieuwe sitegebied aan het begin of aan het einde wilt opslaan ten opzichte van de bestaande sitegebieden. Als u niets opgeeft, wordt het nieuwe sitegebied aan het begin opgeslagen ten opzichte van de bestaande sitegebieden:- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" position="start"]
- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_SiteArea" position="end"]
- delete
- Dit wordt gebruikt om een item te verwijderen. U moet ook het docid van het item opgeven.Bijvoorbeeld:
- [plugin:RemoteAction action="delete" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1"]
- edit
- Dit wordt gebruikt om een itemformulier te openen in de bewerkingsmodus. U moet ook het docid van het item opgeven.Bijvoorbeeld:
- [plugin:RemoteAction action="edit" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1"]
- read
- Dit wordt gebruikt om een itemformulier te openen in de alleen-lezenmodus. U moet ook het docid van het item opgeven.Bijvoorbeeld:
- [plugin:RemoteAction action="read" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1"]
- openmainview
- Dit wordt gebruikt om een view in een authoringportlet te openen. U moet ook een view-parameter opgeven.Bijvoorbeeld:
- [plugin:RemoteAction action="openmainview" view="contentbysitearea"]
U kunt de volgende viewparameters gebruiken:- contentbysitearea
- contentbytitle
- myrecent
- mydraft
- mypendingapproval
- mypublished
- myexpired
- mydeleted
- alldraftitems
- allexpireditems
- allpublisheditems
- alldeleteditems
- componentsbytype
- move
- Dit wordt gebruikt om een sitegebied of een contentitem te verplaatsen. U opent bijvoorbeeld als volgt het verplaatsingsvenster voor een contentitem of een sitegebied:
- [plugin:RemoteAction action="move" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1"]
De verplaatsingsrichting wordt aangegeven met "1" voor omhoog en "-1" voor omlaag. U verplaatst bijvoorbeeld als volgt een contentitem één positie omhoog:- [plugin:RemoteAction action="move" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1" pid="com.ibm.workplace.wcm.api.WCM_SiteArea/ID1" moveDirection="1"]
- link
- Hiermee wordt een contentitem gekoppeld aan een sitegebied. Bijvoorbeeld:
- [plugin:RemoteAction action="link" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1" pid="com.ibm.workplace.wcm.api.WCM_SiteArea/ID2"]
Als u links naar items maakt, kunt u het pad naar het bovenliggende item opgeven met behulp van de parameter ppath in plaats van de parameter pid:- [plugin:RemoteAction action="link" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1" ppath="library1/sitearea1/sitearea2"]
Als u links naar items maakt, kunt u een nieuw bovenliggend item maken met de parameter autoCreateParent. U moet ook de bibliotheek opgeven waar het item dat wordt gelinkt zich bevindt. Dat doet u met de parameter slibrary. De parameter ppath wordt gebruikt om aan te geven onder welk bestaand bovenliggend item het nieuwe bovenliggende item wordt gemaakt:- [plugin:RemoteAction action="link" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1" autoCreateParent="true" slibrary="libraryname" ppath="library1/sitearea1/sitearea2"]
- copy
- Dit wordt gebruikt om een item te kopiëren. U kopieert bijvoorbeeld als volgt een contentitem naar een nieuw sitegebied:
- [plugin:RemoteAction action="copy" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1" pid="com.ibm.workplace.wcm.api.WCM_SiteArea/ID2"]
U kunt bij het kopiëren de volgende extra parameters gebruiken:- copyAsDraft="true"
Hiermee wordt de werkstroom van de gemaakte kopie opnieuw gestart. Meestal krijgt de gemaakte kopie hierdoor de status Concept.
- wid="com.ibm.workplace.wcm.api.WCM_Workflow/ID1"
Hiermee geeft u een andere werkstroom op bij het maken van een kopie. Ook wordt hiermee de werkstroom van de gemaakt kopie opnieuw gestart. Meestal krijgt de gemaakte kopie hierdoor de status Concept.
- position="start"
Hiermee wordt de kopie gemaakt als eerste item onder het opgegeven bovenliggende item. Als dit niet is opgegeven, wordt het item gekopieerd als laatste onderliggende item van het opgegeven bovenliggende item.
Als u items kopieert, kunt u het pad naar het bovenliggende item opgeven met behulp van de parameter ppath in plaats van de parameter pid:- [plugin:RemoteAction action="copy" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1" ppath="library1/sitearea1/sitearea2"]
Als u items kopieert, kunt u een nieuw bovenliggend item maken met de parameter autoCreateParent. U moet ook de bibliotheek opgeven waar het item dat wordt gekopieerd zich bevindt. Dat doet u met de parameter slibrary. De parameter ppath wordt gebruikt om aan te geven onder welk bestaand bovenliggend item het nieuwe bovenliggende item wordt gemaakt:- [plugin:RemoteAction action="copy" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1" autoCreateParent="true" slibrary="libraryname" ppath="library1/sitearea1/sitearea2"]
- approve
- Dit wordt gebruikt om een item in een werkstroom goed te keuren. U moet ook het docid van het item opgeven.Bijvoorbeeld:
- [plugin:RemoteAction action="approve" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1"]
- decline
- Dit wordt gebruikt om een item in een werkstroom af te wijzen. U moet ook het docid van het item opgeven.Bijvoorbeeld:
- [plugin:RemoteAction action="decline" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1"]
- saveandapprove
- Dit wordt gebruikt om een item in een werkstroom goed te keuren, waarbij het item is geopend in de bewerkingsmodus in dezelfde sessie. U moet ook het docid van het item opgeven.Bijvoorbeeld:
- [plugin:RemoteAction action="saveandapprove" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1"]
- [plugin:RemoteAction action="saveandapprove" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1" isdraft="true"]
- previousstage
- Dit wordt gebruikt om een item te verplaatsen naar het vorige stadium in een werkstroom.
U moet ook het docid van het item opgeven.Bijvoorbeeld:
- [plugin:RemoteAction action="previousstage" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1"]
- viewversions
- Dit wordt gebruikt om het venster Versies van een item te openen. U moet ook het docid van het item opgeven.Bijvoorbeeld:
- [plugin:RemoteAction action="viewversions" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1"]
- viewhistory
- Dit wordt gebruikt om het historievenster van een item te openen. U moet ook het docid van het item opgeven.Bijvoorbeeld:
- [plugin:RemoteAction action="viewhistory" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1"]
Velden invullen bij het maken van of bewerken van content
Als u de parameter "new" of "edit" gebruikt voor contentitems, kunt u met een URL ook gegevens aan verschillende velden in het contentitem toevoegen.
- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" wcmfield.content.name="newcontent"]
- wcmfield.content.name=
- wcmfield.content.title=
- wcmfield.content.description=
- wcmfield.content.authors=
- wcmfield.content.owners=
- wcmfield.content.publishDate=
- wcmfield.content.expiryDate=
- wcmfield.content.generalDateOne=
- wcmfield.content.generalDateTwo=
- wcmfield.content.workflow= (Alleen te gebruiken bij het maken van content.)
- wcmfield.content.categories=
- wcmfield.content.keywords=
- wcmfield.element.elementname= Opmerking: U vervangt elementnaam door de naam van het element dat u wilt vullen. De elementparameter kan alleen worden gebruikt met de volgende elementtypen:
- Tekst
- Html
- Rich Text
- Optie kiezen
- Gebruikersselectie
- Datum en tijd
- Getal
- JSP
- Link
- Componentverwijzing
- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" wcmfield.content.authors="uid=usera,cn=cn-name,dc=dc-name"]
- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" wcmfield.content.workflow="ID1"]
- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" wcmfield.content.categories="ID1"]
- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" wcmfield.content.generalDateOne="Feb 14, 2008 12:53:03 PM"]
- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" wcmfield.content.generalDateOne="Feb 14, 2008"]
- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" wcmfield.element.jspelementname="/wps/wcm/jsp/html/example.jsp"]
- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" wcmfield.element.mycompref.type="com.aptrix.pluto.cmpnt.NavigatorCmpnt" wcmfield.element.mycompref.id="e4bdf10042d0769698ccbeb0e25cc973"]
- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" wcmfield.element.elementname="AA" wcmfield.element.elementname="BB"]
- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" wcmfield.element.elementname="uid=wpsadmin,o=defaultWimFileBasedRealm" wcmfield.element.elementname="uid=wpsadmin2,o=defaultWimFileBasedRealm"]
- Een link toevoegen aan een contentitem
- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" wcmfield.element.elementname.type="content" wcmfield.element.elementname.id="contentID"]
- Een link toevoegen aan een linkcomponent:
- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" wcmfield.element.elementname.type="link" wcmfield.element.elementname.id="linkcomponentID"]
- Een link toevoegen aan een afbeelding of een bestandsresourcecomponent:
- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" wcmfield.element.elementname.type="resource" wcmfield.element.elementname.id="componentID"]
- Een link toevoegen aan een URL:
- [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" wcmfield.element.elementname.type="external" wcmfield.element.elementname.externalReference="myurl"]
- Om aan te geven of u de naam van het item wilt gebruiken waarnaar u als tekstlink verwijst, voegt u het volgende toe aan de tag:
- wcmfield.element.elementname.useReferenceLinkText="true"
- Als u wilt dat een afbeelding als link wordt weergegeven, voegt u het volgende toe aan de tag:
- wcmfield.element.elementname.linkImage="imagecomponentID"
- Als u de tekst van de link opgeeft, voegt u het volgende toe aan de URL:
- wcmfield.element.elementname.linkText="text"
- Als u de beschrijving van de link opgeeft, voegt u het volgende toe aan de URL:
- wcmfield.element.elementname.linkDescription="text"
- Als u een linkdoel opgeeft, voegt u het volgende toe aan de URL:
- wcmfield.element.elementname.linkTarget=
- _blank
- _parent
- _self
- _top
- targetname
Parameters opslaan
U kunt de volgende "save"-parameters toevoegen aan de tag van een actie op afstand.
- autoSave
- Dit wordt gebruikt om een bestuur- of beheerbaar item op te slaan. Dit gebeurt op de achtergrond en de gebruiker krijgt dit niet te zien. Bijvoorbeeld:
- wcmfield.autosave="true"
- saveValidate
- Deze parameter bepaalt of de waarschuwingen en foutberichten van een autosave-actie worden afgebeeld voor de gebruiker. Als de waarde "true" is ingesteld, worden de waarschuwingen en foutberichten voor de gebruiker afgebeeld. Als de waarde "false" is ingesteld, worden de berichten niet weergegeven. De standaardwaarde is true.Bijvoorbeeld:
- &wcmfield.saveValidate="false"
Commentaar toevoegen aan de itemhistorie
Bij het maken van items die gebruikmaken van een werkstroom waarvoor "Commentaar opgeven bij goedkeuring" is ingesteld op true, kunt u commentaar aan de itemhistorie toevoegen. Voeg daartoe comment="comment text" toe aan de URL.
[plugin:RemoteAction action="edit" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1" createDraft="true" comment="comment text"]
Voorbeelden
- Tag: [plugin:RemoteAction action="viewversions" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1"]
- URL: http://<host>/wps/myportal/wcmAuthoring?wcmAuthoringAction=viewversions&docid=com.ibm.workplace.wcm.api.WCM_Content/ID1
- Tag: [plugin:RemoteAction action="viewhistory" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1"]
- URL: http://<host>/wps/myportal/wcmAuthoring?wcmAuthoringAction=viewhistory&docid=com.ibm.workplace.wcm.api.WCM_Content/ID1
- Tag: [plugin:RemoteAction action="read" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1"]
- URL: http://<host>/wps/myportal/wcmAuthoring?wcmAuthoringAction=read&docid=com.ibm.workplace.wcm.api.WCM_Content/ID1
- Tag: [plugin:RemoteAction action="edit" &docid=com.ibm.workplace.wcm.api.WCM_Content/ID1]
- URL: http://<host>/wps/myportal/wcmAuthoring?wcmAuthoringAction=edit&docid=com.ibm.workplace.wcm.api.WCM_Content/ID1
- Tag: [plugin:RemoteAction action="move" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1" moveDirection="1" pid="com.ibm.workplace.wcm.api.WCM_SiteArea/ID1"]
- URL: http://<host>/wps/myportal/wcmAuthoring?wcmAuthoringAction=move&docid=com.ibm.workplace.wcm.api.WCM_Content/ID1&moveDirection=1&pid=com.ibm.workplace.wcm.api.WCM_SiteArea/ID1
- Tag: [plugin:RemoteAction action="move" docid="com.ibm.workplace.wcm.api.WCM_SiteArea/ID1" "moveDirection="-1" pid="com.ibm.workplace.wcm.api.WCM_SiteArea/ID1"]
- URL: http://<host>/wps/myportal/wcmAuthoring?wcmAuthoringAction=move&docid=com.ibm.workplace.wcm.api.WCM_SiteArea/ID1&moveDirection=-1&pid=com.ibm.workplace.wcm.api.WCM_SiteArea/ID1
- Tag: [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" wcmfield.content.title="newcontent"]
- URL: http://<host>/wps/myportal/wcmAuthoring?wcmAuthoringAction=new&type=com.ibm.workplace.wcm.api.WCM_Content&wcmfield.content.title=newcontent
- Tag: [plugin:RemoteAction action="edit" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1" wcmfield.content.keywords="keyword1" wcmfield.content.keywords="keyword2"]
- URL: http://<host>/wps/myportal/wcmAuthoring?wcmAuthoringAction=edit&docid=com.ibm.workplace.wcm.api.WCM_Content/ID1&wcmfield.content.keywords=keyword1&wcmfield.content.keywords=keyword2
- Tag: [plugin:RemoteAction action="edit" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1" wcmfield.content.keywords="keyword1" wcmfield.content.keywords="keyword2" wcmfield.autosave="true"]
- URL: http://<host>/wps/myportal/wcmAuthoring?wcmAuthoringAction=edit&docid=com.ibm.workplace.wcm.api.WCM_Content/ID1&wcmfield.content.keywords=keyword1&wcmfield.content.keywords=keyword2&wcmfield.autosave=true
- Tag: [plugin:RemoteAction action="edit" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1" wcmfield.content.keywords="keyword1" wcmfield.autosave="true" wcmfield.saveValidate="false"]
- URL: http://<host>/wps/myportal/wcmAuthoring?wcmAuthoringAction=edit&docid=com.ibm.workplace.wcm.api.WCM_Content/ID1&wcmfield.content.keywords=keyword1&wcmfield.autosave=true&wcmfield.saveValidate=false
- Tag: [plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" atid="com.ibm.workplace.wcm.api.WCM_AuthoringTemplate/ID1" pid="com.ibm.workplace.wcm.api.WCM_SiteArea/ID2" wcmfield.content.name="newcontent" wcmfield.autosave="true" wcmfield.saveValidate="true"]
- URL: http://<host>/wps/myportal/wcmAuthoring?wcmAuthoringAction=new&type=com.ibm.workplace.wcm.api.WCM_Content&atid=com.ibm.workplace.wcm.api.WCM_AuthoringTemplate/ID1&pid=com.ibm.workplace.wcm.api.WCM_SiteArea/ID2&wcmfield.content.name=newcontent&wcmfield.autosave=true&wcmfield.saveValidate=true
- Tag: [plugin:RemoteAction action="edit" docid="com.ibm.workplace.wcm.api.WCM_Content/ID1" createDraft="true" comment="comment"]
- URL: http://<host>/wps/myportal/wcmAuthoring?wcmAuthoringAction=edit&docid=com.ibm.workplace.wcm.api.WCM_Content/ID1&createDraft=true&comment=comment