URL-voorbeelden voor items op een rapportserver - SharePoint-modus

Als u rapporten en gerelateerde items wilt publiceren naar een SharePoint-bibliotheek, kunt u de inhoud publiceren met behulp van de Reporting Services-ontwerpprogramma's zoals Report Designer. U kunt de inhoud ook uploaden met behulp van SharePoint-siteacties.

SharePoint-sites gebruiken verschillende webadressen dan een Reporting Services-rapportserver in de systeemeigen modus. Een SharePoint-sitewebhiërarchie bevat de SharePoint-webtoepassing, een site op het hoogste niveau, optionele subsites en bibliotheken. U moet weten hoe u een URL-adres maakt dat de SharePoint-server en de locatie opgeeft in de SharePoint-sitehiërarchie waar u een rapport of gerelateerde items wilt publiceren.

Items met betrekking tot een rapport zijn gedeelde gegevensbronnen, subrapporten, drillthrough-rapporten en resources zoals afbeeldingsbestanden op het web. Een rapport dat naar een SharePoint-bibliotheek wordt gepubliceerd, moet deze gerelateerde items opgeven op basis van hun locatie in de SharePoint-bibliotheek.

Gebruik de voorbeelden in dit artikel om URL's te maken voor rapporten en gerelateerde items in uw rapportageoplossingen.

Sitehiërarchie

Wanneer u een rapportserver configureert voor uitvoering in de geïntegreerde SharePoint-modus, wordt de SharePoint-webhiërarchie gebruikt om items te adresseren die worden verwerkt en beheerd op een rapportserver.

De volgende elementen van de webhiërarchie kunnen worden gebruikt voor toegang tot en beveiligde rapportserverinhoud. Andere objecten, zoals lijsten en pagina's, worden niet gebruikt voor toegang tot inhoud van de rapportserver en worden daarom niet beschreven in de volgende tabel.

URL-syntaxis en -regels

U kunt elk rapportserveritem in een bibliotheek identificeren met behulp van de volledig gekwalificeerde URL. De URL bevat een protocolvoorvoegsel, servernaam, site, bibliotheek, bestandsnaam en bestandsnaamextensie voor het bestandstype.

URL voor een SharePoint-server

U moet een URL naar de SharePoint-server gebruiken wanneer u een rapportserver- of rapportmodelproject implementeert van SQL Server Data Tools (SSDT) naar de rapportserver.

Als u de naam van de server wilt vinden die u wilt gebruiken, opent u een browser en zoekt u de SharePoint-bibliotheek waar u een rapport wilt publiceren. De servernaam wordt direct na het protocolvoorvoegsel weergegeven, bijvoorbeeld http:*//servername*.

Gebruik van proxy-eindpunten voor Reporting Services-URL's wordt niet ondersteund. Een proxy-eindpunt bevat bijvoorbeeld http:*//servername:8080/reportserver*een poortnummer.

URL voor een SharePoint-serversite of -subsite

Wanneer u een rapport of rapportgegevensbron implementeert, moet u een URL gebruiken naar een SharePoint-site en -subsite, indien aanwezig. In de URL wordt de sitenaam direct na de servernaam weergegeven, bijvoorbeeld https://*servername/site* of https://*servername/site/subsite*.

Op een Microsoft Office SharePoint Server 2007- of SharePoint Server 2010-webtoepassing komen de site en subsite vaak overeen met de tabbladen op de hoofdsite. Als u de sitenaam of subsitenaam wilt zoeken, selecteert u Start en vervolgens Alle site-inhoud. Schuif naar de onderkant en zoek naar sites en werkruimten. De lijst met sites wordt weergegeven in deze sectie.

URL voor een SharePoint-bibliotheek

Wanneer u een rapport of gerelateerd item implementeert in een SharePoint-bibliotheek, moet u een URL naar de SharePoint-bibliotheek gebruiken. De URL die u voor een bibliotheek wilt gebruiken, verschilt afhankelijk van de versie van SharePoint die u gebruikt.

Op Microsoft Windows SharePoint Services 3.0 of SharePoint Foundation 2010 wordt de bibliotheek weergegeven na de servernaam, bijvoorbeeld https://*servername/*Shared Documents.

Op Office SharePoint Server 2007 of SharePoint Server 2010 wordt de bibliotheek weergegeven na de site en subsite. Bijvoorbeeld: https://*servername/site/*Documents.

