Een Office-oplossing implementeren met ClickOnce

U kunt uw Office-oplossing in minder stappen implementeren als u ClickOnce gebruikt. Als u updates publiceert, detecteert en installeert uw oplossing deze automatisch. ClickOnce vereist echter dat u uw oplossing afzonderlijk installeert voor elke gebruiker van een computer. Daarom moet u overwegen Windows Installer (.msi) te gebruiken als meer dan één gebruiker uw oplossing op dezelfde computer uitvoert.

In dit onderwerp

De oplossing publiceren

U kunt uw oplossing publiceren met behulp van de wizard Publiceren of projectontwerper. In deze procedure gebruikt u Projectontwerper omdat deze de volledige set publicatieopties biedt. Zie de wizard Publiceren (Office-ontwikkeling in Visual Studio).

De oplossing publiceren

  1. Kies in Solution Explorer het knooppunt met de naam van uw project.

  2. Kies Project, ProjectNameProperties in de menubalk.

  3. Kies in Projectontwerper het tabblad Publiceren , waarin de volgende afbeelding wordt weergegeven.

    Het tabblad Publiceren van projectontwerper

  4. Voer in het vak Locatie van publicatiemap (FTP-server of bestandspad) het pad in van de map waarin u de projectontwerper de oplossingsbestanden wilt kopiëren.

    U kunt een van de volgende typen paden invoeren.

    • Een lokaal pad (bijvoorbeeld C:\FolderName\FolderName).

    • Een UNC-pad (Uniform Naming Convention) naar een map in uw netwerk (bijvoorbeeld \\ServerName\FolderName).

    • Een relatief pad (bijvoorbeeld PublishFolder\, de map waarin het project standaard wordt gepubliceerd).

  5. Voer in het vak URL van de installatiemap het volledig gekwalificeerde pad in van de locatie waar eindgebruikers uw oplossing vinden.

    Als u de locatie nog niet weet, voert u niets in dit veld in. ClickOnce zoekt standaard naar updates in de map van waaruit uw gebruikers de oplossing installeren.

  6. Kies de knop Vereisten.

  7. Controleer in het dialoogvenster Vereisten of het selectievakje Installatieprogramma maken voor het installeren van vereiste onderdelen is ingeschakeld.

  8. In de lijst Kies welke vereisten u wilt installeren, schakelt u de selectievakjes in voor Windows Installer 4.5 en het juiste .NET Framework-pakket.

    Als uw oplossing bijvoorbeeld is gericht op .NET Framework 4.5, schakelt u de selectievakjes in voor Windows Installer 4.5 en Microsoft .NET Framework 4.5 Volledig.

  9. Als uw oplossing is gericht op .NET Framework 4.5, schakelt u ook het selectievakje Visual Studio 2010 Tools for Office Runtime in.

    Opmerking

    Dit selectievakje wordt standaard niet weergegeven. Als u dit selectievakje wilt weergeven, moet u een Bootstrapper-pakket maken. Zie Een Bootstrapper-pakket maken voor een Office 2013 VSTO-invoegtoepassing met Visual Studio 2012.

  10. Kies onder De installatielocatie voor vereisten opgeven een van de opties die worden weergegeven en kies vervolgens de knop OK .

    In de volgende tabel wordt elke optie beschreven.

    Optie Description
    Vereisten downloaden van de website van de leverancier van het onderdeel De gebruiker wordt gevraagd deze vereisten van de leverancier te downloaden en te installeren.
    Vereisten downloaden vanaf dezelfde locatie als mijn toepassing De vereiste software wordt geïnstalleerd met de oplossing. Als u deze optie kiest, kopieert Visual Studio alle vereiste pakketten naar de publicatielocatie voor u. Deze optie werkt alleen als de vereiste pakketten zich op de ontwikkelcomputer bevinden.
    Download de vereisten vanaf de volgende locatie Visual Studio kopieert alle vereiste pakketten naar de locatie die u opgeeft en installeert deze met de oplossing.

    Zie het dialoogvenster Voorwaarden.

  11. Kies de knop Updates , geef op hoe vaak de VSTO-invoegtoepassing of aanpassing van elke eindgebruiker op updates moet controleren en kies vervolgens de knop OK .

    Opmerking

    Als u een cd of een verwisselbaar station gebruikt voor de implementatie, selecteert u het keuzerondje Nooit controleren op updates.

    Zie Een update publiceren voor meer informatie over het publiceren van een update.

  12. Kies de knop Opties , controleer de opties in het dialoogvenster Opties en kies vervolgens de knop OK .

  13. Kies de knop Nu publiceren .

    Visual Studio voegt de volgende mappen en bestanden toe aan de publicatiemap die u eerder in deze procedure hebt opgegeven.

    • De map Toepassingsbestanden.

    • Het installatieprogramma.

    • Een implementatiemanifest dat verwijst naar het implementatiemanifest van de meest recente versie.

      De map Toepassingsbestanden bevat een submap voor elke versie die u publiceert. Elke versiespecifieke submap bevat de volgende bestanden.

    • Een toepassingsmanifest.

    • Een implementatiemanifest.

    • Aanpassingsassemblies.

      In de volgende afbeelding ziet u de structuur van de publicatiemap voor een Outlook VSTO-invoegtoepassing.

      Mapstructuur publiceren

    Opmerking

    ClickOnce voegt de extensie .deploy toe aan assembly's, zodat een beveiligde installatie van Internet Information Services (IIS) de bestanden niet blokkeert vanwege een onveilige extensie. Wanneer de gebruiker de oplossing installeert, verwijdert ClickOnce de extensie .deploy .

  14. Kopieer de oplossingsbestanden naar de installatielocatie die u eerder in deze procedure hebt opgegeven.

