Import položek z existujícího sharepointového webu

Článek
10/10/2023

Šablona projektu Importovat balíček řešení SharePointu umožňuje opakovaně používat prvky, jako jsou typy obsahu a pole z existujících sharepointových webů v novém řešení služby Visual Studio SharePoint. I když můžete spustit většinu importovaných řešení bez úprav, existují určitá omezení a problémy, které je potřeba zvážit, zejména pokud po importu upravíte některé položky.

Poznámka:

Chcete-li importovat opakovaně použitelné pracovní postupy, použijte šablonu projektu Importovat opakovaně použitelný pracovní postup. Další informace najdete v tématu Pokyny pro import opakovaně použitelných pracovních postupů.

Podporovaná řešení SharePointu

Visual Studio 2012 plně podporuje import řešení vytvořených v SharePoint Foundation a SharePoint Serveru.

Visual Studio 2012 nepodporuje import řešení vytvořených v následujících aplikacích:

Windows SharePoint Services 3.0
Microsoft Office SharePoint Server 2007
Visual Studio 2008
Microsoft SharePoint Designer 2007
Visual Studio 2010

I když můžete často úspěšně importovat řešení vytvořená těmito aplikacemi, tato funkce se neotestuje a nepodporuje.

Omezení importu položek

I když se většina sharepointových položek dá importovat z existujícího souboru .wsp , následující položky nejsou podporované a můžou vyžadovat správné úpravy:

Entity služby BDC
Elementy přidružení pracovního postupu kódu
Pracovní postupy kódu
Webové části vizuálu (.ascx)
Webové služby (.asmx)
Vazby typu obsahu
Příjemci událostí
Definice seznamu (šablony)
Definice webu

Při exportu řešení ze služby SharePoint Foundation nebo serveru SharePoint Server se tyto položky automaticky vyloučí ze souboru WSP . Jiné soubory .wsp vygenerované z nepodporovaných nástrojů však mohou tyto položky obsahovat. (Viz "Podporovaná řešení SharePointu" výše v tomto tématu.)

Co se stane při importu řešení

Při importu řešení pomocí šablony Importovat balíček řešení Služby SharePoint zkopíruje Visual Studio veškerý obsah souboru .wsp a pokusí se odsouhlasit a zachovat tolik přidružení a odkazů mezi importovanými prvky a jejich soubory, kolik je to možné.

Všechny importované položky se zkopírují do odpovídajících složek v Průzkumník řešení. Například typy obsahu se zobrazí v části Typy obsahu složky Typy obsahu a instance seznamu v části Instance seznamu. Soubory přidružené k importované položce se také zkopírují do složky položky. Například importovaná instance seznamu obsahuje své moduly, formuláře a stránky ASPX.

Závislé položky

Pokud vyberete položku v průvodci importem balíčku řešení Služby SharePoint, ale ne její závislé položky, zobrazí se v poli se zprávou informace, že závislé položky musí být vybrány také před importem.

Co jsou funkce?

Uživatelé Aplikace SharePoint Designer můžou v importovaných řešeních v Průzkumník řešení vidět neočekávané soubory označované jako funkce. I když funkce existovaly v řešení SharePoint Designeru, byly skryté v zobrazení. Funkce jsou teď viditelné v sadě Visual Studio.

Funkce jsou kontejnery pro položky SharePointu. Každá funkce uchovává odkaz na každou položku, například typy obsahu a definice seznamu, které obsahuje. Při importu řešení sada Visual Studio nastaví funkce pro všechny importované prvky a pokusí se zachovat relace mezi funkcemi pro soubory. Všechny soubory, jejichž odkazy nelze vyřešit, jsou vloženy do složky Jiné importované soubory .

Další informace o funkcích najdete v tématu Vývoj řešení SharePointu a práce s funkcemi.

Zpracování speciálních případů

V některých případech Visual Studio nemůže sloučit položku se závislými soubory. Všechny soubory, které sada Visual Studio nemohla přeložit, se zobrazí ve složce Jiné importované soubory. Kromě toho jsou jejich vlastnosti DeploymentType nastaveny na NoDeployment , aby nebyly nasazeny s řešením.