Als u de padinformatie voor een nieuwe SharePoint-bibliotheek of voor een onbekende site wilt vinden, opent u een browser en zoekt u de SharePoint-bibliotheek waar u uw rapporten wilt publiceren. Als de bibliotheek leeg is, uploadt u een bestand. Klik met de rechtermuisknop op het bestand en selecteer Eigenschappen om het venster Eigenschappen te openen. Het adres van het bestand bevat de URL-waarden die u nodig hebt voor een publicatiebewerking.

Volledig gekwalificeerde URL's voor items op een SharePoint-site

Items die zijn opgeslagen in een SharePoint-bibliotheek, worden altijd behandeld via een volledig gekwalificeerde URL die begint met de webtoepassing (https://*server*) als het hoofdknooppunt en eindigt met de naam van het bestand waarnaar u verwijst.

Bestandsnamen in de URL moeten een bestandsnaamextensie bevatten.

U kunt geen relatieve URL's gebruiken voor afhankelijke items in rapporten die u publiceert op een SharePoint-site. U kunt bijvoorbeeld geen relatieve URL gebruiken om te verwijzen naar een gedeelde gegevensbron, rapportmodel of subrapport. U moet altijd de volledig gekwalificeerde URL opgeven voor een SharePoint-bibliotheek voor elk item. Er is geen manier om te voorspellen waar een afhankelijk bestand zich mogelijk bevindt. U kunt dit niet voorspellen omdat er geen vooraf gedefinieerde hiërarchie is voor de sites die u kunt gebruiken om een URL-indeling te parseren.

Wanneer u een rapport publiceert of uploadt dat afhankelijke items bevat, moet u de verwijzingen instellen op de afhankelijke items nadat het rapport is gepubliceerd. Verwijzingen die correct werkten in de preview-modus in Report Designer, werken niet gegarandeerd nadat het rapport is gepubliceerd. Zie Publiceren vanuit een bewerkingsprogramma naar een SharePoint-bibliotheek in dit artikel voor meer informatie.

URL's voor externe afbeeldingen

Een rapportdefinitie kan een afbeeldingsbestand bevatten dat is opgeslagen als een extern bestand. U kunt naar dat bestand in de rapportdefinitie verwijzen door een volledig gekwalificeerde URL in te stellen op het afbeeldingsbestand. Het kan worden opgeslagen op een SharePoint-site of op een externe computer.

Ongeacht de rapportservermodus moeten verwijzingen naar een extern afbeeldingsbestand in een rapport een volledig gekwalificeerde URL zijn. Als u naar een extern afbeeldingsbestand verwijst, moet u doorgaans het account voor het verwerken van rapporten zonder toezicht configureren.

Subrapporten en drillthrough-rapporten opgeven

Subrapporten moeten zich in dezelfde map bevinden als het hoofdrapport. U kunt geen relatieve map opgeven.

Als u drillthrough-rapporten wilt opgeven, neemt u de URL op in een expressie. Geef bijvoorbeeld het rapport op met de naam SalesDetails als een drillthrough-rapport. Stel voor het tekstvak of de tijdelijke aanduiding in de actie ReportName op de volgende expressie in:

="https://site/subsite/documentlibrary/SalesDetails.rdl"  

Gereserveerde namen op SharePoint-sites

Als u een URL maakt of maakt naar een item dat zich op een SharePoint-site bevindt, weet u dat de woorden Persoonlijk en Sites gereserveerde namen zijn onder de standaardsite.

Voorbeelden van URL's

Wanneer u items publiceert naar een SharePoint-bibliotheek, moet u volledig gekwalificeerde URL's opgeven voor de doelbibliotheek. Een volledig gekwalificeerde SharePoint-URL bevat de SharePoint-webtoepassing, site, bibliotheek, map (optioneel), bestands- en bestandsnaamextensie. De volgende voorbeelden bevatten verschillende illustraties van de syntaxis die u moet gebruiken.

Publiceren vanuit een bewerkingsprogramma naar een SharePoint-bibliotheek

Wanneer u een bewerkingsprogramma voor rapporten gebruikt om rapporten en gerelateerde bestanden naar een bibliotheek te publiceren, worden de bestanden gevalideerd voordat ze worden toegevoegd. Als u rapporten en gerelateerde bestanden uploadt met behulp van de actie Uploaden in een SharePoint-bibliotheek, wordt er geen validatiecontrole uitgevoerd. U weet niet of het bestand geldig is totdat u het rapport opent door het te beheren, te bewerken of uit te voeren.

Gedeelde gegevensbronnen

Wanneer u een gedeelde gegevensbron publiceert vanuit een bewerkingsprogramma voor rapporten, stelt u de projecteigenschap TargetDataSourceFolder in. De doelgegevensbronmap moet een URL naar een SharePoint-bibliotheek zijn. In tegenstelling tot in de systeemeigen Modus van Reporting Services kunt u geen relatieve map opgeven; relatieve paden zijn niet geldig. Als er geen map in het pad van de documentbibliotheek bestaat, wordt er een gemaakt.

Wanneer u een gedeeld gegevensbronbestand (.rds) publiceert naar een SharePoint-site, wordt met deze actie het gegevensbestand gewijzigd in de bestandsextensie .rsds. Het RSDS-bestand kan niet lokaal worden opgeslagen vanaf een SharePoint-site en geïmporteerd in een bestaand Reporting Services-project. Gedeelde gegevensbronnen met bestandsnaamextensies .rds en .rsds zijn niet uitwisselbaar.

Gedeelde gegevensbronnen van Report Designer

Als u gedeelde gegevensbronnen publiceert vanuit een Report Designer-project, kunt u een URL gebruiken waarmee de doelbibliotheek wordt opgegeven of u kunt de eigenschap leeg laten. In tegenstelling tot in de systeemeigen Modus van Reporting Services kunt u geen relatieve map opgeven; relatieve paden zijn niet geldig. Als er geen map in het pad van de documentbibliotheek bestaat, wordt er een gemaakt. Als u de doelgegevensbronmap leeg laat, wordt de gegevensbron gepubliceerd in de doelrapportmap.

Bestandsnamen

Bestandsnamen in een URL voor rapportitems moeten een bestandsnaamextensie bevatten. De bestandsnaamextensie bepaalt het bestandstype. Wanneer u rapportitems publiceert vanuit een bewerkingsprogramma voor rapporten, wordt de bestandsnaamextensie automatisch opgenomen. Als u een rapportitem uploadt naar een SharePoint-bibliotheek, moet u een bestandsnaamextensie opnemen.

Als u geen bestandsnaamextensie opgeeft voor items die u uploadt naar een SharePoint-site, treedt de fout rsInvalidDataSourceReference op. Bestandsnamen bevatten mogelijk geen tekens die niet worden herkend als geldige bestandsnaamtekens door SharePoint-toepassingen. Neem niet de volgende tekens op: # % & * : < > ? / { | }.

Verschillen tussen uploaden en publiceren

Wanneer u Report Designer of Report Builder gebruikt om rapporten en gerelateerde bestanden naar een bibliotheek te publiceren, valideert het systeem de bestanden voordat u ze toevoegt. Als u rapporten en gerelateerde bestanden uploadt met behulp van de actie Uploaden in een SharePoint-bibliotheek, wordt er geen validatiecontrole uitgevoerd. U weet niet of het bestand geldig is totdat u het rapport opent door het te beheren, te bewerken of uit te voeren.

Een gepubliceerd item bijwerken

Nadat u een item hebt gepubliceerd of geüpload naar een SharePoint-bibliotheek, moet u het item uit de bibliotheek uitchecken voordat u het bijwerkt. Terwijl het rapport voor u is uitgecheckt, bent u de enige gebruiker die gemachtigd is om het rapport te wijzigen. Wanneer u klaar bent, checkt u het opnieuw in.

U kunt een rapport uploaden of publiceren zonder eerst het document uit te checken, bijvoorbeeld door een item met dezelfde naam als een bestaand item te uploaden. Als u dit doet, checkt de rapportserver het voor u uit, voegt het bijgewerkte rapport toe als een nieuwe versie van het bestaande item en checkt vervolgens het document weer in.

Externe afbeeldingen als resources

Een rapportserver die in de systeemeigen modus wordt uitgevoerd, ondersteunt het concept van een resource. Het concept van een resource wordt gedefinieerd als elk bestand dat is opgeslagen en beveiligd op de rapportserver, maar de rapportserver verwerkt het niet. In de systeemeigen modus kan het elk type bestand zijn.

Wanneer een rapportserver wordt uitgevoerd in de geïntegreerde SharePoint-modus, heeft het concept van een resource een beperktere definitie. De rapportserver behoudt het concept van een resource voor het opslaan van rapporten die verwijzen naar een externe afbeelding. Dit concept is van toepassing als het rapport een momentopname of een kopie is die wordt bewaard voor intern gebruik.

Verwante inhoud

• Een rapport publiceren naar een SharePoint-bibliotheek
• Een gedeelde gegevensbron publiceren naar een SharePoint-bibliotheek
• Dialoogvenster Projecteigenschappen