Bepalen hoe u vertrouwen wilt verlenen aan de oplossing

Voordat een oplossing op gebruikerscomputers kan worden uitgevoerd, moet u vertrouwen verlenen of moeten gebruikers reageren op een vertrouwensprompt wanneer ze de oplossing installeren. Als u een vertrouwensrelatie aan de oplossing wilt verlenen, ondertekent u de manifesten met behulp van een certificaat dat een bekende en vertrouwde uitgever identificeert. Zie De oplossing vertrouwen door de toepassing en implementatiemanifesten te ondertekenen.

Als u een aanpassing op documentniveau implementeert en u het document in een map op de computer van de gebruiker wilt plaatsen of het document beschikbaar wilt maken op een SharePoint-site, moet u ervoor zorgen dat Office de locatie van het document vertrouwt. Zie Vertrouwen geven aan documenten.

Gebruikers helpen de oplossing te installeren

Gebruikers kunnen de oplossing installeren door het installatieprogramma uit te voeren, het implementatiemanifest te openen of tijdens het aanpassen op documentniveau het document rechtstreeks te openen. Als best practice moeten gebruikers uw oplossing installeren met behulp van het installatieprogramma. De andere twee benaderingen zorgen er niet voor dat de vereiste software is geïnstalleerd. Als gebruikers het document willen openen vanaf de installatielocatie, moeten ze het toevoegen aan de lijst met vertrouwde locaties in het Vertrouwenscentrum van de Office-toepassing.

Het document openen van een aanpassing op documentniveau

Gebruikers kunnen het document van een aanpassing op documentniveau rechtstreeks openen vanaf de installatielocatie of door het document naar hun lokale computer te kopiëren en vervolgens de kopie te openen.

Als best practice moeten gebruikers een kopie van het document op hun computers openen, zodat meerdere gebruikers niet tegelijkertijd proberen dezelfde kopie te openen. Als u deze procedure wilt afdwingen, kunt u het installatieprogramma configureren om het document naar gebruikerscomputers te kopiëren. Zie Het document van een oplossing op de computer van de eindgebruiker plaatsen (alleen aanpassingen op documentniveau).

De oplossing installeren door het implementatiemanifest te openen vanaf een IIS-website

Gebruikers kunnen een Office-oplossing installeren door het implementatiemanifest vanaf internet te openen. Een beveiligde installatie van Internet Information Services (IIS) blokkeert echter bestanden met de extensie .vsto . Het MIME-type moet worden gedefinieerd in IIS voordat u een Office-oplossing kunt implementeren met IIS.

