Operationsmetoder operations-methods

I det här avsnittet beskrivs de vanliga åtgärdsparametrarna som hanteras av API:t för IPS-webbtjänsten.

En fullständig beskrivning av varje åtgärdsparameter finns i Operationsparametrar.

Handtag: om section-094ce1afa6244fa5b2c762f44ffdca1c

Hanterar refererande IPS-objekt som returneras av vissa API-åtgärder. Du kan också skicka handtag som parametrar till efterföljande åtgärdsanrop. Handtag är strängdatatyper ( xsd:string).

Handtag är endast avsedda att användas under en enda programsession. Dessutom bör du göra handtagen beständiga eftersom deras format kan ändras mellan olika IPS-versioner. När du skriver interaktiva program implementerar du timeout för sessioner och tar bort alla referenser mellan sessioner, särskilt efter en IPS-uppgradering. När du skriver icke-interaktiva program anropar du lämpliga åtgärder för att hämta referenser varje gång programmet körs. I följande Java/Axis2-kodexempel visas felaktig och korrekt kodkörning:

Felaktig handtagskod

Det här kodexemplet är felaktigt eftersom det innehåller ett hårdkodat värde (555) för företagsreferensen.

SearchAssetsParam searchParam = new SearchAssetsParam(); searchParam.setCompanyHandle("555");// INCORRECT
searchParam.setFolder("myFolder");
SearchAssetsReturn retVal = ipsApi.searchAssets(searchParam, authHeader);

Korrigera handtagskod

Detta kodexempel är korrekt eftersom det anropar getCompanyInfo för att returnera en giltig referens. Den förlitar sig inte på ett hårdkodat värde. Använd den här metoden eller någon annan IPS API-motsvarighet för att returnera den nödvändiga referensen.

GetCompanyInfoParam companyInfoParam = new GetCompanyInfoParam();
companyInfoParam.setCompanyName("My Company"); GetCompanyInfoReturn companyInfoReturn = ipsApi.getCompanyInfo(companyInfoParam, authHeader);
String companyHandle = companyInfoReturn.getCompanyInfo().getCompanyHandle();
SearchAssetsParam searchParam = new SearchAssetsParam(); searchParam.setCompanyHandle(companyHandle); //CORRECT
searchParam.setFolder("myFolder");
SearchAssetsReturn retVal = ipsApi.searchAssets(searchParam, authHeader);

Vanliga typer av handtag section-e683ac8283284f9688e63f51a494f7a0

companyHandle

De flesta åtgärder kräver att du anger ett företagskontext genom att skicka en companyHandle parameter. Företagshandtaget är en pekare som returneras av vissa åtgärder som getCompanyInfo, addCompanyoch getCompanyMembership.

userHandle

The userHandle parameter är en valfri parameter för åtgärder som riktar sig till en viss användare. Som standard riktar dessa åtgärder sig till den anropande användaren (den användare vars inloggningsuppgifter skickas för autentisering). Administratörsanvändare med rätt behörighet kan dock ange en annan användare. Till exempel setPassword anger vanligtvis lösenordet för den autentiserade användaren, men en administratör kan använda userHandle -parameter för att ange lösenordet för en annan användare.

För åtgärder som kräver en företagskontext (med companyHandle parameter) måste både autentiserade användare och målanvändare vara medlemmar i det angivna företaget. För åtgärder som inte kräver någon företagskontext måste både den autentiserade användaren och målanvändaren vara medlemmar i minst ett gemensamt företag.

Följande åtgärder kan hämta användarhandtag:

accessUserHandle och accessGroupHandle

Som standard används åtgärder som kräver åtkomstbehörighet (läsa, skriva, ta bort) i den anropande användarens behörighetskontext. Vissa åtgärder gör att du kan ändra det här sammanhanget med accessUserHandle eller accessGroupHandle parameter. The accessUserHandle kan en administratör personifiera en annan användare. The accessGroupHandle -parametern gör att anroparen kan arbeta i kontexten för en viss användargrupp.

responseFieldArray och excludeFieldArray

Vissa åtgärder gör att anroparen kan begränsa vilka fält som ska inkluderas i svaret. Genom att begränsa fält kan du minska den tid och det minne som krävs för att bearbeta begäran och minska svarsdatans storlek. Anroparen kan begära en viss lista med fält genom att skicka en responseFieldArray -parameter, eller med en numrerad lista över uteslutna fält via excludeFieldArray parameter.

Båda responseFieldArray och excludeFieldArray ange fält med hjälp av en nodsökväg som avgränsas med /. Om du till exempel anger att searchAssets returnerar bara namnet, det senaste ändringsdatumet och metadata för varje resurs enligt följande:

<responseFieldArray>
   <items>assetArray/items/name</items>
   <items>assetArray/items/lastModified</items>
   <items>assetArray/items/metadataArray</items>
</responseFieldArray>

Om du vill returnera alla fält (förutom behörigheter):

<excludeFieldArray>
   <items>assetArray/items/permissions</items>
</excludeFieldArray>

Observera att nodsökvägarna är relativa till den returnerade nodroten. Om du anger ett komplext textfält utan något av dess underordnade element (till exempel: assetArray/items/imageInfo) inkluderas alla dess underelement. Om du anger ett eller flera delelement i ett komplext typfält (till exempel assetArray/items/imageInfo/originalPath) inkluderas bara de delelementen.

Om du inte inkluderar responseFieldArray eller excludeFieldArray i en begäran returneras alla fält.

Språk

Sedan IPS 4.0 har IPS API:t stöd för att ställa in språkkontexten för en åtgärd genom att skicka authHeader locale-parameter. Om parametern locale inte finns, HTTP-huvudet Accept-Language används. Om den här rubriken inte finns används standardspråket för IPS-servern.

Vissa åtgärder tar också explicita språkparametrar, som kan skilja sig från åtgärdssammanhanget. Till exempel submitJob operationen tar locale parameter som anger språkområdet som används för jobbloggning och e-postmeddelanden.

Språkparametrar använder formatet <language_code>[-<country_code>]

Om språkkoden är en gemen tvåbokstavskod som anges av ISO-639 och den valfria landskoden är en versal, tvåbokstavskod som specificeras av ISO-3266. Den nationella strängen för amerikansk engelska är till exempel en-US.