Pokud například importujete definici seznamu ExpenseForms, zobrazí se definice seznamu s tímto názvem ve složce Definice seznamu v Průzkumník řešení spolu s jeho Elements.xml a Schema.xml soubory. Přidružené formuláře ASPX a HTML však mohou být umístěny do složky s názvem ExpenseForms ve složce Jiné importované soubory . Chcete-li dokončit import, přesuňte tyto soubory pod definici seznamu ExpenseForms v Průzkumník řešení a změňte vlastnost DeploymentType pro každý soubor z NoDeployment na ElementFile.

Při importu příjemců událostí se soubor Elements.xml zkopíruje do správného umístění, ale sestavení musíte do balíčku řešení zahrnout ručně, aby se nasadila s řešením. Další informace o tom, jak to provést, naleznete v tématu Postupy: Přidání a odebrání dalších sestavení.

Při importu pracovních postupů se formuláře aplikace InfoPath zkopírují do složky Jiné importované soubory . Pokud soubor WSP obsahuje webovou šablonu, nastaví se jako spouštěcí stránka v Průzkumník řešení.

Import polí a sáčků vlastností

Při importu řešení s více poli se všechny definice samostatných polí sloučí do jednoho Elements.xml souboru pod uzlem v Průzkumník řešení s názvem Pole. Podobně se všechny položky tašky vlastností sloučí do souboru Elements.xml pod uzlem s názvem PropertyBags.

Pole v SharePointu jsou sloupce zadaného datového typu, například text, logická hodnota nebo vyhledávání. Další informace najdete v tématu Stavební blok: Sloupce a typy polí. Tašky vlastností umožňují přidávat vlastnosti do objektů v SharePointu, všechno od farmy po seznam na sharepointovém webu. Kontejnery vlastností se implementují jako tabulka hash názvů a hodnot vlastností. Další informace naleznete v tématu Správa konfigurace služby SharePoint nebo nastavení sady vlastností Služby SharePoint.

Odstranění položek v projektu

Většina položek v řešeních SharePointu má jednu nebo více závislých položek. Například instance seznamů závisí na typech obsahu a typech obsahu na polích. Po importu sharepointového řešení vás Visual Studio neoznámí žádné problémy s odkazy, pokud odstraníte položku v řešení, ale ne její závislé položky, dokud se nepokusíte řešení nasadit. Pokud má například importované řešení instanci seznamu, která závisí na typu obsahu a odstraníte tento typ obsahu, může dojít k chybě při nasazení. K chybě dochází v případě, že závislá položka není na serveru Služby SharePoint k dispozici. Podobně platí, že pokud odstraněná položka obsahuje také související tašku vlastností, odstraňte položky tašky vlastností ze souboru PropertyBags Elements.xml . Proto pokud odstraníte nějaké položky z importovaného řešení a dojde k chybám nasazení, zkontrolujte, jestli je potřeba odstranit také některé závislé položky.

Obnovení chybějících atributů funkce

Při importu řešení se některé volitelné atributy funkcí vynechávají z importovaného manifestu funkce. Pokud chcete obnovit tyto atributy v novém souboru funkce, identifikujte chybějící atributy porovnáním původního souboru funkce s novým manifestem funkce a postupujte podle pokynů v tématu Postupy: Přizpůsobení funkce SharePointu.

Detekce konfliktů nasazení se neprovádí u předdefinovaných instancí seznamu.

Visual Studio neprovádí detekci konfliktů nasazení u integrovaných instancí seznamu (to znamená výchozích instancí seznamu, které jsou součástí SharePointu). Neprovádí se detekce konfliktů, aby se zabránilo přepsání předdefinovaných instancí seznamu na SharePointu. Předdefinované instance seznamu jsou stále nasazené nebo aktualizované, ale nikdy se neodstraní ani nepřepíší. Další informace najdete v tématu Řešení potíží s balením a nasazením SharePointu.

Import pracovních postupů SharePoint Serveru 2010