Het .vsto MIME-type toevoegen aan IIS 6.0
  1. Op de server waarop IIS 6.0 wordt uitgevoerd, kies Start>Alle Programma's>Beheertools>Internet Information Services (IIS) Manager.

  2. Kies de computernaam, de map Websites of de website die u configureert.

  3. Kies actie-eigenschappen> op de menubalk.

  4. Kies op het tabblad HTTP-headers de knop MIME-typen .

  5. Kies in het venster MIME-typen de knop Nieuw .

  6. Voer in het venster MIME-type.vsto in als de extensie, voer application/x-ms-vsto in als mime-type en pas de nieuwe instellingen toe.

    Opmerking

    Als de wijzigingen van kracht worden, moet u de World Wide Web Publishing Service opnieuw starten of wachten totdat het werkproces wordt gerecycled. Vervolgens moet u de schijfcache van de browser leegmaken en vervolgens het .vsto-bestand opnieuw proberen te openen.

Het .vsto MIME-type toevoegen aan IIS 7.0
  1. Op de server waarop IIS 7.0 wordt uitgevoerd, kies>Start>, Alle Programma's>, Accessoires.

  2. Open het snelmenu voor de opdrachtprompt en kies Uitvoeren als administrator.

  3. Voer in het vak Openen het volgende pad in en kies vervolgens de knop OK .

    %windir%\system32\inetsrv
    
  4. Voer de volgende opdracht in en pas de nieuwe instellingen toe.

    set config /section:staticContent /+[fileExtension='.vsto',mimeType='application/x-ms-vsto']
    

    Opmerking

    Als de wijzigingen van kracht worden, moet u de World Wide Web Publishing Service opnieuw starten of moet u wachten totdat het werkproces wordt gerecycled. Vervolgens moet u de schijfcache van de browser leegmaken en vervolgens het .vsto-bestand opnieuw proberen te openen.

Plaats het document van een oplossing op de computer van de eindgebruiker (alleen aanpassingen op documentniveau)

U kunt het document van uw oplossing naar de computer van de eindgebruiker kopiëren door een actie na de implementatie te maken. Op die manier hoeft de gebruiker het document niet handmatig van de installatielocatie naar de computer te kopiëren nadat deze de oplossing heeft geïnstalleerd. U moet een klasse maken die de actie na de implementatie definieert, de oplossing bouwt en publiceert, het toepassingsmanifest wijzigt en de toepassing en het implementatiemanifest opnieuw ondertekent.

In de volgende procedures wordt ervan uitgegaan dat uw projectnaam ExcelWorkbook is en dat u de oplossing publiceert in een gemaakte map met de naam C:\publish op uw computer.

Een klasse maken die de actie na de implementatie definieert

  1. Kies bestand>toevoegen>nieuw project op de menubalk.

  2. Kies in het dialoogvenster Nieuw project toevoegen in het deelvenster Geïnstalleerde sjablonen de Windows-map.

  3. Kies in het deelvenster Sjablonen de sjabloon Klassebibliotheek .

  4. Voer in het veld NaamFileCopyPDA in en kies vervolgens de knop OK .

  5. Kies in Solution Explorer het FileCopyPDA-project .

  6. Kies op de menubalk Project>Add Reference.

  7. Voeg op het tabblad .NET verwijzingen toe aan Microsoft.VisualStudio.Tools.Applications.Runtime en Microsoft.VisualStudio.Tools.Applications.ServerDocument.

  8. Wijzig de naam van de klasse in FileCopyPDAen vervang de inhoud van het bestand door de code. Met deze code worden de volgende taken uitgevoerd:

    • Kopieert het document naar het bureaublad van de gebruiker.

    • Hiermee wijzigt u de eigenschap _AssemblyLocation van een relatief pad naar een volledig gekwalificeerd pad voor het implementatiemanifest.

    • Hiermee verwijdert u het bestand als de gebruiker de oplossing verwijdert.

      using Microsoft.VisualStudio.Tools.Applications.Deployment;
      using Microsoft.VisualStudio.Tools.Applications;
      using System.IO;
      
      namespace FileCopyPDA
      {
          public class FileCopyPDA : IAddInPostDeploymentAction
          {
              public void Execute(AddInPostDeploymentActionArgs args) 
              {
                  string dataDirectory = @"Data\ExcelWorkbook.xlsx";
                  string file = @"ExcelWorkbook.xlsx";
                  string sourcePath = args.AddInPath;
                  Uri deploymentManifestUri = args.ManifestLocation;
                  string destPath = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory);
                  string sourceFile = System.IO.Path.Combine(sourcePath, dataDirectory);
                  string destFile = System.IO.Path.Combine(destPath, file);
      
                  switch (args.InstallationStatus)
                  {
                      case AddInInstallationStatus.InitialInstall:
                      case AddInInstallationStatus.Update:
                          File.Copy(sourceFile, destFile);
                          ServerDocument.RemoveCustomization(destFile);
                          ServerDocument.AddCustomization(destFile, deploymentManifestUri);
                          break;
                      case AddInInstallationStatus.Uninstall:
                          if (File.Exists(destFile))
                          {
                              File.Delete(destFile);
                          }
                          break;
                  }
              }
          }
      }
      