Pokud naimportujete pracovní postup vytvořený na SharePoint Serveru, po nasazení se nespustí správně. Pracovní postup se nespustí správně, protože některá sestavení chybí a pracovní postupy SharePoint Serveru obsahují formuláře InfoPathu, které nejsou aktuálně podporovány v řešeních pracovních postupů sady Visual Studio. Importované pracovní postupy serveru SharePoint Server je však možné provést tak, aby fungovaly správně po opravě některých položek, například přidání odkazů na sestavení serveru SharePoint Server a opětovné připojení formulářů aplikace InfoPath. Další informace najdete v tématu Import pracovních postupů SharePoint Serveru 2010.

Omezení znaků názvu položky

Visual Studio má limit 260 celkového počtu znaků pro názvy položek projektu a projektu, včetně cesty. Při importu řešení se při překročení tohoto limitu zobrazí název položky:

Zadaná cesta, název souboru nebo obojí jsou příliš dlouhé. Plně kvalifikovaný název souboru musí být menší než 260 znaků a název adresáře musí být menší než 248 znaků.

Když se zobrazí tato chyba, položka se nevytvořila. K tomuto problému dochází nejčastěji u importovaných modulů. Chcete-li se tomuto problému vyhnout, postupujte takto:

Pokud je zadáte do dialogového okna Přidat nový projekt , použijte pro svůj projekt krátké názvy.
Vytvořte projekt v umístění co nejblíže kořenové složce, abyste cestu zkrátili.

Atribut SharePointProductVersion

Pokud importujete řešení vytvořené v dřívější verzi SharePointu, jako je Windows služba SharePoint Services 3.0 nebo systém Microsoft Office SharePoint Server 2007, změňte hodnotu atributu SharePointProductVersion v manifestu balíčku na 12.0 nebo vložte ovládací prvek správce skriptů do všech importovaných webových stránek a ponechte SharePointProductVersion nastavenou na 14.0. V opačném případě se importované webové formuláře nezobrazí v SharePointu.

Pozadí

Řešení v SharePoint Foundation a SharePoint Serveru zahrnují atribut s názvem SharePointProductVersion. SharePoint používá tento atribut v manifestech balíčku k určení verze SharePointu, pro které je řešení určené. Dvě platné hodnoty jsou 12,0 a 14,0. Hodnota 12.0 označuje, že položka je navržena pro Systém Windows služba SharePoint Services 3.0 nebo systém Microsoft Office SharePoint Server 2007; hodnota 14.0 označuje, že položka je navržena pro SharePoint Foundation nebo SharePoint Server.

Pro lepší zabezpečení při vykreslování stránek ASPX vyžaduje SharePoint Foundation a SharePoint Server, aby všechny stránky ASPX nebo předlohy obsahovaly ovládací prvek správce skriptů. Další informace o správci skriptů naleznete v tématu Přehled ovládacího prvku ScriptManager. Vzhledem k tomu, že ovládací prvek správce skriptů nebyl ve Windows služba SharePoint Services 3.0 a systém Microsoft Office SharePoint Serveru 2007 dostupný, musí být přidán do libovolného systému Windows služba SharePoint Services 3.0 nebo systém Microsoft Office Stránka SharePoint Serveru 2007, která je upgradována na SharePoint Foundation nebo SharePoint Server. Stránky ASPX, které používají standardní stránku předlohy, nevyžadují ovládací prvek správce skriptů, protože jeden je již přidán na standardní stránku předlohy. Stránky ASPX, které nepoužívají stránku předlohy nebo které používají vlastní stránku předlohy, ale musí přidat ovládací prvek skriptu, aby fungovaly na SharePoint Foundation nebo SharePoint Serveru.

Absence ovládacího prvku správce skriptů může být problém při importu windows služba SharePoint Services 3.0 nebo systém Microsoft Office projektu SharePoint Server 2007 do sady Visual Studio 2010, protože atribut SharePointProductVersion všech nových projektů je nastaven na 14.0. Pokud nasadíte upgradovaný projekt s webovým formulářem bez správce skriptů, formulář se na SharePointu nezobrazí.

Sdílet prostřednictvím