De oplossing bouwen en publiceren

  1. Open in Solution Explorer het snelmenu voor het FileCopyPDA-project en kies vervolgens Build.

  2. Open het snelmenu voor het ExcelWorkbook-project en kies Bouwen.

  3. Open het snelmenu voor het ExcelWorkbook-project en kies Verwijzing toevoegen.

  4. Kies in het dialoogvenster Verwijzing toevoegen het tabblad Projecten , kies FileCopyPDA en kies vervolgens de knop OK .

  5. Kies in Solution Explorer het ExcelWorkbook-project .

  6. Kies op de menubalk Project>New Folder.

  7. Voer gegevens in en kies vervolgens de Enter-toets .

  8. Kies in Solution Explorer de map Gegevens .

  9. Kies op de menubalk Project>Add Existing Item.

  10. Blader in het dialoogvenster Bestaand item toevoegen naar de uitvoermap voor het ExcelWorkbook-project , kies het ExcelWorkbook.xlsx bestand en kies vervolgens de knop Toevoegen .

  11. Kies in Solution Explorer het bestandExcelWorkbook.xlsx .

  12. Wijzig in het venster Eigenschappen de eigenschap Build Action in Inhoud en de eigenschap Kopiëren naar uitvoerlocatie naar Kopiëren indien nieuwer.

    Wanneer u deze stappen hebt voltooid, lijkt uw project op de volgende afbeelding.

    Projectstructuur van de actie na de implementatie.

  13. Publiceer het ExcelWorkbook-project .

Het toepassingsmanifest wijzigen

  1. Open de oplossingsmap, c:\publish, met behulp van Verkenner.

  2. Open de map Toepassingsbestanden en open vervolgens de map die overeenkomt met de meest recente gepubliceerde versie van uw oplossing.

  3. Open het ExcelWorkbook.dll.manifest-bestand in een teksteditor, zoals Kladblok.

  4. Voeg na het </vstav3:update> element de volgende code toe. Gebruik voor het klassekenmerk van het <vstav3:entryPoint> element de volgende syntaxis: NamespaceName.ClassName. In het volgende voorbeeld zijn de naamruimte en klassenamen hetzelfde, dus de resulterende naam van het toegangspunt is FileCopyPDA.FileCopyPDA.

    <vstav3:postActions>
      <vstav3:postAction>
        <vstav3:entryPoint
          class="FileCopyPDA.FileCopyPDA">
          <assemblyIdentity
            name="FileCopyPDA"
            version="1.0.0.0"
            language="neutral"
            processorArchitecture="msil" />
        </vstav3:entryPoint>
        <vstav3:postActionData>
        </vstav3:postActionData>
      </vstav3:postAction>
    </vstav3:postActions>
    

De toepassings- en implementatiemanifesten opnieuw ondertekenen

  1. Kopieer in de map%USERPROFILE%\Documents\Visual Studio 2013\Projects\ExcelWorkbook\ExcelWorkbook het ExcelWorkbook_TemporaryKey.pfx-certificaatbestand en plak het in de map PublishFolder\Application Files\ExcelWorkbook_MostRecentPublishedVersion .

  2. Open de Opdrachtprompt van Visual Studio en wijzig vervolgens mappen in de map c:\publish\Application Files\ExcelWorkbook_MostRecentPublishedVersion (bijvoorbeeld c:\publish\Application Files\ExcelWorkbook_1_0_0_4).

  3. Onderteken het gewijzigde toepassingsmanifest door de volgende opdracht uit te voeren:

    mage -sign ExcelWorkbook.dll.manifest -certfile ExcelWorkbook_TemporaryKey.pfx
    

    Het bericht 'ExcelWorkbook.dll.manifest is ondertekend' wordt weergegeven.

  4. Ga naar de map c:\publish en werk het implementatiemanifest bij en onderteken het door de volgende opdracht uit te voeren:

    mage -update ExcelWorkbook.vsto -appmanifest "Application Files\Ex
    celWorkbookMostRecentVersionNumber>\ExcelWorkbook.dll.manifest" -certfile "Application Files\ExcelWorkbookMostRecentVersionNumber>\ExcelWorkbook_TemporaryKey.pfx"
    

    Opmerking

    Vervang in het vorige voorbeeld MostRecentVersionNumber door het versienummer van de laatst gepubliceerde versie van uw oplossing (bijvoorbeeld 1_0_0_4).

    Het bericht 'ExcelWorkbook.vsto is ondertekend' wordt weergegeven.

  5. Kopieer het bestand ExcelWorkbook.vsto naar de map c:\publish\Application Files\ExcelWorkbook_MostRecentVersionNumber .

Plaats het document van een oplossing op een server waarop SharePoint wordt uitgevoerd (alleen aanpassingen op documentniveau)

U kunt uw aanpassing op documentniveau publiceren aan eindgebruikers met behulp van SharePoint. Wanneer gebruikers naar de SharePoint-site gaan en het document openen, installeert de runtime de oplossing automatisch vanuit de gedeelde netwerkmap naar de lokale computer van de gebruiker. Nadat de oplossing lokaal is geïnstalleerd, werkt de aanpassing nog steeds, zelfs als het document ergens anders wordt gekopieerd, zoals het bureaublad.

Het document op een server met SharePoint plaatsen

  1. Voeg het oplossingsdocument toe aan een documentbibliotheek op een SharePoint-site.

  2. Voer de stappen uit voor een van de volgende methoden:

    • Gebruik het Office-configuratieprogramma om de server waarop SharePoint wordt uitgevoerd, toe te voegen aan het Vertrouwenscentrum in Word of Excel op alle gebruikerscomputers.

      Zie Beveiligingsbeleid en -instellingen in Office 2010.

    • Zorg ervoor dat elke gebruiker de volgende stappen uitvoert.

      1. Open Word of Excel op de lokale computer, kies het tabblad Bestand en kies vervolgens de knop Opties .

      2. Kies in het dialoogvenster Vertrouwenscentrum de knop Vertrouwde locaties .

      3. Schakel het selectievakje Vertrouwde locaties in mijn netwerk toestaan in (niet aanbevolen) en kies vervolgens de knop Nieuwe locatie toevoegen .

      4. Voer in het vak Pad de URL in van de SharePoint-documentbibliotheek die het document bevat dat u hebt geüpload (bijvoorbeeld http://SharePointServerName/TeamName/ProjectName/DocumentLibraryName).

        Voeg niet de naam van de standaardwebpagina toe, zoals default.aspx of AllItems.aspx.

      5. Vink het selectievakje Submappen van deze locatie zijn ook vertrouwd aan en kies vervolgens de knop OK.

        Wanneer gebruikers het document openen vanaf de SharePoint-site, wordt het document geopend en wordt de aanpassing geïnstalleerd. Gebruikers kunnen het document naar hun bureaublad kopiëren. De aanpassing wordt nog steeds uitgevoerd omdat de eigenschappen in het document verwijzen naar de netwerklocatie van het document.

Een aangepast installatieprogramma maken

U kunt een aangepast installatieprogramma voor uw Office-oplossing maken in plaats van het installatieprogramma te gebruiken dat voor u wordt gemaakt wanneer u de oplossing publiceert. U kunt bijvoorbeeld een aanmeldingsscript gebruiken om de installatie te starten of u kunt een batchbestand gebruiken om de oplossing te installeren zonder tussenkomst van de gebruiker. Deze scenario's werken het beste als de vereisten al zijn geïnstalleerd op computers van eindgebruikers.

Als onderdeel van uw aangepaste installatieproces roept u het installatieprogramma voor Office-oplossingen (VSTOInstaller.exe) aan, dat standaard op de volgende locatie is geïnstalleerd:

%commonprogramfiles%\microsoft shared\VSTO\10.0\VSTOInstaller.exe

Als het hulpprogramma zich niet op die locatie bevindt, kunt u de HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath of HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath registersleutel gebruiken om het pad naar dat hulpprogramma te vinden.

U kunt de volgende parameters gebruiken met VSTOinstaller.exe.

Kenmerk Definition
/Installeren of /I Installeer de oplossing. U moet deze optie volgen met het pad van een implementatiemanifest. U kunt een pad opgeven op de lokale computer, een UNC-bestandsshare (Universal Naming Convention). U kunt een lokaal pad opgeven (C:\FolderName\PublishFolder), een relatief pad (Publish\) of een volledig gekwalificeerde locatie (\\ServerName\FolderName of http:// ServerName/FolderName).
/Verwijderen of /U Verwijder de oplossing. U moet deze optie volgen met het pad van een implementatiemanifest. U kunt een pad opgeven dat zich kan bevinden op de lokale computer of op een UNC-bestandsshare. U kunt een lokaal pad (c:\FolderName\PublishFolder), een relatief pad (Publish\) of een volledig gekwalificeerde locatie (\\ServerName\FolderName of http:// ServerName/FolderName) opgeven.
nl-NL: /Silent of /S Installeren of verwijderen zonder de gebruiker te vragen om invoer of het weergeven van berichten. Als een vertrouwensprompt is vereist, wordt de aanpassing niet geïnstalleerd of bijgewerkt.
/Help of /? Geef de Help-informatie weer.

Wanneer u VSTOinstaller.exeuitvoert, worden de volgende foutcodes mogelijk weergegeven.

Foutcode Definition
0 De oplossing was succesvol geïnstalleerd of verwijderd, of de VSTOInstaller Help werd weergegeven.
-100 Een of meer opdrachtregelopties zijn niet geldig of zijn meerdere keren ingesteld. Voer voor meer informatie 'vstoinstaller /?' in of zie Een aangepast installatieprogramma maken voor een ClickOnce Office-oplossing.
-101 Een of meer opdrachtregelopties zijn niet geldig. Voer 'vstoinstaller /?' in voor meer informatie.
-200 De URI van het implementatiemanifest is niet geldig. Voer 'vstoinstaller /?' in voor meer informatie.
-201 De oplossing kan niet worden geïnstalleerd omdat het implementatiemanifest niet geldig is. Zie Implementatiemanifesten voor Office-oplossingen.
-202 De oplossing kan niet worden geïnstalleerd omdat de sectie Visual Studio Tools voor Office van het toepassingsmanifest niet geldig is. Zie toepassingsmanifesten voor Office-oplossingen.
-203 De oplossing kan niet worden geïnstalleerd omdat er een downloadfout is opgetreden. Controleer de URI of de locatie van het netwerkbestand van het implementatiemanifest en probeer het opnieuw.
-300 De oplossing kan niet worden geïnstalleerd omdat er een beveiligingsfout is opgetreden. Zie Secure Office-oplossingen.
-400 De oplossing kan niet worden geïnstalleerd.
-401 De oplossing kan niet worden verwijderd.
-500 De bewerking is geannuleerd omdat de oplossing niet kan worden geïnstalleerd of verwijderd of het implementatiemanifest niet kan worden gedownload.

Een update publiceren

Als u een oplossing wilt bijwerken, publiceert u deze opnieuw met behulp van de wizard Projectontwerper of Publiceren. Vervolgens kopieert u de bijgewerkte oplossing naar de installatielocatie. Wanneer u de bestanden naar de installatielocatie kopieert, moet u ervoor zorgen dat u de vorige bestanden overschrijft.

De volgende keer dat de oplossing op een update controleert, wordt de nieuwe versie automatisch gevonden en geladen.

De installatielocatie van een oplossing wijzigen

U kunt het installatiepad toevoegen of wijzigen nadat een oplossing is gepubliceerd. U kunt het installatiepad wijzigen om een of meer van de volgende redenen:

  • Het installatieprogramma is gecompileerd voordat het installatiepad bekend was.

  • De oplossingsbestanden zijn gekopieerd naar een andere locatie.

  • De server waarop de installatiebestanden worden gehost, heeft een nieuwe naam of locatie.

    Als u het installatiepad van een oplossing wilt wijzigen, moet u het installatieprogramma bijwerken en vervolgens moeten gebruikers het uitvoeren. Voor aanpassingen op documentniveau moeten gebruikers ook een eigenschap in hun document bijwerken om naar de nieuwe locatie te verwijzen.

Opmerking

Als u gebruikers niet wilt vragen hun documenteigenschappen bij te werken, kunt u gebruikers vragen het bijgewerkte document op te halen vanaf de installatielocatie.

Het installatiepad in het installatieprogramma wijzigen

  1. Open een opdrachtpromptvenster en wijzig de mappen in de installatiemap.

  2. Voer het installatieprogramma uit en neem de /url parameter op, die het nieuwe installatiepad als een tekenreeks gebruikt.

    In het volgende voorbeeld ziet u hoe u het installatiepad wijzigt in een locatie op de website van Fabrikam, maar u kunt die URL vervangen door het gewenste pad:

    setup.exe /url="http://www.fabrikam.com/newlocation"
    

    Opmerking

    Als er een bericht wordt weergegeven en wordt aangegeven dat de handtekening van het uitvoerbare bestand ongeldig is, is het certificaat dat is gebruikt om de oplossing te ondertekenen, niet meer geldig en is de uitgever onbekend. Als gevolg hiervan moeten gebruikers bevestigen dat ze de bron van de oplossing vertrouwen voordat ze deze kunnen installeren.

    Opmerking

    Als u de huidige waarde van de URL wilt weergeven, voert u het volgende uit setup.exe /url.

    Voor aanpassingen op documentniveau moeten gebruikers het document openen en vervolgens de eigenschap _AssemblyLocation bijwerken. In de volgende stappen wordt beschreven hoe gebruikers deze taak kunnen uitvoeren.

De eigenschap _AssemblyLocation in een document bijwerken

  1. Kies info op het tabblad Bestand, die in de volgende afbeelding wordt weergegeven.

    Tabblad Info in Excel

  2. Kies geavanceerde eigenschappen in de lijst Eigenschappen, die in de volgende afbeelding wordt weergegeven.

    Geavanceerde eigenschappen in Excel.

  3. Kies op het tabblad Aangepast in de lijst Eigenschappen _AssemblyLocation, zoals in de volgende afbeelding wordt weergegeven.

    De eigenschap AssemblyLocation.

    Het vak Waarde bevat de id van het distributiemanifest.

  4. Voer vóór de identifier het volledig gekwalificeerde pad van het document in, gevolgd door een scheidingsteken, in de indeling Path|Identifier (bijvoorbeeld File://ServerName/FolderName/FileName|74744e4b-e4d6-41eb-84f7-ad20346fe2d9.

    Voor meer informatie over het opmaken van deze kenmerk, zie Overzicht van aangepaste documenteigenschappen.

  5. Kies de knop OK en sla het document op en sluit het.

  6. Voer het installatieprogramma uit zonder de parameter /URL om de oplossing op de opgegeven locatie te installeren.

Een oplossing terugdraaien naar een eerdere versie

Wanneer u een oplossing terugdraait, worden gebruikers teruggezet naar een eerdere versie van die oplossing.

Een oplossing terugdraaien

  1. Open de installatielocatie van de oplossing.

  2. Verwijder in de publicatiemap op het hoogste niveau het implementatiemanifest (het VSTO-bestand ).

  3. Zoek de submap voor de versie waarnaar u wilt terugdraaien.

  4. Kopieer het implementatiemanifest van die submap naar de publicatiemap op het hoogste niveau.

    Als u bijvoorbeeld een oplossing wilt terugdraaien die OutlookAddIn1 heet van versie 1.0.0.1 naar versie 1.0.0.0, kopieert u het bestand OutlookAddIn1.vsto uit de map OutlookAddIn1_1_0_0_0 . Plak het bestand in de publicatiemap van het hoogste niveau, waarbij het versiespecifieke implementatiemanifest voor OutlookAddIn1_1_0_0_1 dat daar al stond wordt overschreven.

    In de volgende afbeelding ziet u de structuur van de publicatiemap in dit voorbeeld.

    Mapstructuur publiceren

    De volgende keer dat een gebruiker de toepassing of het aangepaste document opent, wordt de wijziging van het implementatiemanifest gedetecteerd. De eerdere versie van de Office-oplossing wordt uitgevoerd vanuit de ClickOnce-cache.

Opmerking

Lokale gegevens worden opgeslagen voor slechts één eerdere versie van een oplossing. Als u twee versies terugdraait, worden lokale gegevens niet bewaard. Zie Lokale en externe gegevens in ClickOnce-toepassingen voor meer informatie over lokale en externe gegevens.